Yleiset Redmine-asennus- ja päivitysongelmat
Koska sekä Redmine että Easy Redmine ovat avoimen lähdekoodin ja enemmän tai vähemmän alustariippumattomia, joitakin asennus- ja päivitysongelmia voi ilmetä erilaisten palvelinkonfiguraatioiden, ohjelmistoversioiden tai asennettujen liitännäisten vuoksi. Teemme kovasti töitä näiden yleisimpien ongelmien seuraamiseksi auttaaksemme sinua vianetsinnässä.
Sovelluksen päivityksen aikana lokissa näkyy virhesanoma, joka sisältää lauseen "Sinulla on virhe SQL-syntaksissasi; tarkista manuaali, joka vastaa MySQL-palvelimen versiota, oikea syntaksi lähellä käytettäväksi ... ".
Syy
Tämä tarkoittaa, että tietokantasi on vanhentunut eikä se pysty käsittelemään sovelluksemme sille lähettämää pyyntöä. Se ei yksinkertaisesti ymmärrä sitä.
Ratkaisu
Sinun täytyy päivittää tietokantasi.
Miten päivitän tietokannan?
Yksityiskohtainen kuvaus Tietopankissa.
Olet asentanut tai päivittänyt Easy Redminen käyttäjällä, jolla ei ole riittäviä käyttöoikeuksia, etkä ole noudattanut vahvaa suositustamme ojeiden mukaisesti (vähintään kerran aiemmin).
- Korjaa käyttöoikeudet komentojen chgrp ja chown avulla palvelimen asetusten mukaisesti (esim. chgrp -R www-data public_html)
- Aja asennus uudelleen komennolla bunt exec rake easyproject: installera RAILS_ENV = produktion, joka tyhjentää välimuistin (jos suoritat sen pääkäyttäjänä, se ei onnistu)
- Käynnistä palvelin uudelleen
Jos käytät Easy Softwaren tarjoamaa virtuaalikonetta, suorita se käyttäjän lätt alla:
sudo chown -R lätt / Home / lätt / ström
(vanhemmissa koneissa - sudo chown -R easy /srv/easyredmine/public_html)
sudo chgrp -R enkelt / Home / lätt / ström
(vanhemmissa koneissa - sudo chgrp -R easy /srv/easyredmine/public_html)
cd / Home / lätt / ström
(vanhemmissa koneissa - cd /srv/easyredmine/public_html)
bunt exec rake easyproject: installera RAILS_ENV = produktion
sudo-tjänsten puma@ditt.domän.namn starta om
Muista asettaa käyttöoikeudet kaikille tarvittaville kansioille.
Tässä on joitain vinkkejä mitä voit tehdä, jos kohtaat 500 virheen.
- suorita Easy-palvelimen vaatimusten tarkistus ja yritä korjata epäonnistuneet validoinnit
- varmuuskopioi tietokantasi
- lataa uusin paketti Asiakasalueelta
- varmista, että web-palvelimella på Täysi pääsy allmänheten, filer, log, tmp kansioihin
- suorita buntinstallation - utan utvecklingstest
- suorita bunt exec rake easyproject: installera RAILS_ENV = produktion
- käynnistä sovellispalvelin uudelleen
- poista kaikki kolmansien osapuolien Redmine-liitännäiset (myös tietokannasta)
- kirjoita meille osoitteeseen support@easyredmine.com ja liitä mukaan tiedosto log/production.log
På olemassa monia mahdollisia syitä tälle virheelle. Tässä muutamia vinkkejä:
- selaimen välimuistiongelma - yritä poistaa välimuisti selaimesta
- dns-ongelma
- palvelimen asetusongelma
Tarkista ensin yhteys ja verkko (varmista, että palvelimeen pääsee ping-komennolla tai traceroute-komennolla). Palomuuri palvelimen puolella.
Jos kaikki yllä olevat vaikuttavat olevan kunnossa, yritä saada tietoa nginx-virhelokeista. Tarkista nginx-virheloki palvelimen puolelta - /var/log/nginx/error.log
Tarkista, että nginx-konfiguraatiosi vastaa standardia. Standardi nginx-konfiguraatio löytyy täältä:
https://www.redmine.org/projects/redmine/wiki/HowTo_configure_Nginx_to_run_Redmine
Esimerkki nginx-konfiguraatiosta (käytetty Easy Softwaren toimesta). Se på melko samanlainen kuin virallinen, vain muutama muuttuja på optimoitu:
Användare www-data;
arbetare_processer 8;
worker_rlimit_nofile 60000;
error_log /var/log/nginx/error.log;
pid /var/run/nginx.pid;
evenemang {
arbetarkopplingar 10240;
# multi_accept på;
}
http {
ssl_protocols TLSv1 TLSv1.1 TLSv1.2; # älä käytä SSLv3 ref: PUDEL
inkludera /etc/nginx/mime.types;
default_type application / octet-stream;
server_names_hash_bucket_size 2048;
access_log /var/log/nginx/access.log;
sendfile på;
#tcp_nopush på;
#keepalive_timeout 0;
keepalive_timeout 65;
tcp_nodelay on;
send_timeout 1800;
client_body_timeout 1800;
client_header_timeout 1800;
proxy_read_timeout 1800;
client_max_body_size 220m;
fastcgi_buffer_size 64K;
fastcgi_buffers 128 16k;
proxy_max_temp_file_size 0;
types_hash_max_size 4096;
types_hash_bucket_size 128;
proxy_busy_buffers_size 256k;
proxy_buffers 8 256k;
proxy_buffer_size 256k;
gzip på;
gzip_disable "MSIE [1-6] \. (?!. * SV1)";
inkludera /etc/nginx/conf.d/*.conf;
inkludera / etc / nginx / sites-enabled / *;
inkludera / etc / nginx / sites-auto / *;
}
Muita mahdollisia syitä 502-virheelle ovat...
Unicorn ei toimi ollenkaan, johtuen
- Riittämättömät käyttöoikeudet
- Väärä passagerarversion
- Väärä Ruby-versio
- Puuttuvat gemit
- Rikki oleva tiedostojärjestelmä
Saadaksesi selville tarkan ongelman, sinun täytyy tarkistaa virhelokit unicornista tai apachesta + sovellisloki Easy Redminestä (log/production.log)
Aikakatkaisu
Jos matala aikakatkaisu på määritetty, tämä virhe ilmestyy:
- suurissa vientitapahtumissa
- palvelimen ylikuormituksessa
- rake-tehtävissä, jotka suoritetaan käyttöliittymästä
MySQL-yhteyksien rajoitus
Varmista, että sinulla on riittävä määrä sallittuja yhteyksiä MySQL:iin. Se riippuu käyttäjien määrästä, mutta sinun tulisi sallia vähintään 100 yhteyttä.
Tämä virhe ilmenee versiosta 2018 1.2 (alustalla 04.00 ja uudempi)
Virhe tapahtuu päivityksen asennuksen aikana, joka sisältää seuraavia.
[!] Virhe `Gemfile`-tiedoston jäsentämisessä:
[!] Virhe `Gemfile`-tiedoston jäsentämisessä: ei voi ladata kyseistä tiedostoa --
# plugin 'rys-bundler', github: 'easysoftware / rys-bundler', branch: 'master'> Plugin.hook ('rys-gemfile', själv)
Bundler ei voi jatkaa.
Tämä johtuu vanhentuneesta redmine-asentimen versiosta.
Ratkaisu:
Ennen päivityksen asentamista
$ gem installera redmine-installer
Tämä ongelma ilmenee, kun käytät liitettä Easy Redmine URL-osoitteessasi, esimerkiksi: https://company.com/easyredmine/
Tässä tapauksessa sinun på varmistettava, että muuttuja RAILS_RELATIVE_URL_ROOT på määritetty oikeaan liitteeseen /easyredmine
Bitnami:
- Luo lisäkonfiguraatiotiedosto config/additional_environment.rb
- config.action_controller.relative_url_root = "/ easyredmine"
- sitten esikäännä resurssit (rake easyproject:install RAILS_ENV=produktion) ja käynnistä palvelin uudelleen
Varmista, että wkhtmltopdf på asennettu ja käynnissä ( wkhtmltopdf tarvitsee X-palvelimen tai muun emulaation)
Kokeile sitä käyttämällä: "wkhtmltopdf google.com google.pdf"
Lisää välityspalvelimen määrityksiin:
proxy_set_header X-Forwarded-Proto https
Kontrollera cronkonfigurationen. Det är mycket viktigt att rakeuppgifter är INTE drivs av rot. Det kommer att orsaka fel på grund av otillräckliga behörigheter.
Låt oss säga att du kör Easy Redmine under användaren lätt. Kommandona är:
Visa aktiva krönor crontab -u lätt -l
Redigera crontab -u lätt -e
Applicera förändringar sudo service cron reload
Exempel på att köra varje 5-minut:
* / 5 * * * * /home/easy/scripts/easy_scheduler.sh &> / dev / null
#! / bin / bash -l
LOG_FILE = "/ home / lätt / ström / log / easy_scheduler_rake.log"
eko "$ (datum '+% Y-% m-% d% H:% M:% S') starta kratta" >> $ {LOG_FILE}
cd / home / easy / current && bundle exec rake easyproject: scheduler: run_tasks RAILS_ENV = produktion >> $ {LOG_FILE}
eko "$ (datum '+% Y-% m-% d% H:% M:% S') slutsträng" >> $ {LOG_FILE}
/home/easy/scripts/easy_scheduler.sh måste vara körbar:
sudo chmod + x /home/easy/scripts/easy_scheduler.sh
Tveka inte att söka på internet för en mer exakt manual för att ställa in cron på din server. Det är inte en exklusiv Easy Redmine krävs funktion.
Kun päivität Easy Redminea Windows-alustalla ja saat virheilmoituksen ExecJs :: RuntimeError
Sinun tarvitsee förgäves asentaa NODEJS järjestelmääsi oikean päivityksen suorittamiseksi.
Varmista, että web-palvelimesi tukee URL-osoitteen todellista kokoa
Varmista, että ET käytä Webrick-web-palvelinta!
- varmista, että sinulla on uusin versio web-palvelimesta ja Rubysta
- määritä hitaat suodatinhaut näyttämään vähemmän kenttiä
- nollaa CRON, jotta se ei käynnisty niin usein
- tutustu tähän tapaustutkimukseen - Railsin nopeutus ilman Ruby-koodin muokkaamista
- tarkista konfiguraatiosi - https://www.easyredmine.com/resources/installation/1885-suositeltava-optimaalinen-konfiguraatio-easy-redmine-palvelimelle
Kopioi tiedostot kansio vanhasta Redminestäsi.
Voit muuttaa oletustiedostojen sijaintia Redminen konfiguraatiotiedostossa tai voit käyttää symbolista linkkiä. LAN- tai pilvipohjaisia verkkotallennuksia liitteille ei suositella luotettavuusongelmien vuoksi.
Konfiguration:
./config/configuration.yml
# Absoluuttinen polku hakemistoon, jossa liitteet säilytetään.
# Oletusarvo på 'filer'-hakemisto Redmine-instanssissasi.
# EasyRedmine-instanssillasi tulee olla lukuoikeudet ja kirjoitusoikeudet tähän hakemistoon.
# Esimerkkejä: attachments_storage_path: / var / www / redmine / files
Vianmääritys:
Jos et voi avata liitettä, tarkista yleisimmät virheet tiedostosta ./log/production.log:
Liitettä ei voi lähettää, /var/www/redmine/files/2015/08/150805095407_xxx.PNG ei ole olemassa tai sitä ei voi lukea
ENOENT, Käyttö estetty... jne.
Varmista, että web-palvelimellasi on täysi pääsy kansioihin allmänheten, filer, log, tmp
Uudet sitoumukset tietovarastossasi eivät näy Easy Redminessa, elleivät ne ole haettu sovelluksella. Sinun täytyy asettaa webkoukut tietovaraston asiakkaalle (github, gitlab, TortoiseSVN,...) tiedoilla Easy Redmine-instanssistasi.
- Mene hallintaan >> asetukset >> tietovarastot
- Ota käyttöön WS tietovaraston hallintaa varten
- Luo API-avain
- spara
- Mene tietovaraston asiakkaallesi
- Lisää webkoukku
Oletetaan, että sivustosi på easyredmine.company.com
Gitille - https://easyredmine.company.com/ Sys / git_fetcher
tai https://easyredmine.company.com/ Sys / git_fetcher? Key =[API-avain]
- asiakkaan asetuksesta riippuen, se voi vaatia joko yhden URL-osoitteen tai avaimen eri kenttään
SVN:lle - https://easyredmine.company.com/ sys / fetch_changesets
tai https://easyredmine.company.com/ Sys / fetch_changesets? Nyckel =[API-avain]
Kohdasta 5 eteenpäin se on kaikki tietovaraston asiakkaan vastuulla eikä liity Easy Redmine-asetuksiin. Se on jotain, mitä sinun täytyy varmistaa puhtaan asennuksen tai päivityksen jälkeen Redminesta.
Kun määrität Easy Redminen verkkotunnusta, varmista, että käytät vähintään ensimmäisen tason verkkotunnusta, esimerkiksi http://myeasyredmine.com sen sijaan, että käyttäisit pelkkää http://myeasyredmine . Jotkut selaimet saattavat kohdata ongelmia sen tavoittamisessa.
Mene hallintapaneeliin >> Asetukset >> Sähköposti-ilmoitukset
ja varmista, että LÄHETTÄJÄN osoite on oikein.
Sen tulisi olla sama (tai ainakin samasta SMTP-palvelimesta) kuin konfiguraatiotiedostossa. Muuten jotkut sähköpostipalvelut (gmail, yahoo jne.) saattavat hylätä ilmoitukset.
Tarkista konfiguraatiosi tämän artikkelin tietojen perusteella.
Varmistaaksesi, että konfiguraatio on oikein, yritä tarkistaa, voitko muodostaa yhteyden sähköpostipalvelimeen Easy Redmine -palvelimestasi käyttäen telnetiä.
telnet sinun.verkkotunnus.tässä porttinumero_tässä (Esimerkiksi: telnet gmail.com 465)
Se näyttää sinulle, voitko todella muodostaa yhteyden sähköpostipalvelimeesi vai onko ongelma sähköpostipalvelimen konfiguraatiossa.
Errno::EPIPE (Rikki oleva putki) eller wkhtmltopdf: ei voi muodostaa yhteyttä X-palvelimeen
Aiheutuu ongelmista viennin komponentin wkhtmltopdf med
Tässä på ehdotetut ratkaisut.
Päättymätön palvelin
Hanki tarvittava versio wkhtmltopdf:stä osoitteesta http://wkhtmltopdf.org/downloads.html
Esimerkki (sinun täytyy työskennellä oman ympäristösi yksityiskohtien kanssa):
- sudo apt-get installera xvfb xauth
- wget https://bitbucket.org/wkhtmltopdf/wkhtmltopdf/downloads/wkhtmltox-0.13.0-alpha-7b36694_linux-jessie-amd64.deb
- sudo dpkg -i wkhtmltox-0.13.0-alpha-7b36694_linux-jessie-amd64.deb
- sudo apt-get -f installera
- sudo mv / usr / local / bin / wkhtmltopdf / usr / local / bin / xwkhtmltopdf
- eko 'exec xvfb-run -a -s "-skärm 0 640x480x16" xwkhtmltopdf "$ @"' | sudo tee / usr / local / bin / wkhtmltopdf> / dev / null
- sudo chmod a + x / usr / local / bin / wkhtmltopdf
Vain ei-päättymätön palvelin
- Sinun täytyy asentaa wkhtmltopdf palvelimeesi VÄG -hakemistoon
(apt-get install wkhtmltox, yum installera wkhtmltox)
Sen på oltava asennettuna bundleriin, muuten se ei ehkä toimi Easy Redminen päivityksen jälkeen - Varmista, että ohjelma toimii oikein (suorita esimerkiksi konsolista wkhtmltopdf https://easyredmine.com homepage.pdf)
- suorita rake easyproject:install RAILS_ENV=produktion uudelleen
- käynnistä palvelin uudelleen
Liitännäisen asennus
- ÄLÄ asenna liitännäisiä ROOT-käyttäjänä
- Poista ensin kaikki vanhat Easy Gantt -liitännäiset, jos sellaisia on (plugins/easy_gantt*)
- Kopioi kaikki puretut liitännäiset REDMINE_ROOT/plugins-kansioon
- REDMINE_ROOT-kansiossa
Suorita: |
$ buntinstallation |
- (tai paketuppdatering) |
$ bundle exec rake db: migrera RAILS_ENV = produktion |
$ bundle exec rake redmine: plugins: migrera RAILS_ENV = produktion |
Tämän jälkeen käynnistä palvelin uudelleen.
Onnistuneen asennuksen vaatimukset
- Redmine-version: Yhteensopiva Redmine 3.2.x, 3.3.x, 3.4.x, 4.x kanssa.
- Ruby-version: 2.3+ (suositus 2.6.)
- Tietokannan tyyppi: MySQL (suositus), PostgreSQL
Seuraa asennusohjeita #Installera. Varmista, ettei asennusloki sisällä virheitä. Jos siellä on virheitä, yritä ratkaista ne kuvauksen mukaisesti tai ota yhteyttä support@easyredmine.com ja liitä lokiin liittyvä virheosio.
Asennus Bitnami-ympäristössä
Bitnami-ympäristöä ei ole testattu eikä taata. Jos asennus epäonnistuu, suorita seuraavat vaiheet manuaalisesti:
Suorita: |
$ bunt uppdatering |
$ rake db: migrera |
$ rake redmine: plugins: migrera |