Instalar Redmine 1.3 en servidor CentOS con WHM/Cpanel.

Este manual explica cómo instalar Redmine en un servidor con CentOS y WHM/Cpanel. A diferencia de otras distribuciones no podemos configurar Apache así como así, ya que WHM tiene un sistema de plantillas interno para restaurar los ficheros de configuración modificados en base a la configuración del servidor, esto evita problemas y aporta gran estabilidad en entornos de producción.

WHM está preparado para desplegar aplicaciones Rails que cada usuario podrá configurar desde su Cpanel, el único problema es que las gemas disponibles y a la vez necesarias en WHM no son compatibles con redmine.

Para desplegar la aplicación utilizaremos Apache 2.2 junto con phusion_passenger, además del propio Redmine 1.3. Así que en primer lugar obtendremos el código fuente necesario e instalaremos passenger. A través de ssh ejecutaremos:

cd /root/tmp
wget http://rubyforge.org/frs/download.php/75814/redmine-1.3.1.tar.gz
tar zxvf redmine-1.3.1.tar.gz
gem install passenger
passenger-install-apache2-module

El siguiente paso es habilitar el módulo passenger en apache, podremos hacerlo desde el panel de configuración de Apache en WHM. Dentro del panel encontraremos la opción “include editor” y en el selector de pre-virtual-host include añadiremos lo siguiente:

LoadModule passenger_module /usr/lib/ruby/gems/1.8/gems/passenger-3.0.11/ext/apache2/mod_passenger.so
PassengerRoot /usr/lib/ruby/gems/1.8/gems/passenger-3.0.11
PassengerRuby /usr/bin/ruby

y pulsamos Update, esto debería reiniciar Apache sin errores. Si el reboot devuelve errores quizás alguna ruta no sea correcta, podemos usar find para ve en que ruta se encuentra cada cosa.
Volvemos al ssh y preparamos nuestro proyecto para ser desplegado:

cd /root/tmp/redmine-1.3.1/config
mv database.yml.example database.yml
cd ../public
mv dispatch.cgi.example dispatch.cgi
mv dispatch.fcgi.example dispatch.fcgi
mv dispatch.rb.example dispatch.rb
mv htaccess.fcgi.example .htaccess

Ahora editaremos el fichero de configuración de la BD:

cd ..
nano config/database.yml

Es evidente que necesitamos crear una BD en mysql, además es aconsejable crear un usuario que tenga todos los privilegios sobre esta BD pero sobre ninguna más. Esto podemos hacerlo desde Cpanel o desde la linea de comandos de mysql.

Ahora debemos preparar las gemas que Redmine necesita, pero en primer lugar necesitamos una versión más antigua de RubyGems:

cd /root/tmp
wget http://production.cf.rubygems.org/rubygems/rubygems-1.4.2.tgz
tar zxvf rubygems-1.4.2.tgz
cd rubygems-1.4.2
ruby setup.rb

gem install bundler

Creamos un fichero ./Gemfile y añadimos las siguientes lineas:

source "http://rubygems.org"
gem "rake", "0.8.3"
gem "rack", "1.1.0"
gem "i18n", "0.4.2"
gem "rubytree", "0.5.2", :require => "tree"
gem "RedCloth", "~>4.2.3", :require => "redcloth" # for CodeRay
gem "mysql"
gem "coderay", "~>0.9.7"

y ejecutamos:

bundle install

Ahora debemos copiar la carpeta donde está redmine en /home/{user}/public_html y cambiar su nombre por redmine:

cp /root/tmp/redmine-1.3.1 /home/{user}/public_html/
mv /home/{user}/public_html/redmine-1.3.1 /home/{user}/public_html/redmine
cd /home/{user}/public_html/redmine
chown -R apache:apache ./
chmod -R 755 ./

Y procedemos a sincronizar la BD:
Editamos el fichero config/environment.rb y descomentamos la linea:

ENV['RAILS_ENV'] ||= 'production'

ejecutamos:

RAS_ENV=production bundle exec rake generate_session_store
RAILS_ENV=prodILuction bundle exec rake db:migrate
RAILS_ENV=production bundle exec rake redmine:load_default_data

En el último paso podremos elegir el idioma del sistema.

Si hemos llegado hasta aquí, hemos hecho la parte más difícil, la aplicación está lista para usarse, solo falta desplegarla en Apache usando passenger. Como ya comenté no podemos editar los ficheros de configuración generales de Apache pero podemos pedirle al sistema que nos incluya ficheros adicionales creados por nosotros usando un script.

/scripts/ensure_vhost_includes --user=nombre_usuario
/scripts/rebuildhttpdconf
/scripts/restartsrv_httpd

Una vez hecho esto podemos añadir ficheros de configuración adicionales en la carpeta
/etc/httpd/conf/userdata/std/2/ que acabe en “.conf”
Por ejemplo crearemos el fichero:
/etc/httpd/conf/userdata/std/2/redmine.conf donde escribiremos:

RailsEnv production
RailsBaseURI /redmine

Allow from all
Options -MultiViews

Con esto, tras reiniciar Apache:

/etc/init.d/httpd restart

debería estar disponible en la URL: nombre_dominio/redmine