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 phần mềm hoặc 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 máy chủ MySQL của bạn để sử dụng cú pháp đúng gầ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 độ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ó.
Решение
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-данни)
- Chạy lại quá trình cài đặt пакет EXEC рейк easyproject: инсталиране RAILS_ENV = производство để xóa bộ nhớ кеш (nếu bạn chạy bằng tài khoản root, quá trình này sẽ Конг 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 лесно:
sudo chown -R лесно / Начало / лесно / ток
(trên các máy cũ - sudo chown -R easy /srv/easyredmine/public_html)
sudo chgrp -R лесно / Начало / лесно / ток
(trên các máy cũ - sudo chgrp -R easy /srv/easyredmine/public_html)
cd / Начало / лесно / ток
(trên các máy cũ - cd /srv/easyredmine/public_html)
пакет EXEC рейк easyproject: инсталиране RAILS_ENV = производство
sudo service 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.
- chạy 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
- chạy сноп инсталиране --without тест развитие
- chạy пакет EXEC рейк easyproject: инсталиране RAILS_ENV = производство
- khởi động lại máy chủ ứng dụng
- xóa bất kỳ плъгин 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
Има много възможни причини за тази грешка. Ето няколко съвета:
- кеша на браузъра проблем - опитайте се да изтриете кеша от браузъра
- 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-данни;
работни_процеси 8;
worker_rlimit_nofile 60000;
error_log /var/log/nginx/error.log;
pid /var/run/nginx.pid;
събития {
worker_connections 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;
изпрати файл на;
#tcp_nopush на;
#keepalive_timeout 0;
keepalive_timeout 65;
tcp_nodelay включен;
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 на;
gzip_disable "MSIE [1-6] \. (* SV1?!.)";
включва /etc/nginx/conf.d/*.conf;
включва / и т.н. / Nginx / сайтове с активирани / *;
включва / и т.н. / Nginx / сайтове, автоматично / *;
}
Други възможни причини за 502 грешка включват ...
Unicorn не работи изобщо, поради
- Недостатъчни разрешения
- Грешна версия на пътническия
- Грешен Ruby версия
- Липсващи скъпоценни камъни
- Broken файлова система
За да разберете точно проблема, трябва да се провери трупи грешки в еднорог или Apache + дневник заявление от Easy Redmine (дневник / production.log)
Timeout
Ако ниска изчакване е конфигурирана, тази грешка ще се появи:
- големи износа
- претоварване на сървъра
- рейк задачи се изпълняват от графичния интерфейс
Граница на 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 --
# приставка 'rys-bundler', github: 'easysoftware / rys-bundler', клон: 'master'> Plugin.hook ('rys-gemfile', самостоятелно)
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 инсталирате 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ậu tố chính xác /easyredmine của 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 (рейк easyproject:install RAILS_ENV=production) và khởi động lại máy chủ
Уверете се 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"
Thêm vào cấu hình прокси của bạn:
proxy_set_header X-предаден-Прото HTTPS
Проверете конфигурацията Cron. Това е много важно, че рейк задачи са НЕ управлявана от корен. Това ще доведе до провал поради недостатъчно права.
Да речем, че използвате Easy Redmine под потребителското лесно. Командите са:
Виж активните crons кронтаб -u лесно -l
Редактиране кронтаб -u лесно -е
Прилага промени sudo service cron презареждане
Пример за движение Cron всеки 5 минути:
* / 5 * * * * /home/easy/scripts/easy_scheduler.sh &> / dev / null
#! / bin / bash -l
LOG_FILE = "/ Начало / лесно / ток / дневник / easy_scheduler_rake.log"
echo "$ (date '+% Y-% m-% d% H:% M:% S') start rake" >> $ {LOG_FILE}
cd / home / easy / current && bundle exec rake easyproject: планировчик: run_tasks RAILS_ENV = производство >> $ {LOG_FILE}
echo "$ (date '+% Y-% m-% d% H:% M:% S') end rake" >> $ {LOG_FILE}
/home/easy/scripts/easy_scheduler.sh трябва да е изпълним:
sudo chmod + x /home/easy/scripts/easy_scheduler.sh
Не се колебайте да търсите в интернет, по-точно за употреба, за да се създаде Cron на вашия сървър за. Това не е изключително лесно 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:
$ Актуализация пакет
$ Рейк db: мигрират
$ Рейк redmine: плъгини: мигрират
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 файлове това е Redmine.
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ể 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ị правя 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 'files' 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.
# Ví dụ: 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
- Save
- Отидете в хранилище на клиента
- Добавяне на webhook
Да кажем, че вашият сайт е easyredmine.company.com
За Git - https://easyredmine.company.com/ Сис / git_fetcher
или https://easyredmine.company.com/ Сис / git_fetcher? Ключ =[API ключ]
- в зависимост от настройката на клиента, той може да изисква един единствен URL или ключа в различна област
За SVN - https://easyredmine.company.com/ Сис / fetch_changesets
или https://easyredmine.company.com/ Сис / fetch_changesets? Ключ =[API ключ]
От гледна 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 độ đầ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 имейл
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ụ имейл (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ủ имейл từ máy chủ Easy Redmine của bạn bằng cá 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ủ имейл của bạn thực sự hay có vấn đề trong cấu hình máy chủ имейл 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ư
Errno::EPIPE (Đường ống bị hỏng) Ас 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 dien đồ 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 плъгин
- Добавете плъгин за ROOT
- Trước tiên, xóa tất cả các плъгин Easy Gantt cũ nếu có (plugins/easy_gantt*)
- Sao chép tất cả các плъгин đã giải nén vào thư mục REDMINE_ROOT/plugins
- С помощта на REDMINE_ROOT
Chạy: |
$ Bundle install |
- (Hoặc пакетна актуализация) |
$ bundle exec rake db: мигрирайте RAILS_ENV = производство |
$ bundle exec rake redmine: plugins: мигриране 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: |
$ Актуализация пакет |
$ Рейк db: мигрират |
$ Рейк redmine: плъгини: мигрират |