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 may chủ, phiên bản phần mềm hoặc wtyczka các đã cài đ ặ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 may chủ MySQL cua bạn để sử dụng cu pháp đúng gần đó …” xuất hiện trong nhật ký.
Nguyên nhan
Điều nay có nghĩa là cơ sở dữ liệu cua bạn đã lỗi thời và không thể hoạt động với yêu cầu mà ứng dụng của chúng t ôi gửi đến nó. Nó chỉ đơn giản là không hiểu nó.
Rozwiązanie
Bạn cần cập nhật cơ sở dữ liệu cua mình.
Làm thế nào để cập nhật cơ sở du 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 i chown theo cai đặt máy chủ (ví dụ: chgrp -R www-data public_html)
- Chạy lại quá trình cài đặt bundle exec natarcia easyproject: zainstaluj RAILS_ENV = produkcja để xóa bộ nhớ cache (nếu bạn chạy bằng tài khoản korzeń, quá trình này sẽ nie Thành Cong)
- Khởi động lại máy chủ
Nếu bạn đang sử dụng may ả do Easy Software cung cấp, hãy chạy dưới người dùng łatwo:
sudo chown -R easy / home / easy / current
(trên các máy cũ - sudo chown -R easy /srv/easyredmine/public_html)
sudo chgrp -R easy / home / easy / current
(trên các máy cũ - sudo chgrp -R easy /srv/easyredmine/public_html)
cd / home / easy / current
(trên các máy cũ - cd /srv/easyredmine/public_html)
bundle exec natarcia easyproject: zainstaluj RAILS_ENV = produkcja
usługa sudo puma@twoja.nazwa.domeny restart
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 loi 500.
- chay Kiểm tra yêu cầu máy chủ Easy và thử sửa các kiểm tra không thành công
- sao lưu cơ sở du liệu cua ban
- tải goi mới nhất từ Khu vực Khach hang
- đảm bảo rằng may chủ web có quyền truy cập đầy đủ vào các thư mục publicznego, plików dziennika, tmp
- chay Wiązka instalacji --without testu rozwoju
- chay bundle exec natarcia easyproject: zainstaluj RAILS_ENV = produkcja
- khởi động lại może chủ ứng dụng
- wtyczka xóa bất kỳ Redmine của ben 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
Istnieje wiele możliwych przyczyn tego błędu. Oto kilka wskazówek:
- Problem cache przeglądarki - spróbuj usunąć cache z przeglądarki
- problem dns
- Problem ustawienia serwera
Najpierw sprawdź połączenie i sieć (sprawdź, czy serwer jest osiągalny, używając polecenia ping lub polecenia traceroute). Strona serwera zapory.
Jeśli wszystko powyższe wydaje się w porządku, spróbuj uzyskać informacje z nginx error.logs. Sprawdź plik nginx error.log po stronie serwera - /var/log/nginx/error.log
Dokładnie sprawdzić, czy konfiguracja nginx odpowiada standardowi. Konfiguracja standardowa nginx można znaleźć tutaj:
https://www.redmine.org/projects/redmine/wiki/HowTo_configure_Nginx_to_run_Redmine
Przykład konfiguracji nginx (jaki jest stosowany przez Easy Software). Jest bardzo podobny do oficjalnego tylko kilka zmienne są zoptymalizowane:
użytkownika www-data;
work_processes 8;
worker_rlimit_nofile 60000;
error_log /var/log/nginx/error.log;
pid /var/run/nginx.pid;
zdarzenia {
worker_connections 10240;
# Multi_accept dalej;
}
http {
ssl_protocols TLSv1 TLSv1.1 TLSv1.2; # nie używaj SSLv3 ref: POODLE
dołącz /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?!).";
obejmują /etc/nginx/conf.d/*.conf;
include / etc / nginx / strony obsługującej / *;
include / etc / nginx / strony-auto / *;
}
Inne możliwe przyczyny błędu 502 to ...
Unicorn nie działa w ogóle, ze względu na
- niewystarczające uprawnienia
- Błędna wersja pasażera
- Błędna wersja Ruby
- Brakujące kamienie
- złamane plików
Aby dowiedzieć się dokładnie problem, trzeba sprawdzić logi błędów w jednorożec lub apache + dzienniku aplikacji z łatwym Redmine (log / production.log)
Timeout
Jeśli niski limit czasu jest skonfigurowany ten błąd pojawi się na:
- duże eksport
- przeciążenie serwera
- Zadania natarcia uruchomić z GUI
Limit połączeń MySQL
Upewnij się, że masz wystarczającą liczbę połączeń dozwolonych do MySQL. To zależy od liczby użytkowników, ale trzeba mieć co najmniej 100 dozwolone.
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', self)
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.
Rozwiązanie:
Trước khi cài đặt bản nâng cap
$ gem zainstaluj redmine-installer
Vấn đề này xảy ra khi bạn sử dụng hậu tố trên URL Easy Redmine cua bạn, ví dụ: https://company.com/easyredmine/
Trong trường hop 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ậu tố chính xác /easyredmine của bạ rz
BitNami:
- Tạo một tệp cấu hình bổ śpiewane 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=produkcja) và khởi động lại máy chủ
Upewnić się wkhtmltopdf đã được cài đặt và đang chạy ( wkhtmltopdf cần X serwer hoặc mô phỏng khác)
Thử nó bằng cách sử dụng: „wkhtmltopdf google.com google.pdf”
Thêm vào cấu hình proxy cua bạn:
proxy_set_header x przekazane proto HTTPS
Sprawdź konfigurację cron. Jest to bardzo ważne, że są zadania Rake NIE prowadzony przez root. Będzie to spowodować awarię z powodu niewystarczających uprawnień.
Powiedzmy, że działają zgodnie z użytkownikiem Łatwa Redmine łatwe. Polecenia są:
Zobacz aktywne crons crontab -l -u łatwe
Edycja crontab -u łatwe -e
Zatwierdź zmiany sudo service cron reload
Przykład działa crona co 5 minut:
* / 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: scheduleer: run_tasks RAILS_ENV = produkcja >> $ {PLIK_LOGU}
echo "$ (date '+% Y-% m-% d% H:% M:% S') end rake" >> $ {LOG_FILE}
/home/easy/scripts/easy_scheduler.sh musi być plikiem wykonywalnym:
sudo chmod + x /home/easy/scripts/easy_scheduler.sh
Nie wahaj się szukać w Internecie dla bardziej precyzyjnej instrukcji, aby skonfigurować cron na serwerze. To nie jest wyłącznie wymagana Łatwy Redmine funkcji.
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à Ustawienie NODEJS trên hệ thống cua 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:
$ Pakiet aktualizacji
$ Rake db: migrować
$ Redmine Rake: plugins: migracja
Hãy đảm bảo máy chủ web của bạn hỗ trợ kích thước thực cua địa chỉ URL
Hãy đảm bảo ban không sử dụng may chủ web Webrick!
- đảm bảo bạn có phiên bản moi nhất cua may chủ web và Ruby
- cấu hình lại các truy vấn boộ lọc chậm để hiển thị ít trường hơn
- đặt lại CRON cua bạn để không khởi chạy quá thường xuyên
- tam khảo nghiên cuu trường hop này – Tăng tốc Rails mà không cần sửa mã Ruby
- kiểm tra cấu hình cua bạn - https://www.easyredmine.com/resources/installation/1885-recommended-optimal-configuration-of-easy-redmine-server
Sao chép thư mục pliki tu Redmine cu cua ban.
Bạn có thể thay đổi vị tri mặc định cua tệp trong tệp cấu hình cua Redmine hoặc ban có thể sử dụng liên kết tượng trưng. Lưu trữ đính kèm trên mạng LAN hoặc đám mây không được khuyến nghị do vấn đề về niezawodny.
Konfiguracja:
./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 „pliki” trong phiên bản Redmine cua ban.
# Phiên bản EasyRedmine cua bạn cần có quyền đọc/ghi trên thư mục này.
# Ví dụ: attachments_storage_path: / var / www / Redmine / pliki
Khắc phục sự cu:
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 không tồn tại hoặc không thể đọc được
ENOENT, Từ chối quyền... w
Hãy đảm bảo rằng may chủ web cua bạn có các thư mục Pełny dostęp publicznego, plików dziennika, tmp
Nowe Zobowiązuje do swojego repozytorium nie są odzwierciedlane w łatwym Redmine ile nie zostały one pobrane przez aplikację. Musisz ustawić webhooks na własną repozytorium klient (Github, gitlab, TortoiseSVN, ...) z informacjami o przykład Łatwy Redmine.
- Iść do administracja >> ustawienia >> repozytoria
- Włącz WS zarządzania repozytorium
- Generowanie klucza API
- Zapisz
- Idź do swojego repozytorium klienta
- Dodaj webhook
Załóżmy, że Twoja strona jest easyredmine.company.com
Dla git - https://easyredmine.company.com/ Sys / git_fetcher
lub https://easyredmine.company.com/ Sys / git_fetcher? Key =[Klucz API]
- w zależności od ustawienia klienta, może wymagać pojedynczy adres URL lub klucz do innej dziedzinie
Dla SVN - https://easyredmine.company.com/ sys / fetch_changesets
lub https://easyredmine.company.com/ Sys / fetch_changesets? Key =[Klucz API]
Z punktu 5, to wszystko zależy od repozytorium klienta i nie związane z ustawieniami Łatwy Redmine. To jest coś, należy zweryfikować po czystej instalacji lub uaktualnienia z Redmine.
Khi cấu hình miền cua Easy Redmine cua bạn, hãy đảm bảo sử dụng ít nhất miền cấp độ đầu tiên, ví dụ như 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 may chủ SMTP). Nếu không, một số dịch vụ e-mail (gmail, yahoo, vv) có thể từ chối thông báo.
Kiểm tra cấu hình cua bạn theo bai viết nay 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 may chủ e-mail do may chủ Easy Redmine của bạn bằng cách s nie potrzebujesz telnetu.
telnet twoja.domena.here numer_portu (Ví 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-mail cua bạn thực sự hay có vấn đề trong cấu hình may chủ e-mail của ban.
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) hoặc 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 đồ hoa
Lấy phiên bản cần Thiết cua wkhtmltopdf từ http://wkhtmltopdf.org/downloads.html
Ví dụ (bạn phải làm việc với chi tiết cua moi trường cua riêng ban):
- sudo apt-get zainstaluj 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
Chỉ áp dụng cho may chủ không có giao diện đồ hoa
- Bạn cần phải cài đặt wkhtmltopdf trên máy chủ cua bạn trong PATH
(Apt-get install wkhtmltox, yum install wkhtmltox)
Nó phải được cài đặt trong pakieter, 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ừ konsola ví dụ như wkhtmltopdf https://easyredmine.com homepage.pdf)
- chạy lại rake easyproject:install RAILS_ENV=produkcja
- khởi động lại may chủ
Wtyczka Cài đặt
- ĐỪNG cài đặt wtyczka với quyền ROOT
- Trước tiên, xóa tất cả các wtyczka 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: |
$ Bundle install |
- (aktualizacja pakietu hoặc) |
$ pakiet exec rake db:migrate RAILS_ENV=produkcja |
$ pakiet exec rake redmine:plugins:migrate RAILS_ENV=produkcja |
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ở du liệu: MySQL (khuyến nghị), PostgreSQL
Thực hiện quy trình cài đặt trong #zainstalować. 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 mo tả hoặc liên hệ support@easyredmine.com với phần mo 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: |
$ Pakiet aktualizacji |
$ Rake db: migrować |
$ Redmine Rake: plugins: migracja |