Běžné problémy s instalací a aktualizací Redmine.
Vzhledem k tomu, že jsou jak Redmine, tak Redmine Open Source a jsou více méně nezávislé na platformě, mohou se vyskytnout problémy s instalací a aktualizací Easy kvůli různým konfiguračním serverům, verzím softwaru nebo nainstalovaným pluginům. Proto je třeba sledovat ty nejčastěji, abyste vám pomohli odstranitm problémy.
Instalovali jste nebo aktualizovali Easy Redmine pod uživatelem s nedostatečnými oprávněními, nesledující naše silná doporučení v instrukcích (alespoň jednou v minulosti).
- Správná oprávnění pomocí příkazů chgrp a chown podle nastavení serveru (např. chgrp -R www-Data public_html)
- Spusťte instalaci znovu svazek exec rake easyproject: nainstalovat RAILS_ENV = výroba, která vymaže cache (pokud ji spustíte jako root, nebude úspěšná)
- Restartujte server
Pokud používáte virtuální stroj poskytovaných společností Easy Software, spusťte pod uživatelem snadný:
sudo chown -R snadné / home / easy / current
(ve starších strojích - sudo chown -R easy /srv/easyredmine/public_html)
sudo chgrp -R snadné / home / easy / current
(v starších strojích - sudo chgrp -R easy /srv/easyredmine/public_html)
cd / home / easy / current
(ve starších strojích - cd /srv/easyredmine/public_html)
svazek exec rake easyproject: nainstalovat RAILS_ENV = výroba
restartujte službu sudo puma@vaše.doména
Nezapomeňte nastavit oprávnění pro všechny potřebné složky.
Instalace pluginu
- NEinstalujte pluginy jako uživatel ROOT
- Nejprve všechny staré pluginy Easy Gantt, pokud existují (plugins/easy_gantt*)
- Zkopírujte všechny rozbalené pluginy do REDMINE_ROOT/plugins
- V REDMINE_ROOT
| Spustit: |
| $ Svazek nainstalovat |
| - (nebo aktualizace balíčku) |
| $ bundle exec rake db: migrace RAILS_ENV = produkce |
| $ bundle exec rake redmine: pluginy: migrace RAILS_ENV = produkce |
Poté restartujte server.
Požadavky pro úspěšnou instalaci
- Verze Redmine: Kompatibilní s Redmine 3.2.x, 3.3.x, 3.4.x, 4.x.
- Verze Ruby: 2.3+ (doporučeno 2.6.)
- Typ databáze: MySQL (doporučeno), PostgreSQL
Následujte postup instalace v #instalovat. Ověřte, zda instalační protokol žádné chyby. Pokud ano, snažte se je řešit podle popisu nebo opravit support@easyredmine.com s připojeným chybovým oddílem protokolu.
Instalace na Bitnami
Bitnami není testováno ani zaručeno. Pokud instalaci samostatně, spusťte ručně:
| Spustit: |
| $ Aktualizace bundle |
| $ Rake db: migrovat |
| $ Rake Redmine: plugins: migrovat |
Dokumentace / znalosti Ganttovy diagramy
Při aktualizaci aplikace se v protokolu objeví chybová zpráva obsahující "Máte chybu ve své SQL syntaxi; slouží manuál, který odpovídá vaší verzi MySQL serveru pro správnou syntaxi použití v blízkosti... "
Příčina
Znamená to, že vaše databáze je zastaralá a nemůže pracovat s požadavkem, který na ni naše aplikace posílá. Jednoduše tomu nerozumím.
Řešení
Musíte aktualizovat svou databázi.
Jak aktualizovat?
Podrobný popis v Znalostní báze.
určitě se, že váš webový server podporuje skutečnou velikost URL adresy
jinak se, že NEPOUŽÍVÁTE webový server Webrick!
- ujištěte se, že máte nejnovější verzi webového serveru a Ruby
- překonfigurujte pomalé dotazování filtrů tak, aby zobrazovalo méně polí
- resetujte svůj CRON, aby se neaktivoval tak často
- odkaz na tuto studii případu - Zrychlení Rails bez dotyku kódu Ruby
- ideálně svou konfiguraci - https://www.easyredmine.com/resources/installation/1885-recommended-optimal-configuration-of-easy-redmine-server
Zkopírujte složku souborů z vašeho starého Redmine.
Výchozí umístění Redmine můžete změnit v konfiguračním souboru Redmine nebo můžete použít symbolický odkaz. Síťová úložiště LAN nebo cloudové úložiště pro přílohy není doporučeno kvůli problémům s spolehlivostí.
Konfigurace:
./config/configuration.yml
# Absolutní cesta k adresáři, kde jsou přílohy uloženy.
# Výchozí umístění je adresář 'files' ve vaší instanci Redmine.
# Vaše instance EasyRedmine musí mít oprávnění ke čtení a zápis do tohoto adresáře.
# Příklady: attachments_storage_path: / var / www / Redmine / soubory
Řešení problémů:
Pokud nemůžete otevřít přílohu, podívejte se do ./log/production.log pro běžné chyby:
Nelze odeslat přílohu, /var/www/redmine/files/2015/08/150805095407_xxx.PNG neexistuje nebo není čitelný
ENOENT, Odmítnuto oprávnění... atd.
určitě se, že váš webový server má plný přístup ke složkám veřejnost, soubory, log, tmp s přístupem pro všechny uživatele.
Nové závazky ve vašem repozitáři se nezobrazí v Easy Redmine, pokud nejsou stažené aplikace. Musíte nastavit webhooky pro váš klientském repozitáři (github, gitlab, TortoiseSVN,...) s informacemi o vaší instanci Easy Redmine.
- Jdi do toho správy >> nastavení >> repozitáře
- Aktivujte WS pro správu repozitářů
- Vytvořte API klíč
- Uložte
- Přejděte na váš klientský repozitář
- Přidejte webhook
Předpokládejme, že vaše stránka je easyredmine.company.com
Pro git - https://easyredmine.company.com/ Sys / git_fetcher
nebo https://easyredmine.company.com/ Sys / git_fetcher? Key =[API klíč]
- v závislosti na nastavení klienta může vyžadovat jedinou URL adresu nebo klíč do jiného pole
Pro SVN - https://easyredmine.company.com/ sys / fetch_changesets
nebo https://easyredmine.company.com/ Sys / fetch_changesets? Key =[API klíč]
Od bodu 5 je to vše na klientském repozitáři a nesouvisí s nastavením Easy Redmine. Je to něco, co musíte ověřit po čisté instalaci nebo po aktualizaci z Redmine.
Při konfiguraci vaší domény se jedná o první, že používáte alespoň alespoň doménu úrovně vaší úrovně, například http://myeasyredmine.com místo pouhého http://myeasyredmine. Některé prohlížeče s ním mohou mít problém.
Přejděte do správy >> Nastavení >> Emailová upozornění
a ověřte, že adresa ODPOVĚĎ je správná.
Měla by být stejná (nebo alespoň z toho SMTP serveru) jako v konfiguračním souboru. Jinak některé emailové služby (gmail, yahoo, atd.) mohou upozornění odmítnout.
Zkontrolujte svou konfiguraci podle tohoto článku v databázi znalostí.
Pro ověření, že konfigurace je správná, zkuste zkontrolovat, zda se můžete připojit k mail serveru ze svého serveru Easy Redmine pomocí telnetu.
telnet vaše.domena.zde číslo_portu_zde (například: telnet gmail.com 465)
Ukáže vám, zda se skutečně můžete připojit k vašemu mailserveru, nebo existuje problém v konfiguraci vašeho mailserveru.
Při pokusu o export PDF souboru se může objevit chyba (nebo se nic nestane). Produkční log bude obsahovat chybovou hlášku podobnou
Errno :: EPIPE (Broken pipe) nebo wkhtmltopdf: nelze se připojit k X serveru
Problém způsobený exportním komponentem wkhtmltopdf
Zde jsou navržená řešení.
Bezhlavý server
Získejte potřebnou verzi wkhtmltopdf z http://wkhtmltopdf.org/downloads.html
Příklad (musíte pracovat s podrobnostmi vašeho vlastního prostředí):
- 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 nainstalovat
- sudo mv / usr / local / bin / wkhtmltopdf / usr / local / bin / xwkhtmltopdf
- echo 'exec xvfb-run -a -s "-screen 0 640x480x16" xwkhtmltopdf "$ @"' | sudo tee / usr / local / bin / wkhtmltopdf> / dev / null
- sudo chmod a + x / usr / local / bin / wkhtmltopdf
Pouze pro bezhlavý server
- Musíte mít nainstalovaný wkhtmltopdf na vašem serveru v PATH
(Apt-get install wkhtmltox, yum install wkhtmltox)
Musí být nainstalován v bundleru, jinak by nemusel fungovat po aktualizaci Easy Redmine - například se, že program funguje správně (spusťte například z konzole wkhtmltopdf https://easyredmine.com homepage.pdf)
- znovu spusťte rake easyproject:install RAILS_ENV=production
- restartujte server
Zde jsou některé tipy, co můžete udělat, pokud narazíte na chybu 500.
- spusťte Snadná kontrola požadavků na server a zkuste opravit chybu ověření
- zazálohujte svou databázi
- stáhněte si nejnovější balíček z Klientských zón
- ujištěte se, že webový server má Plný přístup veřejné, soubory, log, tmp složky
- spusťte svazek nainstalovat --without vývoj testů
- spusťte svazek exec rake easyproject: nainstalovat RAILS_ENV = výroba
- restartujte aplikační server
- smazat pluginy Redmine od třetích stran (také z databáze)
- napište nám na support@easyredmine.com a přiložte log/production.log
Existuje mnoho možných příčin této chyby. Zde je několik tipů:
- mezipaměť prohlížeče problém - zkuste vymazat mezipaměť z prohlížeče
- dns problém
- Problém nastavení serveru
Nejprve zkontrolujte připojení a síť (ověřte, zda je server dosažitelný pomocí příkazu ping nebo traceroute). Strana brány firewall.
Pokud se vše výše zdá v pořádku, zkuste získat nějaké informace z nginx error.logs. Zkontrolujte nginx error.log na straně serveru - /var/log/nginx/error.log
Ještě jednou zkontrolujte, zda konfigurace Nginx odpovídá standardu. Standardní konfigurace Nginx lze nalézt zde:
https://www.redmine.org/projects/redmine/wiki/HowTo_configure_Nginx_to_run_Redmine
Příklad konfigurace Nginx (jak je používán Easy Software). Je to docela podobný oficiální jednoho jsou optimalizované jen několik proměnných:
Uživatel www-dat;
pracovní procesy 8;
worker_rlimit_nofile 60000;
error_log /var/log/nginx/error.log;
pid /var/run/nginx.pid;
Události {
worker_connections 10240;
# Multi_accept dále;
}
http {
ssl_protocols TLSv1 TLSv1.1 TLSv1.2; # nepoužívejte SSLv3 ref: POODLE
zahrnout /etc/nginx/mime.types;
default_type aplikace / octet-stream;
server_names_hash_bucket_size 2048;
access_log /var/log/nginx/access.log;
sendfile on;
#tcp_nopush na;
#keepalive_timeout 0;
keepalive_timeout 65;
tcp_nodelay zapnuto;
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 zapnuto;
gzip_disable "MSIE [1 6-] \. (* SV1?!).";
zahrnují /etc/nginx/conf.d/*.conf;
include / etc / nginx / sites-povolen / *;
include / etc / nginx / sites-auto / *;
}
Další možné příčiny chyby 502 patří ...
Unicorn neběží vůbec, díky
- nedostatečná oprávnění
- Chybná verze cestujícího
- Chybná verze Ruby
- Chybějící drahokamy
- Broken filesystem
Chcete-li zjistit přesné problém, je třeba zkontrolovat chybové hlášky Unicorn nebo Apache + protokolu aplikací od Easy Redmine (log / production.log)
Timeout
Pokud je nastaven nízký časový limit, tato chyba se objeví při:
- velkých exportech
- přetížení serveru
- spouštění rake úloh z GUI
Omezit připojení k MySQL
stačí se, že máte dostatečný počet povolených připojení k MySQL. Záleží na počtu uživatelů, ale měli byste mít povoleno alespoň 100 připojení.
Tato chyba se vyskytuje od verze 2018 1.2 (platforma 04.00 a vyšší).
Chyba během instalace obsahuje následující z následujících.
[!] Došlo k chybě při zpracování souboru `Gemfile`:
[!] Došlo k chybě při zpracování souboru `Gemfile`: nelze načíst takový soubor --
# plugin 'rys-bundler', github: 'easysoftware / rys-bundler', větev: 'master'> Plugin.hook ('rys-gemfile', já)
Bundler nemůže pokračovat.
Je to způsobeno zastaralou verzí instalace redmine.
Řešení:
Před instalací aktualizace
$ gem install redmine-installer
- Vytvořte další konfigurační soubor config/additional_environ.rb
- config.action_controller.relative_url_root = "/ easyredmine"
- poté zkompilujte prostředky (rake easyproject:install RAILS_ENV=production) a restartujte server
například se, že je spuštěn a spuštěn wkhtmltopdf ( wkhtmltopdf potřebuje X server nebo jinou emulaci)
Vyzkoušejte to pomocí: "wkhtmltopdf google.com google.pdf"
Přidejte do vaší konfigurace proxy:
proxy_set_header X-Forwarded-Proto https
Při aktualizaci Easy Redmine na platformě Windows a výskyt chybových zpráv ExecJs :: RuntimeError
Vše, co musíte udělat, je nainstalovat NODEJS na svůj systém pro správnou aktualizaci.
Pokud instalace samostatně, spusťte manuálně:
$ Aktualizace bundle
$ Rake db: migrovat
$ Rake Redmine: plugins: migrovat
