Установка Redmine. Полная пошаговая инструкция. Для чайников.

Redmine — на мой взгляд, лучшее из свободно доступных решений для управления проектами, задачами, ведения статистики и отчетности и много еще чего. Все зависит от требований, фантазии и умений системного администратора \ разработчика.

Итак, перековыряв 100500 разных мануалов по установке и на Хабре и на официальном сайте и в куче блогов, я таки нашел инструкцию, которая от начала и до конца меня устроила и теперь дает возможность за 15 минут установить\обновить\переустановить Redmine 2.x, 3.x

В моем случае я осуществил переезд со старого Redmine 1.4 на новый 3.2, поэтому первые 8 пунктов в случае установки с 0 можно пропустить.

1. Создаю каталог, в который положу резервную копию старого Redmine

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

3. Копирую файлы пользователей старого Redmine в созданный выше каталог.

cp -f /var/lib/redmine/default/files/* /home/usefree/redmine-backup-files/

4. Создаю дамп базы данных. Здесь важно знать учетные данные пользователя, под которым Redmine обращается в базу. Подсмотреть можно в файле /каталог_с_Redmine/config/database.yml

5. Выхожу из учетной записи суперпользователя

6. Перехожу в свой домашний каталог и создаю архив с данными резервной копии.

cd /home/usefree/ tar -cvzf redmine-backup-files.tar.gz /home/usefree/redmine-backup-files

7. Так как я разворачиваю новый Redmine на новом компьютере, то копирую файлы на этот новый компьютер с ip-адресом 192.168.0.222 в свой домашний каталог:

scp redmine-backup-files.tar.gz 192.168.0.222:/home/usefree/

8. Зайдя на этот компьютер, извлекаю файлы

tar -xvf redmine-backup-files.tar.gz

9. Приступаю к собственно установке. Начинаю с обновления пакетов в системе.

sudo apt-get update sudo apt-get upgrade

10. Устанавливаю некоторые дополнительные пакеты.

sudo apt-get install curl gpg —keyserver hkp://keys.gnupg.net —recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 curl -sSL https://get.rvm.io | bash -s stable —ruby=2.0.0 source /home/$USER/.rvm/scripts/rvm sudo apt-get install git git-core subversion sudo apt-get install imagemagick libmagickwand-dev sudo apt-get install libssl-dev

11. Создаю каталог для Redmine, назначаю владельца каталога.

cd /opt/ sudo mkdir redmine sudo chown $USER:$USER redmine

12. Копирую из репозитория Redmine 3.2

cd redmine/ svn co http://svn.redmine.org/redmine/branches/3.2-stable current cd current/

13. Создаю дополнительные каталоги, назначаю им права.

mkdir -p tmp tmp/pdf public/plugin_assets sudo chown -R www-data:$USER files log tmp public/plugin_assets sudo chmod -R 775 files log tmp public/plugin_assets mkdir -p /opt/redmine/repos/svn /opt/redmine/repos/git sudo chown -R www-data:www-data /opt/redmine/repos

14. Устанавливаю инструменты для работы с базой данных и пр.

sudo apt-get install mysql-server libmysqlclient-dev sudo apt-get install -y libgmp3-dev sudo apt-get install ruby-dev

15. Создаю базу данных

mysql -uroot -p CREATE DATABASE redmine CHARACTER SET utf8; CREATE USER ‘redmine’@’localhost’ IDENTIFIED BY ‘password’; GRANT ALL PRIVILEGES ON redmine.* TO ‘redmine’@’localhost’; FLUSH PRIVILEGES; EXIT;

16. Создаю конфигурационные файлы

cp config/configuration.yml.example config/configuration.yml cp config/database.yml.example config/database.yml

17. Заполняю конфигурационный файл учетными данными для подключения к базе данных.

vi config/database.yml production: adapter: mysql2 database: redmine host: localhost username: redmine password: «password» encoding: utf8

18. Установка менеджера gem-пакетов, установка пакетов зависимостей

gem install bundler bundle install —without development test

19. Импортирую данные из старой базы данных

bundle exec rake generate_secret_token

20. Копирую старые файлы пользователей в новый каталог, назначаю им права

cp -f /home/usefree/home/usefree/redmine-backup-files/* /opt/redmine/current/files/ sudo chown -R www-data:www-data /opt/redmine/current/files/

21. Инициализирую базу данных

RAILS_ENV=production bundle exec rake db:migrate

22. Устанавливаю Web-сервер и дополнительные пакеты

sudo apt-get install apache2 apache2-dev libcurl4-gnutls-dev apache2 libapache2-svn \ libapache-dbi-perl libapache2-mod-perl2 libdbd-mysql-perl libauthen-simple-ldap-perl openssl

23. Включаю модули web-сервера

sudo a2enmod ssl perl dav dav_svn dav_fs rewrite

24. Устанавливаю gem-пакет для связи Redmine и web-сервера

gem install passenger passenger-install-apache2-module

Тут может появиться ошибка типа такой

/Users/builder/.rbenv/versions/2.1.3/lib/ruby/gems/2.1.0/gems/bundler-1.13.0/lib/bundler/rubygems_ext.rb:23:in `source’: uninitialized constant Gem::Source (NameError)

Решение такое (может отличаться версия ruby):

https://github.com/fastlane/fastlane/issues/6066
До конца выполнения последней команды будет сгенерирован код, который необходимо поместить в файл passenger.conf (следующий пункт инструкции). Поместить, и только потом нажать Enter !

25. Настраиваю конфигурационный файл модуля web-сервера для связи с redmine. Внимание! текст для файла
passenger.conf генерируется в ходе выполнения предыдущей команды, для корректной установки до завершения выполнения предыдущей команды необходимо тот код, который она выдаст, поместить в файл /etc/apache2/conf-available/passenger.conf . Об этом будет написано английским по серому!

sudo vi /etc/apache2/conf-available/passenger.conf LoadModule passenger_module /home/usefree/.rvm/gems/ruby-2.0.0-p643/gems/passenger-5.0.25/buildout/apache2/mod_passenger.so PassengerRoot /home/usefree/.rvm/gems/ruby-2.0.0-p643/gems/passenger-5.0.25 PassengerDefaultRuby /home/usefree/.rvm/gems/ruby-2.0.0-p643/wrappers/ruby

26. Включаю модуль

sudo a2enconf passenger

27. Загружаю библиотеку Redmine.pm для аутентификации в репозиториях

sudo mkdir /usr/lib/perl5/Apache sudo ln -s /opt/redmine/current/extra/svn/Redmine.pm /usr/lib/perl5/Apache/

28. Настраиваю безопасное подключение по https с использованием самостоятельно сгенерированного сертификата.

sudo mkdir /etc/apache2/ssl sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 \ -keyout /etc/apache2/ssl/redmine.key -out /etc/apache2/ssl/redmine.crt sudo chmod -R 740 /etc/apache2/ssl sudo chown -R www-data:www-data /etc/apache2/ssl

29. Создаю конфигурационные файлы виртуальных хостов web-сервера.

sudo vi /etc/apache2/sites-available/redmine-redirect.conf sudo vi /etc/apache2/sites-available/redmine.conf

смотреть оригинальный пост

30. Выключаю сайт по-умолчанию

sudo a2dissite 000-default

31. Возвращаем удаленный выше bundler

gem install bundler

32. Включаю сайт для redmine, перезапускаю web-сервер

sudo a2ensite redmine redmine-redirect sudo service apache2 restart

33. Настраиваю доставку уведомлений на почту при изменении в задачах.

vi /opt/redmine/current/config/configuration.yml default: email_delivery: delivery_method: :smtp attachments_storage_path: /opt/redmine/current/files production: email_delivery: delivery_method: :smtp smtp_settings: address: «mailserver.yourdomain.com» port: 25 domain: «yourdomain.com»

34. Если вдруг забыт пароль админа(admin), то переустановить его на ‘password’ можно так:

mysql -u redmine -p #enter: UPDATE users SET hashed_password=’353e8061f2befecb6818ba0c034c632fb0bcae1b’ WHERE login=’admin’; UPDATE users SET salt=» WHERE login=’admin’; exit;

Огромное спасибо Martin Denizet за труд по подготовке такой суперподробной и понятной инструкции.

Чуть погодя опишу установку некоторых дополнительных плагинов.

Redmine

Latest releases¶

Resources¶

Установка Redmine¶

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

Затем вы можете установить все зависимости требующиеся 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 — Создание структуры базы данных¶

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Настройка¶

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

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

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

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

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

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

Настройки SCM ¶

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Вам может понадобиться установить gem 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 не поддерживает адресацию IPV6 3 , то соединение с базой данных не может быть установлено и вы получаете ошибку » Can’t connect to MySQL server on ‘localhost’ (10061) «.
Вы можете проверить это пропинговав localhost , если будет пинговаться «::1:», значит используется адресация IPV6.

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

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

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