Redmine instalazio eta eguneraketarako ohiko zailtasunak
Redmine eta Easy Redmine biak Open Source dira eta plataforma independenteak dira, beraz, instalazio eta eguneraketako arazoak gertatu daitezke zerbitzari konfigurazio ezberdinei, software bertsioei edo instalatutako plugin-eei esker. Lan handia egiten dugu horiek ohikoena izateko eta zurekin arazoak konpontzeko laguntzeko.
Applicationaren eguneratzean "You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near ..." mezu errore bat agertzen da erregistroan.
Arrazoia
Zure datubasea zaharkituta dago eta gure aplikazioak bidaltzen dizkion eskaerarekin ezin du lan egin. Ez du ulertzen.
Soluzioa
Zure datubasea eguneratu behar duzu.
Nola eguneratu datubasea?
Xehetasun osoak Baliabideen oinarrian.
Instalatu duzu edo eguneratu Easy Redmine erabiltzaile baten baimen gutxiagorekin, gure gomendio sendoa jarraitu gabe jarraipenak (gutxienez bada bada lehen aldiz).
- Baimenak zuzendu chgrp eta chown komandoekin zerbitzariaren ezarpenetara egokituz (adibidez chgrp -R www-data public_html)
- Instalazioa berriz abiarazi bundle exec rake easyproject:install RAILS_ENV=production cachea garbituko duena (root bidez abiarazten baduzu, ez izango da arrakastatsua)
- Zerbitzaria berrabiarazi
Easy Softwarek hornitutako birtual makinetan erabili ahal izateko, easy erabiltzailearen azpian abiarazi:
sudo chown -R easy /home/easy/current
(makina zaharretan - sudo chown -R easy /srv/easyredmine/public_html)
sudo chgrp -R easy /home/easy/current
(makina zaharretan - sudo chgrp -R easy /srv/easyredmine/public_html)
cd /home/easy/current
(makina zaharretan - cd /srv/easyredmine/public_html)
bundle exec rake easyproject:install RAILS_ENV=production
sudo service puma@your.domain.name restart
Gogoratu baimenak ezarri beharreko karpetei buruz.
Hemen daude zenbait iradokizun 500 errorearekin topo egiten baduzu zer egin dezakezun jakiteko.
- abiarazi Errazko zerbitzariaren eskakizunen egiaztapena eta saiatu ezin izan diren egiaztagirien konponketarekin
- segurtatu zure datu-basea
- deskargatu azken paketea Bezeroen Gunean
- ziurtatu web zerbitzariak Sarrera osoa publikoa, fitxategiak, erregistroa, tmp karpetak dituela
- abiarazi bundle install --without development test
- abiarazi bundle exec rake easyproject:install RAILS_ENV=production
- abiarazi aplikazio zerbitzaria berriro
- ezabatu 3.en parteen Redmine plugina (datu-basea barne)
- idatzi guri support@easyredmine.com helbidera eta erantsi log/production.log
There are many possible causes of this error. Here are a few tips:
- browser cache problem - try deleting cache from the browser
- dns problem
- server setting problem
First check your connection and network (verify that server is reachable by using a ping command or traceroute command). Firewall server side.
If all above seems fine, try to get some information from nginx error.logs. Check nginx error.log at the server side - /var/log/nginx/error.log
Double check that your nginx configuration matches the standard. Standard nginx configuration can be found here:
https://www.redmine.org/projects/redmine/wiki/HowTo_configure_Nginx_to_run_Redmine
Example of an nginx configuration (as is used by Easy Software). It's quite similar to official one only few variables are optimized:
user www-data;
worker_processes 8;
worker_rlimit_nofile 60000;
error_log /var/log/nginx/error.log;
pid /var/run/nginx.pid;
events {
worker_connections 10240;
# multi_accept on;
}
http {
ssl_protocols TLSv1 TLSv1.1 TLSv1.2; # dont use SSLv3 ref: POODLE
include /etc/nginx/mime.types;
default_type application/octet-stream;
server_names_hash_bucket_size 2048;
access_log /var/log/nginx/access.log;
sendfile on;
#tcp_nopush on;
#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 on;
gzip_disable "MSIE [1-6]\.(?!.*SV1)";
include /etc/nginx/conf.d/*.conf;
include /etc/nginx/sites-enabled/*;
include /etc/nginx/sites-auto/*;
}
Other possible causes of 502 error include...
Unicorn is not running at all, due to
- Insufficient permissions
- Wrong version of passenger
- Wrong Ruby version
- Missing gems
- Broken filesystem
To find out the exact problem, you need to check error logs in unicorn or apache + application log from Easy Redmine (log/production.log)
Timeout
If low timeout is configured, this error will appear on:
- large exports
- overload of server
- rake tasks run from the GUI
Limit of MySQL connections
Make sure you have a sufficient number of connections allowed to MySQL. It depends on the number of users, but you should have at least a 100 allowed.
Hizketa hau gertatzen da 2018 1.2 bertsioetik aurrera (04.00 eta handiagoa den plataforma)
Eguneraketaren instalazioan errorea gertatzen da, hurrengo batzuk dituenak barne.
[!] `Gemfile` fitxategia parseatzean errorea gertatu da:
[!] `Gemfile` fitxategia parseatzean errorea gertatu da: ezin da fitxategi hori kargatu --
# plugin 'rys-bundler', github: 'easysoftware/rys-bundler', branch: 'master' > Plugin.hook('rys-gemfile', self)
Bundler ezin du jarraitu.
Redmine instalatzailearen zaharkitutako bertsioak eraginda dago.
Soluzioa:
Eguneraketa instalatu aurretik
$ gem install redmine-installer
Hau arazoak gertatzen dira Easy Redmine URLaren azken hitza erabiltzen baduzu, adibidez: https://company.com/easyredmine/
Kasu honetan, ziurtatu behar duzu RAILS_RELATIVE_URL_ROOT aldagaia zure zuzeneko azken hitzarekin konfiguratuta dagoela /easyredmine
Bitnami:
- Sortu konfigurazio fitxategi gehigarria config/additional_environment.rb
- config.action_controller.relative_url_root = "/easyredmine"
- ondoren precompile assets (rake easyproject:install RAILS_ENV=production) eta berrabiarazi zerbitzaria
Ziurtatu wkhtmltopdf instalatuta dagoela eta martxan dagoela ( wkhtmltopdf X zerbitzaria edo beste emulazio bat behar du)
Frogatu hau erabiliz: "wkhtmltopdf google.com google.pdf"
Gehitu zure proxy konfiguraziora:
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.
Easy Redmine Windows plataforma batean eguneratzen ari zaren bitartean, errore mezua jasotzen baduzu ExecJs ::RuntimeError
Eguneraketa egokia egiteko, soilik NODEJS instalatu behar duzu zure sistemaren gainean.
Instalazioak huts egiten badu, exekutatu eskuz:
$ bundle update
$ rake db:migrate
$ rake redmine:plugins:migrate
Ziurtatu zure web zerbitzaria URL helbidearen tamaina egokia duela
Ziurtatu ez duzula Webrick web zerbitzaria erabiltzen!
- egiaztatu web zerbitzariaren eta Ruby-ren azken bertsioa daukazula
- berrezarri arazo garestiak iragazkiak txikitzeko
- berrezarri zure CRON-a hain askotan ez abiarazteko
- erreferentzia kasu honetara - Rails azkarra Ruby kodea ukatzeari begiratu gabe
- egiaztatu zure konfigurazioa - https://www.easyredmine.com/resources/installation/1885-recommended-optimal-configuration-of-easy-redmine-server
Kopiatu fitxategiak karpeta zure zahar Redmine-tik.
Redmine-ren konfigurazio fitxategian lehenetsitako fitxategi kokapena aldatu dezakezu edo symlink erabili dezakezu. LAN edo cloud-based sareko biltegiratzeentzako ez da gomendagarria fidagarritasun arazoengatik.
Konfigurazioa:
./config/configuration.yml
# Fitxategiak biltegiratzeko direktorioaren bide absolutua.
# Lehenetsia zure Redmine instantziaren 'fitxategiak' direktorioa da.
# Zure EasyRedmine instantziak irakurri/Idatzi baimena behar du direktorio honetan.
# Adibideak: attachments_storage_path: /var/www/redmine/files
Arazoak konpontzea:
Eranskina ezin baduzu ireki, ikusi ./log/production.log errore arruntentzako:
Eranskina bidali ezin da, /var/www/redmine/files/2015/08/150805095407_xxx.PNG ez dago existitzen edo ezin da irakurri
ENOENT, Baimena Ukatuta... eta abar.
Ziurtatu zure web zerbitzariak Oso sarbidea duela publikoa, fitxategiak, erregistroa, tmp karpeta guztietan
Zure ereduetan egindako commit berriak ez dira Easy Redminean erakusten, aplikazioak eskuratzen ez baditu. Webhooks ezarri behar dituzu zure eredu bezeroan (github, gitlab, TortoiseSVN,...) zure Easy Redmine instantziari buruzko informazioarekin.
- Joan administraziora >> ezarpenak >> ereduetan
- Gaitu WS ereduen kudeaketarako
- Sortu API gako bat
- Gorde
- Joan zure ereduetako bezeroera
- Gehitu webhook bat
Esan dezagun zure gunea easyredmine.company.com da dela
Git-entzat - https://easyredmine.company.com/sys/git_fetcher
edo https://easyredmine.company.com/sys/git_fetcher?key=[API gakoa]
- bezeroaren ezarpenaren arabera, URL bakarra edo gakoa ezberdineko eremuan sartzea behar izan dezake
SVN-entzat - https://easyredmine.company.com/sys/fetch_changesets
edo https://easyredmine.company.com/sys/fetch_changesets?key=[API gakoa]
5. puntutik aurrera, ereduetako bezeroaren araberakoa da eta Easy Redminearen ezarpenekin ez du lotura. Instalazio garbi edo Redmine bertsio berritik eguneratzearen ondoren egiaztatu behar duzun gauza bat da.
Zure Easy Redminearen domeinua konfiguratzen duzunean, ziurtatu gutxienez lehenengo mailako domeinua erabiltzen duzula, adibidez http://myeasyredmine.com bakarrik erabiltzen baduzu http://myeasyredmine orduz. Nabigatzaile batzuek arazoak izan ditzakete hura atzitzeko.
Joan Administrazioa >> Ezarpenak >> Email jakinarazpenak
eta egiaztatu FROM helbidea zuzena dela.
Berbera izan behar da (edo gutxienez SMTP zerbitzari berberatik) konfigurazio fitxategian. Bestela, zenbait posta zerbitzu (gmail, yahoo, etab.) jakinarazpenak ukatuko dituzte.
Egiaztatu zure konfigurazioa Honen ezagutza oinarrian dagoen artikulu honetan.
Konfigurazioa zuzena dela egiaztatzeko, saiatu posta zerbitzariarekin Easy Redmine zerbitzariatik telnet erabiliz konektatu dezakezula egiaztatu.
telnet zure.domeinua.hemen portu_zenbakia_hemen (Adibidez: telnet gmail.com 465)
Zure posta zerbitzariarekin benetan konektatu ahal zarela edo posta zerbitzariaren konfigurazioan arazo bat dagoela erakutsiko dizu.
PDF esportazioa egitean errore bat gertatzen bada (edo ez gertatzen den bezala agertzen bada). Produkzio erregistroak hurrengo erroreak zerrendatuko ditu:
Errno::EPIPE (Broken pipe) edo wkhtmltopdf: ezin da X zerbitzariarekin konektatu
wkhtmltopdf komponentea esportatzearekin lotutako arazoak eraginak izan ditu
Hona hemen proposatutako soluzioak.
Headless zerbitzaria
Lortu beharreko wkhtmltopdf bertsioa http://wkhtmltopdf.org/downloads.html helbidean
Adibidea (zure ingurumenaren xehetasunekin lan egin behar duzu):
- 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
Non-headless zerbitzaria bakarrik
- wkhtmltopdf instalatuta izan behar duzu zerbitzarian PATH-en
(apt-get install wkhtmltox, yum install wkhtmltox)
Bundler-en instalatuta egon behar da, bestela ezin du ondo funtzionatu Easy Redmine eguneratzea ondoren - Programa ongi funtzionatzen duela ziurtatu (adibidez, konsolatik exekutatu wkhtmltopdf https://easyredmine.com homepage.pdf)
- rake easyproject:install RAILS_ENV=production berriz abiarazi
- zerbitzaria berrabiarazi
Plugin instalazioa
- EZ instalatu plugina ROOT erabiltzaile gisa
- Lehenik, ezabatu Easy Gantt plugin zaharrak badira (plugins/easy_gantt*)
- Kopiatu deszipatutako plugin guztiak REDMINE_ROOT/plugins karpetan
- REDMINE_ROOT-en
Exekutatu: |
$ bundle install |
- (edo bundle update) |
$ bundle exec rake db:migrate RAILS_ENV=production |
$ bundle exec rake redmine:plugins:migrate RAILS_ENV=production |
Ondoren, berrabiarazi zerbitzaria.
Instalazio arrakastatsurako baldintzak
- Redmine bertsioa: Redmine 3.2.x, 3.3.x, 3.4.x, 4.x-ekin bateragarria.
- Ruby bertsioa: 2.3+ (2.6 gomendatua).
- Datu-base mota: MySQL (gomendatua), PostgreSQL
Jarraitu instalazio prozedura #install atalean. Egiaztatu instalazio agirian akatsik ez dagoen. Akaso badago, konpondu deskribapenaren arabera edo jarri harremanetan support@easyredmine.com-rekin, agiriaren akats atala erantsita.
Bitnami-n instalazioa
Bitnami ez da frogatu edo bermatua. Instalazioak huts egiten badu, exekutatu eskuz:
Exekutatu: |
$ bundle update |
$ rake db:migrate |
$ rake redmine:plugins:migrate |