Установка и настройка Redmine 1.3.0 на Windows XP SP2 / Windows 7

Знакомство с Ruby on Rails (RoR)

В моей повседневной жизни возникла потребность использовать веб приложение для управления проектами, Redmine. Так как на своем домашнем ПК я использую ОС Windows XP SP2, предполагал ряд проблем с установкой и настройкой Redmine. В общем то так оно и получилось.

Убив от 5 до 6 часов на поиск документации по установке и исправлении ошибок, у меня все таки получилось увидеть в своем браузере интерфейс Redmine *СЧАСТЬЕ*.

В статье я постараюсь рассказать вам о установке и настройки всех необходимых компонентов для использования Redmine на ОС Windows XP SP2 / Windows 7. Начнем с терминов и названий.

Что такое Ruby?

Ruby – высокоуровневый язык программирования для объектно-ориентированного программирования.

Что такое Rails (RoR)?

Попросту говоря это Framework разработанный на Ruby, это как Zend Framework на PHP.

Что такое Gem?

В статье мы не раз увидим это слово. Gem – это менеджер пакетов для Ruby, т.е. с помощью него мы устанавливаем, обновляем нужные нам компоненты для Ruby.

Со всеми последующими терминами Вы можете ознакомиться в википедии.

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

Начнем по порядку.

1ый этап (Установка Ruby и Redmine)

Для начала нам необходимо установить Ruby, но не спешите! Вся эта связка Ruby + Ruby on Rails очень капризна к версиям компонентов. Поэтому для начала необходимо посмотреть и определиться какую версию Redmine мы будем использовать. Таблицу совместимости можно посмотреть на www.redmine.org/projects/redmine/wiki/RedmineInstall

В этой статье будет рассмотрена установка Redmine 1.3.*. Поэтому для неё мы будем использовать Ruby 1.8.7, Rails 2.3.14. В таблице также указаны дополнительные версии компонентов, которые необходимы для правильной работы Redmine (rack и rubygems).

Скачиваем Ruby 1.8.7 с rubyinstaller.org/downloads/
Во время установки указываем путь C:\Ruby\ и не забываем, поставить галочку «Add Ruby executables to your Path». Установка завершена.

Теперь надо скачать Redmine 1.3.0 c rubyforge.org/frs/?group_id=1850
Создаем директорию apps в C:\Ruby\. В ней будут находится наши приложения. Переносим архив с Redmine в C:\Ruby\apps\. Извлекаем в текущую папку и переименуем redmine-1.3.0 в redmine. Итого получаем установленный Ruby и распакованный фреймворк в C:\Ruby\apps\redmine\.

2ой этап (Установка Rails)

Теперь нам необходимо установить фреймворк Ruby on Rails (RoR) для Redmine. Незабываем, что нам нужна версия 2.3.14, поэтому при установки мы явно указываем версию. Пуск -> Выполнить -> cmd, открыли командную строку. Выполняем команды:

cd C:\ gem install rails –v=2.3.14 

После установки Вы можете просмотреть список установленных пакетов и их версии. Команда:

cd C:\ gem list 

В ОС Windows 7 возникла ошибка при данных командах связанная с путями. Решается она довольно просто. Открываем C:\Ruby\bin\gem.bat в редакторе и изменяем:

@ECHO OFF SET _HOMEDRIVE=%HOMEDRIVE% SET _HOMEPATH=%HOMEPATH% SET HOMEDRIVE=C: SET HOMEPATH=Ruby IF NOT "%~f0" == "~f0" GOTO :WinNT @"ruby.exe" "C:/Ruby/bin/gem" %1 %2 %3 %4 %5 %6 %7 %8 %9 GOTO :EOF :WinNT @"ruby.exe" "%~dpn0" %* SET HOMEDRIVE=%_HOMEDRIVE% SET HOMEPATH=%_HOMEPATH% 

После выполняем вышеперечисленные команды.

3ий этап (Установка Rack)

Что такое Rack? Честно говоря без понятия. Где то вычитал, что он служит для обеспечения взаимодействия между веб серверами. В таблицы совместимости на сайте Redmine для версии 1.3.0 требуется Rack 1.1.*. Снова устанавливаем, явно указывая версию компонента:

cd C:\ gem install rack –v=1.1.0 

4ый этап (DevKit + RDoc)

Нам необходимо установить компонент rdoc, но для того, чтобы его установить надо настроить DevKit.
Скачиваем DevKit rubyinstaller.org/downloads/
Распакуем мы его в C:\Ruby\devkit\

Выполняем команды:

cd C:\Ruby\devkit\ ruby dk.rb init ruby dk.rb review ruby dk.rb install 

Если установка прошла успешно, пробуем установить RDoc:

cd C:\ gem install rdoc 

5ый этап (Возможные проблемы с rubytree)

В дальнейшем у нас могут возникнуть проблемы с компонентом rubytree. Чтобы в дальнейшем их не было, выполним команду:

cd C:\ rake gems:refresh_specs 

6ой этап (Обновление RubyGems)

В таблицы совместимости указано, что нужна версия не выше 1.7.0. Давайте обновим нашего пакетного менеджера версией 1.6.2 выполнив команду:

cd C:\ gem update –system=1.6.2 

7ой этап (MySQL)

Теперь пожалуй мы создадим базу данных Redmine и пользователя для неё:

CREATE DATABASE `redmine` CHARACTER SET UTF8; 

Создаем пользователя для Redmine:

CREATE USER 'redmine'@'localhost' IDENTIFIED BY '12345'; 

Если данный пользователь уже есть, пересоздайте его, т.е. удалите:

DROP USER ‘redmine’@’localhost’; 

Выдаем все права для пользователя redmine для базы Redmine:

GRANT ALL PRIVILEGES ON redmine.* TO ‘redmine’@’localhost’; FLUSH PRIVILEGES; 

8ой этап (Настройка Redmine и Ruby для работы с MySQL)

Для работы с MySQL нам еще потребуется скачать DLL библиотеку libmySQL.dll
Скачиваем instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQL.dll
Библиотеку перемещаем в C:\Ruby\bin\

Открываем каталог C:\Ruby\apps\redmine\config\. В этом каталоге делаем копию файла database.yml.example и переименуем его в database.yml, открываем.

Настроим подключение к MySQL для production версии. Сохраняем.

production:   adapter: mysql   database: redmine   host: localhost   username: redmine   password: 12345   encoding: utf8 

Теперь нам надо установить компонент для работы с MySQL:

cd C:\ gem install mysql 

9ый этап (Создание структуры БД и внесение данных)

Выполняем команды:

cd C:\Ruby\apps\redmine\ rake generate_session_store set RAILS_ENV=production rake db:migrate rake redmine:load_default_data 

Думаю тут все понятно.

10ый этап (Наконец то)

Теперь мы можем запустить встроенный веб сервер Webrick и проверить работоспособность нашего веб приложения:

cd C:\Ruby\apps\redmine\ ruby script/server webrick –e production 

Если все прошло успешно, открываем localhost:3000/ и видим окно приветствия Redmine.
Стандартный логин и пароль для администратора: admin / admin
Для постоянной работы данный веб сервер (Webrick) использовать не рекомендуется, поэтому в следующей статье мы рассмотрим установку и настройку Mongrel.

Чтобы закрыть Webrick, в cmd жмем Ctrl + C.