Manual de Instalación
Contents
1. Instalaci n Redmine Emergya Documentaci n preparada para Modernizaci n y Gobierno Electr nico Ministeri ecretana General de Presidencia Empresa Emergya Consultor a JEMERGYA Autor Procedencia Antonio Fern ndez M nager de Negocio Equipo de Trabajo rea de Desarrollo de Negocio Versi n v1 0 Fecha 09 03 12 AENOR AENOR S 4 ii ACI O Lina E CMMI Rar Empr Empresa Gesti n Registrad ja CESEN Ambien tal nn ISO 9001 2000 ISO 14001 2000 CEA Instalaci n de Redmine Emergya 1 NDICE DE CONTENIDO T Req eriMIENtOS rt R A AA 3 1 1 Stema OPeratiVO iia a EO 3 1 2 Ruby Ruby on RAS Y TAC vocoder 3 13 Compatibilidad A Eee 4 1 4 Base de Dit A lic 4 1 5 Componentes OpciONAlesS ooooooccccccnnconccnccnononnnnnnnonnnnnonnnnnnnnnnnr non Ai rr rr anne rr nr rn nan E RARER ERa 5 A RedMINE aseena aeara aaa re erran raaa Aare ra aaaea Eaa d Aaaa aerea PE anaid aaea Emanaa Ea aA aaea AEEA 6 3 Pr cedimiento para la Instalaci n 7 3 1 Obtenci n del c digO fente uno alba 7 3 2 Creaci n de base de datos civic aaa ba aia dani 7 3 3 Configuraci n opciones de base de datOS coooccccnnociconocccccoaccnononconanncannnno nana ona EENE cc naar nn n rana rar nn nnnnr nn anno 7 3 4 Generar un almac n de la SESI N oooonnnncnnnncccnnncccnononccononcn conca nono n canon cananea 8 3 5 Creaci n estructura base de datOS ooomoccnnonccononoconnonncnnanannnonn2. 14 Rack 1 1 x RubyGems lt 1 8 1 9 3 1 3 x ruby 1 8 6 1 8 7 Rails 2 3 14 Rack 1 1 x RubyGems lt 1 7 1 2 x ruby 1 8 6 1 8 7 Rails 2 3 11 Rack 1 1 x RubyGems lt 1 6 1 1 x ruby 1 8 6 1 8 7 Rails 2 3 5 Rack 1 0 1 RubyGems lt 1 4 1 0 x ruby 1 8 6 1 8 7 Rails 2 3 5 Rack 1 0 1 RubyGems lt 1 4 0 9 x ruby 1 8 6 1 8 7 Rails 2 3 5 Rack 1 0 1 RubyGems lt 1 4 0 8 x ruby 1 8 6 1 8 7 Rails 2 1 2 Las versiones oficiales incluyen la versi n de Rails apropiada en su directorio correspondiente por lo que s lo necesita instalar las versiones correctas de Ruby RubyGems Rake Rack Si no si obtiene la fuente desde el repositorio de Redmine usted tendr que instalar la versi n de Rails requerida en el equipo con gem install rails version lt version requerida gt Instalaci n de Redmine Emergya E 1 3 Compatibilidad e Ruby 1 9 no es compatible a n Se requiere usar Ruby 1 8 x como se indic anteriormente e Se requiere Rake 0 8 7 versi n 0 9 x no es compatible con Rails a n e Es necesario Rack 1 1 x 1 1 0 tiene un error haciendo uso de comillas simples La migraci n de base de datos fallar a con otra versi n e Mongrel 1 1 5 necesita un parche para funcionar bien con Rails 2 3 11 En el caso de actualizaci n otro problema puede aparecer por alg n tiempo despu s de la migraci n 7857 e 118n 0 4 2 se requiere para Redmine gt 1 0 5 e Rails 2 3 11 hasta 2 3 14 sufren
3. lt postgres_user_password gt encoding utf8 schema_ search path lt database schema gt default public Generar un almac n de la sesi n rake generate session store Creaci n estructura base de datos Crear la estructura de la base de datos ejecutando el comando siguiente en el directorio ra z de la aplicaci n RAILS ENV production rake db migrate Instalaci n de Redmine Emergya F 3 6 3 7 Se crear n tablas y una cuenta de administrador Si sale este error Rake aborted no such file to load net https es necesario instalar libopensslI ruby1 8 en Ubuntu de la siguiente forma apt get install libopensslI ruby1 8 Introducci n datos configuraci n por defecto en base de datos Introduzca los datos de configuraci n por defecto en la base de datos ejecutando el comando siguiente RAILS ENV production rake redmine load default data Este paso es opcional pero altamente recomendado ya que puede definir su propia configuraci n a partir de cero Se cargar por defecto roles de usuarios registros estados de flujos de trabajo y etiquetas Configuraci n de los permisos Nota Los usuarios de Windows tienen que saltarse esta secci n El usuario que ejecuta Redmine debe tener permiso de escritura en los siguientes subdirectorios files log tmp crear el ltimo si no est presente Suponiendo que se ejecuta Redmine con un usuario Redmine mkdir tmp public plugin assets sudo chown R redmi
4. similar sudo aptitude install libdbd pg ruby1 8 SQLite 3 1 5 Componentes opcionales e Binarios del SCM por ejemplo svn para la navegaci n de repositorios debe estar disponible en su PATH Ver http www redmine org projects redmine wiki RedmineRepositories para la compatibilidad y los requisitos del SCM e RMagick http rmagick rubyforge ora para permitir la exportaci n de Gantt a imagen jpeg e Ruby OpenID Library http www janrain com openid enabled para habilitar el soporte de OpenID s lo en Redmine trunk 0 9 dev Requerida Versi n 2 o superior Instalaci n de Redmine Emergya 2 VERSI N DE REDMINE Se recomienda a la mayor a de los usuarios instalar las versiones puntuales de Redmine Redmine actualmente publica una nueva versi n cada 6 meses y estas publicaciones son consideradas muy usables y estables No se recomienda instalar Redmine del tronco a menos que est muy familiarizado con Ruby on Rails y se encuentre siempre al d a con los cambios El Tronco se rompe a menudo Instalaci n de Redmine Emergya F 3 PROCEDIMIENTO PARA LA INSTALACI N 3 1 3 2 3 3 Obtenci n del c digo fuente Obtener el c digo fuente de Redmine ya sea a trav s de la descarga de una versi n empagquetada o revisando el repositorio de c digo donde se encuentre Por ejemplo en http rubyforge org frs group_id 1850 Creaci n de base de datos Crear una base de datos vac a y nombr
5. una base de datos mysql Database usr bin mysqldump u lt username gt p lt password gt lt redmine database gt gzip gt path to backup db redmine date y m d gz Attachments rsync a path to redmine files path to backup files 12 Instalaci n de Redmine Emergya 5 ACTUALIZACI N A UNA NUEVA VERSI N E 13 Instalaci n de Redmine Emergya JEMERGYA La SOLUCI N est en SER LIBRES Nuevo Tajamar 555 Piso 6 Las Condes Santiago de Chile Tel 562 427391700 www emergya cl E 14
6. de un grave problema con el env o de correos electr nicos a varios destinatarios cuando estos superan la cifra de 8 Ver http www redmine org issues 8751 para m s detalles y soluci n 1 4 Base de Datos e MySQL 5 0 o superior recomendado Hay que asegurarse de instalar los enlaces de C para Ruby que mejoran el rendimiento Se puede obtener mediante la ejecuci n de gem install mysql Si se tiene problemas para instalar la gema mysqli ir a http wiki rubyonrails org database support mysal e PostgreSQL 8 Hay que asegurarse de que el DateStyle de su base de datos de se establece en la norma ISO ajuste de PostgreSQL por defecto e Se puede configurar para que se establezca ejecutando ALTER DATABASE redmine_db SET dateStyle ISO MDY e Algunos errores en PostgreSQL 8 4 0 y 8 4 1 afectan al comportamiento de Redmine http www redmine org issues 4259 http www redmine org issues 4314 se solucionan en PostgreSQL 8 4 2 e Hay que instalar el adaptador de PosgreSQL para Ruby Se puede conseguir mediante la ejecuci n uno de los siguientes gem install postgres pr nativo de la aplicaci n de Ruby no activamente mantenida por su autor presenta problemas con 9 x gem install pg funciona con conexiones SSL puede necesitar bibliotecas de desarrollo y paquetes para su sistema operativo antes de que se compile Instalaci n de Redmine Emergya Ubuntu OS bibliotecas de desarrollo se puede instalar con o
7. e de usuario de Redmine por ejemplo Para MySQL create database redmine character set utf8 create user redmine localhost identified by my password grant all privileges on redmine to redmine f localhost Para las versiones de MySQL anteriores a 5 0 2 omita el paso de la creaci n de usuario en su lugar grant all privileges on redmine to redmine fa localhost identified by my password Para PostgreSQL CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD my password NOINHERIT VALID UNTIL infinity CREATE DATABASE redmine WITH ENCODING UTF8 OWNER redmine Configuraci n opciones de base de datos Copia el archivo config database yml example a config database yml y edita este archivo con el fin de configurar las opciones de la base de datos para el entorno de producci n Ejemplo para una base de datos MySQL production adapter mysql database redmine Instalaci n de Redmine Emergya E 7 3 4 3 5 host localhost username redmine password my password Si el servidor no se est ejecutando en el puerto est ndar 3306 utiliza esta configuraci n en su lugar production adapter mysql database redmine host localhost port 3307 username redmine password my password Ejemplo para una base de datos PostgreSQL puerto por defecto production adapter postgresql database lt your_database_name gt host lt postgres_host gt username lt postgres user gt password
8. ne redmine files log tmp public plugin _assets sudo chmod R 755 files log tmp public plugin assets Comprobaci n de la instalaci n ejecutando el servidor web WEBrick ruby script server webrick e production Una vez que ha lanzado WEBrick dirija su navegador a http localhost 3000 Ahora deber a ver la p gina de bienvenida de la aplicaci n Instalaci n de Redmine Emergya E Nota WEBrick no es adecuado para el uso normal utilice nicamente WEBrick para probar que la instalaci n ha llegado correctamente hasta este punto No se recomienda el uso de webrick para otra cosa que el desarrollo Utilice una de las muchas gu as existentes para configurar Redmine utilizar cualquiera de los pasajeros aka mod_rails aka o Mongrel para servir su Redmine 3 8 Utilizaci n cuenta predeterminada del administrador para el inicio de sesi n login admin password admin Usted puede ir a Admin amp Settings para modificar la configuraci n de la aplicaci n o 10 Instalaci n de Redmine Emergya F 1 4 CONFIGURACI N Desde la versi n 1 2 0 la configuraci n de Redmine se definen en un archivo llamado config configuration yml Si se necesita para reemplazar la configuraci n predeterminada de la aplicaci n basta con copiar config configuration yml example a config configuration yml a continuaci n editar el nuevo archivo el archivo est bien comentado por s mismo por lo que se debe echar una ojeada al mi
9. nnnnnro na nana cnn nnn aa a AAAA e inaa 8 3 6 Introducci n datos configuraci n por defecto en base de katOS ocooocccinnoccconoccnonancnconnnnnnonanononnnancnnnnnns 9 3 7 Configuraci n de lOS PErMISOS viii a ias 9 3 8 Utilizaci n cuenta predeterminada del administrador para el inicio de Sesi N oooonocnnnnccninnnnccananccon 10 ACONMQUE ION once 11 4 1 Configuraci n del servidor de correo SMTP ooonocccnnncccnnonnnnonannnnnnnnnnonnnnnn nn nn nnnn nn naar nac nnn nan ran rra ranrn nana 11 4 2 Configuraci n de SOM noccinncccnoniconanrnno nano 11 4 3 Configuraci n de almacenamiento de datos AdjUNtOS ococonccccninocicnnocccnanncnonanncnnn canon cnn nano na nnnnnncnnnnn 11 4 4 Configuraci n del registro rrisin o 11 Ab BACKUPS A E A E E 12 5 ActAalzaci n A una nueva VES ON con 13 Instalaci n de Redmine Emergya 1 REQUERIMIENTOS 1 1 Redmine deber a funcionar en la mayor a de los sistemas operativos Unix Linux Mac servidor de Mac y Windows siempre y cuando Ruby est disponible en esa plataforma Ver HowTos espec fica de instalaci n aqu 1 2 Sistema operativo Ruby Ruby on Rails y rack EN Las versiones regeridas de Ruby y Ruby on Rails para una determinada versi n de Redmine son Versi n de RedMine Versiones de Ruby Soportadas Versi n requerida de Rails Versiones soportadas de Rack Versiones soportadas de Rubygems current trunk ruby 1 8 7 1 9 2 Rails 2 3
10. smo Esta configuraci n se puede definir por entorno de Rails producci n desarrollo prueba Importante no se olvide de reiniciar la aplicaci n despu s de cualquier cambio 4 1 Configuraci n del servidor de correo SMTP 4 2 Configuraci n de SCM 4 3 Configuraci n de almacenamiento de datos adjuntos 4 4 Configuraci n del registro Redmine se encuentra por defecto a un nivel de registro de informaci n escribiendo en el registro de subdirectorio Dependiendo de la utilizaci n del sitio esto puede ser una gran cantidad de datos y para evitar que el contenido del archivo de registro siga creciendo sin l mite se considera rotar esos datos ya sea a trav s de una utilidad de sistema como logrotate o mediante el fichero config additional_environment rb Para ulitilizar este ltimo m todo copia config additional_environment rb example a config additional_environment rb y agregue las l neas siguientes Logger new PATH NUM_ FILES TO ROTATE FILE SIZE config logger Logger new config log path 2 1000000 config logger level Logger INFO w 11 Instalaci n de Redmine Emergya F 4 5 Backups Copias de seguridad de Redmine deben incluir datos almacenado en su base de datos Redmine archivos adjuntos almacenado en el directorio de archivos de su instalaci n Redmine Aqu hay un simple script de shell que se puede utilizar para copias de seguridad diarias suponiendo que usted est utilizando
Download Pdf Manuals
Related Search