Как установить redmine на windows

Руководство->Руководство по установке

Оригинал: Installing Redmine v.196

  • Table of contents
  • Установка Redmine
    • Требования
      • Операционная система
      • Ruby интерпретатор
      • База данных
      • Не обязательные компоненты
    • Версии Redmine
    • Установка
      • Шаг 1 — Redmine application
      • Шаг 2 — Установка зависимостей
        • не обязательные зависимости
        • Дополнительные зависимости (Gemfile.local)
      • Создайте пустую базу данных и сопутствующего пользователя
        • MySQL
        • PostgreSQL
      • Шаг 4 — Настройка подключения к базе данных
      • Шаг 5 — Генерация ключа для безопасного хранения сессий
      • Шаг 6 — Создание структуры базы данных
      • Шаг 7 — Загрузка данных по умолчанию
      • Шаг 8 — Настройка разрешений
      • Шаг 9 — Тестирование установки
      • Шаг 10 — Вход в приложение
    • Настройка
      • Настройка Email / SMTP-серверов
    • Настройки SCM
      • Настройка хранилища вложений
    • Настройка логирования
    • Резервное копирование
    • Замечания по установке на Windows
    • Альтернатива ручной установке

Данная документацию по установке 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

База данных¶

  • MySQL 5.0 и выше (рекомендуется)
    • установите C биндинги для Ruby, которые существенно улучшают производительность. Вы можете получить их запустив gem install mysql2.
  • PostgresSQL 8.2 или выше
    • убедитесь, что тип данных установлен в ISO (настройка по-умолчанию для Postgres). Вы можете установить ее используя: ALTER DATABASE "redmine_db" SET datestyle="ISO,MDY";
    • некоторые ошибки в PostgreSQL 8.4.0 и 8.4.1 вызывают ошибки в Redmine(#4259, #4314), они исправлены в PostgreSQL 8.4.2
  • Microsoft SQL Server *новое*
    • поддержка запланирована для версии 2.3.0 (но она уже доступна в trunk для ранних версий)
  • SQLite 3 (не для многопользовательского использования!)

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

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

Версии Redmine¶

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

Установка¶

Шаг 1 — Redmine application¶

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

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

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

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

gem install bundler

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

bundle install --without development test

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

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

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

bundle install --without development test rmagick

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

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

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

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

bundle install --without development test postgresql sqlite

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

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

Например:

# Gemfile.local
gem 'puma'

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

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

MySQL¶

create database redmine character set utf8; 
create user 'redmine'@'localhost' identified by 'my_password'; 
grant all privileges on redmine.* to 'redmine'@'localhost';

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

grant all privileges on redmine.* to 'redmine'@'localhost' identified by 'my_password';

PostgreSQL¶

CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'my_password' NOINHERIT VALID UNTIL 'infinity';
CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine;

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

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

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

production: 
 adapter: mysql 
 database: redmine 
 host: localhost 
 username: redmine 
 password: my_password

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

production: 
 adapter: mysql2 
 database: redmine 
 host: localhost 
 username: redmine 
 password: my_password

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

production: 
  adapter: mysql 
  database: redmine 
  host: localhost 
  port: 3307
  username: redmine 
  password: my_password

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

production:
  adapter: postgresql
  database: <your_database_name>
  host: <postgres_host>
  username: <postgres_user>
  password: <postgres_user_password>
  encoding: utf8
  schema_search_path: <database_schema> (default - public)

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

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

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

  • для Redmine 1.4.x:
rake generate_session_store
  • для Redmine 2.x:
rake generate_secret_token

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

  1. Создайте структуру базы данных, выполнив следующую команду в корневом каталоге приложения:
RAILS_ENV=production rake db:migrate

в Windows:

set RAILS_ENV=production
rake db:migrate

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

проблемы в Ubuntu:

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

Rake aborted!
no such file to load -- net/https

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

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

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

RAILS_ENV=production rake redmine:load_default_data

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

Например:

в Unix-подобных:

RAILS_ENV=production REDMINE_LANG=fr rake redmine:load_default_data

в Windows:

set RAILS_ENV=production
set REDMINE_LANG=fr
rake redmine:load_default_data

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

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

Пользователь, который запускает Redmine должны иметь разрешение на запись в следующие подкаталоги:

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

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

mkdir tmp tmp/pdf public/plugin_assets
sudo chown -R redmine:redmine files log tmp public/plugin_assets
sudo chmod -R 755 files log tmp public/plugin_assets

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

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

  • для Redmine 1.4.x:
bundle exec ruby script/server webrick -e production
  • для Redmine 2.x:
bundle exec ruby script/rails server webrick -e production
  • для Redmine 3.x
bundle exec rails server webrick -e production

После старта WEBrick, откройте в браузере http://localhost:3000/. Теперь вы должны увидеть страницу приветствия приложения.

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

Шаг 10 — Вход в приложение¶

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

  • Логин: admin
  • Пароль: admin

Теперь вы можете посетить раздел 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 не работают)
  • определить полный путь к бинарникам

