Redmine

h1. Установка

{{>toc}}

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

* операционная система: Unix, Linux, Mac, Mac Server and Windows

* 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

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

* "RMagick":http://rmagick.rubyforge.org (to enable Gantt export to png image)

h2. Версии Redmine

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

h2. Установка

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

# Создайте пустую базу данных и сопутствующих пользователя с именем 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>

RAILS_ENV=production rake redmine:load_default_data

</pre>

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

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

Пользователь, который запускает 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>