Vanlige problemer ved installasjon og oppdatering av Redmine
I løpet av applikasjonsoppdateringen vises en feilmelding som inneholder "Du har en feil i SQL-syntaksen din; søk i håndboken som samsvarer med versjonen av MySQL-serveren din for riktig syntaks å bruke nær ..." i loggen.
Årsak
Dette betyr at databasen din er utdatert og den kan ikke fungere med forespørselen som applikasjonen vår sender til den. Den forstår den bare ikke.
Løsning
Du må oppdatere databasen din.
Hvordan oppdatere databasen?
Detaljert beskrivelse i Kunnskapsbasen.
- Korriger tillatelser ved hjelp av kommandoene chgrp og chown i henhold til serverinnstillingene (f.eks. chgrp -R www-data public_html)
- Kjør installasjonen på nytt med kommandoen bundle exec rake easyproject:install RAILS_ENV=production, som vil tømme hurtigbufferen (hvis du kjører den som root, vil den ikke være vellykket)
- Start serveren på nytt
Hvis du bruker en virtuell maskin levert av Easy Software, kjør den under brukeren easy:
sudo chown -R easy /home/easy/current
(på eldre maskiner - sudo chown -R easy /srv/easyredmine/public_html)
sudo chgrp -R easy /home/easy/current
(på eldre maskiner - sudo chgrp -R easy /srv/easyredmine/public_html)
cd /home/easy/current
(på eldre maskiner - cd /srv/easyredmine/public_html)
bundle exec rake easyproject:install RAILS_ENV=production
sudo service puma@your.domain.name restart
Husk å sette tillatelser for alle nødvendige mapper.
Her er noen tips om hva du kan gjøre hvis du støter på en 500-feil.
- kjør Easy server requirements check og prøv å reparere mislykkede valideringer
- sikkerhetskopier databasen din
- last ned den nyeste pakken fra Klientsonen
- sørg for at webserveren har Full tilgang public, files, log, tmp mapper
- kjør bundle install --without development test
- kjør bundle exec rake easyproject:install RAILS_ENV=production
- start applikasjonsserveren på nytt
- slett eventuelle tredjeparts Redmine-plugins (også fra databasen)
- skriv til oss på support@easyredmine.com og legg ved log/production.log
Hvis lav timeout er konfigurert, vil denne feilen vises på:
- store eksporteringer
- overbelastning av server
- rake-oppgaver som kjøres fra GUI
Grense for MySQL-tilkoblinger
Sørg for at du har tilstrekkelig antall tillatte tilkoblinger til MySQL. Det avhenger av antall brukere, men du bør ha minst 100 tillatte tilkoblinger.
Dette feilet oppstår fra versjon 2018 1.2 (plattform 04.00 og nyere)
Feil under oppgraderingsinstallasjon som inneholder noen av følgende.
[!] Det oppstod en feil ved parsing av `Gemfile`:
[!] Det oppstod en feil ved parsing av `Gemfile`: kan ikke laste inn filen --
# plugin 'rys-bundler', github: 'easysoftware/rys-bundler', branch: 'master' > Plugin.hook('rys-gemfile', self)
Bundler kan ikke fortsette.
Dette skyldes en utdatert versjon av redmine-installer.
Løsning:
Før du installerer oppgraderingen
$ gem install redmine-installer
Dette problemet oppstår når du bruker et suffiks på din Easy Redmine URL, for eksempel: https://company.com/easyredmine/
I dette tilfellet må du forsikre deg om at variabelen RAILS_RELATIVE_URL_ROOT er konfigurert til ditt riktige suffiks /easyredmine
Bitnami:
- Opprett en ekstra konfigurasjonsfil config/additional_environment.rb
- config.action_controller.relative_url_root = "/easyredmine"
- deretter kompiler assets (rake easyproject:install RAILS_ENV=production) og start serveren på nytt
Sørg for at wkhtmltopdf er installert og kjører ( wkhtmltopdf trenger X-server eller annen emulering)
Test det ved å bruke: "wkhtmltopdf google.com google.pdf"
Legg til i proxy-konfigurasjonen din:
proxy_set_header X-Forwarded-Proto https
Check cron configuration. It is very important that rake tasks are NOT run by root. It will cause failure due to insufficient permissions.
Let's say you are running Easy Redmine under user easy. The commands are:
View active crons crontab -u easy -l
Editing crontab -u easy -e
Apply changes sudo service cron reload
Example for running cron every 5 minutes:
*/5 * * * * /home/easy/scripts/easy_scheduler.sh &> /dev/null
#!/bin/bash -l
LOG_FILE="/home/easy/current/log/easy_scheduler_rake.log"
echo "$(date '+%Y-%m-%d %H:%M:%S') start rake" >> ${LOG_FILE}
cd /home/easy/current && bundle exec rake easyproject:scheduler:run_tasks RAILS_ENV=production >> ${LOG_FILE}
echo "$(date '+%Y-%m-%d %H:%M:%S') end rake" >> ${LOG_FILE}
/home/easy/scripts/easy_scheduler.sh has to be an executable:
sudo chmod +x /home/easy/scripts/easy_scheduler.sh
Don't hesitate to search the internet for a more precise manual to set up cron on your server. It is not an exclusively Easy Redmine required function.
Når du oppdaterer Easy Redmine på Windows-plattformen og får en feilmelding ExecJs ::RuntimeError
Alt du trenger å gjøre er å installere NODEJS på systemet ditt for riktig oppdatering.
Hvis installasjonen mislykkes, kjør manuelt:
$ bundle update
$ rake db:migrate
$ rake redmine:plugins:migrate
Sørg for at webserveren din støtter faktisk størrelse på URL-adressen
Sørg for at du IKKE bruker Webrick webserver!
- sørg for at du har den nyeste versjonen av webserveren og Ruby
- omkonfigurer de trege filterforespørslene for å vise færre felt
- tilbakestill CRON-en din for å ikke starte så ofte
- se på denne case-studien - Rails speed up without touching Ruby code
- sjekk konfigurasjonen din - https://www.easyredmine.com/resources/installation/1885-recommended-optimal-configuration-of-easy-redmine-server
Kopier filer mappe fra din gamle Redmine.
Du kan endre standard plasseringen for filer i Redmine sin konfigurasjonsfil eller du kan bruke en symbolisk lenke. LAN eller skybaserte nettverkslagringer for vedlegg anbefales ikke på grunn av pålitelighetsproblemer.
Konfigurasjon:
./config/configuration.yml
# Absolutt sti til mappen der vedlegg lagres.
# Standarden er 'files' mappen i din Redmine-instans.
# Din EasyRedmine-instans må ha lese/skrive-tilgang til denne mappen.
# Eksempler: attachments_storage_path: /var/www/redmine/files
Feilsøking:
Hvis du ikke kan åpne et vedlegg, se ./log/production.log for vanlige feil:
Kan ikke sende vedlegg, /var/www/redmine/files/2015/08/150805095407_xxx.PNG eksisterer ikke eller kan ikke leses
ENOENT, Tillatelse nektet... osv.
Sørg for at webserveren din har Full tilgang til public, files, log, tmp-mappene
Nye endringer i ditt repository blir ikke reflektert i Easy Redmine med mindre de blir hentet av applikasjonen. Du må sette opp webhooks på din repository-klient (github, gitlab, TortoiseSVN,...) med informasjon om din Easy Redmine-instans.
- Gå til administrasjon >> innstillinger >> repositories
- Aktiver WS for repository-håndtering
- Generer en API-nøkkel
- Lagre
- Gå til din repository-klient
- Legg til en webhook
La oss si at nettstedet ditt er easyredmine.company.com
For git - https://easyredmine.company.com/sys/git_fetcher
eller https://easyredmine.company.com/sys/git_fetcher?key=[API-nøkkel]
- avhengig av klientinnstillingen, kan det kreve en enkelt URL eller nøkkelen i et annet felt
For 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 opp til repository-klienten og ikke relatert til Easy Redmine-innstillinger. Dette er noe du må verifisere etter en ren installasjon eller oppgradering fra Redmine.
Når du konfigurerer domenet til Easy Redmine, må du sørge for å bruke minst et førstnivås domene, for eksempel http://myeasyredmine.com i stedet for bare http://myeasyredmine . Noen nettlesere kan ha problemer med å nå det.
og bekreft at AVSENDER-adressen er riktig. Den bør være den samme (eller i det minste fra samme SMTP-server) som i konfigurasjonsfilen. Ellers kan noen e-posttjenester (gmail, yahoo, osv.) avvise varsler. Sjekk konfigurasjonen din i henhold til denne artikkelen i kunnskapsbasen.
For å bekrefte at konfigurasjonen er riktig, prøv å sjekke om du kan koble til e-postserveren fra din Easy Redmine-server ved hjelp av telnet. telnet din.domene.her portnummer_her (For eksempel: telnet gmail.com 465) Det vil vise deg om du virkelig kan koble til e-postserveren din, eller om det er et problem i konfigurasjonen av e-postserveren din.
Når du prøver å utføre en PDF-eksport som resulterer i en feil (eller oppfører seg som om ingenting skjer). Produksjonsloggen vil liste opp feil lignende som
Errno::EPIPE (Broken pipe) eller wkhtmltopdf: cannot connect to X server
Forårsaket av problemer med eksportkomponenten wkhtmltopdf
Her er de foreslåtte løsningene.
Headless server
Få nødvendig versjon av wkhtmltopdf fra http://wkhtmltopdf.org/downloads.html
Eksempel (du må jobbe med detaljene i ditt eget miljø):
- 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-alpha-7b36694_linux-jessie-amd64.deb
- sudo apt-get -f install
- 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
Kun ikke-headless server
- Du må ha wkhtmltopdf installert på serveren din i PATH
(apt-get install wkhtmltox, yum install wkhtmltox)
Det må være installert i bundler, ellers kan det hende det ikke fungerer etter oppdatering av Easy Redmine - Sørg for at programmet fungerer korrekt (kjør fra konsollen for eksempel wkhtmltopdf https://easyredmine.com homepage.pdf)
- kjør rake easyproject:install RAILS_ENV=production på nytt
- start serveren på nytt
Plugin installasjon
- IKKE installer plugins som ROOT-bruker
- Først, slett alle gamle Easy Gantt-plugins hvis de finnes (plugins/easy_gantt*)
- Kopier alle unzipped plugins til REDMINE_ROOT/plugins
- I REDMINE_ROOT
Kjør: |
$ bundle install |
- (eller bundle update) |
$ bundle exec rake db:migrate RAILS_ENV=production |
$ bundle exec rake redmine:plugins:migrate RAILS_ENV=production |
Etter det, start serveren på nytt.
Krav for vellykket installasjon
- Redmine-versjon: Kompatibel med Redmine 3.2.x, 3.3.x, 3.4.x, 4.x.
- Ruby-versjon: 2.3+ (anbefalt 2.6.)
- Database type: MySQL (anbefalt), PostgreSQL
Følg installasjonsprosedyren i #install. Sjekk om installasjonsloggen ikke inneholder noen feil. Hvis den gjør det, prøv å løse det i henhold til beskrivelsen, eller kontakt support@easyredmine.com med feilseksjonen i loggen vedlagt.
Installering på Bitnami
Bitnami er ikke testet eller garantert. Hvis installasjonen mislykkes, kjør manuelt:
Kjør: |
$ bundle update |
$ rake db:migrate |
$ rake redmine:plugins:migrate |