Пример(для Subversion):

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

scm_subversion_command: "svn_replacement.exe" 

Абсолютный путь:

scm_subversion_command: "C:\Program Files\Subversion\bin\svn.exe" 

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

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

Примеры:

attachments_storage_path: /var/redmine/files
attachments_storage_path: D:/redmine/files

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

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

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

#Logger.new(PATH,NUM_FILES_TO_ROTATE,FILE_SIZE)
config.logger = Logger.new(config.log_path, 2, 1000000)
config.logger.level = Logger::INFO

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

Резервная копия Redmine должна включать:

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

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

# База данных 
/usr/bin/mysqldump -u <username> -p<password> <redmine_database> | gzip > /path/to/backup/db/redmine_`date +%y_%m_%d`.gz 

# Вложения 
rsync -a /path/to/redmine/files /path/to/backup/files

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

Существует готовый инсталлятор Ruby MRI, который можно получить http://rubyinstaller.org.

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

Установите переменную окружения RAILS_ENV:

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

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

RAILS_ENV=production <any commmand>
<any commmand> RAILS_ENV=production

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

set RAILS_ENV=production    
<any commmand>

Проблемы при установке gem-пакета MySQL:

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

gem install mysql

В некоторых случаях необходимо скопировать libmysql.dll в вашу директорию ruby/bin. Не все libmysql.dll подходят, эта похоже работает http://instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQL.dll

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

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

Решение:

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

1 http://serverfault.com/questions/4689/windows-7-localhost-name-resolution-is-handled-within-dns-itself-why

2 http://www.victor-ratajczyk.com/post/2012/02/25/mysql-fails-to-resolve-localhost-disable-ipv6-on-windows.aspx

3 https://github.com/brianmario/mysql2/issues/279

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

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

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

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

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

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

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

Берем инсталятор с сайта Bitnami для Windows (в комплекте — Redmine+Apache+MySQL).

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

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

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

Перенос баз.

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

C:\Program Files\BitNami Redmine Stack\mysql\bin > mysql -uroot -p1234
mysql> create user 'redmine'@'localhost' identified by 'password';
mysql> create database redmine\_bitnami default character set utf8;
mysql> grant all on redmine\_bitnami.* to 'redmine'@'localhost';

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

C:\Program Files\BitNami Redmine Stack\mysql\bin\ >
mysql -u root -p --default-character-set=utf8 redmine -e "source <имя\_дампа>.sql;

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

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

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

  1. Идем в меню Пуск -> Программы -> Bitnami Redmine Stack, запускаем «Use Bitnami redmine Stack».
  2. Переходим: > cd C:\Program Files\BitNami Redmine Stack\apps\redmine
  3. Выполняем команду: rake db:migrate RAILS_ENV=production
  4. Из compmgmt.msc перезапускаем сервис с именем redmineMongrel1 и redmineMongrel2.

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

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

  1. Копируем настройки рассылки по e-mail которые содержатся в файле «C:/Program Files/BitNami Redmine Stack/apps/redmine/config/email.yml».
  2. Копируем файлы от старого редмайна в соответствующую папку.
  3. Настраиваем Apache на порт 88, конфигурационный файл лежит C:\Program Files\BitNami Redmine Stack\apache2\conf\httpd.conf — строка Listen 88.
  4. Добавляем порт 88 в исключения для Windows Firewall.
  5. Заходим в Redmine через web-интерфейс под администратором в пункт: Администрирование -> Общие -> Указываем имя dbs:88/redmine — это имя будет использоваться трекером для ссылки в почте.
  6. После запуска Redmine в работу создаем тестовое задание. Ждем ответа от пользователей. В случае успеха останавливаем Redmine на старом сервере. Настраиваем пользователям ссылки в браузере, чтобы подключение шло на новый сервер  (\\server_name:88\redmine).\\

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

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

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

