Vanlige problemer ved installation og opdatering af Redmine
I løbet af applikationsopdateringen vises en fejlmelding som indeholder "Du har en fejl i SQL-syntaksen din; søg i håndboken som samsvarer med versionen af MySQL-serveren din for rigtig syntaks at bruge nær ..." jeg logger.
årsag
Dette betyder at databasen er uddateret og den kan ikke fungere med anmodningen som applikationen vores sender til den. Den forstår den bare ikke.
Løsning
Du må opdatere databasen din.
Hvordan opdaterer databasen?
Detaljeret beskrivelse i Kunnskabsbasen.
- Korriger tilatelser ved hjælp af kommandoene chgrp og chown i henhold til serverindstillinger (f.eks. chgrp -R www-data public_html)
- Kjør installationen på nytt med kommandoen bundle exec rake easyproject: installere RAILS_ENV = produktion, som vil tømme hurtigbufferen (hvis du kører den som root, vil den ikke være vellykket)
- Start serveren på nytt
Hvis du bruger en virtuell maskin leveret af Easy Software, køres den under brugeren let:
sudo chown -R let / Home / let / strøm
(på eldre maskiner - sudo chown -R easy /srv/easyredmine/public_html)
sudo chgrp -R let / Home / let / strøm
(på eldre maskiner - sudo chgrp -R easy /srv/easyredmine/public_html)
cd / Home / let / strøm
(på eldre maskiner - cd /srv/easyredmine/public_html)
bundle exec rake easyproject: installere RAILS_ENV = produktion
sudo service puma@dit.domæne.navn genstart
Husk å sette tilatelser for alle nødvendige kortlæggere.
Her er nogle tips om hvad du kan gjøre hvis du støter på en 500-feil.
- kjør Nem server krav kontrol og prøv å reparere mislykkede valideringer
- sikkerhedskopier databasen din
- last ned den nyeste pakke fra Klientsonen
- sørg for at webserveren har Fuld tilgang offentligheden, filer, log, tmp kortet
- kjør bundt installere, uden hold i udvikling test
- kjør bundle exec rake easyproject: installere RAILS_ENV = produktion
- start applikationsserveren på nytt
- slet alle andre Redmine-plugins (også fra databasen)
- skriv til oss på support@easyredmine.com og læg ved log/production.log
Hvis lav timeout er konfigureret, vil denne fejl vises på:
- store eksporteringer
- overbelastning af server
- rake-opgaver som køres fra GUI
Grense til MySQL-tilkoblinger
Sørg for at du har tilstrækkeligt antal tillatte tilkoblinger til MySQL. Det afhenger af antallet af brugere, men du bør have mindst 100 tillatte tilkoblinger.
Dette fejlet opstår fra version 2018 1.2 (plattform 04.00 og nyere)
Feil under opgraderingsinstallation som indeholder nogle af følgende.
[!] Det opstod en fejl ved parsing af `Gemfile`:
[!] Det opstod en fejl ved at parsing af `Gemfile`: kan ikke laste inn filen --
# plugin 'rys-bundler', github: 'easysoftware / rys-bundler', branch: 'master'> Plugin.hook ('rys-gemfile', selv)
Bundler kan ikke fortsætte.
Dette skyldes en uddateret version af redmine-installer.
Løsning:
Før du installerer opgraderingen
$ gem installer redmine-installer
Dette problem opstår, når du bruger og suffiks på din Easy Redmine URL, for eksempel: https://company.com/easyredmine/
I dette tilfælde må du sikre dig om at variere RAILS_RELATIVE_URL_ROOT er konfigureret til dine rigtige suffiks /easyredmine
Bitnami:
- Opret en ekstra konfigurationsfil config/additional_environment.rb
- config.action_controller.relative_url_root = "/ easyredmine"
- derefter kompiler aktiver (rake easyproject:install RAILS_ENV=production) og start serveren på nyt
Sørg for kl wkhtmltopdf er installeret og køre ( wkhtmltopdf behøver X-server eller anden emulering)
Test det ved at bruge: "wkhtmltopdf google.com google.pdf"
Læg til i proxy-konfigurationen din:
proxy_set_header X-Forwarded-Proto https
Tjek cron konfiguration. Det er meget vigtigt, at rakeopgaver er IKKE drevet af rod. Det vil forårsage svigt på grund af utilstrækkelige tilladelser.
Lad os sige, at du kører Easy Redmine under brugeren let. Kommandoerne er:
Se aktive krøller crontab -u let-l
Redigering crontab -u let -e
Anvend ændringer sudo service cron reload
Eksempel på at køre cron hvert 5 minut:
* / 5 * * * * /home/easy/scripts/easy_scheduler.sh &> / dev / null
#! / bin / bash -l
LOG_FILE = "/ home / let / strøm / log / easy_scheduler_rake.log"
ekko "$ (dato '+% Y-% m-% d% H:% M:% S') start rive" >> $ {LOG_FILE}
cd / home / let / aktuelt && bundle exec rake easyproject: scheduler: run_tasks RAILS_ENV = produktion >> $ {LOG_FILE}
ekko "$ (dato '+% Y-% m-% d% H:% M:% S') slutrive" >> $ {LOG_FILE}
/home/easy/scripts/easy_scheduler.sh skal være en eksekverbar:
sudo chmod + x /home/easy/scripts/easy_scheduler.sh
Tøv ikke med at søge på internettet for en mere præcis vejledning til opsætning af cron på din server. Det er ikke en udelukkende Easy Redmine påkrævet funktion.
Når du opdaterer Easy Redmine på Windows-plattformen og får en fejlmelding ExecJs :: RuntimeError
Alt du behøver at gøre er å installatør NODEJS på systemet dit for rigtig opdatering.
Hvis installationen mislykkes, køre manuelt:
$ bundle opdatering
$ Rake db: migrere
$ rake redmine: plugins: migrere
Sørg for at webserveren støtter faktisk størrelse på URL-adressen
Sørg for at du IKKE bruger Webrick webserver!
- sørg for at du har den nyeste version af webserveren og Ruby
- omkonfigurere de trege filterforespørslene for at vise færre filt
- tilbagestill CRON-en din for ikke at starte så ofte
- se på denne case-studien - Rails fremskynde uden at røre Ruby kode
- tjek konfigurationen din - https://www.easyredmine.com/resources/installation/1885-recommended-optimal-configuration-of-easy-redmine-server
Kopimaskine filer map fra din gamle Redmine.
Du kan ændre standarden for filer i Redmin sin konfigurationsfil eller du kan bruge en symbolsk lenke. LAN eller skybaseret netværkslagring anbefales not på grund af sikkerhedsproblemer.
Konfiguration:
./config/configuration.yml
# Absolutt sti til mappen der vedlegg lagres.
# Standarden er 'filer' mappen i din Redmine-instans.
# Din EasyRedmine-instans må ha læse/skrive-tilgang til denne kortlægning.
# Eksempler: attachments_storage_path: / var / www / redmine / filer
Feilsøgning:
Hvis du ikke kan åbne et vedlegg, se ./log/production.log for vanlige fejl:
Kan ikke sende vedlegg, /var/www/redmine/files/2015/08/150805095407_xxx.PNG eksisterer ikke eller kan ikke læses
ENOENT, Tillatelse nektet... osv.
Sørg for at webserveren din har Fuld tilgang the offentligheden, filer, log, tmp-mappene
Nye ændringer i dit repository bliver ikke reflekteret i Easy Redmine med mindre hentet af applikationen. Du må sette opp webhooks på din repository-klient (github, gitlab, TortoiseSVN,...) med information om din Easy Redmine-instans.
- Gå til administration >> indstillinger >> repositories
- Aktiver WS til repository-håndtering
- Generer en API-nøkkel
- Gemme
- Gå til din repository-klient
- Læg til en webhook
Vi er på webstedet dit er easyredmine.company.com
Til git - https://easyredmine.company.com/ Sys / git_fetcher
eller https://easyredmine.company.com/ Sys / git_fetcher? Key =[API-nøkkel]
- afhængig af klientindstilling, kan det kræves en enkelt URL eller nøglen i et andet felt
Til SVN - https://easyredmine.company.com/ sys / fetch_changesets
eller https://easyredmine.company.com/ Sys / fetch_changesets? Key =[API-nøkkel]
Fra punkt 5 er det op til repository-klienten og ikke relateret til Easy Redmine-indstillinger. Dette er noget du må verificere efter en ren installation eller opgradering fra Redmine.
Når du konfigurerer domenet til Easy Redmine, må du sørge for at bruge mindste og første niveaus domene, for eksempel http://myeasyredmine.com i stedet for bare http://myeasyredmine. Nogle nettlesere kan have problemer med at nå det.
og bekræft at AVSENDER-adressen er rigtig. Den bør være den samme (eller i det mindste fra samme SMTP-server) som i konfigurationsfilen. Ellers kan nogen e-posttjenester (gmail, yahoo, osv.) avvise varsler. Tjek konfigurationen din i henhold til denne artikel i vidensbasen.
For at bekræfte at konfigurationen er rigtig, prøv at tjekke om du kan koble til e-postserveren fra din Easy Redmine-server ved hjælp af telnet. telnet din.domene.her portnummer_her (For eksempel: telnet gmail.com 465) Det vil vise dig om du virkelig kan koble til e-postserveren din, eller om det er et problem i konfigurationen af e-postserveren din.
Når du prøver at udføre en PDF-eksport som resulterer i en fejl (eller opfører sig som om ingenting sker). Produksjonsloggen vil liste op fejl lignende som
Errno :: EPIPE (Broken pipe) eller wkhtmltopdf: kan ikke oprette forbindelse til X-server
Forårsaket af problemer med eksportkomponenten wkhtmltopdf
Her er de foreslåtte løsningene.
Hovedløs server
Få en nødvendig version af wkhtmltopdf fra http://wkhtmltopdf.org/downloads.html
Eksempel (du må arbejde med detaljer i dit eget miljø):
- sudo apt-get installer 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 installation
- sudo mv / usr / local / bin / wkhtmltopdf / usr / local / bin / xwkhtmltopdf
- ekko '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
Kun ikke-hovedløs server
- Du må ha wkhtmltopdf installer på serveren din i PATH
(apt-get install wkhtmltox, yum install wkhtmltox)
Det må være installeret i bundler, eller det kan ikke fungere efter opdatering af Easy Redmine - Sørg for at fungere korrekt (kør fra konsollen for eksempel wkhtmltopdf https://easyredmine.com homepage.pdf)
- kjør rake easyproject:install RAILS_ENV=produktion på nytt
- start serveren på nytt
Plugin installation
- IKKE installations-plugins som ROOT-bruger
- Først, slett alle gamle Easy Gantt-plugins hvis de findes (plugins/easy_gantt*)
- Kopier alle udpakkede plugins til REDMINE_ROOT/plugins
- JEG REDMINE_ROOT
Kjør: |
$ bundle installere |
- (opdatering af sælgerpakke) |
$ bundle exec rake db: migrer RAILS_ENV = produktion |
$ bundle exec rake redmine: plugins: migrer RAILS_ENV = produktion |
Efter det, start serveren på nytt.
Krav for vellykket installation
- Redmine-version: Kompatibel med Redmine 3.2.x, 3.3.x, 3.4.x, 4.x.
- Ruby-version: 2.3+ (anbefalet 2.6.)
- Databasetype: MySQL (anbefalt), PostgreSQL
Følg installationsproceduren i #installere. Tjek om installationsloggen indeholder ingen fejl. Hvis den gør det, prøv at løse det i henhold til beskrivelsen, eller kontakt support@easyredmine.com med fejlsektionen i loggen vedlagt.
Installation på Bitnami
Bitnami er ikke testet eller garantert. Hvis installationen mislykkes, køre manuelt:
Kjør: |
$ bundle opdatering |
$ Rake db: migrere |
$ rake redmine: plugins: migrere |