Almindelige problemer ved installation og opdatering af Redmine
Da både Redmine og Easy Redmine er Open Source og mere eller mindre platformuafhængige, kan der opstå problemer med installation og opgradering på grund af forskellige serverkonfigurationer, softwareversioner eller installere plugins. Vi arbejder hårdt på at identificere de mest almindelige problemer for at hjælpe dig med fejlfinding.
Under opdatering af applikationen vises en fejlmeddelelse med teksten "Der er en fejl i din SQL-syntaks; tjek manualen, der svarer til din MySQL-serverversion, for den korrekte syntaks, der skal bruges nær ..." jeg logger.
Årsag
Det betyder, at din database er forældet, og den kan ikke arbejde med anmodningen, vores applikation sender til den. Den forstår det simpelthen ikke.
Løsning
Du skal opdatere din database.
Hvordan opdaterer du databasen?
Detaljeret beskrivelse i vidensbasen.
Du har installeret eller opdateret Easy Redmine under en bruger med utilstrækkelige tilladelser, uden at følge vores stærke anbefaling i instruktionerne (mindst én gang tidligere).
- Korriger tilladelserne ved hjælp af kommandoerne chgrp og chown i henhold til serverindstillingerne (f.eks. chgrp -R www-data public_html)
- Kør installationen igen med kommandoen bundle exec rake easyproject: installere RAILS_ENV = produktion, som vil rydde cache (hvis du kører den som root, vil den not være succesfuld)
- Genstart serveren
Hvis du bruger en virtuel maskine leveret af Easy Software, skal du køre den under brugeren let:
sudo chown -R let / Home / let / strøm
(på ældre maskiner - sudo chown -R easy /srv/easyredmine/public_html)
sudo chgrp -R let / Home / let / strøm
(på ældre maskiner - sudo chgrp -R easy /srv/easyredmine/public_html)
cd / Home / let / strøm
(på ældre maskiner - cd /srv/easyredmine/public_html)
bundle exec rake easyproject: installere RAILS_ENV = produktion
sudo service puma@dit.domæne.navn genstart
Husk at indstille tilladelserne for alle nødvendige kortlæggere.
Her er nogle hints til, hvad du kan gøre, hvis du støder på en 500-fejl.
- kør Nem server krav kontrol og prøv at rette fejlede valideringer
- lav en sikkerhedskopi af din database
- hent den nyeste pakke fra Klientzonen
- sørg for, at webserveren har Fuld adgang til maprne offentligheden, filer, log, tmp
- kør bundt installere, uden hold i udvikling test
- kør bundle exec rake easyproject: installere RAILS_ENV = produktion
- genstart applikationsserveren
- slet ikke andet Redmine-plugins (også fra databasen)
- skriv til os på support@easyredmine.com og vedhæft log/production.log
Hvis der er konfigureret en lav timeout, vil denne fejl vises på:
- store eksporteringer
- overbelastning af serveren
- rake-opgaver, der køres fra GUI'en
Begrænsning af MySQL-forbindelser
Sørg for, at du har et tilstrækkeligt antal tilladte forbindelser til MySQL. Det er en konstant andel af brugerne, men du bør have mindst 100 tilladte.
Denne fejl opstår fra version 2018 1.2 (platform 04.00 og højere)
Fejl under opgraderingsinstallation, der indeholder nogle af følgende.
[!] Der opstod en fejl ved parsing af `Gemfile`:
[!] Der opstod en fejl ved parsing af `Gemfile`: kan ikke indlæse sådan en fil --
# plugin 'rys-bundler', github: 'easysoftware / rys-bundler', branch: 'master'> Plugin.hook ('rys-gemfile', selv)
Bundler kan ikke fortsætte.
Det skyldes en forældet version af redmine installer.
Løsning:
Før du installerer opgraderingen
$ gem installer redmine-installer
Dette problem opstår, når du bruger en suffiks på din Easy Redmine URL, for eksempel: https://company.com/easyredmine/
I dette tilfælde skal du sørge for, at du har variablen RAILS_RELATIVE_URL_ROOT konfigureret til din korrekte 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=produktion) og genstart serveren
Sørg for, kl wkhtmltopdf er installeret og kører ( wkhtmltopdf kræver X-server eller anden emulering)
Test det ved at bruge: "wkhtmltopdf google.com google.pdf"
Tilføj til din proxy-konfiguration:
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-platformen og støder på fejlmeddelelsen ExecJs :: RuntimeError
Alt hvad du skal gøre er at installatør NODEJS på dit system for den korrekte opdatering.
Hvis installationen mislykkes, skal du køre følgende manuelt:
$ bundle opdatering
$ Rake db: migrere
$ rake redmine: plugins: migrere
Sørg for, at din webserver understøtter den faktiske størrelse af 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 langsomme filterforespørgsler for at vise færre felter
- nulstil din CRON for ikke at starte så ofte
- henvis til denne case study - Rails fremskynde uden at røre Ruby kode
- tjek din konfiguration - https://www.easyredmine.com/resources/installation/1885-recommended-optimal-configuration-of-easy-redmine-server
Kopimaskine filer map fra din gamle Redmine.
Du kan ændre standardplaceringen for filer i Redmines konfigurationsfil eller du kan bruge et symbolsk link. LAN eller cloud-baserede netværkslagringssteder til vedhæftninger anbefales not på grund af pålidelighedsproblemer.
konfiguration:
./config/configuration.yml
# Absolut sti til mappen, hvor vedhæftninger er gemt.
# Standarden er 'filer' mappen i din Redmine-instans.
# Din EasyRedmine-instans skal have læse/skrive adgang til dette kort.
# Eksempler: attachments_storage_path: / var / www / redmine / filer
Fejlfinding:
Hvis du ikke kan åbne en vedhæftning, se ./log/production.log for almindelige fejl:
Kan ikke sende vedhæftning, /var/www/redmine/files/2015/08/150805095407_xxx.PNG eksisterer ikke eller kan ikke læses
ENOENT, Tilladelse nægtet... osv.
Sørg for, at din webserver har fuld adgang til mapperne offentligheden, filer, log, tmp
Nye commits i dit repository bliver ikke afspejlet i Easy Redmine, uden at de bliver hentet af applikationen. Du skal sætte webhooks op på din repository klient (github, gitlab, TortoiseSVN,...) med information om din Easy Redmine instans.
- Gå til administration >> indstillinger >> repositories
- Aktivér WS til repository håndtering
- Generér en API nøgle
- Ædelsten
- Gå til din repository klient
- Tilføj en webhook
Lad os sige, at dit websted er easyredmine.company.com
Til git - https://easyredmine.company.com/ Sys / git_fetcher
eller https://easyredmine.company.com/ Sys / git_fetcher? Key =[API nøgle]
- afhængig af klientindstillingen kan det kræve 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øgle]
Fra punkt 5 er det op til repository klienten og ikke relateret til Easy Redmine indstillinger. Det er noget, du skal verificere efter en ren installation eller opgradering fra Redmine.
Når du konfigurerer domænet for din Easy Redmine, skal du sørge for at bruge mindst et første niveau-domæne, for eksempel http://myeasyredmine.com i stedet for bare http://myeasyredmine. Nogle browsere kan have problemer med at nå det.
Gå til Administration >> Indstillinger >> E-mail underretninger
og bekræft, at afsenderadressen er korrekt.
Den skal være den samme (eller i det mindste fra samme SMTP-server) som i konfigurationsfilen. Ellers kan nogle e-mail-tjenester (gmail, yahoo, osv.) afvise underretninger.
Tjek din konfiguration i henhold til denne artikel i vidensbasen.
For at bekræfte, at konfigurationen er korrekt, skal du prøve at tjekke, om du kan oprette forbindelse til mailserveren fra din Easy Redmine-server ved hjælp af telnet.
telnet din.domæne.her port_nummer_her (for eksempel: telnet gmail.com 465)
Det vil vise dig, om du virkelig kan oprette forbindelse til din mailserver, eller om der er et problem i din mailserverkonfiguration.
Når du forsøger at eksportere en PDF, der resulterer i en fejl (eller virker som om intet sker). Produktionsloggen vil vise fejl lignende
Errno :: EPIPE (Broken pipe) eller wkhtmltopdf: kan ikke oprette forbindelse til X-server
Forårsaget af problemer med eksportkomponenten wkhtmltopdf
Her er de foreslåede løsninger.
Hovedløs server
Få den nødvendige version af wkhtmltopdf fra http://wkhtmltopdf.org/downloads.html
Eksempel (du skal arbejde med detaljerne 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 skal have wkhtmltopdf installeret på din server i PATH
(apt-get install wkhtmltox, yum install wkhtmltox)
Det skal være installeret i bundler, eller det kan muligvis ikke fungere efter opdatering af Easy Redmine - Sørg for, at fungere korrekt (kør det f.eks. fra konsollen wkhtmltopdf https://easyredmine.com homepage.pdf)
- kør rake easyproject:install RAILS_ENV=produktion igen
- genstart serveren
Plugin installation
- Installer IKKE plugins som ROOT-bruger
- Slet først alle gamle Easy Gantt-plugins, hvis de findes (plugins/easy_gantt*)
- Kopier alle udpakkede plugins til REDMINE_ROOT/plugins
- JEG REDMINE_ROOT
Kø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, genstart serveren.
Krav til 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 (anbefalet), PostgreSQL
Følg installationsproceduren i #installere. Verificer, om installationsloggen indeholder ikke nogen fejl. Hvis den gør det, prøv at løse det i henhold til beskrivelsen, eller kontakt support@easyredmine.com med fejldelen af loggen vedhæftet.
Installation på Bitnami
Bitnami er ikke testet eller garanteret. Hvis installationen mislykkes, skal du køre manuelt:
Kør: |
$ bundle opdatering |
$ Rake db: migrere |
$ rake redmine: plugins: migrere |