Redmine + Apache + Passenger + Subversion на примере Gentoo

Как ранее писал, решил я настроить себе subversion сервер с багтрекером Redmine. Для этого обзавёлся виртуальным выделенным сервером на 1GB.ru . В качестве операционной системы там установлен Gentoo 2008. Для запуска сайта на Ruby on Rails существует много возможных комбинаций серверов. Например, я пробовал Apache + proxy_balancer + Mongrel , просто Mongrel. Так же всевозможные замены Apache на альтернативные веб-сервера. Но посоветовавшись с админом форума http://rubyclub.com.ua/, пришел к тому, что буду использовать Apache + Passenger. Кстати, в сети не нашел какого-либо мануала про Redmine и эту связку, с чем связаны многие часы раздумий. Ну и для полного счастья, точнее для более быстрой работы Passenger устанавливал Ruby Enterprise Edition. Я не рассматриваю установку и настройку базы данных, т.к. у меня она стоит на мощностях хостинга, а не на моем vds.
Цель поста — систематизировать свои знания, оставить себе шпаргалку, ну и показать некоторые нетривиальные места. Практически все собиралось из исходников, так что привязки  конкретно к Gentoo практически нет. Ну и как некоторый показатель — после изучения всех граблей, настройка сервера заняла часа 3-4, и то в связи с ограничением на ресурсы сервера.

Ну и собственно поехали.

1. Так как я все собирал из исходников, то для начала нужно зачистить систему от установленного apache, php, subversion (svn старая версия, лучше поновее). Но в начале сохраните файл /etc/init.d/svnserve . Он пригодится для запуска svn после установки из исходников. В Gentoo последовательно выполняем следующие команды ( php я не планирую использовать, поэтому и удаляю )

Подчищаем директории от не удалившихся файлов. Например у меня осталась папка /etc/apache с конфигами, ну и в /usr/lib/php5 остались модули.

2. Теперь проверим установленную версию rubygems, выполнив команду

У меня было  RUBYGEMS VERSION: 1.1.1 . Как оказалось, это было очень плохо. Когда я пытался установить гемы для ruby, на сервере происходило громадное выделение памяти, после чего программа аварийно завершалась из-за нехватки памяти. Так что обновится нужно, да и в требованиях к Redmine написано «RubyGems 1.3.1 is required». Выполняем следующее

3. Для сборки Ruby Enterprise Edition нам потребуется OpenSSL, так же он может пригодиться для настройки subversion ( это как душе угодно) и apache. Скачиваем с сайта нужную нам версию исходников (вам может не нужна прям последняя, всяко может быть), и распаковываем

Затем конфигурируем OpenSSL, компилируем, и устанавливаем

Ну и нужно сказать системе где искать библиотеки от OpenSSL

4. На этом шаге установим apache. Берем исходники на этой странице. Скачиваем, распаковываем.

Далее конфигурируем, указав путь до OpenSSL ( раз уж мы поставили OpenSSL, то почему бы не собрать все с поддержкой оного?), компилируем, и устанавливаем

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

5. Настало время Ruby Enterprise Edition (ruby-ee). Важный момент — после установки ruby-ee у нас в системе будет два Ruby. Один общесистемный, зарытый в каталогах /usr или /var (не уточнял), и второй ruby-ee, который будет использоваться только в apache. Нужно учесть то, что при запуске скриптов/программ ruby из консоли (например gem install, rake...) , будет запускаться общесистемный Ruby. В дальнейшем при использовании Redmine для задач обслуживания ( вне apache) нужно указывать полный путь до ruby/gem/rake ( /opt/ruby-ee-186/bin/rake). Иначе система будет ругаться на не установленные компоненты. Другой вариант, это установить в общесистемный ruby эти компоненты командой

до установки ruby-ee.
Берем последнюю версию от сюда . Скачиваем, распаковываем.

Важный момент: следующие действия лучше делать из консоли, а не из под запущенного Midnight Commander (если вдруг он у вас запущен). Я не разбирался почему, но при запущенном MC глобальные переменные не определялись. Ruby-ee попутно ставит «пакет» для Passenger и другие. Для нормальной установки нужно определить две глобальные переменные (набрав эти строки в консоли)

Плюс еще одна возможная проблема. На Gentoo с ruby-enterprise-1.8.6-20090201 это проявляется точно. При компиляции возникают ошибки связанные с OpenSSL. Чтобы исправить это, нужно пропатчить три файла в папке ruby-enterprise-1.8.6-20090201\ruby-enterprise-1.8.6-20090201\source\ext\openssl\ как показано по ссылке . Вот теперь мы можем приступить к установке

Во время установки появится вопрос «куда ставить?» Я ввел путь /opt/ruby-ee-186/ (далее некоторые настройки будут идти от этого пути).
(update 9.07.2009) На данную дату вышла новая версия ruby on rails 2.2.3 . Ruby-ee ставит по умолчанию последнию версию. У меня при установке произошли ошибки. В итоге он не поставил ruby on rails. Так что даже если он и поставит, то после этого нужно выполнить следующую команду

