Almindelige problem med installation och uppdatering av Redmine
Då både Redmine och Easy Redmine är öppen källkod och mer eller mindre plattformsberoende, kan det uppstå problem med installation och uppgradering på grund av olika serverkonfigurationer, mjukvaruversioner eller installera plugins. Vi arbetar hårdt på att identifiera de mest vanliga problem för att hjälpa dig med felfinding.
Under uppdatering av applikationen visas en felmeddelande med texten "Der är en fel i din SQL-syntaks; tjek manualen, som svarar till din MySQL-serverversion, för den korrekta syntaks, den ska användas nära ..." jag loggar.
Orsak
Det betyder, att din databas är känd, och den kan inte arbeta med begäran, vår applikationssändare till den. Den förstår det helt enkelt inte.
Lösning
Du ska uppdatera din databas.
Hur uppdaterar du databasen?
Detaljerad beskrivning i vidensbasen.
Du har installerat eller uppdaterat Easy Redmine under en användare med användarvänliga tillstånd, utan att följa vår starka anbefaling i instruktionerne (mindst én gang tidigare).
- Korriger tillstånd med hjälp av kommandoerna chgrp og chown i henhold til serverinställningarna (t.ex. chgrp -R www-data public_html)
- Kör installationen igen med kommandoen bunt exec rake easyproject: installera RAILS_ENV = produktion, som vill rydde cache (hvis du kör den som root, vill den inte vara framgångsrik)
- Genstart serveren
Om du använder en virtuell maskin som levereras av Easy Software, ska du köra den under användare 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
Husk att ange tillstånd för alla nödvändiga kartläggare.
Her är några tips till, hvad du kan göra, hvis du støder på en 500-fejl.
- kør Enkel serverkrav kontrollera og prøv at rette fejlede valideringer
- lav en säkerhetskopi av din databas
- hent den senaste paketet från Klientzonen
- sørg for, at webserveren har Full tillgång till maprne allmänheten, filer, log, tmp
- kør buntinstallation - utan utvecklingstest
- kør bunt exec rake easyproject: installera RAILS_ENV = produktion
- genstart applikationsservern
- alla andra Redmine-plugins (och så från databasen)
- skriv till os på support@easyredmine.com och vedhæft log/production.log
Om det är konfigurerat med lav timeout, kommer detta fel visas på:
- butik exporteringer
- överbelastning af serveren
- rake-uppgifter, der körs från GUI'en
Begrænsning av MySQL-förbindelser
Se till att du har ett tillräckligt antal tillåtna förbindelser till MySQL. Det är en procentandel av användaren, 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)
Fejl under uppgraderingsinstallation, innehåller några av följande.
[!] Der opstod en fel vid parsing av `Gemfile`:
[!] Der opstod en fel ved parsing av `Gemfile`: kan inte indläse sådan en fil --
# plugin 'rys-bundler', github: 'easysoftware / rys-bundler', branch: 'master'> Plugin.hook ('rys-gemfile', själv)
Bundler kan inte fortsätta.
Det beror på en tidigare version av redmine installer.
Lösning:
För att installera uppdateringen
$ gem installera redmine-installer
Detta problem uppstår när du använder en suffiks på din Easy Redmine URL, till exempel: https://company.com/easyredmine/
I detta fall ska du se till att du har variabeln RAILS_RELATIVE_URL_ROOT konfigurerad till din korrekta suffiks /easyredmine
Bitnami:
- Öppna en extra konfigurationsfil config/additional_environment.rb
- config.action_controller.relative_url_root = "/ easyredmine"
- sedan kompilera aktivera (rake easyproject:install RAILS_ENV=produktion) och starta servern
Sörja för, kl wkhtmltopdf installera och köra ( wkhtmltopdf kräver X-server eller annan emulering)
Testa det genom att använda: "wkhtmltopdf google.com google.pdf"
Lägg till din proxy-konfiguration:
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å felmeddelanden ExecJs :: RuntimeError
Alt vad du ska göra er at installera NODEJS på detta system för den korrekta uppdateringen.
Om installationen misslyckas, ska du köra följande manuellt:
$ bunt uppdatering
$ rake db: migrera
$ rake redmine: plugins: migrera
Se till att din webbserver stöder den faktiska storleken på URL-adressen
Sörj för, vid du Använd INTE Webrick webbserver!
- sörj för, du har den senaste versionen av webbservern och Ruby
- omkonfigurera de långsomme filterforespørgsler för att visa færre filtare
- nulstil din CRON för inte att starta så ofta
- henvis till denna fallstudie - Rails snabbare upp utan att röra Ruby-kod
- tjek din konfiguration - https://www.easyredmine.com/resources/installation/1885-recommended-optimal-configuration-of-easy-redmine-server
Kopiera Filer karta från din gamla Redmine.
Du kan ändra standardplaceringen för filer i Redmines konfigurationsfil eller du kan använda en symbolisk länk. LAN eller molnbaserade nätverkslagringsplatser för anpassningar rekommenderas inte på grund av pålitliga problem.
konfiguration:
./config/configuration.yml
# Absolut sti til kartan, var vedhæftningar är gemt.
# Standarden är 'filer' mappen i din Redmine-instans.
# Din EasyRedmine-instans ska ha läs/skriva åtkomst till denna karta.
# Exempler: attachments_storage_path: / var / www / redmine / files
Fejlfinding:
Om du inte kan öppna en vedhæftning, se ./log/production.log för vanliga fel:
Kan inte sende vedhæftning, /var/www/redmine/files/2015/08/150805095407_xxx.PNG existerar inte eller kan inte läsas
ENOENT, Tilladelse nægtet... osv.
Se till att din webbserver har full tillgång till kartorna allmänheten, filer, log, tmp
Nye commits i detta repository blir inte reflekterat i Easy Redmine, utan att hämtas av applikationen. Du ska sätta webhooks op på din repository klient (github, gitlab, TortoiseSVN,...) med information om din Easy Redmine instans.
- Gå till administration >> inställningar >> repositories
- Aktiver WS till förvarshantering
- Generér och API-nyckel
- Save
- Gå till din repository klient
- Lägg till en webhook
Lad oss säga, på denna sida ä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å klientinställningen kan det krävas en enkel URL eller nyckeln i et annat filt
För SVN - https://easyredmine.company.com/ sys / fetch_changesets
eller https://easyredmine.company.com/ Sys / fetch_changesets? Nyckel =[API-nyckel]
Fra punkt 5 är det op till repository klienten och inte relaterat till Easy Redmine-inställningar. Det är något, du ska verifiera efter en ren installation eller uppgradering från Redmine.
När du konfigurerar domænet för din Easy Redmine, ska du sörja för att använda minst och första nivå-domæne, till exempel http://myeasyredmine.com i stället för bara http://myeasyredmine. Vissa webbläsare kan ha problem med att nå det.
Gå till Administration >> Inställningar >> E-post underretninger
och bekräfta, att afsenderadressen är korrekt.
Den ska vara den samme (eller i det minsta från samma SMTP-server) som i konfigurationsfilen. Ellers kan några e-posttjänster (gmail, yahoo, osv.) avvise underretninger.
Tjek din konfiguration i henhold til denna artikel i kunskapsbasen.
För att bekräfta, vid konfigurationen är korrekt, ska du prova att kontrollera att du kan ansluta till e-postservern från din Easy Redmine-server med hjälp av telnet.
telnet din.domæne.her port_nummer_her (till exempel: telnet gmail.com 465)
Det vill visa dig, om du verkligen kan skapa anslutning till din e-postserver, eller om det är ett problem i din e-postserverkonfiguration.
När du försöker att exportera en PDF, det resulterar i ett fel (eller verkar som inte sker). Produktionsloggen vil vise fel liknande
Errno :: EPIPE (Broken pipe) eller wkhtmltopdf: kan inte ansluta till X-servern
Forårsaget av problem med exportkomponenten wkhtmltopdf
Her är de föreslagna lösningar.
Huvudlös server
Få den nödvändiga versionen av wkhtmltopdf från http://wkhtmltopdf.org/downloads.html
Exempel (du ska 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
Kunna inte-huvudlös server
- Du skall ha wkhtmltopdf installera på din server i VÄG
(apt-get install wkhtmltox, yum installera wkhtmltox)
Det ska installeras i bundler, eller det kan eventuellt inte fungera efter uppdateringen av Easy Redmine - Se till att fungera korrekt (kör det f.eks. från konsollen wkhtmltopdf https://easyredmine.com homepage.pdf)
- kør rake easyproject:install RAILS_ENV=produktion igen
- genstart serveren
Installation av plugin
- Installer INTE plugins som ROOT-användare
- Slet först alla gamla Easy Gantt-plugins, om de finns (plugins/easy_gantt*)
- Kopiera alla paketerade 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, genstart serveren.
Krav till lyckad installation
- Redmine-version: Kompatibel med Redmine 3.2.x, 3.3.x, 3.4.x, 4.x.
- Ruby-version: 2.3+ (anbefalet 2.6.)
- Databastyp: MySQL (anbefalet), PostgreSQL
Följ installationsproceduren i #Installera. Verificer, om installationsloggen innehåller inte något fel. Om den gör det, pröva att lösa det i enlighet med beskrivningen, eller kontakt support@easyredmine.com med fejldelen af loggen vedhæftet.
Installation på Bitnami
Bitnami är inte testet eller garanterat. Om installationen misslyckas, ska du köra manuellt:
Kör: |
$ bunt uppdatering |
$ rake db: migrera |
$ rake redmine: plugins: migrera |