Pull to refresh

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

Reading time 4 min
Views 15K

Знакомство с 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.
Tags:
Hubs:
-12
Comments 17
Comments Comments 17

Articles