18 февраля 2013 в 15:39

Установка и настройка 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.
–12
7885
16

Комментарии (17)

+3
lair, #
В моей повседневной жизни возникла потребность использовать веб приложение для управления проектами, Redmine.

… на домашнем компьютере.

Зачем?
0
Palpatinel, #
У меня домашний ПК используется как «мини» сервер для командной работы.
0
lair, #
И еще раз: а зачем? Что, нормальных инструментов для этого нет?
0
Palpatinel, #
Redmine — вполне нормальный инструмент для управления проектами, отслеживания ошибок, wiki + интеграция с Git.

На своем опыте не так много повидал инструментов для управления проектами.
Для отслеживания ошибок в свое время использовал: RT, Mantis, Jira.
+2
lair, #
Я не про инструменты управления проектами, я про домашний ПК с клиентской ОС в качестве мини-сервера для командной работы.
0
Palpatinel, #
ОС то да, все руки не доходят заняться.

Сейчас пока Windows 7 Ultimate 64 стоит.
Но в принцепе вполне пока устраивает под работу с apache php mysql + iis mssql c# .net.
+2
lair, #
Так зачем свои проблемы на остальных переносить?
0
Palpatinel, #
Многие вопросы довольно часто возникают из перечисленных в статье на форумах, при установке на xp, 7.
Я уверен, наверняка кому то это пригодится.
0
retran, #
Зачем 1.3, когда есть 2.2.3. Зачем на винду, когда можно без танцев поставить на виртуалку с линуксом? Зачем вообще на домашний компьютер? Если уж делаете себе домашний ALM, то можно и потратиться на виртуалку в облаке.

Если вы дотнетчик — то нафига вообще городить что-то, когда есть бесплатный облачный TFS, даже с гитом?
+9
DimonZ, #
Актуальная версия Redmine на данный момент 2.2.3.

Где вы откопали это древнющее руководство под 1.3.x? И главное зачем выложили сюда?
–3
Palpatinel, #
Дело в том, что данную статью я писал еще вначале 2012 года.
Именно тогда я первый раз столкнулся с RoR и Redmine.

В то время во время установки и найстроки у меня было не мало вопросов, ответы на которые я не мог найти в рамках 1 статьи.
Именно поэтому решил записать все свои труды в doc.

По этой же статье поставил на XP Redmine 2.1.5.
Своё существование на habrahabr решил начать с добавления этой статьи.

Возможно кому то данное руководство поможет.
НЛО прилетело и опубликовало эту надпись здесь
+1
it_positive, #
А можно уложиться в 10 минут
bitnami.org/stack/redmine
0
fuCtor, #
Смотрел я те сборки, думал воспользоваться Gitorius-ом, ну либо как минимум посмотреть каков он и подходит ли. Жутко тормозная сборка, работает через Apache и так далее. На шаге создания репозитория все повисло. В итоге выбрал GitLab, который за теже 10 минут поставился на чистую Ubuntu Server 12.04 и летал.
+1
XimikS, #
Консерватор, да?)
Древнющий Redmine, откуда вытекает древнющие версии Ruby & Rails, и WinXP со вторым сервис паком.
У рельсов и так бывают иногда некоторые проблемы на Windows (в основном в сторонних гемах), а вы себе зачем-то усложнили задачу в n-цать раз.
0
Palpatinel, #
Рельсы пришлось ставить как и на XP так и на Windows 7.
Возможно я бы выбрал семейство *nix, но так же приходится работать и с C# .Net, который тоже криво компилится под *nix через Mono.
+2
markusweb, #
1ый, 2ой, 3ий, 4ый, 5ый, 6ой, 7ой, 8ой, 9ый, 10ый, ..., 2ве0ысячи13инадцатый?
За что ж вы русский язык так не любите-то?

Только зарегистрированные пользователи могут оставлять комментарии.
Войдите, пожалуйста.