После установки ruby-ee поставим Passenger.

К настройке работы apache и Passenger приступим после установки Redmine.

6. Сейчас установим Subversion. Можно конечно было поставить Redmine, но я хочу поставить его из репозитария, а для этого нужен subversion ( а мы его удалили на 1 шаге ). Скачиваем последнюю версию, разархивируем, ставим. Проблем возникнуть не должно.

7. Теперь приступим к установке Redmine. Важный момент: при установке Файлы будем хранить в /home/www/redmine . Я не буду полностью описывать шаги установки, приведу только последовательность действий, а расшифровку смотрите на сайте . Скачиваем последнюю версию с репозитория

Создаем базу данных, с кодировкой по умолчанию UTF8. Далее переименовываем файл config/database.yml.example в config/database.yml и редактируем в нем раздел production, внеся настройки нашей базы данных. После этого, находясь в корне папки redmine выполняем следующие действия

Для работы почты переименовываем файл config/email.yml.example в config/email.yml и редактируем его, внеся учетные данные почтового сервера. В файле config/enviroment.rb раскомментируйте строку ENV['RAILS_ENV'] ||= 'production' . Ну и почти что самое главное — для работы через Passenger, нужно удалить файл public/.htaccess. Иначе не будут отображаться стили оформления.

8. А теперь настроим связку Apache + Passenger и запустим первый раз Redmine.
Апач будет работать под пользователем apache (или любой другой). Если у вас его нет, то нужно создать. Одно из важных условий — у пользователя apache должен быть домашний каталог /home/www (либо любой другой , но он должен быть доступен для записи пользователем apache). Теперь нужно дать пользователю apache права на папку /www/home/redmine.

Не забывайте после создания каких либо файлов в этой папке под root`ом менять права. Это решает большую часть ошибок.
Теперь собственно Apache. Правим конфигурационный файл /usr/local/apache2/conf/httpd.conf ( я опускаю моменты настройки apache такие как адрес сервера, почта админа и подобное. об этом много разных мануалов). Ищем строку «User daemon» , и заменяем daemon на apache. Также и в следующей строке. В конце файла нужно добавить следующие строки

В строках 1-3 мы указываем откуда запускать passwnger и ruby. Путь должен указывать на папку, которую вы указали в пункте 5 (/opt/ruby-ee-186/) . Строки 4-5 мы указываем от имени какого пользователя запускать Passenger и отключаем смену пользователя. Строки 6-8 ограничивают количество процессов/ресурсов потребляемых passenger`ом. Ну а в остальных строках мы создаем виртуальный хост — наш сайт. Сохраняем файл.
Теперь можно запускать Apache

Заходим на сайт и видим главную страницу Redmine ( а может и не видим -) )

9. Далее настраиваем subversion. Я использую связку subversion и sasl. Небольшую инструкцию можно взять тут и официальный мануал тут . Пара замечаний по этой инструкции. После добавления пользователей в базу не забудьте поправить права доступа к ней, иначе процесс subversion не сможет получить к нему доступ. Для запуска subversion скопируйте в /etc/init.d/ файл svnserve, сохраненный в пункте 1. Правим в нем путь до папки с репозиторием, и имя пользователя. Ну и опять самое важное — для папки с репозиторием смените владельца, иначе опять получим отказ доступа. Права на файлы самое важное!!

10. А теперь последний штрих, на который у меня ушло двое суток. Пробуем создать тестовый проект, добавляем в него ссылку на svn репозиторий.
Заходим на вкладку Хранилище, и если мы видим такую же часть, как выделенная на картинке — все работает отлично. Иначе — плохо. Если мы откроем логи апача, то увидим ошибку « не могу найти svn». Т.е. процесс пытается получить данные из хранилища с помощью программы svn, но не может её найти. Для решения этой проблемы нужно отредактировать файл lib/redmine/scm/adapters/subversion_adapter.rb исправив переменную SVN_BIN

Этим мы говорим от куда запускать svn и где хранить конфиги. Кстати папку для конфигов надо создать и поменять владельца, на того под которым работает svn. Ну и для полного счастья и работы, нужно выполнить в консоли какую-нибудь команду svn указав папку для конфигов. Это нужно для того чтобы установить некоторые параметры настройки svn. Иначе в логах apache будет висеть ошибка, и вывод консоли , с предложение установить один из параметров. Его кстати можно установить вручную в файле — читайем лог ошибки. После этого все должно работать.

--------------------

Вот эти вроде простые действия заняли почти неделю копания. Главная ошибка, это права доступа к файлам. В итоге получился багтрекер projects.dobrih.net.
Ну и на последок несколько ссылок на инструкции по установке Redmine на других связках Redmine 0.8.x Installation Tutorial
Setting up a Redmine site on Ubuntu
русская инструкция по установке на Windows