Almindelige problemer med installation og opdatering af Redmine
da både Redmine og Easy Redmine er open source og er mere eller mindre platformafhængige, kan der opstå nogle installations- og opgraderingsproblemer på grund af forskellige serverkonfigurationer, softwareversioner eller plugins installeret. Vi arbejder hårdt på at spore de mest almindelige for at hjælpe dig med fejlfinding.
Under applikationsopdatering en fejlmeddelelse, der indeholder "Du har en fejl i din SQL-syntaks; tjek manualen, der svarer til din MySQL-serverversion, for den rigtige syntaks at bruge i nærheden ... "vises i loggen.
Årsag
Det betyder, at din database er forældet, og at den ikke kan fungere med den anmodning, som vores ansøgning sender til den. Det forstår det bare ikke.
Løsning
Du skal opdatere din database.
Hvordan opdateres databasen?
Detaljeret beskrivelse i Vidensdatabase.
Du har installeret eller opdateret Easy Redmine under brugeren med utilstrækkelige tilladelser, som ikke følger vores stærke anbefaling i anvisninger (Mindst en gang i fortiden).
- Korrekte tilladelser fra kommandoer chgrp , chown ifølge serverindstillinger (f.eks. chgrp -R www-data public_html)
- Kør installationen igen bundle exec rake easyproject: installere RAILS_ENV = produktion som vil rydde cache (hvis du kører den ved roden, vil det ikke være succesfuld)
- Genstart server
Hvis du bruger virtuel maskine leveres af Easy Software, køre under brugeren let:
sudo chown -R let / Home / let / strøm
(i ældre maskiner - sudo chown -R easy / srv / easyredmin / public_html)
sudo chgrp -R let / Home / let / strøm
(i ældre maskiner - sudo chgrp -R let / srv / easyredmin / public_html)
cd / Home / let / strøm
(i ældre maskiner - cd / srv / easyredmin / 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 mapper.
Her er nogle tips, hvad du kan gøre, hvis du løber ind i 500-fejl.
- køre Nem server krav kontrol og forsøg at reparere mislykkede valideringer
- back-up din database
- downloade den nyeste pakke fra Client Zone
- sørge for, at webserveren har Fuld adgang offentligheden, filer, log, tmp mapper
- køre bundt installere, uden hold i udvikling test
- køre bundle exec rake easyproject: installere RAILS_ENV = produktion
- genstart applikationsserveren
- slette 3rd parternes redmine plugins (også fra database)
- skriv til os på support@easyredmine.com og vedhæft log / produktion.log
Der er mange mulige årsager til denne fejl. Her er et par tips:
- browserens cache problem - prøve at slette cache fra browseren
- dns problem
- server indstilling problem
Kontroller først din forbindelse og dit netværk (kontroller, at serveren kan nås ved hjælp af en ping-kommando eller traceroute-kommando). Firewall-serversiden.
Hvis alt ovenfor virker fint, så prøv at få nogle oplysninger fra nginx error.logs. Kontroller nginx error.log på serversiden - /var/log/nginx/error.log
Dobbelttjek, at din nginx konfiguration matcher standarden. Standard nginx konfiguration kan findes her:
https://www.redmine.org/projects/redmine/wiki/HowTo_configure_Nginx_to_run_Redmine
Eksempel på en nginx konfiguration (som anvendes af Easy Software). Det er meget lig officiel man kun få variabler er optimeret:
bruger www-data;
arbejdstagerprocesser 8;
worker_rlimit_nofile 60000;
error_log /var/log/nginx/error.log;
pid /var/run/nginx.pid;
begivenheder {
arbejderforbindelser 10240;
# Multi_accept på;
}
http {
ssl_protocols TLSv1 TLSv1.1 TLSv1.2; # brug ikke SSLv3 ref: POODLE
inkluderer /etc/nginx/mime.types;
default_type-applikation / octet-stream;
server_names_hash_bucket_size 2048;
adgang_log /var/log/nginx/access.log;
sendfil på;
#tcp_nopush til;
#keepalive_timeout 0;
keepalive_timeout 65;
tcp_nodelay on;
send_timeout 1800;
client_body_timeout 1800;
client_header_timeout 1800;
proxy_read_timeout 1800;
client_max_body_size 220m;
fastcgi_buffer_size 64K;
fastcgi_buffers 128 16k;
proxy_max_temp_file_size 0;
types_hash_max_size 4096;
types_hash_bucket_size 128;
proxy_busy_buffers_size 256k;
proxy_buffers 8 256k;
proxy_buffer_size 256k;
gzip på;
gzip_disable "MSIE [1-6] \. (* SV1?!).";
inkludere /etc/nginx/conf.d/*.conf;
inkludere / etc / nginx / sites-enabled / *;
inkludere / etc / nginx / sites-auto / *;
}
Andre mulige årsager til 502 fejl omfatter ...
Unicorn ikke kører på alle, på grund af
- Utilstrækkelige tilladelser
- Forkert version af passagerer
- Forkert Ruby-version
- manglende perler
- Broken filsystem
For at finde ud af den nøjagtige problem, skal du tjekke fejllogs i unicorn eller apache + ansøgning log fra Easy Redmine (log / production.log)
Timeout
Hvis lav timeout er konfigureret, vises denne fejl på:
- stor eksport
- overbelastning af serveren
- rake opgaver løbe fra GUI
Grænse for MySQL-forbindelser
Sørg for, at du har et tilstrækkeligt antal forbindelser tilladt til MySQL. Det afhænger af antallet af brugere, men du skal have mindst en 100 tilladt.
Denne fejl opstår fra version 2018 1.2 (platform 04.00 og højere)
Fejl under opgraderingsinstallationen indeholder nogle af følgende.
[!] Der opstod en fejl ved parsing `Gemfile`:
[!] Der opstod en fejl ved parsing `Gemfile`: kan ikke indlæse en sådan fil -
# plugin 'rys-bundler', github: 'easysoftware / rys-bundler', branch: 'master'> Plugin.hook ('rys-gemfile', selv)
Bundler kan ikke fortsætte.
Det skyldes forældet version af redmine installer.
Opløsning:
Før du installerer opgraderingen
$ gem installer redmine-installer
Disse problemer opstår, når du bruger et suffiks på din Easy Redmine-URL, for eksempel: https://company.com/easyredmine/
I dette tilfælde skal du sikre dig, at du har variablen RAILS_RELATIVE_URL_ROOT konfigureret til dit korrekte suffiks / easyredmin
Bitnami:
- Opret en ekstra konfigurationsfil config / additional_environment.rb
- config.action_controller.relative_url_root = "/ easyredmine"
- derefter prækompilering aktiver (rake easyproject: installere RAILS_ENV = produktion) og genstarte serveren
Sørg wkhtmltopdf er installeret og kører (wkhtmltopdf har brug for X-server eller anden emulering)
Test det med: "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 rammer fejlmeddelelsen ExecJs :: RuntimeError
Alt du skal gøre er installere NODEJS på dit system for den korrekte opdatering.
Hvis installationen mislykkes, køres manuelt:
$ bundle opdatering
$ Rake db: migrere
$ rake redmine: plugins: migrere
Sørg din webserver understøtter faktiske størrelse af URL-adresse
Sørg for at du er IKKE bruge Webrick webserver!
- Sørg for at du har den nyeste version af webserveren og Ruby
- omkonfigurere de langsomme filter forespørgsler for at vise færre felter
- nulstille dig CRON ikke at starte så ofte
- henvise til denne case - Rails fremskynde uden at røre Ruby kode
- tjekke din konfiguration - https://www.easyredmine.com/resources/installation/1885-recommended-optimal-configuration-of-easy-redmine-server
Kopi filer mappe fra din gamle rødmine.
Du kan ændre standard filer placering i Redmine konfiguration fil eller du kan bruge et symlink. LAN eller cloud baserede netværk lagre for vedhæftede filer ikke anbefalet på grund af pålidelighed problemer.
Konfiguration:
./config/configuration.yml
# Absolut sti til den mappe, hvor vedhæftede filer er gemt.
# Standard er 'filer'-mappen i din Redmine-forekomst.
# Din EasyRedmine-forekomst skal have læs / skrive-tilladelse på denne mappe.
# Eksempler: attachments_storage_path: / var / www / redmine / filer
Fejlfinding:
Hvis du ikke kan åbne en vedhæftet fil, kan du se ./log/production.log for almindelige fejl:
Kan ikke sende vedhæftet fil, /var/www/redmine/files/2015/08/150805095407_xxx.PNG Ikke findes eller er ulæselig
ENOENT, Tilladelse nægtet... Etc.
Sørg for, at din webserver har Fuld adgang offentligheden, filer, log, tmp mapper
Ny forpligter sig til dit depot, afspejles ikke i Easy Redmine, medmindre de hentes af ansøgningen. Du skal indstille webhooks på din repository client (github, gitlab, TortoiseSVN, ...) med oplysninger om din Easy Redmine-forekomst.
- Gå til administration >> indstillinger >> opbevaringssteder
- Aktivér WS for lagerstyring
- Generer en API-nøgle
- Gem
- Gå til din depotklient
- 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ængigt af klientindstilling kan det kræve en enkelt webadresse 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 helt op til lagerklienten og ikke relateret til Easy Redmine-indstillinger. Det er noget, du skal verificere efter ren installation eller opgradering fra Redmine.
Når du konfigurerer domænet til din Easy Redmine, skal du sørge for at bruge mindst domænet på første niveau, for eksempel http://myeasyredmine.com i stedet for blot http: // myeasyredmin. Nogle browsere kan have problemer med at nå det.
Gå til Administration >> Indstillinger >> E-mail-underretninger
og bekræft, at FROM-adressen er korrekt.
Det skal være det samme (eller i det mindste fra samme SMTP-server) som i konfigurationsfilen. Ellers kan nogle e-mail-tjenester (gmail, yahoo osv.) Afvise anmeldelser.
Tjek din konfiguration i henhold til denne artikel i vidensbase.
For at kontrollere, om konfigurationen er korrekt, skal du prøve at kontrollere, om der kan oprettes forbindelse til mailserveren fra din Easy Redmine-server ved hjælp af telnet.
telnet your.domain.here port_number_here (For eksempel: telnet gmail.com 465)
Det vil vise dig, om du virkelig kan oprette forbindelse til din mailserver, eller der er et problem i din mailserverkonfiguration.
Når du prøver at søge en PDF-eksport, der resulterer i en fejl (eller fungerer som om der ikke sker noget). Produktionsloggen viser en fejl, der ligner
Errno :: EPIPE (Broken pipe) or wkhtmltopdf: kan ikke oprette forbindelse til X-server
Årsag af problemer med eksporterende komponent wkhtmltopdf
Her er de foreslåede løsninger.
Hovedløs server
Hent den nødvendige version af wkhtmltopdf fra http://wkhtmltopdf.org/downloads.html
Eksempel (du skal arbejde med detaljer om 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)
Den skal installeres i bundpakker, ellers fungerer det muligvis ikke efter opdatering af Easy Redmine - Sørg for, at programmet fungerer korrekt (Kør fra konsollen til f.eks wkhtmltopdf https://easyredmine.com homepage.pdf)
- re-run rake easyproject: installer RAILS_ENV = produktion
- genstart server
Plugin installation
- Installer IKKE plugins som ROOT-bruger
- Først skal du slette alle gamle Easy Gantt-plugins, hvis de findes (plugins/easy_gantt*)
- Kopier alle udpakkede plugins til REDMINE_ROOT/plugins
- I REDMINE_ROOT
Løb: |
$ bundle installere |
- (eller pakkeopdatering) |
$ bundle exec rake db: migrer RAILS_ENV = produktion |
$ bundle exec rake redmine: plugins: migrer RAILS_ENV = produktion |
Genstart derefter serveren.
Krav til vellykket installation
- Redmine-version: Kompatibel med Redmine 3.2.x, 3.3.x, 3.4.x, 4.x., 5.x.
- Ruby version: 2.3 + (anbefalet 2.6.)
- Database seværdighed: MySQL (anbefales), PostgreSQL
Følg installationsproceduren #installere. Kontroller, om installationen log ikke indeholder fejl. Hvis den gør, så prøv at løse det ifølge beskrivelsen, eller kontakt support@easyredmine.com med fejlen sektion af log knyttet.
Installation på Bitnami
Bitnami er ikke testet eller garanteret. Hvis installationen mislykkes, skal du køre manuelt:
Løb: |
$ bundle opdatering |
$ Rake db: migrere |
$ rake redmine: plugins: migrere |