Vamos a instalar Redmine que es una herramienta para la gestión de proyectos, que con sus diversas funcionalidades permite a los usuarios de diferentes proyectos realizar el seguimiento y organización de los mismos.
Es necesario cumplir con algunos pre-requisitos:
- Tener instalado un Debian 10 y actualizado.
- Tener sudo correctamente configurado. Dado que voy a utilizar un usuario en esta oportunidad, no el usuario root.
- Finalmente tener instalado LAMP, aunque voy a mostrar rápidamente como hacerlo de un tirón sin explicaciones, pero podes ver como instalar LAMP en: https://nksistemas.com/instalando-lamp-en-el-nuevo-debian-10/
Paso 1: Instalación de LAMP
sudo apt install -y apache2 php libapache2-mod-php php-mysql php-mbstring php-xml php-zip mariadb-server
Ejecutamos el script de instalación de Mariadb
sudo mysql_secure_installation
Le damos un Enter cuando pregunte la contraseña, configuramos el password para el usuario root de la base de datos y después Enter hasta el final.
Paso 2: Adicionales para realizar bien la instalación
sudo apt update sudo apt install -y build-essential ruby-bundler ruby-dev zlib1g-dev libapache2-mod-passenger
Si el servicio de bases de datos que vamos a usar es MariaDB instalaremos también su biblioteca de desarrollo:
sudo apt install -y libmariadb-dev
Pero si vamos a usar MySQL:
sudo apt install -y libmysqlclient-dev
Paso 3: Creación de la base de datos
mysql -u root -p create database redmine charset utf8mb4; create user redmine@localhost identified by 'redminepass'; grant all privileges on redmine.* to redmine@localhost; flush privileges; exit
Paso 4: Descargar e instalación de Redmine
En la sección de descargas: https://www.redmine.org/projects/redmine/wiki/Download
cd /opt wget https://www.redmine.org/releases/redmine-4.1.1.tar.gz
Descomprimir
tar -xzvf redmine-4.1.1.tar.gz
Creamos el archivo de configuración, debemos primero copiar el archivo de ejemplo que se encuentra dentro de la carpeta descomprimida, nos posicionamos ahí
cd redmine-4.1.1/
Ahora copiamos en la misma ubicación
cp config/database.yml.example config/database.yml nano config/database.yml
Debemos especificar la base de datos, usuario y contraseña que creamos anteriormente:
production: adapter: mysql2 database: redminedb host: localhost username: redmine password: redminepass
Editamos el archivo Gemfile y desactivamos 2 gemas que no son necesarias en Debian 10:
nano Gemfile
Buscamos 2 opciones y las comentamos con un # delante de cada línea. Con nano buscamos con Ctrl+w
# gem 'tzinfo-data', platforms: [:mingw, :x64_mingw, :mswin] # gem "ffi", platforms: [:mingw, :x64_mingw, :mswin]
Paso 5: Instalar redmine
Y ahora debemos lanzar el instalador como usuario, no es conveniente como root.
bundle install
Nos pedirá la contraseña de nuestro usuario para lanzar aquellas tareas que necesiten permisos de sudo. Por eso es importante que sudo este bien configurado.
Continuaremos generando el token para cifrar las cookies:
bundle exec rake generate_secret_token
Creamos la estructura de la base de datos:
RAILS_ENV=production bundle exec rake db:migrate
Y poblamos la base de datos con la información inicial:
RAILS_ENV=production bundle exec rake redmine:load_default_data
La última pregunta es seleccionar el lenguaje en mi caso lo deje en español (es).
Paso 6: Configurar apache2
Vamos a editar el archivo passenger.conf y agregaremos la directiva Passenger.
sudo nano /etc/apache2/mods-available/passenger.conf
Pegamos lo siguiente en lo que ya existe, agregando la línea en negrita.
<IfModule mod_passenger.c> ... PassengerUser www-data </IfModule>
Ajustamos la propiedad de la carpeta de Redmine al usuario con el que corre el servicio web en Debian 10:
sudo chown -R www-data:www-data /opt/redmine/redmine-4.1.1/
Damos los permisos necesarios:
sudo chmod -R 755 files/ log/ tmp/ public/plugin_assets/
Creamos un enlace simbólico a la aplicación Redmine en la carpeta de documentos web por defecto de Debian 10:
sudo ln -s /opt/redmine/redmine-4.1.1/public/ /var/www/html/redmine
Y editaremos la configuración del servidor virtual por defecto:
sudo nano /etc/apache2/sites-available/000-default.conf
Pegamos el siguiente contenido al final
<Location /redmine> RailsEnv production RackBaseURI /redmine Options -MultiViews </Location>
Reiniciamos apache2
sudo systemctl restart apache2
Paso 7: Acceder vía web
Abrimos un navegador e ingresamos a: http://IP_Server//redmine si estas usando un laboratorio local http://localhost/redmine
En iniciar sesión nos solicitará el usuario que es admin y la contraseña que es admin también, nos solicitará cambiarla por primera vez.