Vanliga problem med installation och uppdatering av Redmine

Här är några tips om vad du kan göra om du stöter på 500-fel.

• köra Enkel serverkrav kontrollera och försök att reparera misslyckade valideringar
• säkerhetskopiera din databas
• ladda ner det senaste paketet från klientzonen
• se till att webbserver har Full tillgång allmänheten, filer, log, tmp mappar
• köra buntinstallation - utan utvecklingstest
• köra bunt exec rake easyproject: installera RAILS_ENV = produktion
• starta om applikationsservern
• ta bort alla 3rd-partiers redmine-plugins (även från databasen)
• skriv oss på support@easyredmine.com och bifoga logg / produktion.logg

Det finns många möjliga orsaker till detta fel. Här är några tips:

• cacheminne för webbläsaren - försök att ta bort cacheminne från webbläsaren
• dns problem
• serverinställningsproblem

Kontrollera först din anslutning och ditt nätverk (kontrollera att servern kan nås med ett ping-kommando eller traceroute-kommando). Firewall-serversidan.

Om allt ovan verkar bra, försök få lite information från nginx error.logs. Kontrollera nginx error.log på serversidan - /var/log/nginx/error.log

Kontrollera att din nginx-konfiguration matchar standarden. Standard nginx-konfiguration finns här:
https://www.redmine.org/projects/redmine/wiki/HowTo_configure_Nginx_to_run_Redmine

Exempel på en nginx-konfiguration (som används av Easy Software). Det är ganska likt officiellt, endast några få variabler är optimerade:

Användare www-data;
arbetare_processer 8;

worker_rlimit_nofile 60000;

error_log /var/log/nginx/error.log;
pid /var/run/nginx.pid;

evenemang {
    arbetarkopplingar 10240;
    # multi_accept på;
}

