User Tools

Site Tools


informatica:linux:redmine

This is an old revision of the document!


REDMINE

ruby project amangement gantt

Probado en Ubuntu 12.04.2 LTS

Instalacion

http://www.redmine.org/projects/redmine/wiki/RedmineInstall

1. Descarga y descompresion (en este ejemplo en '/var/www/redmine'):

http://www.redmine.org/projects/redmine/wiki/Download

cd /var/www
sudo wget http://rubyforge.org/frs/download.php/76771/redmine-2.2.3.tar.gz
sudo tar xvfz redmine-2.2.3.tar.gz
sudo ln -s redmine-2.2.3 redmine
sudo chown -R www-data:www-data redmine

2. (OPCIONAL) Instalar paquetes. Los necesitamos si vamos a usar MySQL y RMagick (para manipular PDF y PNG):

sudo aptitude install libmysqlclient-dev libmagickwand-dev

3. Instalar 'bundler' y las 'gems' requeridas:

sudo aptitude install rubygems
cd /var/www/redmine
sudo gem install bundler
sudo bundle install --without development test postgresql sqlite

OJO si intentamos 'sudo aptitude install rubygems -R' fallara en la instalacion de la gem de json

3.1 (Opcional)

Depende de la version de ruby:

<= 1.8.6 : unsupported
 = 1.8.7 : gem install rdoc-data; rdoc-data --install
 = 1.9.1 : gem install rdoc-data; rdoc-data --install
>= 1.9.2 : nothing to do! Yay!

En este caso:

sudo gem install rdoc-data; sudo rdoc-data --install

4. Crear el usuario para conectarse a la Base de Datos (MySQL en este ejemplo):

create database redmine character set utf8;
create user 'redmine'@'localhost' identified by 'my_password';
grant all on redmine.* to 'redmine'@'localhost';

5. Crear el archivo de configuracion (MySQL en este ejemplo):

sudo vim /var/www/redmine/config/database.yml

Con el siguiente contenido:

production:
  adapter: mysql
  database: redmine
  host: localhost
  username: redmine
  password: my_password

6. Generar la clave secreta de sesion:

cd /var/www/redmine; sudo rake generate_secret_token

7. Crear el esquema de Base de Datos (hacerlo como 'root' creo que es necesario):

cd /var/www/redmine; sudo RAILS_ENV=production rake db:migrate

8. Alimentar de datos la Base de Datos (hacerlo como 'root' creo que es necesario):

cd /var/www/redmine; sudo RAILS_ENV=production rake redmine:load_default_data

9. Arrancar el servidor web de prueba y probar que redmine es accesible:

cd /var/www/redmine; sudo ruby script/rails server webrick -e production

Abrir un navegador y acceder a redmine:

http://localhost:3000

Usuario y contrasenya: admin

Apache + SSL + redmine

http://www.redmine.org/projects/redmine/wiki/HowTo_configure_Apache_to_run_Redmine Seccion 'Ubuntu Server (Version ?) (This not don't work for 8.04 LTS)'

IMPORTANTE Seguir las instrucciones siguientes, es mucho mas simple que en las instrucciones de arriba.

1. Instalar el modulo passenger:

sudo aptitude install libapache2-mod-passenger

2. Configurar:

<VirtualHost *:443>
        ServerName redmine.myserver.com
        ServerAdmin webmaster@localhost
        DocumentRoot /var/www/redmine/public

        SSLEngine on
        SSLCertificateFile    /etc/ssl/certs/ssl-cert-snakeoil.pem
        SSLCertificateKeyFile /etc/ssl/private/ssl-cert-snakeoil.key

        <Directory />
                Options FollowSymLinks
                AllowOverride None
        </Directory>

        <Directory /var/www/redmine/public>
                RailsEnv production
                RailsBaseURI /redmine
                Options Indexes ExecCGI FollowSymLinks
                Order allow,deny
                allow from all
                AllowOverride all
        </Directory>

        ErrorLog ${APACHE_LOG_DIR}/redmine.error.log

        # Possible values include: debug, info, notice, warn, error, crit,
        # alert, emerg.
        LogLevel warn

        CustomLog ${APACHE_LOG_DIR}/redmine.access.log combined
</VirtualHost>

IMPORTANTE la ruta es /public (/var/www/redmine/public en el ejemplo)

3. Reiniciar apache:

sudo /etc/init.d/apache2 restart

4. Acceder:

http://redmine.myserver.com

Configuración correo

Si queremos que redmine envíe notificaciones:

1. Crear el archivo:

sudo vim /var/www/redmine/config/configuration.yml

Con el siguiente contenido:

production:
  email_delivery:
    delivery_method: :sendmail

2. (COMPROBAR) Creo que es necesario reiniciar el servidor de páginas web, apache en este caso:

sudo /etc/init.d/apache2 restart

3. Iniciar sesión en redmine con un usuario con permisos de administrador

4. Ir a Administration / Settings / Email notifications y realizar los ajustes pertinentes

5. Probar a asignar una tarea a un usuario, debería llegarle un mensaje. Se puede mirar los logs:

sudo tail -F /var/log/mail.log
...

Mar 21 18:25:06 itcumulus postfix/pickup[832]: AB7FB46031: uid=1000 from=<ubuntu>
Mar 21 18:25:06 itcumulus postfix/cleanup[2864]: AB7FB46031: message-id=<20130321182506.AB
7FB46031@localhost>
Mar 21 18:25:06 itcumulus postfix/qmgr[833]: AB7FB46031: from=<REMITE@DOMINIO.COM>, size
=338, nrcpt=1 (queue active)
Mar 21 18:25:07 itcumulus postfix/smtp[2868]: AB7FB46031: to=<DESTINO@DOMINIO.COM>, relay=ASPM
X.L.GOOGLE.com[173.194.75.26]:25, delay=0.52, delays=0.04/0.01/0.11/0.36, dsn=2.0.0, statu
s=sent (250 2.0.0 OK 1363890307 l8si26312242vdw.150 - gsmtp)
Mar 21 18:25:07 itcumulus postfix/qmgr[833]: AB7FB46031: removed

Autenticacion LDAP

1. Login como admin

2. Ir a Administration / LDAP authentication

3. Pulsar en “New authentication mode”

4. Rellenar los campos tal que asi:

Setting Value Comment
Name LDAP de Mi empresa
Host ldap.example.com
Port 636 Usamos LDAPS, no STARTTLS
LDAPS Marcado Usamos LDAPS, no STARTTLS
Account cn=admin,dc=example,dc=com Es recomendable crear un usuario con permisos de solo lectura en lugar de este
Password * -
Base DN ou=people,dc=example,dc=com -
On-the-fly user creation Marcado -
Login attribute uid -

5. Grabar

6. Probar

Incrementar nivel de logs

1. Crear el siguiente documento ('/srv/www/redmine' es la ruta a la instancia redmine):

sudo vim /srv/www/redmine/additional_environment.rb

Con el siguiente contenido:

config.logger = Logger.new('/var/log/redmine.log', 2, 1000000)
config.logger.level = Logger::INFO

2. Ajustar permisos por si las moscas:

sudo chown www-data:www-data /srv/www/redmine/additional_environment.rb

3. Reiniciar apache:

sudo /etc/init.d/apache restart

Errores

NameError (undefined local variable or method `disk_directory' for #<Attachment

Sucede porque no existe ese valor en la base de datos. Solucion:

cd /srv/www/redmine; sudo RAILS_ENV=production rake db:migrate
informatica/linux/redmine.1369925297.txt.gz · Last modified: 2015/04/13 20:19 (external edit)