Академический Документы
Профессиональный Документы
Культура Документы
Fecha: Referencia:
EJIE S.A.
Mediterráneo, 3
Tel. 945 01 73 00*
Fax. 945 01 73 01
01010 Vitoria-Gasteiz
Posta-kutxatila / Apartado: 809
01080 Vitoria-Gasteiz
www.ejie.es
Este documento es propiedad de EJIE, S.A. y su contenido es confidencial. Este documento no puede ser reproducido, en su totalidad o parcialmente, ni
mostrado a otros, ni utilizado para otros propósitos que los que han originado su entrega, sin el previo permiso escrito de EJIE, S.A.. En el caso de ser
entregado en virtud de un contrato, su utilización estará limitada a lo expresamente autorizado en dicho contrato. EJIE, S.A. no podrá ser considerada
responsable de eventuales errores u omisiones en la edición del documento.
Control de documentación
Título de documento: MANTIS
Histórico de versiones
Código:
Versión: 1.1
Fecha:
Resumen de cambios:
Primera versión.
Control de difusión
Firma: Fecha:
Distribución:
Referencias de archivo
Localización:
5.1 Memoria................................................................................................................23
6.1 Instalación.............................................................................................................24
El presente documento describe cuáles son los pasos necesarios que se deben seguir para la correcta
puesta en marcha del Mantis. Este proceso incluye, todos los aspectos relativos al proceso de instalación de los
distintos programas que componen la aplicación y los parámetros de configuración iniciales para un correcto
funcionamiento de la aplicación.
2 Conceptos básicos
El acceso a la aplicación (al ser una aplicación de tipo Web), se realiza mediante un navegador. El
Mantis, no tiene ninguna restricción al tipo de navegador que debe usarse para trabajar como cliente.
El objetivo de Mantis es crear y mantener un sistema de control de Bugs, y está diseñado de manera que
sea fácilmente modificable, personalizable y actualizable.
El Mantis se despliega sobre el servidor Web (servidor http Apache) y usará la base de datos MySQL
para la gestión de información.
Puede ser instalado en sistemas operativos Windows, sistemas operativos MacOS o sistemas operativos
de tipo Unix.
http://www.mantisbt.org/
El presente documento hace referencia a las siguientes versiones de producto las cuales son las estables
y recomendadas:
Mantis
MySQL
Apache Web Server
Módulo Apache PHP
El servidor web y el servidor de base de datos se instalarán sobre la misma máquina física.
Para el correcto funcionamiento del Mantis es necesario tener en cuenta que, los distintos componentes
de la arquitectura deben ser visibles los unos con los otros. Se deberán configurar los distintos DNS y se
deberán tener abiertos una serie de puertos específicos para que la herramienta funcione correctamente.
3.1.3.Software y usuarios
No obstante, si se desea una actualización de versiones, el software podrá descargarse desde las
siguientes direcciones:
MySQL: http://dev.mysql.com/downloads/
Apache Web Server: http://httpd.apache.org/download.cgi
Módulo Apache PHP: http://www.php.net/downloads.php
Mantis: http://www.mantisbt.org/download.php
Tamaño: 1794 MB
Nota: Esta estimación de espacio necesario, está efectuada en base a estimaciones iniciales para
una instalación de todos los productos, dejando el espacio necesario no solo para la instalación de los
productos, sino que también hay que dejar espacio para la compilación de los mismos.
Type ‘help;’ or ‘\h’ for help. Type ‘\c’ to clear the buffer.
[mysql.server]
user=mysql
basedir=/var/lib
[mysql_safe]
err-log=/var/log/mysqld.log
pid-file=/var/run/mysqld/mysqld.pid
Se asume la instalación de una instancia de servidor web Apache dedicada al conjunto de herramientas
No obstante también se podría optar por reutilizar alguna de las ya existentes, en cuyo caso,
evidentemente no sería necesario todo el proceso descrito a continuación.
Las siguientes tareas se realizarán con el usuario genérico creado a tal efecto:
1. Desempaquetar httpd-2.2.2.tar.gz sobre /opt/temp
# cd /opt/temp
# tar -xvzf httpd-2.2.2.tar.gz
2. Configurar la compilación para que la instalación se lleve a cabo en /opt/apache2
# cd /opt/tmp/httpd-2.2.2.tar.gz
# ./configure \
--enable-so
--prefix=/opt/apache2
3. Compilar e instalar
# make
# make install
4. Configurar el servidor. Para ello editamos el archivo httpd.conf de /opt/apache2/conf y modificamos
las siguientes líneas
DocumentRoot “/opt/php”
ServerAdmin sd-apache@<dominio>
ServerName <dominio>
Listen <dominio>:<puerto>
DirectoryIndex index.html index.php index.htm index.html.var
User generico
Group users
Nota: Se deberá ajustar el valor de puerto de escucha para evitar colisiones con otras instancias ya
configuradas.
5. Comprobar que todo ha ido correctamente. Para ello crear en /opt/php un archivo index.html con el
siguiente contenido
<html>
<body>
<H1> OK </h1>
</body>
</html>
6. Arrancar el servicio como root
# /opt/apache2/bin/apchectrl start
7. Utilizar el navegador para ver que la pagina se muestra correctamente
http://<dominio>:<puerto>/index.html
8. Instalar el servicio en el init.d para centralizar su acceso, deteniendo primero el servidor apache
arrancado anteriormente
# /opt/apache2/bin/apachectrl stop
Las siguientes tareas se realizarán con el usuario root, teniendo en cuenta que existe una instalación de
Apache en la máquina operativa.
Las siguientes tareas se realizarán con el usuario generico creado a tal efecto:
1. Desempaquetar php-5.1.4.tar.gz sobre /opt/temp
# cd /opt/temp
# tar -xvzf php-5.1.4.tar.gz
2. Configurar la compilación indicando la ruta donde se encuentra instalado MySQL e indicando que el
módulo se va a compilar con soporte MySQL y APXS pudiendo así ser este módulo cargado dinámicamente en
Apache.
# cd /opt/tmp/$PHP
# ./configure \
--with-mysql=/opt/mysql
--with-apxs2=/opt/apache2/bin/apxs
3. Compilar
# make
4. Instalar
# make install
Nota: este paso modifica el fichero de configuración Apache indicando que se debe cargar el Módulo de
PHP.
Una vez instalados todos los productos de base se procederá a instalar la herramienta mantis:
El código php propio del producto que será servido por el servidor web Apache
La instancia, tablas y usuario de base de datos MySQL que almacenará la información
Configuración básica de mantis
3.5.1.Código PHP
Las siguientes tareas se realizarán con el usuario generico creado a tal efecto:
1. Desempaquetar mantis-1.0.3.tar.gz sobre /opt/temp
# cd /opt/temp
# tar -xvzf mantis-1.0.3.tar.gz
2. Renombrar el directorio
# mv mantis-1.0.3 mantis
3. Mover el directorio mantis al directorio de los módulos de Apache
# mv mantis /opt/php
4. Una vez hecho esto, se debe acceder mediante un navegador web a la página (.php) que realiza la
configura la conexión de Mantis a su base de datos.
Las siguientes tareas se realizarán con el usuario generico creado a tal efecto:
Tras introducir los parámetros necesarios, se pulsa en el botón “Install/Upgrade Database” para que se
realice el proceso de configuración de la conexión y la creación de las estructuras de datos.
Una vez se ha completado correctamente la instalación de Mantis, el siguiente paso es configurar una
serie de parámetros básicos para el correcto funcionamiento de Mantis.
Las siguientes tareas se realizarán con el usuario generico creado a tal efecto:
1. Editar el fichero /opt/php/mantis/config_inc.php
# cd /opt/php/mantis
# vi config_inc.php
2. Realizar los siguientes cambios:
Configurar el servicio de correo electrónico (esencial para el correcto funcionamiento de Mantis).
Dentro del fichero se deben completar los datos de estas entradas:
$g_default_languaje = ‘spanish’
Para que no salga en la pantalla inicial el enlace para poder crearse cuentas uno mismo
$g_allow_signup = OFF
3. Por motivos de seguridad, una vez instalado el Mantis se debe o bien eliminar la carpeta “admin” o
bien proteger su acceso para que no se pueda volver a reconfigurar la aplicación desde la interfaz web.
Borrar el directorio admin de Mantis
# cd /opt/php/mantis
# rm -rf admin
# cd /opt/php/mantis
# chown root:root admin
7. Para completar la configuración de un usuario, se debe acceder a la nueva cuenta mediante el correo
que envía el mantis a la dirección de correo especificada y configurar entonces el password
9. Una vez terminada la configuración del nuevo usuario de administración, se debe borrar el usuario de
administración por defecto. Para ello, acceder al perfil del usuario por defecto (administrator) y seleccionar la
opción de eliminar usuario.
Con objeto de poder recuperar la configuración inicial de los productos instalados se recomienda:
Para comprobar el estado del servicio, se accederá a la siguiente ruta y pulsando en el enlace “Check”:
http://<dominio>:<puerto>/mantis/admin/index.php
Puesto que Mantis es una aplicación desplegada en un servidor Apache, el proceso de arranque/parada
del mismo corresponderá al proceso de arranque/parada de Apache.
No se contempla un proceso de backup/restore selectivo, es decir, de solo las aplicaciones deseadas, así
el proceso de restauración podría generar la perdida de la información cargada desde el período comprendido
entre la fecha del último backup y la fecha de recuperación. Dicha circunstancia se comunicará a los
responsables de las aplicaciones.
5.1 Memoria
Mantis es una aplicación que no necesita una gran cantidad de espacio en disco para su funcionamiento.
En principio las necesidades de memoria de la misma son de tipo bajo (250 MBytes).
Cabe recordar que mantis guarda sus datos sobre la base de datos MySql, y que en nuestro caso se ha
configurado el directorio de almacenamiento de datos /servapp/mysql.
Hay que tener en cuenta, que estas cifras son variables y que dependen mucho de la cantidad y tamaño
de los ficheros que se pueden adjuntar con los Bugs.
Nota: Esta estimación esta efectuada en base al adjunto de un documento en formato Word por cada una
de las incidencias dadas de alta en el sistema. El tamaño del documento oscilará entre los 300kb y los 1000Kb.
Se ha configurado el sistema para no permitir ficheros con tamaño superior a 1000Kb (variable $g_max_file_size
del fichero /opt/php/mantis/config_inc.php)
6.1 Instalación
4. Arrancar el servicio
# cd /opt/apache2/bin
# apachectrl start