\%RMPATH\% \mysql\ bin\mysqldump.exe -uUSER -pPASS redmine_bitnami -r
\%FNPREFIX\%db_dump.sql --default-character-set=utf8
rar m -r -s \% FNPREFIX\% db\_dump.rar \%FNPREFIX\%db\_dump\_bitnami.sql
rar a -r -s \% FNPREFIX\% files.rar \%RMPATH\% \ apps\redmine\files\*.*"
rar a -r -s \%FNPREFIX\%utils.rar *.cmd
xcopy \%FNPREFIX\%*.rar \\path\backup_redmine\

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

SET D=\%DATE\%
SET D=\%D:.=\%
SET T=\%time::=\%
SET T=\%T: =0\%
SET DT=\%D:~4,4\%\%D:~2,2\%\%D:~0,2\%\_\%T:,=\% \\
SET WORKPATH=E:\BACKUP\Redmine\
SET FNPREFIX=\%WORKPATH\%\%DT\%_redmine_
SET RMPATH=C:\Program Files\BitNami Redmine Stack
\end{document}

Posted in Redmine and tagged Redmine.

Redmine — популярный инструмент управления проектами с открытым исходным кодом, который позволяет эффективно организовывать работу команды и отслеживать выполнение задач. Установка Redmine на операционную систему Windows может представлять определенные вызовы, но следуя этой подробной инструкции, вы сможете успешно настроить и запустить Redmine на своем ПК.

Содержание

  1. Шаг 1. Установка необходимого программного обеспечения
  2. Шаг 2. Установка Redmine
  3. Подготовка к установке Redmine на Windows
  4. Загрузка и установка Ruby
  5. Настройка базы данных
  6. Установка Redmine на Windows

Шаг 1. Установка необходимого программного обеспечения

Первым шагом в установке Redmine является установка и настройка необходимого программного обеспечения. Вам понадобятся следующие компоненты:

  1. Среда выполнения Ruby: скачайте и установите последнюю версию Ruby с официального веб-сайта Ruby. Убедитесь, что добавили путь к исполняемому файлу Ruby в переменную среды PATH;
  2. Система управления базами данных: установите MySQL или PostgreSQL. Также необходимо установить инструмент командной строки для выбранной системы управления базами данных;
  3. Сервер веб-приложений: рекомендуется использовать модификацию сервера Apache с поддержкой модуля Passenger для запуска приложений Ruby. Скачайте и установите Apache, а затем настройте модуль Passenger в соответствии с документацией.

Шаг 2. Установка Redmine

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

  1. Скачайте последнюю версию Redmine с официального сайта Redmine;
  2. Распакуйте скачанный файл в каталог, где будет размещено приложение;
  3. Откройте командную строку и перейдите в каталог, где находится распакованный архив Redmine;
  4. Установите все необходимые зависимости с помощью команды bundle install —without development test;
  5. Скопируйте файл ‘config/database.yml.example’ в ‘config/database.yml’, откройте его в текстовом редакторе и укажите настройки подключения к базе данных;
  6. Сгенерируйте секретный ключ для приложения, выполнив команду rake generate_secret_token;
  7. Создайте базу данных и выполните необходимые миграции с помощью команды rake db:migrate RAILS_ENV=production;
  8. Установите первоначальные данные в базу данных командой rake redmine:load_default_data RAILS_ENV=production;
  9. Настройте веб-сервер Apache для обслуживания приложения Redmine.

