Обновление Redmine до версии Easy

Это руководство будет полезно тем, кто установил Redmine и хочет обновиться до Easy Redmine. Аналогичная процедура подходит и для установки обновлений в Easy Redmine. Здесь вы узнаете, как использовать установочный пакет Redmine Gem для обновления Redmine.

0) С чего начать

Убедитесь, что у вас есть подходящее аппаратное и программное обеспечение. Необходимо выполнить следующие условия:

Веб-сервер должен обладать ПОЛНЫМ доступом к папкам public, files, log, tmp => НЕ ЗАПУСКАЙТЕ УСТАНОВЩИК REDMINE ИЗ КОРНЕВОЙ ПАПКИ!
Сервер WEBrick НЕ поддерживается
Плагины Easy Redmine идут в [redmine_root]/plugins/easyproject/easy_plugins
В ходе обновления выполняется перенос форматирования. Если вы использовали Textile или Markdown (стандартный синтаксис для Redmine, доступный с версии Easy Redmine 10), тексты будут преобразованы в формат HTML, поддерживаемый CKEditor 5. Некоторые функции (например, toc) будут отключены.
В процессе установки НЕ выполняется автоматическая настройка CRON — это делается вручную
Для установочного пакета Redmine требуется освободить не менее 250 МБ на корневом диске
Во время установки сервер должен быть всё время подключен к интернету
Redmine не может содержать плагины или модификации сторонних поставщиков. Подробности в пункте 2.1 условий установки
Перед установкой обновлений Easy Redmine проверьте содержимое папок плагинов в действующей системе и в пакете обновлений (/plugins и /plugins/easyproject/easy_plugins). Если в пакете обновлений нет плагинов, которые есть в текущей версии, напишите в службу поддержки, чтобы узнать причину и получить правильный пакет. Или просто удалите лишние плагины из системы.

Подробное руководство по установке доступно непосредственно в самом пакете в папке doc/INSTALL

1) Установочный пакет Redmine Ruby Gem

Для начала установите пакет Redmine Ruby Gem. Для установки gem-пакета используйте команду:

$ gem install redmine-installer

(Или gem update redmine-installer для обновления текущего gem-файла до последней версии).

После установки/обновления gem-пакета в Ruby можно приступать к обновлению системы.

Скачать установочный пакет

2) Обновление текущей версии Redmine

С помощью установочного пакета Redmine можно обновить текущую систему из архива или хранилища git. Все установленные плагины сохраняются или обновляются, если они есть в новом пакете.

Процедуру обновления можно сохранить в профиле для использования в будущем. Профили хранятся в HOME_FOLDER/.redmine-installer-profiles.yml

Команда для обновления:

redmine upgrade [PATH_TO_PACKAGE] [REDMINE_ROOT]

Мастер обновления выполняет следующие действия:

1) Выбор корневой папки Redmine — определение места установки Redmine (если путь не указан в команде)
2) Загрузка пакета — загрузка пакета во временную папку
3) Проверка текущей версии Redmine
4) Создание резервной копии — полная / конфигурация + база данных / только база данных
5) Обновление — выполнение команд обновления
6) Перемещение Redmine — добавление новых файлов в текущую версию Redmine
7) Сохранение профиля — сохранение процедуры обновления для использования в будущем

Команда для обновления Redmine из архива

redmine upgrade [PATH_TO_PACKAGE] [REDMINE_ROOT]

Пример

redmine upgrade easyredmine_2016_stable_u11271_v2018_1_2__platform_04_00.zip /home/easy/current

Команда для обновления Redmine из профиля

redmine upgrade [PACKAGE] [REDMINE_ROOT] --profile PROFILE_ID

Обновление с пользовательскими модификациями

Если вы используется плагин easyproject и не хотите копировать модификации из старой версии, примените команду

--skip-old-modifications

Более полная информация доступна в документации GEM