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

Оригинал: Installing Redmine v.118

Установка¶

• Table of contents
• Установка
  • Требования для версии 1.1.x:
    • Опционально
  • Версии Redmine
  • Установка
  • Конфигурация логирования
  • Конфигурирование SMTP-сервера
  • Резервное копирование

Требования для версии 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

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

gem install rails -v=2.3.5

Установка Rack:

gem install rack -v=1.0.1

Примечания:
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

Опционально¶

• Бинарники системы управления версиями исходников (например svn), для просмотра репозитария (должны быть указаны в переменной PATH). Смотри Настройка репозиториев.
• RMagick (чтобы включить возможность экспорта диаграммы Ганта в png изображение)
• Ruby OpenID Library (чтобы активировать поддержку OpenID) [только в Redmine trunk / 0.9-dev] Требуется версия 2 или выше.

Версии Redmine¶

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

Установка¶

1. Получите исходный код Redmine либо загрузки упакованных релиз или просмотреть код хранилища. См. Download
2. Создайте пустую базу данных и сопутствующих пользователя с именем Redmine например
   Для MySQL:
   

   create database redmine character set utf8; 
   create user 'redmine'@'localhost' identified by 'my_password'; 
   grant all privileges on redmine.* to 'redmine'@'localhost';
   

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

   production: 
   adapter: mysql 
   database: redmine 
   host: localhost 
   username: redmine 
   password: my_password
   

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

   production: 
   adapter: mysql 
   database: redmine 
   host: localhost 
   port: 3307
   username: redmine 
   password: my_password
   

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

   rake generate_session_store
   

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

   RAILS_ENV=production rake db:migrate
   

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

   Rake aborted!
   no such file to load -- net/https
   

   
   вам необходимо установить libopenssl-ruby1.8, в Ubuntu выполните: pt-get install libopenssl-ruby1.8
6. Установите в базу данных конфигурацию по умолчанию, выполнив следующую команду:
   

   RAILS_ENV=production rake redmine:load_default_data
   

   
   Это загрузит по умолчанию роли, трекеры, статусы, рабочие процессы и перечисления. Этот шаг является необязательным, так как вы можете создать свою собственныю конфигурацию с нуля, но рекомендуется к выполнению.
7. Настройка разрешений
   Пользователи Windows могут пропустить этот шаг.
   Пользователь, который запускает Redmine должны иметь разрешение на запись в следующие подкаталоги: files , log , tmp (создайте последний, если его нет).
   Предполагается, что вы запустили Redmine от пользователя redmine:
   

   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
   

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

   ruby script/server webrick -e production
   

   
   После старта WEBrick, откройте в браузере http://localhost:3000/. Теперь вы должны увидеть страницу приветствия приложения.
9. Используйте учетную запись администратора по умолчанию, чтобы войти:
• Логин: admin
• Пароль: admin

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

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

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

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

#Logger.new(PATH,NUM_FILES_TO_ROTATE,FILE_SIZE)
config.logger = Logger.new(config.log_path, 2, 1000000)
config.logger.level = Logger::INFO

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

Скопировать config/email.yml.example в config/email.yml и отредактировать этот файл.
См. пример Настройка почты
Не забудьте перезапустить приложение после любого изменения.

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

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

• данные (хранящиеся в базе данных Redmine)
• вложения (хранится в директории files вашей установки Redmine)

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

# База данных 
/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