После завершения установки вам будет доступен интерфейс Redmine, и вы сможете начать использование этого мощного инструмента управления проектами на своем компьютере под управлением Windows.

Примечание: в данной инструкции приведены только основные шаги для установки Redmine на операционную систему Windows. В зависимости от вашей конкретной конфигурации и требований, могут потребоваться дополнительные настройки и настройка.

Подготовка к установке Redmine на Windows

Перед установкой Redmine на Windows необходимо выполнить несколько предварительных шагов, чтобы гарантировать правильную работу приложения:

Шаг Описание
1 Установите и настройте Ruby, язык программирования, на котором работает Redmine. Подходят версии Ruby 1.9 и выше.
2 Установите и настройте управление базами данных MySQL или PostgreSQL, которые можно использовать с Redmine.
3 Установите и настройте систему контроля версий Git или Subversion, если вы планируете использовать их в Redmine.
4 Скачайте и установите необходимые библиотеки, такие как ImageMagick и RMagick, для поддержки загрузки и работы с изображениями в Redmine.

После выполнения этих шагов вы будете готовы к установке Redmine на Windows и сможете продолжить процесс установки.

Загрузка и установка Ruby

Перед установкой Redmine необходимо установить язык программирования Ruby:

  1. Перейдите на официальный веб-сайт Ruby по адресу https://rubyinstaller.org/downloads/.
  2. Скачайте установщик Ruby для Windows, соответствующий вашей версии операционной системы (32-бит или 64-бит).
  3. Запустите скачанный установщик и следуйте указаниям мастера установки Ruby.
  4. Выберите пункт «Install Ruby» и установите Ruby в папку, к примеру, «C:\Ruby».
  5. Установите флажок «Add Ruby executables to your PATH» для автоматического добавления пути к исполняемым файлам Ruby в переменную окружения PATH.
  6. Нажмите кнопку «Install», чтобы начать установку Ruby.
  7. Дождитесь завершения установки Ruby.
  8. После успешной установки проверьте правильность установки, открыв командную строку Windows и введя команду «ruby -v».

Примечание: Важно выбрать правильную версию Ruby для вашей системы и следовать указаниям установщика для успешной установки программы.

Настройка базы данных

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

1. Скачайте и установите MySQL или PostgreSQL в соответствии с инструкцией на официальном веб-сайте каждой базы данных.

2. После установки базы данных, вам необходимо создать базу данных для Redmine. Откройте командную строку и выполните следующую команду, заменив «redmine» на имя вашей базы данных:

Для MySQL:

mysql -u root -p
CREATE DATABASE redmine CHARACTER SET utf8mb4;

Для PostgreSQL:

psql -U postgres
CREATE DATABASE redmine WITH ENCODING 'UTF8' LC_COLLATE='C' LC_CTYPE='C' TEMPLATE=template0;

3. Создайте пользователя базы данных для Redmine. Выполните следующую команду, заменив «redmine» на имя вашей базы данных и «pass» на пароль пользователя:

Для MySQL:

GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'pass';

Для PostgreSQL:

CREATE ROLE redmine LOGIN PASSWORD 'pass' NOINHERIT VALID UNTIL 'infinity';
GRANT ALL PRIVILEGES ON DATABASE redmine TO redmine;

4. Проверьте, что база данных была успешно создана, введя следующую команду для MySQL:

SELECT SCHEMA_NAME FROM INFORMATION_SCHEMA.SCHEMATA WHERE SCHEMA_NAME = 'redmine';

или следующую команду для PostgreSQL:

\l

Вы должны увидеть базу данных «redmine» в списке баз данных.

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