http {
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2; # använd inte SSLv3 ref: POODLE
    inkludera /etc/nginx/mime.types;
                default_type application / octet-stream;
                server_names_hash_bucket_size 2048;

    access_log /var/log/nginx/access.log;

    sendfile på;
    #tcp_nopush på;

    #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)";

    inkludera /etc/nginx/conf.d/*.conf;
    inkludera / etc / nginx / sites-enabled / *;
    inkludera / etc / nginx / sites-auto / *;
}

Andra möjliga orsaker till 502-felet inkluderar ...

Unicorn kör inte alls på grund av

• Otillräckliga behörigheter
• Felaktig version av passageraren
• Fel Ruby version
• Saknade ädelstenar
• Bruten filsystem

För att ta reda på det exakta problemet, måste du kontrollera felloggar i enhörning eller apache + programlogg från Easy Redmine (log / production.log)

Timeout

Om låg tidsavbrott är konfigurerat visas detta fel på:

• stor export
• överbelastning av server
• rake-uppgifter körs från GUI

Gräns ​​för MySQL-anslutningar

Se till att du har ett tillräckligt antal anslutningar till MySQL. Det beror på antalet användare, men du bör ha minst en 100 tillåten.

Detta fel uppstår från version 2018 1.2 (plattform 04.00 och högre)

Ett fel under uppgraderingsinstallationen innehåller något av följande.

[!] Det uppstod ett fel att parsa "Gemfile":

[!] Det fanns ett fel att parsa "Gemfile": kan inte ladda en sådan fil -

# plugin 'rys-bundler', github: 'easysoftware / rys-bundler', branch: 'master'> Plugin.hook ('rys-gemfile', själv)

Bundler kan inte fortsätta.

Det orsakas av föråldrad version av redmininstallatören.

Lösning:

Innan du installerar uppgraderingen

$ gem installera redmine-installer

Dessa problem uppstår när du använder ett suffix på din Easy Redmine-URL, till exempel: https://company.com/easyredmine/

I det här fallet måste du se till att du har variabel RAILS_RELATIVE_URL_ROOT konfigurerad till ditt korrekta suffix / easyredmin

Bitnami:

1. Skapa en ytterligare konfigurationsfil config / additional_environment.rb
2. config.action_controller.relative_url_root = "/ easyredmine"
3. sedan förkompilera tillgångar (rake easyproject: installera RAILS_ENV = produktion) och starta om servern

Se till wkhtmltopdf är installerad och kör (wkhtmltopdf behöver X-server eller annan emulering)
Testa det med hjälp av: "wkhtmltopdf google.com google.pdf"

Lägg till i din proxy-konfiguration:

proxy_set_header X-Forwarded-Proto https

När du uppdaterar Easy Redmine på Windows-plattformen och slår på felmeddelande ExecJs :: RuntimeError

Allt du behöver göra är installera NODEJS på ditt system för korrekt uppdatering.

Om installationen misslyckas, kör manuellt:

$ bunt uppdatering
$ rake db: migrera
$ rake redmine: plugins: migrera

Se till att din webbserver stöder den faktiska storleken på webbadressen

Se till att du är INTE använder Webrick webserver!

• se till att du har den senaste versionen av webbservern och Ruby
• Konfigurera de långsamma filterfrågorna för att visa färre fält
• återställ CRON för att inte starta så ofta
• hänvisa till denna fallstudie - Rails snabbare upp utan att röra Ruby-kod
• kolla din konfiguration - https://www.easyredmine.com/resources/installation/1885-recommended-optimal-configuration-of-easy-redmine-server

Kopiera filer mapp från din gamla Redmine.

Se till att din webbserver har Full tillgång allmänheten, filer, log, tmp mappar

Nytt engagerar sig i ditt arkiv återspeglas inte i Easy Redmine om de inte hämtas av ansökan. Du måste ange webbhakar på din förvaringsklient (github, gitlab, TortoiseSVN, ...) med information om din Easy Redmine-förekomst.

1. Gå till administration >> inställningar >> förvar
2. Aktivera WS för arkivhantering
3. Generera en API-nyckel
   
4. Save
5. Gå till din förvarsklient
6. Lägg till en webhook
   Låt oss säga att din webbplats ä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äva en enda webbadress eller nyckeln till ett annat fält
   För SVN - https://easyredmine.company.com/ sys / fetch_changesets
   eller https://easyredmine.company.com/ Sys / fetch_changesets? Nyckel =[API-nyckel]

Från punkt 5 är det helt upp till lagringsklienten och inte relaterat till Easy Redmine-inställningar. Det är något du måste verifiera efter ren installation eller uppgradering från Redmine.

När du konfigurerar domänen för din Easy Redmine, se till att du använder minst domännamn på grundnivå, till exempel http://myeasyredmine.com istället för bara http: // myeasyredmin. Vissa webbläsare kan ha problem med att nå den.

Gå till Administration >> Inställningar >> E-postaviseringar
och verifiera att FROM-adressen är korrekt.

Den ska vara densamma (eller åtminstone från samma SMTP-server) som i konfigurationsfilen. Annars kan vissa e-posttjänster (gmail, yahoo, etc.) avvisa anmälningar.

Kontrollera din konfiguration enligt den här artikeln i kunskapsbasen.

För att verifiera att konfigurationen är korrekt, försök kontrollera om du kan ansluta till e-postservern från din Easy Redmine-server med hjälp av telnet.

telnet your.domain.here port_number_here (Till exempel: telnet gmail.com 465)

Det kommer att visa dig om du verkligen kan ansluta till din mailserver eller det finns ett problem i din mailserverkonfiguration.

När du försöker gå till en PDF-export som resulterar i ett fel (eller fungerar som om ingenting händer). Produktionsloggen listar fel som liknar
Errno :: EPIPE (Broken pipe) or wkhtmltopdf: kan inte ansluta till X-servern

Orsakat av problem med exporterande komponent wkhtmltopdf

Här är de föreslagna lösningarna.

Huvudlös server

Få den nödvändiga versionen av wkhtmltopdf från http://wkhtmltopdf.org/downloads.html

Exempel (du måste arbeta med detaljer om din egen miljö):

1. sudo apt-get installera xvfb xauth
2. wget https://bitbucket.org/wkhtmltopdf/wkhtmltopdf/downloads/wkhtmltox-0.13.0-alpha-7b36694_linux-jessie-amd64.deb
3. sudo dpkg -i wkhtmltox-0.13.0-alpha-7b36694_linux-jessie-amd64.deb
4. sudo apt-get -f installera
5. sudo mv / usr / local / bin / wkhtmltopdf / usr / local / bin / xwkhtmltopdf
6. eko 'exec xvfb-run -a -s "-skärm 0 640x480x16" xwkhtmltopdf "$ @"' | sudo tee / usr / local / bin / wkhtmltopdf> / dev / null
7. sudo chmod a + x / usr / local / bin / wkhtmltopdf

Endast icke-huvudlös server

1. Du måste ha wkhtmltopdf installerad på din server i VÄG
   (apt-get install wkhtmltox, yum installera wkhtmltox)
   Den måste installeras i buntaren, annars fungerar det kanske inte efter uppdatering av Easy Redmine
2. Se till att programmet fungerar korrekt (kör från konsolen till exempel wkhtmltopdf https://easyredmine.com homepage.pdf)
3. återköra rake easyproject: installera RAILS_ENV = produktion
4. starta om servern

Du har installerat eller uppdaterat Easy Redmine under användaren med otillräckliga behörigheter, följt inte vår starka rekommendation i instruktioner (åtminstone en gång i det förflutna).

1. Rätta behörigheter med kommandon chgrp samt chown enligt serverns inställningar (t.ex. chgrp -R www-data public_html)
2. Kör installationen igen bunt exec rake easyproject: installera RAILS_ENV = produktion vilket kommer att rensa cacheminnet (om du kör det med root, kommer det att göra det inte vara framgångsrik)
3. Starta om servern

Om du använder virtuell maskin som tillhandahålls av Easy Software kör du under användaren lätt:

sudo chown -R lätt / Home / lätt / ström
(i äldre maskiner - sudo chown -R lätt / srv / easyredmin / public_html)

sudo chgrp -R enkelt / Home / lätt / ström
(i äldre maskiner - sudo chgrp -R lätt / srv / easyredmin / public_html)

cd / Home / lätt / ström
(i äldre maskiner - cd / srv / easyredmin / public_html)

bunt exec rake easyproject: installera RAILS_ENV = produktion

sudo-tjänsten puma@ditt.domän.namn starta om

Kom ihåg att ange behörigheterna för alla nödvändiga mappar.

Under applikationsuppdatering ett felmeddelande som innehåller "Du har ett fel i din SQL-syntax; kontrollera manualen som motsvarar din MySQL-serverversion för rätt syntax att använda nära ... "visas i loggen.

Orsak
Det betyder att din databas är föråldrad och att den inte kan fungera med den begäran som vår ansökan skickar till den. Det förstår det bara inte.

Lösning
Du måste uppdatera din databas.

Hur uppdaterar jag databasen?
Detaljerad beskrivning i Kunskapsbas.

Installation av plugin

1. Installera INTE plugins som en ROOT-användare
   
2. Ta först bort alla gamla Easy Gantt-plugins om de finns (plugins/easy_gantt*)
   
3. Kopiera alla uppackade plugins till REDMINE_ROOT/plugins
   
4. I REDMINE_ROOT

Starta sedan om servern.

Titta på videohandledning

Krav på framgångsrik installation

• Redmine-version: Kompatibel med Redmine 3.2.x, 3.3.x, 3.4.x, 4.x., 5.x.
• Ruby version: 2.3 + (rekommenderad 2.6.)
• Databas typ: MySQL (rekommenderas), PostgreSQL

Följ installationsproceduren i #Installera. Kontrollera om installationsloggen inte innehåller några fel. Om det gör, försök lösa det enligt beskrivningen eller kontakta support@easyredmine.com med felsektionen i den bifogade loggen.

Installation på Bitnami

Bitnami är inte testad eller garanterad. Om installationen misslyckas, kör manuellt:

Gantt dokumentation / kunskap

• Enkel Gantt PRO