Cómo instalar Redmine 3.2 en Xampp

En este artículo vamos a ver cómo instalar Redmine 3.2 en Xampp. Si recordamos Xampp es una equeña aplicación que incluye servidor Apache, PHP y MySQL de manera conjunta y ya preconfigurada para que podamos disponer de un servidor web sin necesidad de realizar apenas configuración.

Aunque lo ideal sería instalar nuestra herramienta de Gestión de Proyectos Redmine en un servidor Linux, puede sernos muy útil para los que desarrollamos sobre Windows instalar nuestro entorno sobre este tipo de plataformas.

Resumo los pasos que habría que dar. Al final del artículo tenéis una recopilación de los posibles problemas que os podéis encontrar en alguno de los pasos.

También te puede interesar:
→ Redirigir redmine del puerto 3000 al 80 por Apache
→ Configurar repositorio SVN Redmine
→ Diagrama entidad relación de Redmine realizado con MySQL Workbench
→ Cómo instalar Xampp con Ruby on Rails para Redmine

Pasos a realizar para instalar Redmine

1. Crear BBDD de MySQL para Redmine
2. Instalar Ruby
3. Instalar DevKits
4. Instalar gemas: json 1.8.3 y redcarpet 3.3.2
5. Instalar gema: Bundler
6. Ejecutar instalador de Redmine: bundle install --without development test rmagick

Instalar previamente

Tanto Ruby, como DevKits deben de ser de la misma arquitectura, 32 o 64 bits y hay que coger la versión en la que todos sean compatibles.

• Ruby 2.1.7 (32bits) installer: http://rubyinstaller.org/downloads/
• Development-Kit compatible con Ruby 2.1.7: http://rubyinstaller.org/downloads/
• Rails 4.2 (Se puede instalar usando este comando, gem install rails -v '4.2', pero el instalador de Redmine ya lo hace él solo por lo que no es necesario que hagamos nada.)

La versión de Ruby 2.2 me dio problemas en la instalación de Development Kits. Me fue imposible instarlarlo todo con esa versión.
Después probé con la versión 1.9.3 de Ruby, pero parece que para mejorar compatibilidades con otras gemas tiene una carpeta de gemas de ruby 1.9.1 y estas son incompatibles con la gema de Redcarpet. Por dicho motivo, tampoco pude completar una instalación satisfactoria con esta versión de Ruby. Al final, la única con que la pude completar la instalación fue con Ruby 2.1.7.

Instalación de Ruby 2.1

• Descargar Ruby 2.1 de 32 bits installer e instalarlo en d:\xampp\ruby21
• Crear las variables de entorno.
  • Añadir al PATH de windows la ruta: d:\xampp\ruby21\bin
  • Añadir al PATH de windows la ruta: d:\xampp\DevKits\bin
• Comprobar que está correctamente instalado Ruby ejecutando el comando: ruby -v

Instalación de Development-Kits

Los pasos que voy a seguir están basadas en las instrucciones originales de https://github.com/oneclick/rubyinstaller/wiki/Development-Kit

Descargamos las Development Kits y las descompromimos en d:\xampp\DevKits

Si tenemos un SO de 64 bits hay que modificar previamente el fichero d:\xampp\DevKitsdk.rb ya que tiene un BUG. Corregir la variable REG_KEYS con estos valores:

# variable corregida para sistemas de 64 bits
REG_KEYS = [
'SoftwareRubyInstallerMRI',
'SoftwareRubyInstallerRubinius',
'SoftwareWow6432NodeRubyInstallerMRI'
]

Ahora ejecutamos el siguiente comando desde d:\xampp\DevKits:

ruby dk.rb init

Este comando nos detectará todas las versiones de Ruby que tengamos instaladas en nuestro sistema. Deberemos modificar el fichero config.yml para que solo contenga la versión de Ruby que nos interese.

Una vez configurado el fichero config.yml, ya podemos realizar el paso que instala las Develpment Kits, ejecutando el comando:

ruby dk.rb install

Instalación de gemas necesarias

Ahora ya podremos ejecutar el siguiente comando para instalar la gema de JSON y comprobar a la vez que DevKits está instalado correctamente:

gem install json -v '1.8.3' --platform=ruby

Instalamos la gema Redcarpet:

gem install redcarpet -v '3.3.2'

Pasos para Instalar de Redmine

Ya tenemos todo lo necesario. Nuestro sistema ya instalado Ruby On Rails y podemos comenzar con la instalación de nuestro sistema de Gestión de Proyectos con Redmine.

Los pasos aquí descritos están basados en las instrucciones originales de la web de Redmine donde incluyo mis anotaciones propias donde me han surgido problemas que no vienen en dichas instrucciones.

Descargar y desplegar Redmine

Seguimos las instrucciones originales de Redmine:
http://www.redmine.org/projects/redmine/wiki/RedmineInstall

Descargamos el zip de Redmine y lo descomprimos en d:\xampp\htdocs\redmine-3.2.0

Creación de la BBDD

Arrancamos Xampp, con su Apache y MySQL.

