Redmine

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

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

h1. Установка Redmine

{{>toc}}

h2. Требования

h3. Операционная система

Redmine должен работать на Unix, Linux, [[RedmineInstallOSX|Mac]], [[RedmineInstallOSXServer|Mac Server]] and Windows поскольку Ruby доступен для этих платформ. Конкретные инструкции доступны здесь [[RusHowTos|тут]].

h3. Ruby & Ruby on Rails & Rack

|_=.версия Redmine|_=.Поддерживаемая 

                    версия Ruby     |_=.Необходимая

                                     версия Rails  |_=.Необходимая

                                                     версия Rack |

|текущий

 транк          |/9.ruby 1.8.6,1.8.7|Rails 2.3.11   |Rack 1.1.1   |

|транк с

 r2887 по r4903                     |Rails 2.3.5    |Rack 1.0.1   |  

|транк с

 r2493 по r2286                     |Rails 2.2.2    |             |

|транк до r2493                     |Rails 2.1.2    |             |

|1.2.x                              |Rails 2.3.11   |Rack 1.1.1   |

|1.1.x                              |/3. Rails 2.3.5|/3.Rack 1.0.1|

|1.0.x                              |

|0.9.x                              |

|0.8.x                              |Rails 2.1.2    |             |

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

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

<pre>

gem install rails -v=2.3.11

</pre>

Установка Rack:

<pre>

gem install rack -v=1.1.0

</pre>

h3. Примечания о совместимости:

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

* Требуется RubyGems 1.3.7 или выше со следующими ограничениями:

** *Rails 2.3.5 не будет работать с RubyGems 1.5.0 и выше*, придерживайтесь предыдущих версий RubyGems

** *Rails 2.3.11 не будет работать с RubyGems 1.7.0 и выше*, придерживайтесь предыдущих версий RubyGems

* *Требуется Rake 0.8.7* (Rails пока не поддерживает rake 0.9.x)