В этом разделе мы рассмотрим подробную инструкцию по установке Redmine на Windows. Следуйте этим шагам, чтобы установить Redmine на свой компьютер:

  1. Перейдите на официальный сайт Redmine и загрузите последнюю версию программы.
  2. Установите Ruby и RubyGems на ваш компьютер. Вы можете загрузить их с официальных веб-сайтов и выполнить установку, следуя инструкциям на экране.
  3. Запустите командную строку и установите Bundler, выполнив команду gem install bundler.
  4. Создайте новую папку для установки Redmine и перейдите в нее в командной строке.
  5. Разархивируйте скачанный архив Redmine в новую папку.
  6. Откройте командную строку в папке Redmine и выполните команду bundle install. Это установит все необходимые зависимости.
  7. Создайте базу данных для Redmine. Вы можете использовать MySQL или любую другую базу данных, совместимую с Redmine.
  8. Приведите файл config/database.yml.example в рабочее состояние, переименовав его в config/database.yml и указав данные подключения к базе данных.
  9. Выполните следующие команды: rake generate_secret_token, rake db:migrate, rake redmine:load_default_data. Это настроит базу данных Redmine.
  10. Запустите веб-сервер, используя команду rails server.
  11. Откройте браузер и перейдите по адресу http://localhost:3000. Вы должны увидеть страницу приветствия Redmine.
  12. Завершите процесс установки, следуя инструкциям на экране.

Теперь вы можете использовать Redmine на своем компьютере с операционной системой Windows. Установите плагины, настройте пользователей и начните управлять своими проектами с помощью Redmine.

Время на прочтение
4 мин

Количество просмотров 37K

В этой статье рассматривается вариант установки Redmine с базой данных SQlite3 на Windows и запуск его как сервиса. Все необходимые компоненты для установки приведены в статье. Для тестирования была установлена виртуальная машина с «голым» Windows 7 без пакетов обновления, без дополнительного ПО и произведена пошаговая установка по инструкции в статье.

Ответ на вопрос: «Сколько требует ресурса так установленная Redmine?»

ОЗУ: Процесс Redmine использует 2 МБ оперативной памяти, а интерпретатор Ruby «ест» 170 МБ оперативной памяти.
ЖД: Установленный «пустой» Redmine с остальным ПО занимает ~500 МБ жесткого диска.

Необходимые компоненты для установки Redmine

Ruby — среда разработки Ruby.
DevKit для Ruby — компонент разработчика для Ruby.
AddTrustExternalCARoot-2048.pem — сертификат безопасности для Ruby.
Redmine — последняя версия Redmine.
NSSM — сервис менеджер.

Пошаговая инструкция

Часть 1, распаковка
1. Устанавливаем RubyInstaller в нужный нам каталог (например C:\Ruby) и при установке ставим галочки:

«Add Ruby executables to your PATH» и «Associate .rb and .rbw files with this Ruby installation»

2. Распаковываем DevKit в C:\Ruby\Devkit
3. Копируем сертификат в C:\Ruby\lib\ruby\2.1.0\rubygems\ssl_certs
4. Распаковываем Redmine в C:\Ruby\Redmine
5. Распаковываем NSSM в папку Redmine C:\Ruby\Redmine\NSSM

Часть 2, установка devkit
1. Открываем консоль cmd от имени администратора.
2. Переходим в каталог Devkit:

cd C:\Ruby\Devkit

3. Выполняем команду инициализации Devkit:

ruby dk.rb init

4. Выполняем команду установки Devkit:

ruby dk.rb install

Часть 3, установка необходимых gem`ов
1. Устанавливаем менеджер для управления gem`ами:

gem install bundler

2. Устанавливаем sqlite3 для Ruby

gem install sqlite3-ruby

