?

Log in

No account? Create an account

Previous Entry | Next Entry

Установка RedMine на Windows

Решил сегодня установить RedMine. Кто не знает - это web система управления проектами. Т.е. в систему добавляются проекты, по каждому проекту ведется учет задач (запросов на новые фичи, исправление багов), есть форум, wiki, план разработки, можно прилагать различную документацию и файлы.
Поставить и заставить все работать у меня получилось с 3-го или 4-го раза. Позже, поискав в интернете, я увидел, что я не один такой, что некоторые мучаются аж по неделе :), другие просто забивают, так и не добившись работоспособности. Я также пробовал пакетный инсталлятор от Bitnami, который по задумке должен был сделать все за меня, но на деле не получилось (сначала он вис, потом, когда я разобрался с зависанием, то были ошибки при установке mysql и т.д.).
Потратив 3 часа, я решил поделиться опытом и написать пошаговую инструкцию по установке Redmine на Windows.

Итак, приступим.

1) Так как Redmine написан на Ruby on Rails, то сначала нам нужно установить Ruby. Текущая версия Ruby - 1.9.2, а текущая версия Redmine 1.0.1 не работает c Ruby 1.9, поэтому на данный момент (я ж не знаю, может вы читаете эту статью уже в 2012-м и таких проблем уже нет :) ) нужно устанавливать Ruby 1.8.7.
Скачать его можно здесь: http://rubyinstaller.org/downloads/
или здесь: http://bazanov.net/rubyinstaller-1.8.7-p302.exe
Скачиваем и устанавливаем. При установке не забываем поставить галочку "Add Ruby executables to your PATH". Я устанавливал Ruby в каталог предложенный по умолчанию - C:\Ruby187\, поэтому в дальнейшем будем предполагать, что Ruby находится в этом каталоге.

2) В каталоге C:\Ruby187\ создаем каталог apps (т.е. в этом каталоге будут приложения, написанные на Ruby), в apps создаем каталог redmine и копируем в него содержимое архива с redmine, который вы качаете здесь: http://rubyforge.org/frs/download.php/72200/redmine-1.0.1.zip или здесь: http://bazanov.net/redmine-1.0.1.zip

3) Следующие команды необходимо будет выполнять из каталога C:\Ruby187\apps\redmine\, иначе вы столкнетесь с проблемами на следующих этапах. Поэтому запустите командную строку (cmd) и перейдите в указанный каталог:
cd C:\Ruby187\apps\redmine

4) Теперь необходимо установить Ruby on Rails фреймворк. Версия Redmine 1.0.1 требует Ruby on Rails 2.3.5, поэтому при установке явно укажем версию. Итак, в командой строке выполняем:
gem install rails -v=2.3.5

5) Теперь нужно установить Rack (для обеспечения взаимодействия между веб серверами, поддерживающими Ruby, и различными Ruby фреймворками). Опять же, явно указываем версию 1.0.1:
gem install rack -v=1.0.1

6) Устанавливаем веб-сервер Mongrel, который будет непосредственно обрабатывать http запросы и позволять нам работать с Redmine в браузере:
gem install mongrel

7) На данный момент у вас должен быть установлен MySql Server. Его установку я описывать не буду, скажу лишь, что лично у меня установлен MySql Server 5.1.47.

8) Создаем базу данных MySql, в которой RedMine будет хранить свои данные, и пользователя, под которым будет осуществляться доступ к этой базе:
create database redmine character set utf8;
create user 'redmine'@'localhost' identified by 'my_password';
grant all privileges on redmine.* to 'redmine'@'localhost';

9) В каталоге redmine/config копируем (или переименовываем) файл database.yml.example в файл database.yml и правим его, указав соответствующие параметры доступа к БД в production и development конфигурациях (по умолчанию нужно просто написать пароль, который вы указали на предыдущем шаге).

10) Выполянем команду
gem install mysql
(без этого у меня были проблемы с выполнением какого-то из следующих шагов)

