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ác phỷm đặ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ột thông báo lỗi chứa; 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 đn ..." xuất hiện trong nhật ký.
Λόγος
Đ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 đụang vứu màngi yêu úng tôi gửi đến nó. Nó chỉ đơn giản là không hiểu nó.
Λύση
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 και chown theo cài đặt máy chủ (ví dụ: chgrp -R public_html www-data)
- Chạy lại quá trình cài đặt δέσμη exec easyproject γκανιότα: εγκατάσταση RAILS_ENV = παραγωγή để xóa bộ nhớ cache (nếu bạn chạy bằng tài khoản root, quá trình này sẽ Khong Thành Công)
- Κάντε επανεκκίνηση του διακομιστή
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 εύκολος:
sudo chown -R εύκολο / home / easy / current
(trên các máy cũ - sudo chown -R easy /srv/easyredmine/public_html)
sudo chgrp -R εύκολο / 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)
δέσμη exec easyproject γκανιότα: εγκατάσταση RAILS_ENV = παραγωγή
επανεκκίνηση της υπηρεσίας sudo puma@your.domain.name
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.
- τρέξιμο Kiểm tra yêu cầu máy chủ Εύκολο 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 δημόσια, αρχεία, ημερολόγιο, tmp
- τρέξιμο δέσμη εγκαταστήσετε --without δοκιμή ανάπτυξης
- τρέξιμο δέσμη exec easyproject γκανιότα: εγκατάσταση RAILS_ENV = παραγωγή
- 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
Υπάρχουν πολλές πιθανές αιτίες αυτού του σφάλματος. Ακολουθούν μερικές συμβουλές:
- πρόβλημα cache του browser - δοκιμάστε να διαγράψετε cache από τον browser
- πρόβλημα DNS
- προβλήματος ρύθμιση διακομιστή
Πρώτα ελέγξτε τη σύνδεση και το δίκτυό σας (βεβαιωθείτε ότι ο διακομιστής είναι προσβάσιμος χρησιμοποιώντας μια εντολή ping ή εντολή traceroute). Πλευρά διακομιστή τείχους προστασίας.
Εάν όλα τα παραπάνω φαίνονται καλά, προσπαθήστε να λάβετε μερικές πληροφορίες από το nginx error.logs. Ελέγξτε το nginx error.log από την πλευρά του διακομιστή - /var/log/nginx/error.log
Διπλός έλεγχος ότι η διαμόρφωση nginx σας ταιριάζει με το πρότυπο. Τυπική διαμόρφωση nginx μπορείτε να βρείτε εδώ:
https://www.redmine.org/projects/redmine/wiki/HowTo_configure_Nginx_to_run_Redmine
Παράδειγμα μιας ρύθμισης nginx (όπως χρησιμοποιείται από την Easy Software). Είναι αρκετά παρόμοια με τα επίσημα ένα μόνο λίγες μεταβλητές βελτιστοποιηθεί:
χρήστης www-data?
εργαζόμενοι_επεξεργασίες 8;
worker_rlimit_nofile 60000?
error_log /var/log/nginx/error.log;
pid /var/run/nginx.pid;
events {
εργαζόμενοι_συνδέσεις 10240;
# Multi_accept για?
}
http {
ssl_protocols TLSv1 TLSv1.1 TLSv1.2; # μην χρησιμοποιείτε SSLv3 ref: POODLE
συμπεριλάβετε τους τύπους /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;!)."?
περιλαμβάνουν το /etc/nginx/conf.d/*.conf.
περιλαμβάνουν / etc / nginx / sites-enabled / *;
περιλαμβάνουν / etc / nginx / sites-auto / *.
}
Άλλες πιθανές αιτίες σφάλματος 502 περιλαμβάνουν ...
Unicorn δεν λειτουργεί καθόλου, λόγω της
- ανεπαρκή δικαιώματα
- Λάθος έκδοση του επιβάτη
- Λάθος έκδοση Ruby
- Λείπει πολύτιμοι λίθοι
- σπασμένο σύστημα αρχείων
Για να μάθετε το ακριβές πρόβλημα, θα πρέπει να ελέγξετε τα αρχεία καταγραφής σφαλμάτων στο μονόκερο ή Apache + αρχείο καταγραφής εφαρμογής από την Easy Redmine (log / production.log)
Χρονικό όριο
Εάν έχει ρυθμιστεί μικρό χρονικό όριο, αυτό το σφάλμα θα εμφανιστεί:
- μεγάλες εξαγωγές
- υπερφόρτωση του διακομιστή
- καθηκόντων γκανιότα τρέχει από το GUI
Όριο των συνδέσεων MySQL
Βεβαιωθείτε ότι έχετε αρκετό αριθμό συνδέσεων που επιτρέπονται στην MySQL. Εξαρτάται από τον αριθμό των χρηστών, αλλά θα πρέπει να έχετε τουλάχιστον ένα 100 επιτρέπεται.
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', κλάδος: '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.
Λύση:
Trước khi cài đặt bản nâng cấp
$ gem install 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 thíachạe bạ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) và 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 διακομιστής 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 của bạn:
proxy_set_header X-Forwarded-Proto https
Ελέγξτε τη διαμόρφωση cron. Είναι πολύ σημαντικό ότι τα καθήκοντα γκανιότας είναι ΔΕΝ τρέχει από τη ρίζα. Θα προκαλέσει αποτυχία λόγω ανεπαρκών δικαιωμάτων.
Ας υποθέσουμε ότι εκτελείτε το Easy Redmine κάτω από το χρήστη εύκολη. Οι εντολές είναι:
Προβολή ενεργών crons crontab -u εύκολο -l
Επεξεργασία crontab -u εύκολο -ε
Εφαρμογή αλλαγών υπηρεσία sudo cron reload
Παράδειγμα για την εκτέλεση cron κάθε 5 λεπτά:
* / 5 * * * * /home/easy/scripts/easy_scheduler.sh &> / dev / null
#! / bin / bash -l
LOG_FILE = "/ home / εύκολο / τρέχον / log / easy_scheduler_rake.log"
echo "$ (ημερομηνία '+% Y-% m-% d% H:% M:% S') έναρξη τσουγκράνας" >> $ {LOG_FILE}
cd / home / easy / current && bundle exec rake easyproject: scheduler: run_tasks RAILS_ENV = παραγωγή >> $ {LOG_FILE}
echo "$ (ημερομηνία '+% Y-% m-% d% H:% M:% S') τελική τσουγκράνα" >> $ {LOG_FILE}
/home/easy/scripts/easy_scheduler.sh πρέπει να είναι εκτελέσιμο:
sudo chmod + x /home/easy/scripts/easy_scheduler.sh
Μη διστάσετε να ψάξετε στο διαδίκτυο για ένα ακριβέστερο εγχειρίδιο για να ρυθμίσετε το cron στον server σας. Δεν είναι απαραίτητη η λειτουργία Easy Redmine.
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à Σύνθεση 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:
$ update update
$ Rake db: μεταναστεύσουν
$ rake redmine: plugins: μεταναστεύουν
Hãy đảm bảo máy chủ web 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 αρχεία 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óngtịnh ưng. Lưu trữ đính kèm trên mạng LAN hoặc đám mây không được khuyến nghị κάνω vấn đề về αξιόπιστος.
Διαμόρφωση:
./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 «αρχεία» trong phiên bản Redmine của bạn.
# Phiên bản EasyRedmine của bạn cần có quyền đọc/ghi trên thư mục này.
#Σε: attachments_storage_path: / var / www / redmine / αρχεία
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 khô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 Πλήρης πρόσβαση δημόσια, αρχεία, ημερολόγιο, tmp
Οι νέες δεσμεύσεις στο αποθετήριο σας δεν αντικατοπτρίζονται στο Easy Redmine, εκτός αν παραληφθούν από την εφαρμογή. Πρέπει να ορίσετε webhooks για σας πελάτη αποθετηρίου (github, gitlab, TortoiseSVN, ...) με πληροφορίες σχετικά με το παράδειγμα σας Easy Redmine.
- Πηγαίνετε στο διαχείριση >> ρυθμίσεις >> αποθετήρια
- Ενεργοποιήστε το WS για διαχείριση αποθετηρίων
- Δημιουργία κλειδιού API
- Αποθήκευση
- Πηγαίνετε στον πελάτη του αποθετηρίου
- Προσθέστε ένα webhook
Ας υποθέσουμε ότι ο ιστότοπός σας είναι easyredmine.company.com
Για git - https://easyredmine.company.com/ sys / git_fetcher
ή https://easyredmine.company.com/ sys / git_fetcher? key =[API key]
- ανάλογα με τη ρύθμιση του πελάτη, μπορεί να απαιτήσει μια μοναδική διεύθυνση URL ή το κλειδί σε διαφορετικό πεδίο
Για το SVN - https://easyredmine.company.com/ sys / fetch_changesets
ή https://easyredmine.company.com/ sys / fetch_changesets? key =[API key]
Από το σημείο 5, όλα εξαρτώνται από τον πελάτη αποθετηρίου και δεν σχετίζονται με τις ρυθμίσεις Easy Redmine. Είναι κάτι που πρέπει να επαληθεύσετε μετά από καθαρή εγκατάσταση ή αναβάθμιση από το 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 độ ti đíh vả 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). Nếu không, một số dịch vụ email (gmail, yahoo, vv) có thể từ chối thông báo.
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ủủ b Easy cừamin e-mail ch sử dụng telnet.
telnet your.domain.here port_number_here (Εδώ: 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ủ email của bạn thực sự hay có vấuhh đụn máy đủa bủa bủa của 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ư
Σφάλμα::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 đồ 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 εγκατάσταση 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 εγκατάσταση
- 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 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 PATH
(apt-get να εγκαταστήσετε wkhtmltox, yum install 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ừ κονσόλα ví dụ như wkhtmltopdf https://easyredmine.com homepage.pdf)
- chạy lại rake easyproject:install RAILS_ENV=production
- khởi động lại máy chủ
Πρόσθετο Cài đặt
- ĐỪNG cài đặt plugin với quyền ROOT
- Trước tiên, xóa tất cả các πρόσθετο Easy Gantt cũ nếu có (πρόσθετα/easy_gantt*)
- Sao chép tất cả các plugin đã giải nén vào thư mục REDMINE_ROOT/πρόσθετα
- Προτιμήστε το REDMINE_ROOT
Chạy: |
$ bundle install |
- (hoặc ενημέρωση πακέτου) |
$ bundle exec rake db: migrate RAILS_ENV = παραγωγή |
$ bundle exec rake redmine: plugins: migrate RAILS_ENV = παραγωγή |
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.)
- Λάβετε υπόψη μου: MySQL (khuyến nghị), PostgreSQL
Thực hiện quy trình cài đặt trong #εγκαθιστώ. 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: |
$ update update |
$ Rake db: μεταναστεύσουν |
$ rake redmine: plugins: μεταναστεύουν |