Vanliga problem vid installation och uppdatering av Redmine
eftersom både Redmine och Easy Redmine är öppen källkod och är mer eller mindre plattformsoberoende, kan vissa installations- och uppgraderingsproblem uppstå på grund av olika serverkonfigurationer, programvaruversioner eller installerade tillägg. Vi arbetar hårt för att identifiera de vanligaste problemen för att kunna hjälpa dig med felsökning.
Under applikationsuppdateringen visar ett felmeddelande som innehåller "Du har ett fel i din SQL-syntax; kolla i manualen som motsvarar din MySQL-serverversion för rätt syntax att använda nära ..." jag loggar.
Orsak
Det betyder att din databas är föråldrad och kan inte fungera med den begäran som vår applikation skickar till den. Den förstår helt enkelt inte den.
Lösning
Du behöver uppdatera din databas.
Hur uppdaterar du databasen?
Detaljerad beskrivning finns i Kunskapsbasen.
Du har installerat eller uppdaterat Easy Redmine under en användare med otillräckliga behörigheter, vilket inte följer vår starka rekommendation i instruktionerna (minst en gång tidigare).
- Korrigera behörigheterna med kommandona chgrp OCH chown enligt serverinställningarna (t.ex. chgrp -R www-data public_html)
- Kör installationen igen med kommandot bunt exec rake easyproject: installera RAILS_ENV = produktion vilket kommer att rensa cacheminnet (om du kör det som root kommer det integre att lyckas)
- Starta om servern
Om du använder en virtuell maskin som tillhandahålls av Easy Software, kör under användaren lätt:
sudo chown -R lätt / Home / lätt / ström
(på äldre maskiner - sudo chown -R easy /srv/easyredmine/public_html)
sudo chgrp -R enkelt / Home / lätt / ström
(på äldre maskiner - sudo chgrp -R easy /srv/easyredmine/public_html)
cd / Home / lätt / ström
(på äldre maskiner - cd /srv/easyredmine/public_html)
bunt exec rake easyproject: installera RAILS_ENV = produktion
sudo-tjänsten puma@ditt.domän.namn starta om
Kom ihåg att sätta behörigheterna för alla nödvändiga mappar.
Här är några tips på vad du kan göra om du stöter på 500-fel.
- blinda Enkel serverkrav kontrollera och försök att åtgärda misslyckade validering
- säkerhetskopiera din databas
- ladda ner det senaste paketet från Klientzonen
- se till att webbservern har Full tillgång allmänheten, filer, log, tmp mappar
- blinda buntinstallation - utan utvecklingstest
- blinda bunt exec rake easyproject: installera RAILS_ENV = produktion
- starta om applikationsservern
- ta bort eventuella tredjeparts Redmine-plugins (även från databasen)
- skriv till oss på support@easyredmine.com och bifoga log/production.log
Om en låg timeout är konfigurerad kommer detta fel att visa på:
- stora exportfiler
- överbelastning av servern
- rake-uppgifter som körs från GUI
Begränsning av MySQL-anslutningar
Säkerställ att du har tillräckligt med anslutningar till MySQL. Det beror på antalet användare, men du bör ha minst 100 tillåtna.
Denna fel uppstår från version 2018 1.2 (plattform 04.00 och högre)
Fel under uppgraderingsinstallationen innehåller något av följande.
[!] Det uppstod ett fel vid tolkning av `Gemfile`:
[!] Det uppstod ett fel vid tolkning av `Gemfile`: kan inte ladda sådan fil --
# plugin 'rys-bundler', github: 'easysoftware / rys-bundler', branch: 'master'> Plugin.hook ('rys-gemfile', själv)
Bundler kan inte fortsätta.
Det orsakas av en föråldrad version av redmine installer.
Lösning:
Innan du installerar uppgraderingen
$ gem installera redmine-installer
Dessa problem uppstår när du använder ett suffix på din Easy Redmine URL, till exempel: https://company.com/easyredmine/
Jag det här fallet måste du se till att du har variabeln RAILS_RELATIVE_URL_ROOT konfigurerad till ditt korrekta suffix /easyredmine
Bitnami:
- Skapa en ytterligare konfigurationsfil config/additional_environment.rb
- config.action_controller.relative_url_root = "/ easyredmine"
- sedan kompilera tillgångar (rake easyproject:install RAILS_ENV=produktion) och starta om servern
Säkerställ att wkhtmltopdf är installerat och körs ( wkhtmltopdf behöver X-server eller annan emulering)
Testa det genom att använda: "wkhtmltopdf google.com google.pdf"
Lägg till i din proxykonfiguration:
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.
När du uppdaterar Easy Redmine på Windows-plattformen och stöter på felmeddelandet ExecJs :: RuntimeError
Allt du behöver göra är att Installera NODEJS på ditt system för rättsuppdatering.
Om installationen misslyckas, kör manuellt:
$ bunt uppdatering
$ rake db: migrera
$ rake redmine: plugins: migrera
Säkerställ att din webbserver stöder den faktiska storleken på URL-adressen
Säkerställ att du INTE använder Webrick webbserver!
- se till att du har den senaste versionen av webbservern och Ruby
- omkonfigurera de långsamma filterfrågorna för att visa färre fält
- återställ din CRON så att den inte startar så ofta
- hänvisa till denna fallstudie - Rails snabbare upp utan att röra Ruby-kod
- kontrollera din konfiguration - https://www.easyredmine.com/resources/installation/1885-recommended-optimal-configuration-of-easy-redmine-server
Kopiera kartan filer från din gamla Redmine.
Du kan ändra standardplatsen för filer i Redmines konfigurationsfil eller använda en symbolisk länk. LAN- eller molnbaserade nätverkslagringar för bilagor rekommenderas integre på grund av tillförlitlighetsproblem.
konfiguration:
./config/configuration.yml
# Absolut sökväg till kartan där bilagor lagras.
# Standard är mapp 'filer' i din Redmine-instans.
# Din EasyRedmine-instans behöver läs- och skrivrättigheter till denna mapp.
# Exempel: attachments_storage_path: / var / www / redmine / files
Felsökning:
Om du inte kan öppna en bilaga, se ./log/production.log för vanliga fel:
Kan inte skicka bilaga, /var/www/redmine/files/2015/08/150805095407_xxx.PNG finns inte eller går inte att läsa
ENOENT, Åtkomst nekad... etc.
Säkerställ att din webbserver har full åtkomst till mapparna allmänheten, filer, log, tmp
Nya ändringar i ditt arkiv syns inte i Easy Redmine förrän hämtas av applikationer. Du behöver sätta upp webhooks på din repository-klient (github, gitlab, TortoiseSVN,...) med information om din Easy Redmine-instans.
- Gå till administration >> inställningar >> repositories
- Aktivera WS för hantering av repository
- Generera och API-nyckel
- Spar
- Gå till din repository-klient
- Lägg till en webhook
Låt oss säga att din webbplats är easyredmine.company.com
För git - https://easyredmine.company.com/ Sys / git_fetcher
eller https://easyredmine.company.com/ Sys / git_fetcher? Key =[API-nyckel]
- beroende på klientens inställning kan det krävas en enda URL eller nyckeln i ett annat fält
För SVN - https://easyredmine.company.com/ sys / fetch_changesets
eller https://easyredmine.company.com/ Sys / fetch_changesets? Nyckel =[API-nyckel]
Från punkt 5 är det upp till repository-klienten och inte relaterat till Easy Redmine-inställningar. Det är något du måste verifiera efter en ren installation eller uppgradering från Redmine.
När du konfigurerar domänen för din Easy Redmine, se till att du använder minst domännamn på grundnivå, till exempel http://myeasyredmine.com istället för bara http: // myeasyredmin. Vissa webbläsare kan ha problem med att nå den.
Gå till Administration >> Inställningar >> E-postaviseringar
och verifiera att FRÅN-adressen är korrekt.
Den bör vara densamma (eller åtminstone från samma SMTP-server) som i konfigurationsfilen. Annars kan vissa e-posttjänster (gmail, yahoo, etc.) avvisa aviseringar.
Kontrollera din konfiguration enligt den här artikeln i kunskapsdatabasen.
För att verifiera att konfigurationen är korrekt, försök att kontrollera om du kan ansluta till e-postservern från din Easy Redmine-server med hjälp av telnet.
telnet din.domän.här portnummer_här (Till exempel: telnet gmail.com 465)
Det kommer att visa om du verkligen kan ansluta till din e-postserver eller om det finns ett problem i din e-postserverkonfiguration.
När du vill göra en PDF-export som gör det i ett fel (eller agerar som om ingenting). Produktionsloggen skulle lista fel liknande
Errno :: EPIPE (Broken pipe) eller wkhtmltopdf: kan inte ansluta till X-servern
Orsakat av problem med exportkomponenten wkhtmltopdf
Här är de föreslagna lösningarna.
Huvudlös server
Hämta den nödvändiga versionen av wkhtmltopdf från http://wkhtmltopdf.org/downloads.html
Exempel (du måste arbeta med detaljerna i din egen miljö):
- 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
Endast icke-huvudlös server
- Du behöver ha wkhtmltopdf installerat på din server i VÄG (apt-get install wkhtmltox, yum installera wkhtmltox)
Det måste vara installerat i bundler, annars kan det sluta fungera efter att Easy Redmine har uppdaterats - Se till att programmet fungerar korrekt (kör det från konsolen till exempel wkhtmltopdf https://easyredmine.com homepage.pdf)
- kör om rake easyproject:installera RAILS_ENV=produktion
- starta om servern
Installation av plugin
- Installera INTE plugins som ROOT-användare
- Ta först bort alla gamla Easy Gantt-plugins om de finns (plugins/easy_gantt*)
- Kopiera alla uppackade plugins till REDMINE_ROOT/plugins
- JAG REDMINE_ROOT
Kör: |
$ buntinstallation |
- (uppdatering av säljarpaket) |
$ bundle exec rake db: migrera RAILS_ENV = produktion |
$ bundle exec rake redmine: plugins: migrera RAILS_ENV = produktion |
Efter det, starta om servern.
Krav för framgångsrik installation
- Redmine-version: Kompatibel med Redmine 3.2.x, 3.3.x, 3.4.x, 4.x.
- Ruby-version: 2.3+ (rekommenderas 2.6.)
- Databastyp: MySQL (rekommenderas), PostgreSQL
Följ installationsproceduren i #Installera. Kontrollera om installationsloggen inte innehåller några fel. Om det gör det, försök att lösa det enligt beskrivningen eller kontakta support@easyredmine.com med den felaktiga delen av loggen bifogad.
Installation på Bitnami
Bitnami är inte testat eller garanterat. Om installationen misslyckas, kör manuellt:
Kör: |
$ bunt uppdatering |
$ rake db: migrera |
$ rake redmine: plugins: migrera |