Delirios de un Informático

Cómo instalar Redmine 2.2 con Apache en subdirectorio

En 2011 ya comenté cómo instalar Redmine con Apache en subdirectorio pero se trataba de versión 1.2. Hace unos días recurrí a estas instrucciones para instalar la reciente versión 2.2 pero la cosa se complicó un poco: se proporcionan instrucciones oficiales para instalar en un subdirectorio pero aquí, aquí y aquí se habla largo y tendido de que no funciona correctamente.

El problema parece estar en que al indicar el subdirectorio mediante el archivo environment.rb las direcciones de los archivos estáticos se generan correctamente pero no los enlaces de la interfaz. Modificando la configuración para que se generen correctamente, dejan de funcionar los archivos estáticos. Tras probar mil y una opciones, al final acabé haciendo una instalación híbrida: configurar Apache para que sirva los estáticos y realice las llamadas a Redmine mediante un proxy, utilizando el servidor webrick.

Las instrucciones de instalación sugieren instalar una cantidad de dependencias que no es normal (¿para qué demonios necesito compilar una extensión nativa de PostgreSQL si no lo voy a usar?) por lo que mejor realizar una instalación básica en Debian:

apt-get install ruby rubygems
apt-get install libmagick9-dev libmysqlclient-dev libsqlite3-dev libpq-dev ruby-dev
gem install rails --include-dependencies
gem install rake --version=0.8.7
gem install builder --version=3.0.0
gem install bundler coderay fastercsv jquery-rails json mysql2 net-ldap
gem install pg rack-openid rmagick sqlite3 test-unit yard
gem install jquery-rails --version=2.0.2
gem install mocha --version=0.12.3
gem install mysql --version=2.8.1
gem install shoulda --version=2.11
gem install ruby-openid --version=2.1.8
apt-get remove --purge libmagick9-dev libmysqlclient-dev libsqlite3-dev libpq-dev ruby-dev
apt-get autoremove --purge

Una vez instaladas las dependencias, la instalación de Redmine se realiza con los siguientes comandos:

/var/lib/gems/1.8/bin/rake generate_secret_token --trace
RAILS_ENV=production /var/lib/gems/1.8/bin/rake db:migrate
RAILS_ENV=production /var/lib/gems/1.8/bin/rake redmine:load_default_data
ruby script/rails server webrick -e production

Para que los enlaces de la interfaz se generen con el correspondiente subdirectorio hay que modificar el archivo config/environment.rb cambiando la última línea por lo siguiente:

RedmineApp::Application.routes.default_scope = {:path=>'/redmine', :shallow_path=>'/redmine'}
RedmineApp::Application.initialize!
Redmine::Utils::relative_url_root = '/redmine'

Para que los archivos estáticos se carguen correctamente, es necesario modificar el archivo config/environments/production.rb añadiendo la siguiente línea:

config.action_controller.asset_host = "http://ejemplo.com/estaticos"

Habrá que copiar la carpeta public de Redmine para que sea accesible desde http://ejemplo.com/estaticos/redmine, ya que todas las llamadas se realizarán añadiendo el subdirectorio. Por último, la configuración para que Apache realice las llamadas a webrick sería la siguiente:

<Location /redmine>
	ProxyPass http://localhost:3000/redmine
	ProxyPassReverse http://localhost:3000/redmine
</Location>

Después de realizar todos estos pasos, resulta evidente que un proyecto de la talla de Redmine debería simplificar el proceso para una instalación tan común como esta y tener una documentación más completa al respecto.

Cómo instalar Redmine con Apache en subdirectorio

Ya comenté anteriormente cómo instalar una aplicación programada en Ruby en Debian. En este caso se trata de Redmine, un estupendo gestor de proyectos que tiene la gran ventaja de ser muy completo para desarrolladores pero que también resulta muy sencillo para usuarios no técnicos.

El mayor problema que tuve al instalar Redmine fué al configurarlo para que funcionara sin problemas en un subdirectorio del tipo midominio.com/redmine, ya que parece pensado para ejecutarse en un dominio directamente. Para eso he optado por usar el directorio /var/lib/redmine porque si se ubica en la raiz del servidor web y se utiliza el servidor integrado a través de un proxy (que explicaré más adelante), se podría acceder directamente a los archivos Ruby en texto plano, lo que supone un evidente problema. Por otro lado, he utilizado SQLite de nuevo, pero también es posible utilizar MySQL.

El proceso sería el siguiente:

cd /var/lib
wget http://rubyforge.org/frs/download.php/75097/redmine-1.2.1.tar.gz
tar xzvf redmine-1.2.1.tar.gz
mv redmine-1.2.1.tar.gz redmine && cd redmine
sudo apt-get install ruby libruby rubygems rake ruby1.8-dev libsqlite3-dev
export GEM_HOME=/var/lib/redmine/vendor
gem install rails -v=2.3.11
gem install rake -v=1.1.0
gem install i18n -v=0.4.2
gem install fcgi sqlite3
cp config/database.yml.example config/database.yml

En este punto es necesario editar el archivo database.yml para añadir la configuración de la base de datos. En mi caso, para SQLite he usado lo siguiente:

