Redmine

[[RusGuide|Руководство]]->[[RusInstallation_guide|Руководство по установке]]

Оригинал: [[RedmineUpgrade|Upgrading an existing installation v.44]]

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

{{>toc}}

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

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

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

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

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

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

h3. MySQL база данных

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

Например:

<pre>

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

</pre>

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

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

h3. Вариант 1 - Если [[Download|скачивали]] релизы tar.gz или ZIP-файл

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

# Скопируйте настройки базы данных, файл config/database.yml в директорию config новой директории установки

# Скопируйте настройки электронной почты, файл config/email.yml в директорию config новой директории установки

# Скопируйте содержимое каталога files/ в новую директорию установки

# Скопируйте папки ваших установленных плагинов в новую директорию установки

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

<pre>

rake config/initializers/session_store.rb

</pre>

Выполните:

<pre>

rake generate_session_store

</pre>

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

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

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

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

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

<pre>

svn update

</pre>

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

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

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

<pre>

rake db:migrate RAILS_ENV=production

</pre>

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

<pre>

rake db:migrate:upgrade_plugin_migrations RAILS_ENV=production

rake db:migrate_plugins RAILS_ENV=production

</pre>

h2. Шаг 5 - Очистка

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

<pre>

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

</pre>

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

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

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

h3. 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, закомитить их и добавить строку чтобы выглядело так

<pre>

#gem 'rack', '~> 1.0.1'

#require 'rack'

load "/usr/lib/ruby/gems/1.8/gems/rack-1.1.0/lib/rack.rb"

</pre>

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

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

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

<pre>

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

</pre>

Лекарство: 

В файле /usr/share/redmine/lib/redmine/scm/adapters/subversion_adapter.rb

найти строку 

<pre>

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

</pre>

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

<pre>

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

</pre>