Redmine установка и настройка windows

Обновлено: 02.07.2024

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

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

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

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

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

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

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) Выполянем команду

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

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

set RAILS_ENV=production
rake db:migrate
rake redmine:load_default_data

(не забываем, что это нужно делать из каталога C:\Ruby187\apps\redmine\)

13) Основной этап установки завершен. Давайте протестируем работоспособность. Выполним команду

14) Теперь время установить вебсервер mongrel в качестве Windows сервиса. Mongrel требует, чтобы сначала был установлен win32-service. Я так понимаю этот пакет позволяет взаимодействовать Ruby и Windows сервисам. Выполняем:

Параметр --platfrom=mswin32 нужен для того, чтобы установка прошла успешно, иначе, скорее всего, вы получите ошибку.

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

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 и выставляем ему автоматический режим запуска (это вы должны знать как сделать).

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

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

PPS. Если вы захотите сменить порт mongrel, то нужно сначала удалить сервис:

Данная документацию по установке Redmine 1.4.0 и выше. Вы все еще можете прочитать документ для 1.3.x здесь.

Требования¶

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

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

Ruby интерпретатор¶

Соответствие версий Ruby и версий Redmine:

Версия Redmine	Поддерживаемая версия Ruby	Необходимая версия Rails
текущий trunk	ruby 1.9.3, 2.0.0, 2.1, 2.2	Rails 4.2
3.0	ruby 1.9.3, 2.0.0, 2.1, 2.2	Rails 4.2
2.6	ruby 1.8.7, 1.9.2, 1.9.3, 2.0.0, 2.1, 2.2, jruby-1.7.6	Rails 3.2

База данных¶

Не обязательные компоненты¶

Бинарники системы управления исходным кодом (SCM) (например svn), для просмотра хранилища(должны быть доступны в PATH). Прочитайтехранилища Redmine для получения информации о совместимости и требованиях. (чтобы включить возможность экспорта диаграммы Ганта в png изображение) (чтобы активировать поддержку OpenID). Требуется версия 2 или выше.

Версии Redmine¶

Большинству пользователей рекомендуется устанавливать последние версии релизов Redmine. В настроящее время новые версии Redmine выпускаются каждые 6 месяцев, эти релизы считаются стабильными и пригодными к использованияю. Не рекомендуется устанавливать Redmine из trunc репозитария, пока если вы глубоко не изучите Ruby On Rails и не сможете идти в ногу с изменениями - время от времени транк ломается.

Установка¶

Шаг 1 - Redmine application¶

Получите исходный код Redmine, загрузив архив релиза или получив код из хранилища. См. Download.

Шаг 2 - Установка зависимостей¶

Redmine использует Bundler для управления зависимостями gems пакетов.

Вам необходимо вначале установить Bundler:

Затем вы можете установить все зависимости требующиеся Redmine. Для этого распаковываете полученный на первом шаге архив релиза в какую-нибудь папку. Делаете эту папку рабочей и устанавливаете зависимости с помощью следующей команды:

не обязательные зависимости¶

RMagick (позволяет использовать ImageMagick для работы с изображениями в при экспорте в PDF и PNG)¶

Если ImageMagick не установлен в вашей системе, вы должны пропустить установку gem-пакета rmagick используя команду:

Если у вас проблемы с установкой rmagick на Windows, посмотрите это HowTo.

Неиспользуемые адаптеры баз данных¶

Вы также можете пропустить установку адаптеров баз данных, которые вы не используете.

Например, если вы используете MySQL, вы можете пропустить установку пакетов PostgreSQL, SQLite с помощью команды:

Дополнительные зависимости ( Gemfile.local )¶

Если вам нужно загрузить gem-пакеты, которые не требуются для ядра Redmine (например, Puma, FCGI), создайте файл Gemfile.local в корневом каталог Redmine. Данный файл будет автоматически загружаться при запуске bundle install .

Создайте пустую базу данных и сопутствующего пользователя¶

Здесь для примера база данных и пользователь базы будет назван redmine , но вы его можете заменить на что-нибудь ещё.

MySQL¶

Для версий MySQL до 5.0.2 вместо шага create user используйте:

PostgreSQL¶

Шаг 4 - Настройка подключения к базе данных¶

Скопируйте файл config/database.yml.example в config/database.yml и отредактируйте этот файл так, чтобы настроить параметры базы данных для "production" окружения(реальное окружения, используемое для работы).

Пример для базы данных MySQL, использующей ruby1.8 или jruby:

Пример для базы данных MySQL, использующей ruby1.9 (адаптер должен быть установлен в mysql2 ):

Если ваш сервер не работает со стандартным портом (3306), используйте эту конфигурацию:

Пример для PostgreSQL (порт по-умолчанию):

Шаг 5 - Генерация ключа для безопасного хранения сессий¶

Этот шаг генерирует случайный ключ, используемый Rails для шифрования хранилища, содержащего данные сессий, тем самым предотвращая их фальсификацию.

Генерация нового ключа сделает недействительными все существующие сеансы после перезагрузки.

Шаг 6 - Создание структуры базы данных¶

Создайте структуру базы данных, выполнив следующую команду в корневом каталоге приложения:

Это создаст таблицы и учетную запись администратора с именем admin .

Если вы получите вот такую ошибку:

вам необходимо установить libopenssl-ruby1.8 , в Ubuntu выполните: apt-get install libopenssl-ruby1.8

Шаг 7 - Загрузка данных по умолчанию¶

Установите в базу данных конфигурацию по умолчанию, выполнив следующую команду:

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

Шаг 8 - Настройка разрешений¶

Пользователи Windows могут пропустить этот шаг.

files (хранит вложения)
log (логи приложения production.log )
tmp and tmp/pdf (создайте, если их нет. Используется для создания PDF документов).

Предполагается, что вы запустили Redmine от пользователя redmine:

Шаг 9 - Тестирование установки¶

Протестируйте установку путем запуска веб-сервера WEBrick:

для Redmine 1.4.x:

для Redmine 2.x:

для Redmine 3.x

Примечание: Webrick не подходит для нормальной эксплуатации, пожалуйста, используйте WEBrick только для тестирования установки. Не рекомендуется использовать webrick ни для чего кроме разработки. Используйте одно из многих руководств в этой вики для настройки Passenger(также известного как mod_rails ), FCGI или Rack сервер (Unicorn, Thin, Puma, hellip;) для обслуживания вашего redmine.

Используйте учетную запись администратора по умолчанию, чтобы войти:

Теперь вы можете посетить раздел Administration (Администрирование) для изменения настроек приложения.

Настройка¶

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

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

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

: Не забудьте перезапустить приложение после любого изменения.

Настройка Email / SMTP-серверов¶

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

Настройки SCM ¶

изменить имена команд по-умолчанию, если бинарники SCM в PATH используют нестандартные имена (Windows .bat/.cmd не работают)
определить полный путь к бинарникам

Переопределение имени команды:

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

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

Настройка логирования¶

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

Для использования последнего, необходимо скопировать config/additional_environment.rb.example в config/additional_environment.rb и в нем добавить следующие строки. Отметим, что по умолчанию в файле установлен высокий уровень журналирования, следовательно, должен быть явно установлен в информацию.

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

данные (хранящиеся в базе данных Redmine)
вложения (хранится в директории files вашей установки Redmine, если не настроено иное местоположение этих файлов)

Вот простой скрипт, который может быть использован для создания ежедневных резервных копий (предположим вы используете базу данных MySQL):

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

После его установки, выберите Start Command Prompt with Ruby в меню Пуск.

При выполнении команд, описанных в данном руководстве, вы должны установить переменной окружения RAILS_ENV с помощью отдельной команды.

Например команды со следующим синтаксисом:

должны быть превращены в 2-е последовательные команды:

Вам может понадобиться установить gem mysql с помощью команды:

Важное замечание для Win7 и последующих

В Win7 и последующих, запись localhost закомментирована в host-файле 1 , а IPV6 является записью по умолчанию 2 . Так как gem-пакет mysql2 не поддерживает адресацию IPV6 3 , то соединение с базой данных не может быть установлено и вы получаете ошибку " Can't connect to MySQL server on 'localhost' (10061) ".
Вы можете проверить это пропинговав localhost , если будет пинговаться "::1:", значит используется адресация IPV6.

В файле database.yml заменить localhost на 127.0.0.1 .

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

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

Redmine — открытое серверное веб-приложение для управления проектами и задачами (в том числе для отслеживания ошибок). Redmine написан на Ruby и представляет собой приложение на основе широко известного веб-фреймворка Ruby on Rails. Распространяется согласно GNU General Public License.

Функциональные возможности

Данный продукт предоставляет следующие возможности:

ведение нескольких проектов;
гибкая система доступа, основанная на ролях;
система отслеживания ошибок;
диаграммы Ганта и календарь;
ведение новостей проекта, документов и управление файлами;
оповещение об изменениях с помощью RSS-потоков и электронной почты;
вики для каждого проекта;
форумы для каждого проекта;
учёт временных затрат;
настраиваемые произвольные поля для инцидентов, временных затрат, проектов и пользователей;
лёгкая интеграция с системами управления версиями (SVN, CVS, Git, Mercurial, Bazaar и Darcs);
создание записей об ошибках на основе полученных писем;
поддержка множественной аутентификации LDAP;
возможность самостоятельной регистрации новых пользователей;
многоязыковой интерфейс (в том числе русский);
поддержка СУБД MySQL, PostgreSQL, SQLite, Oracle.

Подготовка к инсталляции.

Инсталляция.

Устанавливаем на новый сервер: папка для инсталляции по умолчанию C:\Program Files\

Проверяем, что инсталлятор работает. Запускаем в браузере по пути localhost:80, он должен открыть пустую базу, созданную по умолчанию при инсталляции.

Перенос баз.

Создаем новую пустую базу данных с именем redmine_bitnami:

Hа место этой базы восстанавливаем дамп рабочего редмайна (в database.yml должна быть указана соответствующая база в разделе production, также надо дополнительно указать строку encoding: utf8).

либо создаем файл .bat аналогичного содержания.

Так как предыдущий redmine был более старый автоматически база не заработает, поэтому необходимо произвести миграцию базы на более новую версию Redmine.

Миграция производится следующим образом:

Послеустановочная настройка.

Локальные настройки и окружение.

Настройка резервного копирования.

Создаем назначенное задание, для создания резервных копий. Проверяем резервные копии на восстанавливаемость каждую неделю вручную.

Скрип резервного копирования (backup.cmd) выглядит приблизительно следующим образом:

Скрипт к которому обращается скрипт резервного копирования backup.cmd, для именования файлов и определения путей (backup_workwars.cmd):

3 Comments

Спасибо за статью, думаю она многим поможет. Хочу поделиться RMClient для тех, кто планирует проекты с помощью Redmine. Мы разработали таймер для учета времени в системе Redmine, он доступен для скачивания после короткой регистрации. Будем очень признательны за его использование и помощь в тестировании.

Спасибо за интересный плагин. Обязательно попробую и отпишусь Вам в личку.

Подскажите а как развернуть на одной машинке две цмс, тест линк и вордпрес?

Добавить комментарий Отменить ответ

Этот сайт использует Akismet для борьбы со спамом. Узнайте, как обрабатываются ваши данные комментариев.

Прежде всего, мы должны подготовить документы, связанные с Ruby. Redmine разрабатывается на основе Ruby on rails.

Для развертывания веб-сайта обычно требуется wamp, который является средой windows + apache + mysql + php. Есть две популярные интегрированные среды, wampserver и xampp, вот и wampserver.

3. Загрузите ImageMagick, это инструмент для создания графиков. Redmine используется для создания PDF-файлов и другого контента, и его не нужно устанавливать. Когда я установил эту штуку, возникли некоторые проблемы, поэтому я не стал ее устанавливать.

После того, как установочный файл будет готов, можно приступать к установке.

1. Установите railsinstaller. Если вам не нужно выбирать каталог, просто установите его полностью.

2. Чтобы установить wamp, сначала установите среду vc2010, vcredist_x86.exe, а затем установите wamp.Если вам не нужно выбирать каталог, просто установите его полностью.

3. Разархивируйте redmine в c: \ redmine (вы можете распаковать каталог самостоятельно)

4. Установите mysql2 под ruby, вот mysql в wamp, мой wamp установлен по умолчанию, то есть он установлен в каталоге c: \ wamp, там каталог mysql - C: \ wamp \ bin \ mysql \ mysql5.6.12. Скопируйте libmysql.dll и libmysqld.dll из C: \ wamp \ bin \ mysql \ mysql5.6.12 \ lib в c: \ windows \ system32

Введите командную строку dos и введите

gem install mysql2 — ‘–with-mysql-lib=”C:\wamp\bin\mysql\mysql5.6.12\lib” –with-mysql-include=”C:\wamp\bin\mysql\mysql5.6.12\include”‘

Примечание. Здесь требуются заголовочный файл и каталог файлов библиотеки, соответствующие mysql, в противном случае установка не удастся. Введите список драгоценных камней, чтобы увидеть номер версии, соответствующий mysql2

5. Настройте базу данных Запустите wamp, а затем настройте apache, как показано на рисунке ниже.