Creamos la BBDD desde PHPMyAdmin.

Si queremos hacerlo por comandos:

CREATE DATABASE redmine CHARACTER SET utf8;
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'my_password';
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';

Si nuestro MySQL es anterior a la versión 5.0.2 nos podemos saltar el comando CREATE USER y ejecutar este:

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

Configurar la cadena de conexión a la BBDD

Actualizar el fichero de BBDD de Redmine con el nombre que hayamos usado: /config/database.yml en la entrada de "production" que utiliza la librería mysql2.

production:
adapter: mysql2
database: redmine3
host: localhost
username: root
password: root
encoding: utf8

Instalación de dependencias

Redmine usa Bundler para poder resolver las dependencias entre gemas. Para ello necesitamos instalarlo ejecutando el comando:

gem install bundler

Ahora tenemos que colocarnos bajo el directorio donde vamos a publicar nuestro Redmine. En nuestro caso en:

d:xampphtdocsredmine-3.2.0

Como no hemos instalado la gema de IMageMagick ejecutamos el comando:

bundle install --without development test rmagick

Si nos da problemas, podemos seguir las instrucciones la Wiki de Redmine:

• Instalar paquete .exe
• Configurar variables de entorno CPATH y LIBRARY_PATH
• Ejecutar "bundle install"

Generación de Token para protección de las claves

Este paso genera un Token aleatorio para que se utilizará para la generación de las cookies que almacenan la sesión de los usuarios. Es utilizado por Rails y previene de accesos malintencionados. Si generamos un nuevo Token invalidaremos todas las sesiones abiertas, pero esto requiere un reinicio del servidor.

Desde Redmine 2.x se hace mediante el comando:

bundle exec rake generate_secret_token

Creación de esquema de Base de Datos

Crear la variable de entorno:

set RAILS_ENV=production

y ejecutar el siguiente comando desde la carpeta de redmine para crear la estructura de BBDD:

bundle exec rake db:migrate

No hay foto ya que el log generado es muy extenso.

Cargar datos básicos en la Base de Datos

Redmine necesita de un conjunto de datos básicos para poder funcionar. Hay que lanzar el siguiente comando para que realice los inserts necesarios en nuestra base de datos.

bundle exec rake redmine:load_default_data RAILS_ENV=production

El sistema nos preguntará en qué idioma vamos a utilizar la aplicación. Instroducimos "es" de Español y cargará los datos básicos de configuración en ese idioma.

Y con eso es todo. ya tenemos instalado nuestro Redmine por completo.

Podemos sacar una foto de la configuración general de nuestro sistema si ejecutamos el comando:

gem env

Arrancar Servidor Web

Para el caso de Redmine 3.x debemos lanzar desde consola el siguiente comando:

bundle exec rails server webrick -e production

Yo por ejemplo, como nunca recuerdo de memoria el comando, me he creado un archivo BAT en el rail de mi Redmine, así cuando levanto la base de datos desde el panel de control de Xampp, ejecuto también mi BAT.

Acceso a Redmine

Introducir en el navegador la url:

localhost:3000

Usuario y contraseña por defecto es admin / admin

Otras configuraciones

Otros elementos que seguramente nos insterese configurar serán:

• Configurar email en el fichero configconfiguration.yml en la variable email_delivery.
• Configurar carpeta de adjuntos de los tickets en configconfiguration.yml en la variable attachments_storage_path.

Posibles problemas que podemos tener

No descarga paquetes con SSL

Si tenemos errores con SSL puede ser que se deba a problemas que tengamos en nuestra red. Para ello deberemos habilitar la posibilidad de descargar gemas sin SSL eliminando (con -r) el repositorio HTTPS y añadiendo (con -a) el repositorio HTTP,

gem sources -r https://rubygems.org/ - to temporarily remove secure connection

gem sources -a http://rubygems.org/ - add insecure connection

Ahora actualizaremos el listado de gemas que podemos decargar con el comando:

gem update --system

O si seguimos teniendo problemas con el SSL podemos usar este otro:

gem update --system --source http://rubygems.org/

Y ya podremos ejecutar nuevamente el comando que nos daba problemas.

Dependencias al ejecutar bundle install

Puede que a ejecutar el comando bundle install este no termine correctamente y nos pida ejecutar estos dos comandos para que el comando pueda ejecutarse completamente:

gem install rack-openid -v '1.4.2'

gem install actionview -v '4.2.7.1'

Error al instalar gemas

Could not find a valid gem in any repository

Esto se puede deber a que no tenemos ningún repositorio configurado en nuestra instalación de Ruby. Para comprobarlo lanzamos el siguiente comando:

gem sources

Si no sale nada tendremos que añadir un repositorio de la siguiente manera:

gem sources --add http://rubygems.org/

Si probamos de nuevo a instalar las gemas, ya no debería darnos ningún error.

Error: dl is deprecated please use fiddle

Se muestra el error pero al final acaba ejecutándose el comando db:migrate. Se trata solo de un warning. Puede que en un futuro haya que ejecutar otro comando para instalar la BBDD.

Guardar