Redmine

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

Оригинал: [[RedmineInstall|Installing Redmine v.118]]

h1. Установка

{{>toc}}

h2. Требования для версии 1.1.x:

* операционная система: Unix, Linux, [[RedmineInstallOSX|Mac]], [[RedmineInstallOSXServer|Mac Server]] and Windows. Инструкции см. [[RusHowTos|тут]]

* ruby 1.8.6, 1.8.7

* Rails 2.3.5

* Rack 1.0.1

* База данных: MySQL 5.0 or higher (recommended), PostgreSQL 8, SQLite 3

Официальный релиз включает соответствующую версию Rails в директории vendor. Поэтому обычно дополнительных действий не требуется.

Если вы устанавливаете Redmine из хранилища, вы можете установить конкретную версию Rails на вашем компьютере выполнив:

<pre>

gem install rails -v=2.3.5

</pre>

Установка Rack:

<pre>

gem install rack -v=1.0.1

</pre>

Примечания:

Ruby 1.9 пока не поддерживается. Вы должны использовать Ruby 1.8.x, как указано выше.

Требуется RubyGems 1.3.1 или выше (Rails 2.3.5 не будет работать с RubyGems 1.5.0 и более поздние, придерживайтесь предыдущих версий RubyGems)

Rake 0.8.3 или выше

Rack 1.0.1. Если у вас нет этой версии, перенос базы данных не будет работать.

I18n 0.4.2 требуется для Redmine >= 1.0.5

h3. Опционально

* Бинарники системы управления версиями исходников (например svn), для просмотра репозитария (должны быть указаны в переменной PATH). Смотри [[RusRedmineRepositories|Настройка репозиториев]].

* "RMagick":http://rmagick.rubyforge.org (чтобы включить возможность экспорта диаграммы Ганта в png изображение)

* "Ruby OpenID Library":http://openidenabled.com/ruby-openid/ (чтобы активировать поддержку OpenID) [только в Redmine trunk / 0.9-dev] Требуется версия 2 или выше.

h2. Версии Redmine

Для большинства пользователей рекомендуется устанавливать последние версии релизов Redmine. Redmine в настоящее время выпускает новую версию каждые 6 месяцев, и эти релизы считаются очень полезным и стабильным. Не рекомендуется устанавливать Redmine из trunc репозитария, если вы не знакомы с Ruby On Rails, т.к. время от времени trunc-версия сбоит.

h2. Установка

# Получите исходный код Redmine либо загрузки упакованных релиз или просмотреть код хранилища. См. [[Download]]

# Создайте пустую базу данных и сопутствующих пользователя с именем Redmine например

Для MySQL:

<pre><code class="sql">

create database redmine character set utf8; 

create user 'redmine'@'localhost' identified by 'my_password'; 

grant all privileges on redmine.* to 'redmine'@'localhost';

</code></pre>

# Скопировать config/database.yml.example в config/database.yml и отредактировать этот файл для того, чтобы настроить параметры базы данных для "производственной" среды.

Пример для базы данных MySQL:

<pre>

production: 

adapter: mysql 

database: redmine 

host: localhost 

username: redmine 

password: my_password

</pre>

Если ваш сервер не работает со стандартным портом (3306), используйте эту конфигурацию:

<pre>

production: 

adapter: mysql 

database: redmine 

host: localhost 

port: 3307

username: redmine 

password: my_password

</pre>

# Генерация безопасного хранилища сессий

<pre>

rake generate_session_store

</pre>

# Создайте структуру базы данных, выполнив следующую команду в корневом каталоге приложения:

<pre>

RAILS_ENV=production rake db:migrate

</pre>

Это создаст таблицы и учетную запись администратора

Если вы получите вот такую ошибку:

<pre>

Rake aborted!

no such file to load -- net/https

</pre>

вам необходимо установить libopenssl-ruby1.8, в Ubuntu выполните: pt-get install libopenssl-ruby1.8

# Установите в базу данных конфигурацию по умолчанию, выполнив следующую команду:

<pre>

RAILS_ENV=production rake redmine:load_default_data

</pre>

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

# Настройка разрешений

_Пользователи Windows могут пропустить этот шаг._

Пользователь, который запускает Redmine должны иметь разрешение на запись в следующие подкаталоги:  files , log , tmp  (создайте последний, если его нет).

Предполагается, что вы запустили Redmine от пользователя redmine:

<pre>

mkdir tmp public/plugin_assets

sudo chown -R redmine:redmine files log tmp public/plugin_assets

sudo chmod -R 755 files log tmp public/plugin_assets

</pre>

# Протестируйте установку путем запуска веб-сервера WEBrick:

<pre>

ruby script/server webrick -e production

</pre>

После старта WEBrick, откройте в браузере http://localhost:3000/. Теперь вы должны увидеть страницу приветствия приложения.

# Используйте учетную запись администратора по умолчанию, чтобы войти:

* Логин: admin

* Пароль: admin

bq. Примечание: Webrick не подходит для нормальной эксплуатации, пожалуйста, используйте WEBrick только для тестирования.

h2. Конфигурация логирования

По умолчанию в Redmine уровень журналирования :info (информация). В зависимости от использования сайта, лог может сильно вырасти. Чтобы это избежать, необходимо его ротировать, либо с помощью системной утилиты Logrotate, либо через файл Config/additional_environment.rb.

Для использования последнего, необходимо скопировать config/additional_environment.rb.example в config/additional_environment.rb и в нем добавить следующие строки. Отметим, что по умолчанию в файле установлен высокий уровнь журналирования, следовательно, должен быть явно установлен в информацию.

<pre><code class="ruby">

#Logger.new(PATH,NUM_FILES_TO_ROTATE,FILE_SIZE)

config.logger = Logger.new(config.log_path, 2, 1000000)

config.logger.level = Logger::INFO

</code></pre>

h2. Конфигурирование SMTP-сервера

Скопировать config/email.yml.example в config/email.yml и отредактировать этот файл.

См. пример [[Настройка почты]]

Не забудьте перезапустить приложение после любого изменения.

h2. Резервное копирование

Копии Redmine должны включать:

* данные (хранящиеся в базе данных Redmine)

* вложения (хранится в директории files вашей установки Redmine)

Вот простой скрипт, который может быть использован для создания ежедневных резервных копий (если вы используете базу данных MySQL):

<pre>

# База данных 

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

# Вложения 

rsync -a /path/to/redmine/files /path/to/backup/files

</pre>