11) Выполняем команду
rake generate_session_store

12) Выполняем команды
set RAILS_ENV=production
rake db:migrate
rake redmine:load_default_data
(не забываем, что это нужно делать из каталога C:\Ruby187\apps\redmine\)

13) Основной этап установки завершен. Давайте протестируем работоспособность. Выполним команду
ruby script/server webrick -e production
Это запустит вебсервер webrick. Его не рекомендуется использовать для постоянной работы, но так как он очень просто запускается, то его можно использовать чтобы протестировать правильную установку и работу Redmine. Теперь в браузере вводим http://localhost:3000 (3000 - это порт по умолчанию), после чего вы должны увидеть окно приветствия Redmine. Я увидел. Если вы - нет, то значит возникла ошибка на одном из предыдущих этапов. По умолчанию логин и пароль - admin, можете залогиниться и оглядеться. Проверили работоспособность redmine, закрываем webrick (т.е. закрываем консольное окно или жмём там CTRL+C).

14) Теперь время установить вебсервер mongrel в качестве Windows сервиса. Mongrel требует, чтобы сначала был установлен win32-service. Я так понимаю этот пакет позволяет взаимодействовать Ruby и Windows сервисам. Выполняем:
gem install win32-service --platform=mswin32
Параметр --platfrom=mswin32 нужен для того, чтобы установка прошла успешно, иначе, скорее всего, вы получите ошибку.

14) Устанавливаем пакет mongrel_service, для того чтобы mongrel мог работать в качестве Windows сервиса:
gem install mongrel_service --platform=mswin32

15) Устанавливаем mongrel в качестве Windows сервиса с именем Redmine:
mongrel_rails service::install -N Redmine -c C:\Ruby187\apps\redmine\ -p 3000 -e production
Как видите, я использовал порт 3000, т.к. стандартный порт 80 у меня уже занят, вы же можете использовать 80-й порт, чтобы не нужно было потом явно его указывать в адресной строке браузера.

16) Запускаем windows сервис Redmine и выставляем ему автоматический режим запуска (это вы должны знать как сделать).

17) Набираем http://localhost:3000 (или просто http://localhost если вы указали 80-й порт) и видим страницу привествия Redmine. По крайней мере должны видеть :)

Ну вот вроде и все. Надеюсь у вас все получилось!

PS. Сменить пароль администратора можно в меню Administration -> Users.

PPS. Если вы захотите сменить порт mongrel, то нужно сначала удалить сервис:
mongrel_rails service::remove -N Redmine
а потом добавить его заново, указав другой порт:
mongrel_rails service::install -N Redmine -c C:\Ruby187\apps\redmine\ -p 8080 -e production

Comments

( 27 comments — Leave a comment )
adontz
Aug. 25th, 2010 07:45 pm (UTC)
Было бы действительно круто прикрутить всё это к 64битному апачу. Ну это я так, о своём.
funbit
Aug. 26th, 2010 12:56 am (UTC)
Спасибо за инструкцию, авось пригодится в ближайшем будущем. Я устанавливал его год назад, но к сожалению не записал последовательно действий, и сейчас вряд ли повторю :) А Bitnami у меня заработал без проблем, правда на Windows 2008 не встал, только на 2003..
ext_281599
Oct. 11th, 2010 05:52 pm (UTC)
Q!Project
А я воспользовался Q!Project и развернул redmine на своей машине за несколько минут.
nightcoder
Oct. 11th, 2010 10:52 pm (UTC)
Re: Q!Project
Спасибо за информацию, надо будет глянуть, хотя смущает что проект уже почти год не обновлялся.
wolfyk
Oct. 26th, 2010 08:44 pm (UTC)
Re: Q!Project
Да, удалось за несколько минут поставить! Клевая штука!
nicxxx
Nov. 28th, 2010 02:43 am (UTC)
Re: Q!Project
но в Q!Project версия redmine старая, 0.8.6, а сейчас есть уже 1.0.3
stanleyuz
Nov. 15th, 2010 09:28 pm (UTC)
meeriez

Статья написана на должном уровне, пишите ещё.
Dmitriy Averin
Jun. 29th, 2011 07:53 pm (UTC)
ChiliProject 2.0.0RC3
Подскажите, пожалуйста, как установить ChiliProject 2.0.0RC3 на XP
У меня случился затык на шаге 12 этой инструкции ( я чиди ставил, не редмайн). Заранее спасибо!

gogy76
Jul. 6th, 2011 10:59 am (UTC)
при выполнении команды
rake db:migrate
может возникнуть ошибка undefined local variable or method `version_requirements' for #

советуют вставить в enviroment.rb между
bootstrap и initialize секциями следующий код

if Gem::VERSION >= "1.3.6"
module Rails
class GemDependency
def requirement
r = super
(r == Gem::Requirement.default) ? nil : r
end
end
end
end

при установке сервисов можно опустить --platform=mswin32
тогда может заработать в случае ошибки
adelven
Jul. 10th, 2011 05:49 pm (UTC)
вопрос от чайника
при установке мускуля:
Successfully installed mysql-2.8.1-x86-mingw32
1 gem installed
Installing ri documentation for mysql-2.8.1-x86-mingw32...
No definition for next_result
No definition for field_name
No definition for field_table...
...и еще две простыни в таком же роде
соответственно, после внесения вышеозначенного кода появилась системная ошибка ruby:
Запуск программы невозможен, так как на компьютере отсутствует LIBMYSQL.dll.

p.s. прошу меня простить за возможный спам о комментариях...
adelven
Jul. 10th, 2011 05:58 pm (UTC)
mysqlnd 5.0.7 от денвера
gogy76
Jul. 11th, 2011 07:38 am (UTC)
Я не ставил мускл, он был установлен заранее.
Все остальное я делал по инструкции
adelven
Jul. 11th, 2011 07:49 am (UTC)
под установкой мускуля я подразумеваю шаг 10:
gem install mysql
gogy76
Jul. 11th, 2011 08:15 am (UTC)
прошло все без проблем :(
Alexander Bondarchuk
Aug. 9th, 2011 08:57 pm (UTC)
Re: вопрос от чайника
У меня такая же проблема.
Ставил MySQL 5.1.58, другой версии (более старой, как указано в инструкции) на официальном сайте не нашел.
На следующем шаге №11 ошибка:

c:\Ruby187\apps\redmine>rake generate_session_store
NOTE: SourceIndex.new(hash) is deprecated; From c:/Ruby187/apps/redmine/config/.
./vendor/rails/railties/lib/rails/vendor_gem_source_index.rb:100:in `new'.
rake/rdoctask is deprecated. Use rdoc/task instead (in RDoc 2.4.2+)
rake aborted!
uninitialized constant ActiveSupport::Dependencies::Mutex

(See full trace by running task with --trace)


Как это можно вылечить?
Alexander Bondarchuk
Aug. 9th, 2011 09:22 pm (UTC)
Re: вопрос от чайника
Может быть как-то связано с тем, что ставлю на win-сервер 2008 64-разрядный ?
flash flash
Jul. 19th, 2011 09:40 am (UTC)
не учли прокси - тогда gems не ставятся.
Денис Виртилецкий
Jul. 23rd, 2011 01:26 am (UTC)
Если при выполнении пункта 14 (gem install win32-service --platform=mswin32) появляется ошибка вроде этой:
C:\Ruby187\apps\redmine>gem install win32-service
ERROR: Error installing win32-service:
The 'win32-service' native gem requires installed build too

Please update your PATH to include build tools or download the DevK
from 'http://rubyinstaller.org/downloads' and follow the instructio
at 'http://github.com/oneclick/rubyinstaller/wiki/Development-Kit'

То требуется сделать следующее:
1. скачать DevKit-tdm-32-4.5.2-20110712-1620-sfx.exe
2. Распоковать в корневую директорию с Ruby (у меня она была C:\Ruby187) DevKit, чтобы получилось C:\Ruby187\DevKit

Затем, перейти в командной строке в директорию cd C:\Ruby187\DevKit
и набрать следующие команды:

C:\Ruby187\DevKit> ruby dk.rb
У Вас создасться файл config.yml

C:\Ruby187\DevKit> ruby dk.rb review
[не обязательно] это проверка того, правильно ли создался файл config.yml

C:\Ruby187\DevKit> ruby dk.rb install --force
И наконец обновление или установка devkit.rb, если сделали правильно, то должен появиться файл devkit.rb в директории C:\Ruby187\lib\ruby\site_ruby\devkit.rb

Теперь заново переходим в каталог с Redmine, набрав команду:
cd C:\Ruby187\apps\redmine

И заново приступаем к ведению команды:
C:\Ruby187\apps\redmine>gem install win32-service

У меня таким образом удалось решить проблему, надеюсь и у кого-то тоже получиться ;)
Денис Виртилецкий
Jul. 23rd, 2011 09:53 am (UTC)
Да немного не точно написал)
На шаге:
C:\Ruby187\DevKit> ruby dk.rb
У Вас создасться файл config.yml

Нужно указать команду:
ruby dk.rb init

Только после этого создастся нужный нам config.yml файл
alfa_ulsk
Aug. 9th, 2011 02:21 pm (UTC)
Большое спасибо! Пригодилось!
Alexander Bondarchuk
Aug. 10th, 2011 02:16 pm (UTC)
Парни, по вот этой инструкции поставил чистый Redmine:
http://www.redmine.org/projects/redmine/wiki/HowTo_Install_Redmine_in_a_sub-URI_on_Windows_with_Apache

Было несколько подводных камней, но с помощью гугла и упорства все решилось.

Если будут вопросы - пишите, будем пробовать вместе раозбраться.
zaezoezu
Oct. 19th, 2011 10:01 am (UTC)
а если другой сервер?
большое спасибо за статью, но вот проблемка - с "вебриком" все работает, а под "монгрелом" при попытке входа под логином выдается ошибка "о каком-то не существующем методе объекта"; а вообще стоит апач - как бы под него настроить редмейн?
anacrionus
Dec. 23rd, 2011 05:48 am (UTC)
confiiguration.yml
никак не могу настроить уведомление на Е-майл.
редактирую файл installdir/apps/redmine/config/configuration.yml
после редактирование, в настройках программы вижу: араметры работы с почтовым сервером не настроены и функция уведомления по email не активна.

где могут быть логи или ещё чего... ощущение, что я правлю это файл что нет.....
Андрей Буслов
Apr. 17th, 2012 06:36 pm (UTC)
как подключаться пользователям к базе данных Redmine?
Подскажите, как подключаться пользователям к базе данных Redmine?
wirudo_farucono
Dec. 5th, 2012 12:49 pm (UTC)
Пробую ставить версию 2.1.4 на Win 7 x64
Возникает постоянная ошибка со всеми командами rake:
←[31mCould not find gem 'rmagick (>= 2.0.0) x86-mingw32' in the gems available on this machine.←[0m

Как я понимаю, он хочет 32-х битную версию rmagick, и потенциально из за этого ничего не ставится.
Как с этим бороться, и правильны ли мои предположения?
Спасибо.

З.Ы. С Ruby раньше дела не имел, потому больно не пинайте.
Никита Сотников
Apr. 17th, 2013 04:35 am (UTC)
error
при выполнении gem install rails -v=2.3.5 ругается на gem: gem не являетсявнутренней или внешней командой, исполняемой программой или пакетным файлом. В командной строке запускал эту команду из C:\Ruby187\apps\redmine
pmomptlauu48
Jan. 7th, 2014 03:27 am (UTC)
:)
Текст перспективный, добавлю сайт в закладки.
( 27 comments — Leave a comment )