Các vấn đề thường gặp khi cài đặt và cập nhật Redmine
Vì cả Redmine và Easy Redmine đều là mã nguồn mở và khá độc lập với nền tảng, nên có thể xảy ra một số vấn đề về cài đặt và nâng cấp do cấu hình máy chủ, phiên bần mķn phķin đặt. Chúng tôi nỗ lực để theo dõi những vấn đề phổ biến nhất để giúp bạn khắc phục.
Trong quá trình cập nhật ứng dụng, một thông báo lỗi chứa "Bạn có một lỗi trong cú pháp SQL của bạn; hãy kiểm tra hướng dẫn tương ứng với phiên bản máy chủ MySQL của bạn để sử dụng cú pháp đúng g ..." xuất hiện trong nhật ký.
Anledning
Điều này có nghĩa là cơ sở dữ liệu của bạn đã lỗi thời và không thể hoạt động với yu yu mà c tôi gửi đến nó. Nó chỉ đơn giản là không hiểu nó.
Lösning
Bạn cần cập nhật cơ sở dữ liệu của mình.
Làm thế nào để cập nhật cơ sở dữ liệu?
Mô tả chi tiết trong Cơ sở kiến thức.
- Chỉnh sửa quyền bằng các lệnh chgrp Vä chown theo cài đặt máy chủ (ví dụ: chgrp -R www-data public_html)
- Chạy lại quá trình cài đặt bunt exec rake easyproject: installera RAILS_ENV = produktion để xóa bộ nhớ cache (nếu bạn chạy bằng tài khoản root, quá trình này sẽ är inte thành công)
- Khởi động lại máy chủ
Nếu bạn đang sử dụng máy ảo do Easy Software cung cấp, hãy chạy dưới người dùng lätt:
sudo chown -R lätt / Home / lätt / ström
(trên các máy cũ - sudo chown -R easy /srv/easyredmine/public_html)
sudo chgrp -R enkelt / Home / lätt / ström
(trên các máy cũ - sudo chgrp -R easy /srv/easyredmine/public_html)
cd / Home / lätt / ström
(trên các máy cũ - cd /srv/easyredmine/public_html)
bunt exec rake easyproject: installera RAILS_ENV = produktion
sudo-tjänsten puma@ditt.domän.namn starta om
Hãy nhớ thiết lập quyền cho tất cả các thư mục cần thiết.
Dưới đây là một số gợi ý về những gì bạn có thể làm nếu gặp lỗi 500.
- springa Kiểm tra yêu cầu máy chủ Lätt và thử sửa các kiểm tra không thành công
- sao lưu cơ sở dữ liệu của bạn
- tải gói mới nhất từ Khu vực Khách hàng
- đảm bảo rằng máy chủ web có quyền truy cập đầy đủ vào các thư mục allmänheten, filer, log, tmp
- springa buntinstallation - utan utvecklingstest
- springa bunt exec rake easyproject: installera RAILS_ENV = produktion
- khởi động lại máy chủ ứng dụng
- xóa bất kỳ plugin Redmine của bên thứ ba nào (cũng từ cơ sở dữ liệu)
- viết cho chúng tôi qua support@easyredmine.com và đính kèm log/production.log
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.
Lỗi này xảy ra từ phiên bản 2018 1.2 (nền tảng 04.00 và cao hơn)
Lỗi trong quá trình cài đặt nâng cấp chứa một số lỗi sau đây.
[!] Đã xảy ra lỗi khi phân tích `Gemfile`:
[!] Đã xảy ra lỗi khi phân tích `Gemfile`: không thể tải được tệp --
# plugin 'rys-bundler', github: 'easysoftware / rys-bundler', branch: 'master'> Plugin.hook ('rys-gemfile', själv)
Bundler không thể tiếp tục.
Điều này do phiên bản cài đặt redmine đã lỗi thời.
Lösning:
Trước khi cài đặt bản nâng cấp
$ gem installera redmine-installer
Vấn đề này xảy ra khi bạn sử dụng hậu tố trên URL Easy Redmine của bạn, ví dụ: https://company.com/easyredmine/
Trong trường hợp này, bạn cần đảm bảo rằng bạn đã cấu hình biến RAILS_RELATIVE_URL_ROOT với hẑcíne ạn
Bitnami:
- Tạo một tệp cấu hình bổ sung config/additional_environment.rb
- config.action_controller.relative_url_root = "/ easyredmine"
- sau đó biên dịch tài sản (rake easyproject:install RAILS_ENV=production) och khởi động lại máy chủ
Hãy đảm bảo wkhtmltopdf đã được cài đặt và đang chạy ( wkhtmltopdf cần X-server hoặc mô phỏng khác)
Thử nó bằng cách sử dụng: "wkhtmltopdf google.com google.pdf"
Den här proxyn är:
proxy_set_header X-Forwarded-Proto https
Kontrollera cronkonfigurationen. Det är mycket viktigt att rakeuppgifter är INTE drivs av rot. Det kommer att orsaka fel på grund av otillräckliga behörigheter.
Låt oss säga att du kör Easy Redmine under användaren lätt. Kommandona är:
Visa aktiva krönor crontab -u lätt -l
Redigera crontab -u lätt -e
Applicera förändringar sudo service cron reload
Exempel på att köra varje 5-minut:
* / 5 * * * * /home/easy/scripts/easy_scheduler.sh &> / dev / null
#! / bin / bash -l
LOG_FILE = "/ home / lätt / ström / log / easy_scheduler_rake.log"
eko "$ (datum '+% Y-% m-% d% H:% M:% S') starta kratta" >> $ {LOG_FILE}
cd / home / easy / current && bundle exec rake easyproject: scheduler: run_tasks RAILS_ENV = produktion >> $ {LOG_FILE}
eko "$ (datum '+% Y-% m-% d% H:% M:% S') slutsträng" >> $ {LOG_FILE}
/home/easy/scripts/easy_scheduler.sh måste vara körbar:
sudo chmod + x /home/easy/scripts/easy_scheduler.sh
Tveka inte att söka på internet för en mer exakt manual för att ställa in cron på din server. Det är inte en exklusiv Easy Redmine krävs funktion.
Khi bạn đang cập nhật Easy Redmine trên nền tảng Windows và gặp thông báo lỗi ExecJs :: RuntimeError
Tất cả những gì bạn cần làm là Miljö NODEJS trên hệ thống của bạn để có cập nhật đúng.
Nếu quá trình cài đặt thất bại, chạy thủ công:
$ bunt uppdatering
$ rake db: migrera
$ rake redmine: plugins: migrera
Hãy đảm bảo máy chủ webb của bạn hỗ trợ kích thước thực của địa chỉ URL
Hãy đảm bảo bạn không sử dụng máy chủ web Webrick!
- đảm bảo bạn có phiên bản mới nhất của máy chủ web và Ruby
- cấu hình lại các truy vấn bộ lọc chậm để hiển thị ít trường hơn
- đặt lại CRON của bạn để không khởi chạy quá thường xuyên
- tham khảo nghiên cứu trường hợp này - Tăng tốc Rails mà không cần sửa mã Ruby
- kiểm tra cấu hình của bạn - https://www.easyredmine.com/resources/installation/1885-recommended-optimal-configuration-of-easy-redmine-server
Sao chép thư mục filer từ Redmine cũ của bạn.
Bạn có thể thay đổi vị trí mặc định của tệp trong tệp cấu hình của Redmine hoặc bạn có thợn d ƻợn d ƻợn trưng. Lưu trữ đính kèm trên mạng LAN hoặc đám mây không được khuyến nghị gör vấn đề về pålitlig.
Konfiguration:
./config/configuration.yml
# Đường dẫn tuyệt đối đến thư mục lưu trữ tệp đính kèm.
# Mặc định là thư mục 'filer' trong phiên bản Redmine của bạn.
# Phiên från EasyRedmine har fått en đọc/ghi trên thư mục này.
# Vi dụ: attachments_storage_path: / var / www / redmine / files
Khắc phục sự cố:
Nếu bạn không thể mở tệp đính kèm, hãy xem ./log/production.log để tìm các lỗi thông thường:
Không thể gửi tệp đính kèm, /var/www/redmine/files/2015/08/150805095407_xxx.PNG chông tồn tại hoặc không thể đọc được
ENOENT, Từ chối quyền... vv
Hãy đảm bảo rằng máy chủ web của bạn có các thư mục Full tillgång allmänheten, filer, log, tmp
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.
- Gå till administration >> inställningar >> förvar
- Aktivera WS för arkivhantering
- Generera en API-nyckel
- Save
- Gå till din förvarsklient
- 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.
Khi cấu hình miền của Easy Redmine của bạn, hãy đảm bảo sử dụng ít nhất miền cấp độ đầu dên, vín dên http://myeasyredmine.com thay vì chỉ http://myeasyredmine. Một số trình duyệt có thể gặp vấn đề khi truy cập nó.
Đi đến Quản trị >> Cài đặt >> Thông báo qua email
và xác minh rằng ĐỊA CHỈ GỬI là chính xác.
Nó nên giống như trong tệp cấu hình (hoặc ít nhất từ cùng máy chủ SMTP). Jag har skickat e-post (gmail, yahoo, vv) eller skickat e-post.
Kiểm tra cấu hình của bạn theo bài viết này trong Cơ sở kiến thức.
Để xác minh rằng cấu hình là chính xác, hãy thử kiểm tra xem có thể kết nối đến máy chủ e-post tự máá chạn bạ använder telnet.
telnet your.domain.here port_number_here (Vi dụ: telnet gmail.com 465)
Nó sẽ cho bạn biết liệu bạn có thể kết nối đến máy chủ e-post của bạn thực sự hay có vấn trong đụ en bạn.
Khi bạn cố gắng xuất PDF và gặp lỗi (hoặc không có phản ứng gì). Nhật ký sản xuất sẽ liệt kê lỗi tương tự như
Errno::EPIPE (Đường ống bị hỏng) HOAc wkhtmltopdf: không thể kết nối đến máy chủ X
Gây ra bởi vấn đề với thành phần xuất wkhtmltopdf
Đây là các giải pháp đề xuất.
Máy chủ không có giao diện đồ họa
Lấy phiên bản cần thiết của wkhtmltopdf từ http://wkhtmltopdf.org/downloads.html
Ví dụ (bạn phải làm việc với chi tiết của môi trường của riêng bạn):
- sudo apt-get installera 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 installera
- sudo mv / usr / local / bin / wkhtmltopdf / usr / local / bin / xwkhtmltopdf
- eko '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
Chỉ áp dụng cho máy chủ không có giao diện đồ họa
- Bạn cần phải cài đặt wkhtmltopdf trên máy chủ của bạn trong VÄG
(apt-get install wkhtmltox, yum installera wkhtmltox)
Nó phải được cài đặt trong bundler, nếu không có thể không hoạt động sau khi cập nhật Easy Redmine - Đảm bảo rằng chương trình hoạt động đúng (chạy từ console ví dụ như wkhtmltopdf https://easyredmine.com homepage.pdf)
- chạy la rake easyproject:install RAILS_ENV=production
- khởi động lại máy chủ
Cài đặt plugin
- ĐỪNG cài đặt plugin för ROOT
- Trước tiên, xóa tất cả các plugin Easy Gantt cũ nếu có (plugins/easy_gantt*)
- Sao chép tất cả các plugin đã giải nén vào thư mục REDMINE_ROOT/plugins
- Trong thư mục REDMINE_ROOT
Chạy: |
$ buntinstallation |
- (hoặc paketuppdatering) |
$ bundle exec rake db: migrera RAILS_ENV = produktion |
$ bundle exec rake redmine: plugins: migrera RAILS_ENV = produktion |
Sau đó, khởi động lại máy chủ.
Yêu cầu để cài đặt thành công
- Phiên bản Redmine: Tương thích với Redmine 3.2.x, 3.3.x, 3.4.x, 4.x.
- Phiên bản Ruby: 2.3+ (khuyến nghị 2.6.)
- Loại cơ sở dữ liệu: MySQL (khuyến nghị), PostgreSQL
Thực hiện quy trình cài đặt trong #Installera. Xác minh xem nhật ký cài đặt không chứa bất kỳ lỗi nào. Nếu có, hãy cố gắng giải quyết theo mô tả hoặc liên hệ support@easyredmine.com với phần mô tả lỗi đính kèm.
Cài đặt trên Bitnami
Bitnami không được kiểm tra hoặc đảm bảo. Nếu quá trình cài đặt thất bại, chạy thủ công:
Chạy: |
$ bunt uppdatering |
$ rake db: migrera |
$ rake redmine: plugins: migrera |