Project

General

Profile

Actions
History

RusRedmineInstall » History » Revision 10

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

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

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

Установка Redmine

Требования

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

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

Ruby & Ruby on Rails & Rack

версия Redmine Поддерживаемая
версия Ruby 		Необходимая
версия Rails 		Необходимая
версия Rack
текущий
транк 		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 только для тестирования установки. Не рекомендуется использовать webrick ни для чего кроме разработки. Используйте одно из многих руководств в этой вики для настройки passenger(также известного как mod_rails) или mongrel для обслуживания вашего redmine.

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

Настройка

Начиная с версии 1.2.0, настройки Redmine определяются в файле config/configuration.yml.

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

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

Email / SMTP-сервер

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

Настройки SCM

Эта секция настроек позволяет вам:
  • изменить имена команд по-умолчанию, если бинарники SCM в PATH используют нестандартные имена (Windows .bat/.cmd не работают)
  • определить полный путь к бинарникам
    Пример(для Subversion):
    Переопределение имени команды:
    scm_subversion_command: "svn_replacement.exe"
    Абсолютный путь:
    scm_subversion_command: "C:\Program Files\Subversion\bin\svn.exe"

Настройка хранилища вложений

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

attachments_storage_path: /var/redmine/files

attachments_storage_path: D:/redmine/files

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

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

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

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

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

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

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

Команды:

RAILS_ENV=production rake db:migrate
RAILS_ENV=production rake redmine:load_default_data
измените на:
set RAILS_ENV=production
rake db:migrate
rake redmine:load_default_data
Вам может понадобиться установить gem mysql с помощью команды:
gem install mysql
В некоторых случаях необходимо скопировать libmysql.dll в вашу директорию ruby/bin. Не все libmysql.dll подходят, эта похоже работает http://instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQL.dll

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

Некоторые пользователи предпочитают пропустить ручную установку и использовать один из сторонних пакетов Redmine со страницы загрузки.

Updated by Andrey Polyakov over 13 years ago · 10 revisions