* *Требуется Rack 1.1.x*, 1.1.0 содержит ошибку с кавычками(#8416). Миграция базы данных не будет работать с другими версиями.

* *Mongrel 1.1.5 требует патча* прикреплённого к #7688 для нормальной работы с Rails 2.3.11. В случае обновления другие ошибки могут появляется после миграции (#7857).

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

h3. База данных

* MySQL 5.0 и выше (рекомендуется)

** установите C биндинги для Ruby, которые существенно улучшают производительность. Вы можете получить их запустив @gem install mysql@. Если у вас возникают проблемы с установкой mysql гема обратитесь к "Rails Wiki pages":http://wiki.rubyonrails.org/database-support/mysql

* PostgresSQL

** убедитесь, что ваш стиль даты установлен в ISO (настройка по-умолчанию для Postgres). Вы можете установить ее используя: @ALTER DATABASE "redmine_db" SET datestyle="ISO,MDY";@

** некоторые ошибки в PostgreSQL 8.4.0 и 8.4.1 вызывают ошибки в Redmine(#4259, #4314), они исправлены в PostgreSQL 8.4.2

** установите PostgreSQL адаптер для Ruby. Вы можете получить его, запустив(выберите *один* вариант из списка):

*** @gem install postgres-pr@ (нативная Ruby реализация больше активно не сопровождается автором, вызывает "ошибки":https://github.com/mneumann/postgres-pr/issues#issue/4 с 9.x)

*** @gem install pg@ (работает с SSL подключениями, может требовать пакетов/библиотек разработчика для вашей ОС для компиляции)

**** Ubuntu: библиотеки разработчика могут быть установлены с помощью: @sudo aptitude install libdbd-pg-ruby1.8@

* SQLite 3

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

* Бинарники системы управления исходным кодом (SCM) (например svn), для просмотра хранилища(должны быть доступны в PATH). Прочитайте[[RusRedmineRepositories|хранилища Redmine]] для получения информации о совместимости и требованиях.

* "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 и не сможете идти в ногу с изменениями - время от времени транк ломается.

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>

Для версий MySQL до 5.0.2 вмести @create user@ используйте:

<pre><code class="sql">

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

</code></pre>

Для PostgreSQL:

<pre><code class="sql">

CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'my_password' NOINHERIT VALID UNTIL 'infinity';

CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine;

</code></pre>

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

Пример для базы данных 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>

Пример для PostgreSQL (порт по-умолчанию):

<pre>

production:

  adapter: postgresql

  database: <your_database_name>

  host: <postgres_host>

  username: <postgres_user>

  password: <postgres_user_password>

  encoding: utf8

  schema_search_path: <database_schema> (default - public)

</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 выполните: @apt-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/. Теперь вы должны увидеть страницу приветствия приложения.

> Примечание: Webrick не подходит для нормальной эксплуатации, пожалуйста, используйте WEBrick только для тестирования установки. Не рекомендуется использовать webrick ни для чего кроме разработки. Используйте одно из многих руководств в этой вики для настройки passenger(также известного как mod_rails) или mongrel для обслуживания вашего redmine. 

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

* Логин: admin

* Пароль: admin

Теперь вы можете посетить раздел _Admin&Settings_(Администрирование) для изменения настроек приложения.

h1. Настройка

Начиная с версии "1.2.0":http://www.redmine.org/projects/redmine/versions/27, настройки Redmine определяются в файле config/configuration.yml.

Если вам необходимо изменить настройки по-умолчанию, просто скопируйте config/configuration.yml.example в config/configuration.yml и отредактируйте новый файл. Этот файл хорошо прокоментирован, так что смотрите его.

Эти настройки могут быть определены для каждого окружения Rails (production/development/test).

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

h2. Email / SMTP-сервер

Настройка email описана на [[RusEmailConfiguration|отдельной странице]].

h2. Настройки системы управления исходным кодом (SCM)

Эта секция настроек позволяет вам:

* изменить имена команд по-умолчанию, если бинарники SCM в PATH используют нестандартные имена (Windows .bat/.cmd не работают)

* определить полный путь к бинарникам

Пример(для Subversion):

Переопределение имени команды:

<pre>

scm_subversion_command: "svn_replacement.exe"

</pre>Абсолютный путь:

<pre>

scm_subversion_command: "C:\Program Files\Subversion\bin\svn.exe"

</pre>

h2. Настройка хранилища вложений(файлы которые загружаются в систему)

Вы можете задать путь, где Redmine будет хранить вложения, который отличается от стандартного 'files', используя параметр @attachments_storage_path@.

Примеры:

<pre>

attachments_storage_path: /var/redmine/files

</pre><pre>

attachments_storage_path: D:/redmine/files

</pre>

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

По-умолчанию в Redmine уровень журналирования :info (информация). В зависимости от использования сайта, лог может сильно вырасти. Чтобы это избежать, необходимо его ротировать, либо с помощью системной утилиты @logrotate@, либо через файл @сonfig/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>

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

Резервная копия 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>

h1. Замечания по установке на Windows

Получите и установите rubyinstaller с http://rubyforge.org/. Из меню "Пуск" выберите _Start Command Promt with Ruby_.

В командной строке следуйте следующим инструкциям.

Команды:<pre>

RAILS_ENV=production rake db:migrate

RAILS_ENV=production rake redmine:load_default_data

</pre>измените на:<pre>

set RAILS_ENV=production

rake db:migrate

rake redmine:load_default_data

</pre>Вам может понадобиться установить gem mysql с помощью команды:

<pre>

gem install mysql

</pre>В некоторых случаях необходимо скопировать libmysql.dll в вашу директорию ruby/bin. Не все libmysql.dll подходят, эта похоже работает http://instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQL.dll

h1. Альтернатива ручной установке

Некоторые пользователи предпочитают пропустить ручную установку и использовать один из "сторонних пакетов Redmine":http://www.redmine.org/projects/redmine/wiki/Download#Third-party-Redmine-bundles со страницы загрузки.