3. Обновляем все gem`ы и подтверждаем обновления:

gem update

4. Сворачиваем консоль.

Часть 4, настройка redmine
1. В папке config (C:\Ruby\redmine\config) открываем файл “database.yml.example”.
2. Удаляем все записи, кроме sqlite3:

# SQLite3 configuration example
production:
  adapter: sqlite3
  database: db/redmine.sqlite3

3. Сохраняем его уже в формате yml. (C:\Ruby\redmine\config\database.yml)
4. В папке Redmine (C:\Ruby\redmine) открываем файл “Gemfile”.
5. Дописываем туда в начало:

gem "sqlite3-ruby"

сохраняем и выходим.

Часть 5, создание БД и первый запуск redmine
1. Возвращаемся в консоль и переходим в папку с redmine:

cd C:\Ruby\redmine

2. Выполняем команду (установка зависимостей для Redmine):

bundle install

При ошибке rmagick

Найдите в файле “Gemfile” (C:\Ruby\redmine\Gemfile):

platforms :mri, :mingw, :x64_mingw do
  # Optional gem for exporting the gantt to a PNG file, not supported with jruby
  group :rmagick do
    gem "rmagick", ">= 2.14.0"
  end

  # Optional Markdown support, not for JRuby
  group :markdown do
    gem "redcarpet", "~> 3.3.2"
  end
end

и удалите.

ИЛИ просто запустите вместо bundle install:

bundle install --without development test rmagick

3. Выполняем команду (генерируем ключ для Rails):

rake generate_secret_token

4. Выполняем команду (создаем базу данных):

rake db:migrate RAILS_ENV="production"

5. Выполняем команду (устанавливаем конфигурацию по умолчанию):

rake redmine:load_default_data RAILS_ENV="production"

и при запросе пишем “ru”
6. Запускаем сервер:

ruby script/rails s -e "production"

Для новых версий Ruby 2.2.x

ruby bin/rails s -e "production"

7. Проверяем запуск сервера по адресу:

http://localhost:3000/ 

8. Возвращаемся в консоль и останавливаем сервер:

Ctrl+C

Часть 6, создание сервиса для redmine
1. Сворачиваем консоль.
2. Создаем cmd файл:

del C:\Ruby\Redmine\service.log
del C:\Ruby\Redmine\service-err.log
set RAILS_ENV=production
cd C:\Ruby\Redmine
C:\Ruby\bin\ruby.exe -CC:\Ruby\Redmine script/rails server webrick -e production 1>> C:\Ruby\Redmine\service.log 2>> C:\Ruby\Redmine\service-err.log

Для новых версий Ruby 2.2.x

В CMD поменять script/rails на bin/rails

3. Помещаем его в C:\Ruby\Redmine\
4. Переходим в консоль и переходим в папку NSSM:

cd C:\Ruby\Redmine\NSSM

5. Заходим в папку с разрядностью вашей системой, например:

cd win64

6. Создаем сервис:

nssm install Redmine

7. В открытом окне создания сервиса, в Path устанавливаем:

c:\windows\system32\cmd.exe

8. В Arguments устанавливаем:

/c C:\Ruby\Redmine\start.cmd

9. Во вкладке «Details» устанавливаем Startup type: Automatic
10. Перезагружаем ПК (или просто включаем сервис руками) и пользуемся.

Примечания

Для примера были приведены пути C:\Ruby, C:\Ruby\Redmine, C:\Ruby\Redmine\NSSM и другие; Вы можете использовать свои пути, но не забудьте изменить все команды, которые приведены в примере.

По умолчанию webrick запускает redmine на порту 3000, для изменения порта, в созданном CMD файле добавьте -p 80

del C:\Ruby\Redmine\service.log
del C:\Ruby\Redmine\service-err.log
set RAILS_ENV=production
cd C:\Ruby\Redmine
C:\Ruby\bin\ruby.exe -CC:\Ruby\Redmine script/rails server webrick -e production -p 80 1>> C:\Ruby\Redmine\service.log 2>> C:\Ruby\Redmine\service-err.log

Для новых версий Ruby 2.2.x

В CMD поменять script/rails на bin/rails

Используемые материалы

users.livejournal.com/_ander/56346.html
gist.github.com/luislavena/f064211759ee0f806c88
stackoverflow.com/questions/17350837/ruby-on-rails-add-gem-sqlite3-to-your-gemfile
infostart.ru/public/78834

Решил сегодня установить 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

  • Как установить r2 на windows server 2003
  • Как установить realtek high definition audio driver на windows 10
  • Как установить qbittorrent на windows 10
  • Как установить realtek hd audio manager на windows 10
  • Как установить quicktime на windows 10