Затем найдите конфигурацию каталога в конфигурации, найдите Allow from 127.0.0.1 и измените его на Alloc from all, как показано на рисунке ниже.

Затем измените phpmyadmin.conf в C: \ wamp \ alias, чтобы изменить

Options Indexes FollowSymLinks ExecCGI

Allow from 127.0.0.1

Allow from localhost

Измените Allow с 127.0.0.1 на Alloc from all, а затем перезапустите wamp, чтобы локальная сеть могла работать с mysql.

6. Подготовьте базу данных Redmine.

Управляйте sql в phpmyadmin

CREATE DATABASE redmine CHARACTER SET utf8;
CREATE USER ‘redmine’@‘localhost’ IDENTIFIED BY ‘my_password’;
GRANT ALL PRIVILEGES ON redmine.* TO ‘redmine’@‘localhost’;

7. Настройте базу данных Redmine.

В каталоге c: \ redmine \ config скопируйте database.yml.example в database.yml, а затем отредактируйте его для настройки.

Найдите производственный элемент и настройте его следующим образом: (поскольку все они по умолчанию, просто настройте пароль здесь)

8. Установите redmine. В командной строке dos мы вводим каталог c: \ redmine и выполняем

bundle install --without development test postgresql sqlite rmagick

Примечание: Если в процессе установки возможно, что отдельная установка не удалась из-за проблем с сетью, используйте gem install xxxxx для установки указанных.После завершения установки выполните указанную выше команду установки пакета. Пока установка не будет завершена.

Результат успешной установки выглядит следующим образом

Затем введите rake generate_secret_token, чтобы установить зашифрованное хранилище сеансов.

9. Инициализируйте базу данных redmine . В командной строке DOS введите следующую команду

Затем введите следующую команду, здесь будет установлен язык по умолчанию

Как показано на рисунке ниже, это означает завершение

10. Выполнить. В командной строке DOS введите: ruby bin / rails server webrick -e production.

Установка прошла успешно, затем в браузере введите

11. Конфигурация электронной почты:

В пути установки [D: \ redmine-3.2.2 \ redmine-3.2.2 \ config \ configuration.yml] найдите под ним «production», добавьте

Дополнительные примечания для некоторых распространенных проблем:

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

1. Установка Gem mysql2 может не быть установлена успешно из-за проблем с сетью. Просто попробуйте еще несколько раз.

2. Обычно значок сервера WAMP на панели задач должен быть зеленым. В противном случае возможно, что некоторые службы не открылись. Наиболее частая вероятность того, что конфликты порта 80 приводят к тому, что служба apache не запускается. Ситуация, с которой я столкнулся, была связана с тем, что я ранее установил xamp, поэтому два apache конфликтуют. После удаления xamp это нормально. Если вы хотите удалить xamp, вам необходимо закрыть все связанные службы.

3. По умолчанию в mysql пароль отсутствует. Вы можете войти в консоль mysql, а затем использовать инструкцию sql для изменения пароля

mysql> use mysql;
mysql> UPDATE user SET Password = PASSWORD(‘123456’) WHERE user = ‘root’;
mysql> FLUSH PRIVILEGES;

, где 123456 - новый пароль. Обратите внимание, что нельзя пропускать точку с запятой в конце оператора sql. И выполнение SQL может завершиться ошибкой, поэтому попробуйте несколько раз.

Добавить к этому

$cfg[‘Servers’][$i][‘AllowNoPassword’] = false;
$ cfg [‘Servers’] [$ i] [‘user’] = ‘root’; // Пользователь MySQL Имя пользователя mysql, используемое для доступа к phpmyadmin
$ cfg [‘Servers’] [$ i] [‘password’] = ‘123456’; // Пароль MySQL (необходим только соответствует паролю указанного выше имени пользователя mysql

5. Путь к файлу конфигурации пароля для входа в систему Redmine: .

production:
adapter: mysql2
database: redmine
host: localhost
username: root
password: 123456
encoding: utf8

Поскольку мы используем продакшн, достаточно позаботиться только об этом. Это соответствует шагу 9 выше, инициализируйте базу данных redmine. Если вы не видите базу данных redmine в phpMyAdmin, здесь проблема.

6. Развертывание завершено, и к нему можно получить доступ в обычном режиме. Учетная запись администратора и пароль по умолчанию - admin. Все вновь созданные учетные записи должны быть активированы учетной записью администратора для нормального использования.

Читайте также: