Руководство->Руководство по установке

Оригинал: Upgrading an existing installation v.67

Обновление существующей установки¶

Документация ниже, предназначена на обновлении до Redmine 2.x.
Вы можете просмотреть предыдущие версии для обновления до Redmine 1.x here.

• Table of contents
• Обновление существующей установки
  • Шаг 1 - Проверьте требования
  • Шаг 2 - Резервное копирование
    • Резервное копирование файлов
    • MySQL база данных
    • SQLite база данных
    • PostgreSQL
  • Шаг 3 - Выполнить обновление
    • Вариант 1 - Скачайте релиз в виде tar.gz или ZIP-файл
    • Вариант 2 - Обновление с SVN Checkout
  • Шаг 4 - Обновление базы данных
  • Шаг 5 - Очистка
  • Возможные проблемы
    • Rack n.n.n cannot be loaded because Rack n.n.n is already activated
    • SVN репозиторий не открывается

Шаг 1 - Проверьте требования¶

Первый шаг к модернизации Redmine - проверить соответствие требованиям версии, которую вы собираетесь установить.

Шаг 2 - Резервное копирование¶

Рекомендуется сделать резервную копию базы данных и файлов на сервер. Большинство обновлений являются безопасными, но никогда не помешает иметь резервную копию на всякий случай.

Резервное копирование файлов¶

Все загруженные файлы хранятся в каталоге files/. Вы можете скопировать содержимое этого каталога в другое место, чтобы создать резервную копию.

MySQL база данных¶

Команда mysqldump может использоваться для резервного копирования содержимого вашей базы данных MySQL в текстовый файл.
Например:

/usr/bin/mysqldump -u <username> -p<password> <redmine_database> | gzip > /path/to/backup/db/redmine_`date +%y_%m_%d`.gz

SQLite база данных¶

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

PostgreSQL¶

Команда pg_dump может быть использована для резервного копирования содержимого вашей базы PostgreSQL в текстовый файл. Вот пример:

/usr/bin/pg_dump -U <username> -Fc --file=redmine.sqlc <redmine_database>

Шаг 3 - Выполнить обновление¶

Теперь пришло время для выполнения фактического обновления. Этот процесс является различным в зависимости от того, как вы скачали Redmine. Вам только нужно выполнить один из следующих вариантов.

Вариант 1 - Скачайте релиз в виде tar.gz или ZIP-файл¶

1. Распакуйте новый архив программы в новый каталог.

2. Скопируйте настройки базы данных, файл config/database.yml в директорию config новой директории установки. Если вы запускаете Redmine >= 1.4 с mysql и ruby1.9, измените адаптер базы данных на `mysql2`.

3a. Скопируйте файл основных настроек config/configuration.yml в директорию config новой директории установки

3b. Или, если вы обновляете с версии ранее 1.2.0, скопируйте настройки вашей почты из вашего файла config/email.yml в новый файл config/configuration.yml, который может быть создан копированием существующего файла configuration.yml.example.

4. Скопируйте содержимое каталога files в новую директорию установки (данная директория содержит все ваши загруженные файлы).

5. Скопируйте папки ваших установленных плагинов из директории vendor/plugins (если вы обновляете с версии ниже 2.0.0) или из директории plugins (если вы обновляете с версии выше 2.0.0) в новую plugins директорию установки. Убедитесь, что вы копируете только те плагины, которые подходят для новой устанавливаемой версии Redmine.

6. Выполните следующую команду из нового корневого каталога Redmine:

rake generate_secret_token

Данная команда создаст файл (config/initializers/secret_token.rb) со случайными данными, используемый для защиты данных сессий.

7. Проверьте, нет ли тем, которые вы могли установить в каталог public/themes. Вы тоже можете их скопировать, но проверьте подходят ли они для обновленной версии.

ОЧЕНЬ ВАЖНО: не заменять файл config/settings.yml старой версией!

Вариант 2 - Обновление с SVN Checkout¶

1. Перейдите в корневой каталог Redmine и запустить следующую команду:

svn update

2. Если вы обновляете старую версию на 0.8.7 и выше или из trunk версии Redmine на r2493 или выше, необходимо сгенерить файл для защиты данных сессии. См. выше про генерацию session_store.

Шаг 4 - Обновление базы данных¶

Этот шаг может изменить содержимое базы данных. Перейти на новый каталог Redmine и запустите перенос базы данных:

rake db:migrate RAILS_ENV=production

Если у вас установлены какие-либо плагины, вы также должны запустить миграцию их баз данных:

rake redmine:plugins:migrate RAILS_ENV=production

Шаг 5 - Очистка¶

1. Вам необходимо очистить кэш и существующие сессии:

rake tmp:cache:clear
rake tmp:sessions:clear

2. Перезагрузите сервер приложений (например, puma, thin, passenger)

3. Наконец, перейдите в "Admin -> Роли и разрешения", чтобы проверить/задать разрешения для новых возможностей, если таковые имеются.

Возможные проблемы¶

Rack n.n.n cannot be loaded because Rack n.n.n is already activated¶

При использовании Rails 2.3.5 можно получить следующее сообщение Rack 1.0.1 cannot be loaded because Rack 1.0 is already activated.
Для решения необходимо изменить файл action_controller в папке приложения по следующему пути vendor/rails/actionpack/lib/action_controller.rb
Найти строки 34 и 35, закомитить их и добавить строку чтобы выглядело так

#gem 'rack', '~> 1.0.1'
#require 'rack'
load "/usr/lib/ruby/gems/1.8/gems/rack-1.1.0/lib/rack.rb" 

Причем путь надо заменить на нужный

SVN репозиторий не открывается¶

в логах мини веб-сервера thin (/var/log/thin/thin.0.logh) пишется что-нить подобное:

svn: OPTIONS of 'https://Сервер/svn/проект': Server certificate verification failed: issuer is not trusted (https://Сервер)

Лекарство:
В файле /usr/share/redmine/lib/redmine/scm/adapters/subversion_adapter.rb
найти строку

str << " --no-auth-cache --non-interactive" 

и добавить ключ, включающий поддержку неизвестных SSL сертификатов:

str << " --trust-server-cert --no-auth-cache --non-interactive"