Project

General

Profile

Actions
History

RusRedmineInstall » History » Revision 5

« Previous | Revision 5/18 (diff) | Next »
Andrey Polyakov, 2011-08-05 11:10

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

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

Установка Redmine

Требования

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

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

Ruby & Ruby on Rails & Rack
Redmine version Supported
Ruby versions 		Required
Rails version 		Required
Rack version
текущий
транк 		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 Rails 2.3.5 Rack 1.0.1
1.0.x
0.9.x
0.8.x Rails 2.1.2

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

gem install rails -v=2.3.11

Установка Rack:

gem install rack -v=1.1.0

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

  • 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

База данных

  • MySQL 5.0 и выше (рекомендуется)
    • установите C биндинги для Ruby, которые существенно улучшают производительность. Вы можете получить их запустив gem install mysql. Если у вас возникают проблемы с установкой mysql гема обратитесь к Rails Wiki pages
  • 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 реализация больше активно не сопровождается автором, вызывает ошибки с 9.x)
      • gem install pg (работает с SSL подключениями, может требовать пакетов/библиотек разработчика для вашей ОС для компиляции)
        • Ubuntu: библиотеки разработчика могут быть установлены с помощью: sudo aptitude install libdbd-pg-ruby1.8
  • SQLite 3

Опционально

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

Версии Redmine

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

Установка

  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';

    Для версий MySQL до 5.0.2 вмести create user используйте:
    grant all privileges on redmine.* to 'redmine'@'localhost' identified by 'my_password';

    Для PostgreSQL:
    CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'my_password' NOINHERIT VALID UNTIL 'infinity';
CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine;
  3. Скопировать config/database.yml.example в config/database.yml и отредактировать этот файл для того, чтобы настроить параметры базы данных для "production(реальное окружения, используемое для работы)" окружения.
    Пример для базы данных 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

    Пример для PostgreSQL (порт по-умолчанию):
    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)
  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 выполните: apt-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/. Теперь вы должны увидеть страницу приветствия приложения.

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

  1. Используйте учетную запись администратора по умолчанию, чтобы войти:
    • Логин: admin
    • Пароль: admin
      Теперь вы можете посетить раздел Admin&Settings(Администрирование) для изменения настроек приложения.

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

По умолчанию в 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

Updated by Andrey Polyakov over 13 years ago · 5 revisions