production:
  adapter: sqlite3
  database: db/redmine.db
  host: localhost
  username: root
  password:
  encoding: utf8

El siguiente paso es realizar la instalación de Redmine:

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

Ahora es necesario dejar las primeras líneas del archivo environment.rb así:

# Be sure to restart your web server when you modify this file.

# Uncomment below to force Rails into production mode when 
# you don't control web/app server and can't set it the proper way
ENV['RAILS_ENV'] ||= 'production'
ENV['GEM_HOME'] = '/var/lib/redmine/vendor'

También es necesario añadir la línea Redmine::Utils::relative_url_root = "/redmine" al final del archivo para indicar el subdirectorio en donde estará instalado. Una vez realizados los cambios puede comprobarse que funcione correctamente ejecutando el servidor integrado mediante el comando ruby script/server webrick -e production que no debería dar ningún error.

Para integrar Redmine con Apache mediante FastCGI, es necesario añadir lo siguiente a la configuración, bien global o bien de un vhost:

Alias /redmine/ "/var/lib/redmine/public/"
FastCgiServer /var/lib/redmine/public/dispatch.fcgi -processes 1

<Directory "/var/lib/redmine/public>
	AddHandler fastcgi-script .fcgi
	Options +ExecCGI
	AllowOverride all
	Allow from all
	Order allow,deny
</Directory>

En el directorio /var/lib/redmine/public es necesario también renombrar el archivo dispatch.fcgi.example a dispatch.fcgi y añadir crear un .htaccess con el siguiente contenido:

RewriteEngine On
RewriteBase /redmine
RewriteRule ^$ index.html [QSA]
RewriteRule ^([^.]+)$ $1.html [QSA]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ /redmine/dispatch.fcgi [QSA,L]

Con estos pasos por fin quedará instalado en el subdirectorio /redmine. Si esta alternativa no es posible, puede recurrirse al servidor integrado WEBRick y que Apache realice peticiones mediante proxy. Para este caso, la configuración de Apache sería:

<Location /redmine>
        ProxyPass http://127.0.0.1:3000
        ProxyPassReverse http://127.0.0.1:3000/
</Location>

El servidor se puede lanzar con el comando ruby /var/lib/redmine/script/server webrick -d -e production. Por último, si se quiere usar SSL con este método, es necesario añadir a la configuración de Apache la línea RequestHeader set X_FORWARDED_PROTO 'https' para que el servidor WEBRick genere las URLs correctamente.

Cómo instalar Tracks 2.0 con SQLite en Debian Squeeze

Tracks es un sencillo pero potente software de gestión de tareas que sigue la metodología GTD. Está programado en Ruby y es de código abierto. La instalación resulta un poco problemática y he querido documentar un poco el proceso, ya que las guías que he encontrado están hechas para la anterior versión (la 1.7, de inicios del 2009).

El primer paso es asegurarse de que Apache está preparado. Es necesario instalar y habilitar el módulo libapache2-mod-fastcgi y activar AllowOverride All en la configuración para que no sea necesario añadir ningún vhost o configuración específica para Apache, haciendo uso únicamente de .htaccess.

Después hay que descargar y descomprimir Tracks en el directorio raiz del servidor (asumo /var/www):

wget https://github.com/TracksApp/tracks/tarball/v2.0
tar xzvf v2.0 && rm -f v2.0
mv TracksApp-tracks-22a0c94 tracks
cd tracks
cp db/tracks-20-blank.sqlite3.db db/tracks.db
cp config/database.yml.tmpl config/database.yml
cp config/site.yml.tmpl config/site.yml

Estos dos últimos archivos contienen la configuración. Para usar SQLite hay que indicar en el campo database la ruta completa al archivo .db que se acaba de copiar, y después personalizar los campos que se desee en site.yml.

Después es necesario instalar los paquetes de Ruby, sus dependencias y las gemas. Es necesario instalar varios paquetes dev pero que se pueden desinstalar una vez se hayan instalado las gemas:

sudo apt-get install ruby libruby rubygems rake
sudo apt-get install libxslt1-dev libxml2-dev libsqlite3-dev libfcgi-dev ruby1.8-dev
gem install RedCloth sqlite3 fcgi
gem install sanitize -v 1.2.1
sudo apt-get remove --purge libxslt1-dev libxml2-dev libsqlite3-dev libfcgi-dev ruby1.8-dev
sudo apt-get autoremove --purge
script/server -e production

Este último comando inicia el servidor WEBrick que permite comprobar si todas las dependencias están correctamente instaladas. Si todo va bien, debería aparecer algo similar a esto:

[2011-08-24 07:26:04] INFO  WEBrick 1.3.1
[2011-08-23 04:26:04] INFO  ruby 1.8.7 (2011-06-30) [x86_64-linux]
[2011-08-23 04:26:04] INFO  WEBrick::HTTPServer#start: pid=10333 port=3000

En este punto, tenemos Tracks funcionando en el puerto 3000 se podrá acceder desde a http://localhost:3000 pero también estará accesible desde http://localhost/tracks/public.