Gyakori Redmine telepítési és frissítési problémák
Mivel mind a Redmine, mind az Easy Redmine nyílt forráskódúak és többé-kevésbé platformfüggetlenek, előfordulhatnak telepítési és frissítési problémák különböző szerverkonfigurációk, szoftververziók vagy telepített bővítmények miatt. Kemény dolgozunk azon, hogy nyomon kövessük a gyakoriakat, hogy segíthessünk a hibaelhárításban.
Alkalmazás frissítése közben hibaüzenet észlel meg a naplóban, amely tartalmazza a "You have an error in your SQL syntax; ellenőrizze a MySQL szerver verziójának megfelelő kézikönyvet, hogy a közelében milyen szintaxis használható ..." szöveget.
Ok
Ez azt jelenti, hogy az adatbázis elavult, és nem tud működni az alkalmazásunk által küldött kéréssel. Egyszerűen nem érti.
Megagoldas
Frissíteni kell az adatbázist.
Hogyan frissítsük az adatbázist?
Részletes leírás a Tudásbázisban.
Telepítette vagy frissítette az Easy Redmine-t olyan felhasználói fiókkal, amely nem rendelkezik megfelelő engedélyekkel, nem követi a mi erős ajánlásunkat az utasításokban (legább egyszer a múltban).
- Corrig az engedélyeket a szerverbeállításoknak megfelelően a chgrp éS chown parancsokkal (pl. chgrp -R www-data public_html)
- Futtassa újra a telepítést a bundle exec rake easyproject: install RAILS_ENV = termelés parancs segítségével, amely törli a gyorsítótárat (ha root-ként futtatja, akkor nem lesz sikeres)
- Indítsa újra a szervert
Ha az Easy által biztosított virtuális gépet használja Software, futtassa az könnyű felhasználóval:
sudo chown -R könnyű / Home / egyszerű / áram
(az idősebb gépeken - sudo chown -R easy /srv/easyredmine/public_html)
sudo chgrp -R könnyű / Home / egyszerű / áram
(az idősebb gépeken - sudo chgrp -R easy /srv/easyredmine/public_html)
cd / Home / egyszerű / áram
(az idősebb gépeken - cd /srv/easyredmine/public_html)
bundle exec rake easyproject: install RAILS_ENV = termelés
sudo szolgáltatás puma@sajat.domain.neve indítsa újra
Ne felejtse el beállítani az összes szükséges térképengedélyt.
Itt van néhány tipp, hogy mit tehetsz, ha 500-as hibába ütközöl.
- futtasd az Easy szerverkövetelmény-ellenőrzőt és próbáld meg kijavítani a sikertelen ellenőrzéseket
- készíts biztonsági mentést az adatbázisodból
- töltsd le a legújabb csomagot a Kliens Zónából
- győződj meg róla, hogy a webszervernek Teljes hozzáférés van a nyilvános, fájlokat, log, tmp mappákhoz
- futtasd a köteg telepíteni --without fejlesztés teszt parancsot
- futtasd a bundle exec rake easyproject: install RAILS_ENV = termelés parancsot
- indítsd újra az alkalmazás szerverét
- töröld az összes harmadik fél Redmine bővítményt (az adatbázisból is)
- írj nekünk a support@easyredmine.com címre és csatold a log/production.log fájlt
Sok lehetséges okozója lehet ennek a hibának. Itt van néhány tipp:
- gyorsítótár probléma - próbálja törölni a gyorsítótárat a böngészőből
- dns probléma
- szerver beállítási probléma
azonnal a kapcsolat és hálózatát (ellenőrizze, hogy a szerver elérhető-ea ping parancs vagy a traceroute parancsát használja). Tűzfal szerver oldalon.
Ha mindez rendben van, próbáljon meg információt szerezni az nginx hibanaplóiból. előtt az nginx hibanaplóját a szerver oldalán - /var/log/nginx/error.log
ezért, hogy az nginx beállításja megfelel-e a szabványnak. Az itt található nginx beállítás:
https://www.redmine.org/projects/redmine/wiki/HowTo_configure_Nginx_to_run_Redmine
Egy nginx telepítés példája (amelyet az Easy Software használ). Nagyon hasonló az hivataloshoz, csak néhány változó van optimalizálva:
felhasználó www-data;
munkás_folyamatok 8;
worker_rlimit_nofile 60000;
error_log /var/log/nginx/error.log;
pid /var/run/nginx.pid;
események {
worker_connections 10240;
# Multi_accept on;
}
http {
ssl_protocols TLSv1 TLSv1.1 TLSv1.2; # ne használja az SSLv3-at, lásd: POODLE
tartalmazza /etc/nginx/mime.types;
default_type alkalmazás / octet-stream;
server_names_hash_bucket_size 2048;
access_log /var/log/nginx/access.log;
sendfile on;
#tcp_nopush tovább;
#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 on;
gzip_disable "MSIE [1-6] \. (?!. * SV1)";
közé /etc/nginx/conf.d/*.conf;
include / etc / nginx / sites-enabled / *;
include / etc / nginx / sites-auto / *;
}
A 502 hiba más lehetséges okai közé tartozik...
A Unicorn egyáltalán nem fut, mert
- Nincs elegendő engedély
- Rossz utas verzió
- Rossz Ruby verzió
- Hiányzó gyöngyök
- Törött fájlrendszer
A pontos probléma megállapításához ellenőrizni kell a hibanaplókat az unicorn vagy az apache + az Easy Redmine alkalmazásnaplójából (log/production.log)
Időtúllépés
Ha alacsony időkorlát van beállítva, akkor ez a hiba megjelenik:- nagy exportoknál
- a szerver túlterhelésekor
- rake feladatok futtatásakor a GUI-ból
MySQL kapcsolatok korlátja
G mind meg róla, hogy elegendő számú kapcsolat engedélyezett a MySQL-hez. Ez a felhasználók szám, de legalább 100-tól engedélyezettnek kell lennie.
Ez a hiba a 2018 1.2 verziótól kezdődően fordul elő (04.00 és magasabb platform).
Hiba történt a frissítés telepítése közben, amely az egyiket tartalmazza.
[!] Hiba történt a `Gemfile` értelmezésekor:
[!] Hiba történt a `Gemfile` értelmezésekor: nem lehet betölteni a fájlt --
# plugin 'rys-bundler', github: 'easysoftware / rys-bundler', branch: 'master'> Plugin.hook ('rys-gemfile', self)
A Bundler nem tud folytatódni.
Ez az elavult verziója a redmine telepítőnek köszönhető.
Megoldás:
Mielőtt telepítené a frissítést
$ gem telepítse a redmine-installert
- Hozzon létre egy további telepítéss fájlt a config/additional_environment.rb-ben
- config.action_controller.relative_url_root = "/ easyredmine"
- majd előkészítse az erőforrásokat (rake easyproject:install RAILS_ENV=production) és indítsa újra a szervert
G mind meg róla, hogy a wkhtmltopdf telepítve van és fut ( wkhtmltopdf X szerverre vagy más emulációra van szüksége)
Tesztelje ezt: "wkhtmltopdf google.com google.pdf"
Hozzáadás a proxy konfiguráció:
proxy_set_header X-Továbbítva-Proto https
Ellenőrizze cron konfigurációt. Nagyon fontos, hogy a rake feladatok NEM által működtetett gyökér. Ez okozza azt megfelelő engedélyek miatt.
Tegyük fel, hogy fut Easy Redmine amelyet a felhasználó könnyű. A parancsok:
Aktív crons szabályozza crontab -u könnyű -l
Szerkesztés crontab -u könnyű -e
Módosítások elfogadása sudo szolgáltatás cron reload
Példa futó cron minden 5 perc:
* / 5 * * * * /home/easy/scripts/easy_scheduler.sh &> / dev / null
#! / bin / bash -l
Log_File = "/ home / könnyű / current / log / easy_scheduler_rake.log"
echo "$ (date '+% Y-% m-% d% H:% M:% S') start rake" >> $ {LOG_FILE}
cd / home / easy / current && bundle exec rake easyproject: ütemező: run_tasks RAILS_ENV = produkció >> $ {LOG_FILE}
echo "$ (date '+% Y-% m-% d% H:% M:% S') végrake" >> $ {LOG_FILE}
/home/easy/scripts/easy_scheduler.sh kell végrehajtható:
sudo chmod + x /home/easy/scripts/easy_scheduler.sh
Ne habozzon, keressen az interneten pontosabb kézi beállításához cron a szerveren. Ez nem kizárólag egyszerű Redmine kívánt funkciót.
Amikor az Easy Redmine-t frissítette a Windows platformon, és hibaüzenetet kapsz a ExecJs :: RuntimeError kapcsán
Minden, amit tenned kell, az az, hogy telepíted a NODEJS-t a megfelelő frissítéshez.
G mind meg róla, hogy webszervere támogatja az URL-címek tényleges méretét
G mind meg róla, hogy A NEM használja a Webrick webszervert!
- g énver meg róla, hogy a webszer és a Ruby legfrissebb verzióját használja
- állítsa át a lassú szűrőlekérdezéseket, hogy kevesebb mezőt jelenítsen meg
- állítsa vissza a CRON-t, hogy ne induljon el olyan gyakran
- tekintse meg ezt az esettanulmányt - Rails sebesség növelése Ruby kód módosítása nélkül
- jobban a készüléket - https://www.easyredmine.com/resources/installation/1885-recommended-optimal-configuration-of-easy-redmine-server
Másolja át a fájlokat a régi Redmine mappából.
Az alaphelyzetben módosíthatja a Redmine beállításs fájljában, vagy használhat egy szimbolikus linket. A LAN vagy a felhőalapú hálózati tárolók a mellékletekhez nem ajánlottak a megbízhatósági problémák miatt.
Konfiguráció:
./config/configuration.yml
# Az a teljes elérési út, ahol a mellékletek vannak.
# Az alapértelmezett a 'files' mappa a Redmine példányában.
# Az EasyRedmine példányának olvasási / írási engedélyekkel kell rendelkezni ebben a mappában.
# Példák: attachments_storage_path: / var / www / Redmine / fájlok
Hibaelhárítás:
Ha nem tudja megnyitni a mellékletet, tekintse meg a ./log/production.log fájlt a gyakori hibákért:
Nem lehet mellékletet küldeni, /var/www/redmine/files/2015/08/150805095407_xxx.PNG nem létezik, vagy nem olvasható
ENOENT, Engedély megtagadva... stb.
G én meg róla, hogy webkiszolgálója teljes hozzáféréssel rendelkezik a Nyilvános, Fájlok, Napló, Tmp mappákhoz
Az Easy Redmine-ban az új commitok nem jelennek meg, ha csak az alkalmazás nem hívja le őket. Be kell állítani a webhorgokat adattároló kliensén (github, gitlab, TortoiseSVN,...) az Easy Redmine példányával kapcsolatos információkkal.
- Menjen az adminisztráció >> beállítások >> adattárolók oldalra
- Engedélyezze a WS-t az adattároló kezeléséhez
- Generáljon egy API-kulcsot
- Mentes
- Menjen az adattároló klienséhez
- Adjunk hozzá egy webhorgot
Tegyük fel, hogy az oldala easyredmine.company.com
Git-hez - https://easyredmine.company.com/ Sys / git_fetcher
vagy https://easyredmine.company.com/ Sys / git_fetcher? Key =[API-kulcs]
- a kliens beállításitól függően lehet, hogy csak egy URL-t vagy a kulcsot kell beírni egy másik mezőbe
SVN-hez - https://easyredmine.company.com/ Sys / fetch_changesets
vagy https://easyredmine.company.com/ Sys / fetch_changesets? Key =[API-kulcs]
Az 5. ponttól kezdve az adattároló kliens felelős, és nem kapcsolódik az Easy Redmine beállításához. Ez valami, amit tiszta telepítés vagy Redmine frissítés után ellenőriznie kell.
Amikor az Easy Redmine konfigurálja, meg kell róla, hogy legalább az első szintű domaint használja, például domain http://myeasyredmine.com helyett csak http://myeasyredmine. Néhány kérdésenek problémái azzal, hogy elérjék.
Menj az Adminisztrációba >> Beállítások >> Email értesítésekhez
és ellenőrizd, hogy a FELADÓ címe helyes-e.
Ez ugyanaznak kell lennie (vagyis ugyanabból az SMTP szerverből kell származnia), mint a telepítéss fájlban. Ellenkező esetben néhány e-mail szolgáltatás (gmail, yahoo, stb.) elutasíthatja az értesítéseket.
Ellenőrizd a beállítást a Tudásbázisban található cikk sheerint.
Az ellenőrzéshez, hogy a beállítás helyes-e, próbáld meg ellenőrizni, hogy a mail szerverhez csatlakozhatsz-e az Easy Red szerverről a telnet segítségével.
telnet your.domain.here port_number_here (Például: telnet gmail.com 465)
Ez megmutatja, hogy valóban csatlakozni tudsz-e a mail szerverhez, vagy probléma van a mail szerver beállításában.
Errno :: EPIPE (Broken pipe) vagy wkhtmltopdf: Nem lehet csatlakozni az X szerverhez
A wkhtmltopdf komponens exportálásával kapcsolatos problémák által.
Itt vannak a javasolt megoldások.
Fej nélküli szerver
Szerezze be a szükséges verziójú wkhtmltopdf-et a http://wkhtmltopdf.org/downloads.html oldalról
Példa (saját környezetének részleteivel kell dolgozni):
- sudo apt-get install 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-alfa-7b36694_linux-jessie-amd64.deb
- sudo apt-get -f telepítés
- sudo mv / usr / local / bin / wkhtmltopdf / usr / local / bin / xwkhtmltopdf
- echo 'exec xvfb-run -a -s "-képernyő 0 640x480x16" xwkhtmltopdf "$ @"' | sudo tee / usr / local / bin / wkhtmltopdf> / dev / null
- sudo chmod a + x / usr / local / bin / wkhtmltopdf
Csak nem fej nélküli szerver
- A wkhtmltopdf -nek telepítve kell lennie a szerveren a PATH -tilalom
(apt-get install wkhtmltox, yum install wkhtmltox)
Telepítve kell lennie a bundler-ben, külön nem működhet az Easy Redmine frissítése után - G mind meg arról, hogy a program helyesen működik (futtassa például a konzolból wkhtmltopdf https://easyredmine.com homepage.pdf parancsot)
- futtassa újra a rake easyproject:install RAILS_ENV=production parancsot
- indítsa újra a szervert
Plugin telepítése
- NE telepítse a plugineket ROOT felhasználóként
- Először törölje az összes régi Easy Gantt plugint, ha létezik (plugins/easy_gantt*)
- Másolja be az összes kicsomagolt plugint a REDMINE_ROOT/plugins mappába
- A REDMINE_ROOT mappaban
Futtatás: |
$ Bundle telepítés |
- (vagy csomag frissítése) |
$ Bundle exec rake db: migrál RAILS_ENV = gyártás |
$ Bundle exec rake redmine: plugin: migrál RAILS_ENV = gyártás |
indít indítsa újra a szervert.
Sikeres telepítéshez szükséges követelmények
- Redmine verzió: Kompatibilis a Redmine 3.2.x, 3.3.x, 3.4.x, 4.x verziókkal.
- Ruby verzió: 2.3+ (ajánlott 2.6.)
- Adatbázis típusa: MySQL (ajánlott), PostgreSQL
Kövesse az #telepítse telepítési eljárását. ezért, hogy a telepítési napló nem tartalmaz hibákat. Ha, próbálja meg megoldani a leírás szerint, vagy vegye fel a kapcsolatot a support@easyredmine.com címmel, és csatolja a napló hibaszakaszát.
Telepítés Bitnamin
A Bitnami nem tesztelt és nem garantált. Ha a telepítés nem sikerül, futtassa manuálisan:
Futtatás: |
$ Csomag frissítés |
$ Rake db: vándorolnak |
$ Rake Redmine: plugins: vándorolnak |