Mantis:

Manual de administracin

Fecha: 11/09/2007

Referencia:

EJIE S.A. Mediterrneo, 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 propsitos 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 utilizacin estar limitada a lo expresamente autorizado en dicho contrato. EJIE, S.A. no podr ser considerada responsable de eventuales errores u omisiones en la edicin del documento.

Control de documentacin
Ttulo de documento: MANTIS

Histrico de versiones
Cdigo: Versin: Fecha: Resumen de cambios: 1.0

Cambios producidos desde la ltima versin

Primera versin.

Control de difusin
Responsable: Ander Martnez Aprobado por: Ander Martnez Firma: Distribucin: Fecha: 11/09/2007

Referencias de archivo
Autor: Consultora de reas de conocimiento Nombre archivo: Localizacin: Mantis. Manual de administracin vn.n.doc

Mantis. Manual de administracin

2/42

Contenido
Captulo/seccin Pgina

1 2 3 3.1 3.2 3.3 3.4 4 4.1

Introduccin Conceptos bsicos Configuracin inicial de Mantis COMPROBACION DEL DIRECTORIO ADMIN COMPROBACION DE CONFIGURACIN CAMBIAR LA CONFIGURACION COMPROBACIN DE USUARIO DE ADMINISTRACIN ADMINISTRACION DE MANTIS ADMINISTRACION DE USUARIOS

5 5 5 5 6 7 7 12 12 12 14 16 17 19 19 24 25 25 27 29 30 31 31 33 34

4.1.1. Creacin de usuarios 4.1.2. Actualizacin de usuarios 4.1.3. Eliminacin de usuarios 4.1.4. Perfiles de usuario 4.2 ADMINISTRACIN DE E-MAILS

4.2.1. Acceso a la configuracin de e-mails 4.2.2. Configuracin por defecto 4.3 ADMINISTRACIN DE PROYECTOS

4.3.1. Creacin de un Nuevo Proyecto 4.3.2. Modificacin de Proyectos 4.3.3. Gestin de usuarios 4.3.4. Asociacin de subproyecto 5 5.1 5.2 6 ADAPTACION DE LA PLANTILLA DEFINICION DE CAMPOS PERSONALIZADOS ASIGNACION DE CAMPOS PERSONALIZADOS DEFINICIN DE PROYECTOS

Mantis. Manual de administracin

3/42

6.1 6.2

PASO 1: ALTA DE PROYECTO PASO 2: ASOCIACIN DE USUARIOS

34 35 35 37 38 40 40 40 40 41 41 41

6.2.1. Comprobar usuarios 6.2.2. Aadir nuevos usuarios 6.3 PASO 3: CONFIGURAR PROYECTO

6.3.1. Asociar usuarios al proyecto 6.3.2. Asociacin como subproyecto 6.3.3. Asociar campos personalizados 6.3.4. Configuracin por defecto de e-mails 7 7.1 7.2 Recursos necesarios Memoria Espacio en Disco

Mantis. Manual de administracin

4/42

Introduccin

El presente documento describe cuales son los procesos de configuracin que deben realizarse para la correcta explotacin de Mantis. El contenido del documento integra, tanto los aspectos de administracin como los caractersticas de funcionamiento de la aplicacin; necesarios para un correcto uso de la misma.

Conceptos bsicos
Mantis es un sistema de registro y control de Bugs basado en Web.

El acceso a la aplicacin (al ser una aplicacin de tipo Web), se realiza mediante un navegador. El Mantis, no tiene ninguna restriccin 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 diseado de manera que sea fcilmente modificable, personalizable y actualizable. Mantis est desarrollado en PHP y requiere para su correcto funcionamiento Una base de datos (MySQL). Un servidor de aplicaciones Web (servidor http Apache) Mdulo PHP Apache El Mantis se despliega sobre el servidor Web (servidor http Apache) y usar la base de datos MySQL para la gestin de informacin. Puede ser instalado en sistemas operativos Windows, sistemas operativos MacOS o sistemas operativos de tipo Unix. Para obtener informacin adicional sobre el producto acceder a su pgina web: http://www.mantisbt.org/

Configuracin inicial de Mantis

Una vez se completa el proceso de instalacin de Mantis correctamente, para su correcta explotacin se debe comprobar que la aplicacin tenga una configuracin y estado determinados.

3.1

COMPROBACION DEL DIRECTORIO ADMIN

Todo el proceso de instalacin de Mantis se lleva a cabo mediante una serie de pginas en lenguaje php contenidas en el directorio admin de la aplicacin. Una vez se ha efectuado correctamente el proceso de

Mantis. Manual de administracin

5/42

instalacin, este directorio no es necesario para el correcto funcionamiento de Mantis y debe ser eliminado. Si no se hiciera as, cualquiera podra acceder al proceso de instalacin y manipular la aplicacin.

Para comprobar si el directorio ha sido eliminado, bastar con acceder a la pgina de inicio de la aplicacin y ver si aparece el siguiente aviso: WARNING: Admin directory should be removed. http://--dominio--/mantis

En el caso de que aparezca dicho aviso, se debe proceder a la eliminacin del directorio admin.

3.2

COMPROBACION DE CONFIGURACIN

La aplicacin Mantis debe tener configurada una serie de especificaciones, sin las que su funcionamiento no sera correcto. Se debe editar el fichero config_inc.php y comprobar si est configurado lo siguiente: 1. El servicio de correo electrnico (esencial para el correcto funcionamiento de Mantis). Dentro del fichero deben estar especificados los datos de las siguientes entradas: $g_smtp_host: Ruta del servidor de correo SMTP. $g_smtp_username: Nombre de usuario para usar el servidor de correo (si se necesita). $g_smtp_password: Password asociado al usuario introducido anteriormente.

Mantis. Manual de administracin

6/42

2. El interfaz de castellano. Se debe comprobar la entrada referente al idioma est configurada correctamente:

$g_default_languaje = spanish

3. Para que no salga en la pantalla inicial el enlace para la creacin de cuentas automatizada se comprobar que la variable siguiente est en Off:

$g_allow_signup = Off;
# Maximum file size that can be uploaded # Also check your PHP settings (default is usually 2MBs) $g_max_file_size = 1000000; # 1 MB

4. Para configurar que el mximo tamao de fichero adjuntado a una incidencia sea un 1 MB

3.3

CAMBIAR LA CONFIGURACION

Si se desearan cambiar algunos de los parmetros de la configuracin que viene por defecto para Mantis, el administrador abrir los ficheros de configuracin de Mantis con un editor de texto. config_inc.php. es el fichero de configuracin de Mantis. config_defaults_inc.php. es el fichero por defecto de configuracin de Mantis, este fichero se puede usar como ejemplo de posibles valores a asignar y de variables permitidas.

Cualquier cambio de configuracin que efecte el administrador, se actualizar en Mantis una vez ha guardado el fichero (no es necesario reiniciar la aplicacin). Existen muchos valores en ese fichero que permiten configurar Mantis. Una explicacin mas profunda sobre los valores posibles para el archivo de configuracin se encuentra en la Web de Mantis, aqu: http://manual.mantisbt.org/manual.configuration.php.

3.4

COMPROBACIN DE USUARIO DE ADMINISTRACIN

El Mantis, al instalarse, crea por defecto un usuario de administracin. Este usuario tiene la tarea de servir como entrada inicial a la aplicacin y debe ser eliminado tras la creacin de un nuevo usuario para la administracin de la aplicacin. Para comprobar la eliminacin del mismo, bastar con intentar acceder a la aplicacin mediante ese usuario. Se deber ir a la pgina de inicio de la aplicacin e introducir usuario=administrador/password=root. http://--dominio--/mantis

Mantis. Manual de administracin

7/42

En caso de que se acceda al Mantis mediante ese usuario, se debe comprobar la existencia del nuevo usuario de administracin y proceder a la eliminacin del usuario creado por defecto: Desde la entrada de la aplicacin

Mantis. Manual de administracin

8/42

Se accede a la seccin de administracin

Se accede al perfil del usuario por defecto (administrator) y se selecciona la opcin de eliminar usuario

En caso de que no se hubiese borrado el usuario por defecto y no se hubiese creado un usuario administrador nuevo, se debe proceder a la creacin del nuevo usuario de administracin y el borrado posterior del usuario por defecto:

Mantis. Manual de administracin

9/42

Se crea un nuevo usuario administrador

Para completar la configuracin de un usuario, se debe acceder a la nueva cuenta mediante el link contenido en el correo que enva mantis a la cuenta de correo especificada. Al pinchar en el link, se acceder a una pgina de configuracin, donde se especifica el password del nuevo cliente.

Mantis. Manual de administracin

10/42

Tras configurar el password se accede a la administracin de usuario, al nuevo usuario y se le otorga el nivel de administrador. Se seleccionar la opcin protegida para esa cuenta.

Una vez terminada la configuracin del nuevo usuario de administracin, se pasar al borrado del usuario de administracin por defecto. Para efectuar el borrado del usuario por defecto, se accede a su perfil (administrator) y se selecciona la opcin de eliminar usuario.

Mantis. Manual de administracin

11/42

4
4.1

ADMINISTRACION DE MANTIS
ADMINISTRACION DE USUARIOS

Una de las tareas primordiales que debe efectuar el administrador de mantis es la gestin de los usuarios. La seccin para gestin usuarios se encuentra en Administracin Administrar Usuarios. Esta seccin est diseada para permitir llevar a cabo todas las acciones correspondientes a la administracin de usuarios (creacin, edicin y borrado de usuarios) de forma cmoda e intuitiva.

El acceso de los distintos usuarios se realiza pinchando en su respectivo link, para crear un nuevo usuario se pinchara en el botn Crear cuenta y para borrar un usuario se debe acceder a su perfil y apretar el botn Eliminar Usuario.

4.1.1.

Creacin de usuarios

Para crear un usuario, se pincha en el botn Crear Cuenta que se encuentra encima de la cabecera de la tabla de usuarios.

Mantis. Manual de administracin

12/42

Los datos a cumplimentar del usuario son: Nombre del usuario dentro del sistema. Nombre real del usuario. Direccin de correo electrnico del usuario. Este dato es muy importante, ya que el sistema enviar a esta direccin de correo un mail con el link para terminar la configuracin del nuevo usuario. El perfil del usuario. La seleccin del perfil de usuario es muy importante ya que determina los datos que puede ver y las acciones que puede realizar cada usuario. Los tipos y permisos que tiene dentro del sistema cada perfil se definen ms adelante. La opcin de activado determina que el usuario esta activo para el servicio. La opcin de protegido, inhabilita las acciones de borrado y modificacin sobre dicho usuario.

Mantis. Manual de administracin

13/42

4.1.2.

Actualizacin de usuarios

Para actualizar los datos de un usuario, dentro de la pantalla de administracin de usuarios

Se deber seleccionar al usuario deseado pinchando en su link correspondiente. Dicho enlace acceder a

Mantis. Manual de administracin

14/42

la pgina de datos del usuario, donde se realizarn los cambios que se consideren oportunos.

Se pulsa el botn Actualizar Preferencias o Actualizar Usuario (segn el apartado donde se han efectuado las variaciones) para acometer los cambios. Como se puede observar, esta pgina incluye botones para realizar otras acciones que pueden resultar tiles para la administracin de usuarios.

Mantis. Manual de administracin

15/42

4.1.3.

Eliminacin de usuarios

Para eliminar los datos de un usuario, dentro de la pantalla de administracin de usuarios

Se deber seleccionar al usuario deseado pinchando en su link correspondiente. Dicho enlace acceder a la pgina de datos del usuario.

Dentro de esta pgina, bastara con pinchar en el botn Eliminar Usuario

Mantis. Manual de administracin

16/42

Y confirmar la eliminacin para borrar un usuario.

4.1.4.

Perfiles de usuario

Una de las tareas ms importantes del administrador de Mantis, es gestionar el perfil que tendr cada usuario dentro de Mantis. Segn el perfil que se le asigne a cada usuario, este tendr una serie de tareas y permisos para realizar acciones dentro de la aplicacin. Los perfiles de usuario de la aplicacin se asocian a las siguientes actividades: Espectador: Consiste en un usuario ajeno al proceso de gestin y creacin de Bugs. Se asocia a un perfil de usuario exterior, que comprueba la evolucin de incidencias notificadas por cauces exteriores a la aplicacin. Informador: Este tipo de perfil de Mantis engloba al personal encargado de testear aplicaciones y buscar errores en desarrollos. Su misin es buscar problemas o sugerir cambios durante las distintas etapas de un proyecto. Se asocia al perfil de probador de aplicaciones. Desarrollador: Este perfil Mantis engloba al conjunto de programadores asociados a un proyecto. Manager: El perfil de manager, se corresponde con el Responsable. Administrador: Es el perfil reservado al administrador de Mantis. Los usuarios y sus perfiles, segn cada proyecto, vendrn especificados en la plantilla de peticin del proyecto.

Segn el perfil de usuario que tenga cada usuario, se le asocian una serie de permisos dentro de Mantis. Estos permisos se muestran en la siguiente tabla:

Mantis. Manual de administracin

17/42

Se puede consultar esa serie de permisos dentro de la aplicacin accediendo a Administracin Configuracin manejada.

Mantis. Manual de administracin

18/42

4.2

ADMINISTRACIN DE E-MAILS

La posibilidad de enviar e-mail's que ofrece el Mantis es muy interesante, pero para que sea realmente efectiva se debe configurar correctamente ya que se puede enviar informacin a usuarios que no deberan recibirla o se puede colapsar a un usuario con el envi continuo de e-mail's irrelevantes para l. En el envi de e-mails principalmente se ven involucrados dos entidades: el emisor y el receptor de los mensajes. Como principales implicados, el Mantis delega a dichas entidades la tarea de configurar el envo de e-mails. De esta manera, cada uno de los usuarios puede configurar los distintos niveles de e-mails que desea recibir y el sistema puede ser programado con las condiciones que se deben cumplir y los perfiles a los que se envan los e-mails.

4.2.1.

Acceso a la configuracin de e-mails

Para que el servicio de envo de e-mails funcione acorde con las exigencias de los usuarios, el Mantis ofrece a cualquier usuario con el nivel de administrador la capacidad de configurar el envi de e-mail. Los usuarios con perfil de administrador dentro de la aplicacin, estn posibilitados para determinar a que subconjunto de usuarios adscritos a un proyecto y en qu circunstancias la aplicacin les va enviar e-mails. Como las necesidades de cada proyecto son diferentes, la configuracin del envo de e-mails es fcil que sea tambin diferente, por lo que el Mantis permite tener una configuracin general para todos los proyectos contenidos en el Mantis y una configuracin particular para cada una de ellos. Frente a diferencias de configuracin, el sistema siempre le da preferencia a la especificada para el proyecto. Eso s, en este manual vamos a proponer una configuracin por defecto para todos los proyectos, que se estima que es la ideal para todo tipo de proyectos, previendo sobre todo que no se descontrole el envo de los mismos entre los diferentes tipos de usuarios. Un Usuario con perfil de administrador, que desee cambiar la configuracin de la aplicacin con respecto al envo de e-mails (tanto la configuracin general como la propia de cada proyecto) debe seguir los siguientes pasos: 1. Como en cualquier otra operacin que desee realizar un usuario en el Mantis, lo primero que se debe hacer es conectarse correctamente en la aplicacin.

Mantis. Manual de administracin

19/42

2. Al igual que para establecer cualquier de las pautas de administracin de la aplicacin, el usuario debe acceder a la seccin de administracin pinchando en el botn que lleva ese susodicho nombre.

3. Ya dentro de la seccin de administracin, para acceder a la a la pantalla donde se configura el envi de e-mails, se debe acceder a la configuracin manejada

y dentro de ella se debe seleccionar la seccin de notificacin por correo.

Mantis. Manual de administracin

20/42

4. Dentro de esta pagina se encuentran todas las posibilidades de configuracin referentes al envo de e-mails.

Todas las posibles opciones que se pueden usar para definir el envi de e-mails, vienen especificadas en un cuadro.

Mantis. Manual de administracin

21/42

El cuadro en cuestin, esta dividido en celdas. Cada una de las celdas representa una posible opcin de configuracin. Para configurar las distintas opciones, el usuario con perfil de administrador ira seleccionando o deseleccionando el cuadro que corresponda con la configuracin que desea especificar. Como se puede observar, los cuadro tienen tres tipos de colores: Representan las opciones seleccionadas para todos los proyectos y que no estn comprendidas dentro de las opciones por defecto. Representan las opciones seleccionadas para un determinado proyecto y que no estn comprendidas dentro de las opciones seleccionadas para todos los proyectos. Las otras dos tonalidades (son distintas por motivos de diseo), corresponden con las opciones que no cumplen las caractersticas de los dos colores anteriores.

Mantis. Manual de administracin

22/42

Como en cualquier otro esquema de caractersticas similares, las cuadriculas representan la asociacin de las entidades contenidas en la vertical con las entidades horizontales. La barra vertical, representan los motivos por los que se desata el envi de mails. Los motivos por los que se envan mails son:

Enviar Email en Incidencias Asignadas. Enviar Email en Incidencias Reabiertas. Email borrado. Enviar Email en Notas agregadas a la Incidencia. Email en relacin con el cambio. En estado de cambio 'nuevo'. En estado de cambio 'se necesitan ms datos'. En estado de cambio 'aceptado'. En estado de cambio 'confirmado'. En estado de cambio 'asignado'. En estado de cambio 'resuelto'. En estado de cambio 'cerrado'.

La barra horizontal, representa a los destinatarios potenciales de los e-mails. Estos posibles receptores de e-mails se dividen en dos familias, por un lado tenemos los perfiles de usuario y por el otro a los usuarios mas cercanos a la incidencia. La familia de perfiles de usuario esta conformada por, los distintos perfiles de usuario de la aplicacin. Los distintos perfiles de usuario de los que dispone la aplicacin son:

Espectador. Informador. Actualizador. Desarrollador. Manager. Administrador.

Si se selecciona cualquiera de los cuadros contenidos en la vertical de un perfil, cada vez que se cumpla la condicin horizontal del cuadro, se les mandara un mail a todos los usuarios que estn incluidos dentro del proyecto y que tengan ese perfil de usuario.

Dentro de la segunda familia de receptores de e-mails, se encuentra los usuarios con una relacin directa con la incidencia en la que se producen los cambios. Las relaciones con la incidencia que se incluyen son:

Es el usuario quien reporta la incidencia: representa el usuario creador de la incidencia. Es el usuario quien tramita la incidencia: representa al usuario que tiene asignada la incidencia.

Mantis. Manual de administracin

23/42

Usuario monitorizando esta incidencia: representa a todos los usuarios que hayan especificado la monitorizacin de una incidencia. La especificacin de monitorizacin de una incidencia, es especificada por un usuario en la propia incidencia. El usuario aade la nota del bug: representa al usuario que ha aadido una nota a la incidencia.

Si se selecciona cualquiera de los cuadros contenidos dentro de la vertical de un usuario relacionado con la incidencia, cada vez que se cumpla la condicin horizontal del cuadro, se le mandara un mail a la direccin e-mail definida para dicho usuario. .

4.2.2.

Configuracin por defecto

A continuacin se incluye la configuracin por defecto que todos los proyectos van a tener, cada vez que sean creados por el administrador. Esta configuracin es la referente a los e-mails que se envan.

Mantis. Manual de administracin

24/42

. 4.3 ADMINISTRACIN DE PROYECTOS

Las tareas correspondientes a la administracin de proyectos, incluyen la creacin y modificacin de los proyectos.

4.3.1.

Creacin de un Nuevo Proyecto

Se pueden crear proyectos mediante la opcin Administracin Administrar Proyectos. Para crear un proyecto, se usa el botn Crear Nuevo Proyecto que se encuentra encima de la cabecera de la tabla de proyectos.

Mantis. Manual de administracin

25/42

Las opciones a la hora de crear un proyecto son muy intuitivas y no conllevan dificultad alguna. Para crear uno nuevo, bastar con pinchar en el botn Crear Nuevo Proyecto.

Los datos requeridos para crear un proyecto son: (todos estos datos debern venir especificados y

Mantis. Manual de administracin

26/42

cumplimentados obligatoriamente en la plantilla de peticin del proyecto). Nombre del proyecto. Se debe especificar el cdigo que describe el proyecto. Estado en el que se encuentra el proyecto. El estado describe la situacin en la que se encuentra el proyecto en el momento de darlo en alta en mantis. Se deber seleccionar en desarrollo si el proyecto se encuentra en fase de desarrollo, se selecciona release si el proyecto se encuentra en fase de pruebas, se seleccionar estable si el proyecto lo tenemos implantado y funcionando y elegiremos obsoleto si el proyecto esta obsoleto. En acceso, indicamos la accesibilidad del mismo. Se debe seleccionar la opcin de privado para conseguir una completa independencia entre proyectos. (Al seleccionar esta opcin slo los usuarios asignados al mismo podrn trabajar con l). Descripcin del proyecto. Se debe introducir una descripcin escueta de los objetivos y funcionalidades del proyecto.

Una vez se ha completado el proceso de creacin del proyecto, el administrador para completar la especificacin del nuevo proyecto deber modificarlo. La descripcin de estos procesos aparece en el apartado Error! No se encuentra el origen de la referencia. Error! No se encuentra el origen de la referencia. de este documento.

4.3.2.

Modificacin de Proyectos

Para modificar los datos contenidos dentro de un proyecto, se debe acceder a Administracin Administrar Proyectos

Mantis. Manual de administracin

27/42

y pinchar en su correspondiente link para acceder a la pgina que contiene todos los datos del proyecto.

Dentro de esta pantalla, se deber cambiar los parmetros necesarios del proyecto.

Mantis. Manual de administracin

28/42

4.3.3.

Gestin de usuarios

El administrador debe seleccionar, los usuarios especificados en la plantilla de peticin del proyecto de la lista de usuarios disponibles para incorporarlos al proyecto en el que se efecta la modificacin. Durante dicho proceso, el administrador adems dar el nivel de acceso que tendr el usuario en ese proyecto. Este nivel de acceso viene determinado por los perfiles de Mantis: Espectador: Consiste en un usuario ajeno al proceso de gestin y creacin de Bugs. Se asocia a un perfil de usuario exterior, que comprueba la evolucin de incidencias notificadas por cauces exteriores a la aplicacin. Informador: Este tipo de perfil de Mantis engloba al personal encargado de testear aplicaciones y buscar errores en desarrollos. Su misin es buscar problemas o sugerir cambios durante las distintas etapas de un proyecto. Se asocia al perfil de probador de aplicaciones. Desarrollador: Este perfil Mantis engloba al conjunto de programadores asociados a un proyecto. Manager: El perfil de manager, se corresponde con el responsable. Administrador: Es el perfil reservado al administrador de Mantis.

Segn el perfil de usuario que tenga cada usuario, se le asocian una serie de permisos dentro de Mantis. Estos permisos se muestran en la siguiente tabla:

Mantis. Manual de administracin

29/42

Se puede consultar esa serie de permisos dentro de la aplicacin accediendo a Administracin Configuracin manejada.

4.3.4.

Asociacin de subproyecto

La asociacin de un proyecto como subproyectos, es tan simple como acceder a Administracin Administrar del Proyecto especificados en la plantilla de peticin del proyecto como proyecto al que se asocia, seleccionar de la lista desplegable el cdigo del proyecto que se asociara como subproyecto (especificado en la plantilla de peticin del proyecto y que debe haber sido creado anteriormente) y apretar el botn de Aadir Como Subproyecto.

Mantis. Manual de administracin

30/42

ADAPTACION DE LA PLANTILLA

Mantis permite modificar los campos que aparecen en los documentos de creacin de errores. Es tarea del administrador de Mantis el incorporarlos o borrarlos a cada proyecto segn sea adecuado. Para las especificaciones de EJIE, se ha determinado la incorporacin dos nuevos campos para los informes. Estos dos nuevos campos se aadirn a la plantilla de creacin de errores como campos personalizados, por lo que el administrador deber aadir a todos los proyectos que se incluyan en Mantis dichos campos. Estos dos campos en cuestin son: Entorno De Trabajo: define el entorno de trabajo que se est usando para desarrollar el proyecto Tiempo Estimado De Resolucin: Determina el tiempo estimado de resolucin que tiene el proyecto

Estos dos campos son aadidos para cumplir las especificaciones de EJIE. Si en el futuro se viera necesario asignar algn nuevo campo, se debera seguir el mismo procedimiento. El proceso de adicin de esos dos campos se divide en dos fases.

5.1

DEFINICION DE CAMPOS PERSONALIZADOS

El administrador de Mantis, debe definir los nuevos campos que se quieren aadir a la plantilla por defecto de Mantis. Este proceso slo lo tiene que realizar una vez por cada nuevo campo. Para crear los campos personalizados el administrador debe acceder a Administracin -> Administrar Campos Personalizados

Mantis. Manual de administracin

31/42

El administrador en esta pantalla debe introducir el nombre del campo personalizado (especificada en la plantilla de peticin del proyecto) en la caja de texto que se encuentra debajo de la tabla de campos personalizados y pulsar el botn Nuevo campo personalizado. En el caso de actual de EJIE, el administrador debe realizar este procedimiento dos veces. Una para crear el campo Entorno De Trabajo y la otra para crear el campo Tiempo Estimado De Resolucin. Cada vez que se pulsa en el botn de Nuevo campo personalizado, se visualiza la siguiente pantalla:

En esta nueva pantalla el administrador debe especificar las caractersticas del nuevo campo. Estas caractersticas dependen de la naturaleza del nuevo campo. En el caso actual de EJIE se indicar: Entorno De Trabajo Tipo Enumeracin Valores posibles Local|Desarrollo|Pruebas|Produccin Tiempo Estimado De Resolucin Tipo Cadena

Mantis. Manual de administracin

32/42

5.2

ASIGNACION DE CAMPOS PERSONALIZADOS

Una vez se tienen definidos los nuevos campos, el administrador debe asignarle esos campos personalizados a cada nuevo proyecto que se cree. Para realizar la asignacin de los campos personalizados a los proyectos, el administrador deber entrar en Administracin->Administrar Proyectos y seleccionar cada proyecto para editarlo.

En la seccin de campos personalizados, el administrador selecciona los campos personalizados oportunos y pulsara el botn Aadir este campo personalizado para completar el proceso. En el caso actual de EJIE deber aadir los campos Entorno De Trabajo y Tiempo Estimado De Resolucin. Una vez hecho esto, cada vez que se cargue cualquier Bug de ese proyecto se incluirn dichos campos.

Mantis. Manual de administracin

33/42

DEFINICIN DE PROYECTOS

Una vez se ha aprobado la inclusin de un nuevo proyecto en Mantis, el administrador de Mantis recibir la plantilla de peticin del proyecto aprobada. Los pasos que debe dar el administrador para crear el nuevo proyecto son los siguientes.

6.1

PASO 1: ALTA DE PROYECTO Debe acceder a Administracin Administrar Proyecto

y pulsar el botn Crear Nuevo Proyecto (que se encuentra encima de la cabecera de la tabla de proyectos) para comenzar la creacin del nuevo proyecto.

Mantis. Manual de administracin

34/42

El administrador cumplimentara los datos que le pide el sistema, consultando los datos especificados en la plantilla de peticin del proyecto. Nombre del proyecto. El administrador escribe el cdigo que describe el proyecto contenido en la plantilla de peticin del proyecto. Estado en el que se encuentra el proyecto. El administrador selecciona el estado contenido en la plantilla de peticin del proyecto. En acceso. El administrador debe asegurarse que la opcin privado esta seleccionada. Descripcin del proyecto. El administrador introducir la descripcin y el nombre del responsable contenida en la plantilla de peticin del proyecto.

6.2

PASO 2: ASOCIACIN DE USUARIOS

Una vez creado el nuevo proyecto, el administrador de Mantis debe comprobar la existencia de los usuarios asociados al proyecto y crearlos si fuera necesario.

6.2.1.

Comprobar usuarios

Para comprobar la existencia de usuarios, el administrador debe acceder a Administracin Administrar Usuarios y comprobar qu usuarios contenidos en la plantilla de peticin del proyecto estn ya dados de alta en el sistema. Adems el administrador debe cerciorarse que la direccin de correo del usuario es la correcta.

Mantis. Manual de administracin

35/42

Si la direccin de correo es incorrecta, el administrador debe seleccionar el usuario con los datos errneos (obsoletos). Al hacerlo, acceder a la pgina de datos del usuario, donde corregir los datos errneos.

El administrador debe pulsar el botn Actualizar Preferencias para guardar los datos modificados. Una vez el administrador ha comprobado los usuarios que estn ya dados de alta en el sistema, debe crear los usuarios que no estn incluidos.

Mantis. Manual de administracin

36/42

6.2.2.

Aadir nuevos usuarios

Para aadir nuevos usuarios el administrador debe pinchar en el botn Crear Cuenta que se encuentra encima de la cabecera de la tabla de usuarios (que se encuentra en Administracin Administrar)

Los datos que debe cumplimentar del usuario el administrador son: Nombre del usuario. Nombre del usuario dentro del sistema especificado en la plantilla de peticin del proyecto. Nombre real del usuario. Nombre real del usuario dentro del sistema especificado en la plantilla de peticin del proyecto. Direccin de correo electrnico. Direccin de correo electrnico del usuario especificada en la plantilla de peticin del proyecto. La opcin de activado determina que el usuario esta activo para el servicio. El administrador debe asegurarse que la opcin activado esta seleccionada. La opcin de protegido. Esta opcin slo debe seleccionarse si el nuevo usuario que se esta creando tiene el perfil de administrador.

Mantis. Manual de administracin

37/42

6.3

PASO 3: CONFIGURAR PROYECTO

Una vez el administrador ha creado el proyecto y tiene todos los usuarios asociados al proyecto en el sistema, para completar el alta del proyecto debe configurarlo con las especificaciones indicadas en la plantilla de peticin del proyecto. El administrador debe acceder a Administracin Administrar Proyectos

Mantis. Manual de administracin

38/42

y pinchar en su correspondiente link para acceder a la pgina que contiene todos los datos del proyecto.

Para configurar el proyecto el administrador debe realizar las siguientes tareas.

Mantis. Manual de administracin

39/42

6.3.1.

Asociar usuarios al proyecto

El administrador debe seleccionar, los usuarios especificados en la plantilla de peticin del proyecto de la lista de usuarios disponibles para incorporarlos al proyecto que esta configurando. Durante dicho proceso, el administrador adems debe asignar el nivel de acceso especificado a cada usuario en la plantilla de peticin del proyecto.

6.3.2.

Asociacin como subproyecto

Si en la plantilla de peticin del proyecto se especifican subproyectos, el administrador debe crear esos subproyectos mediante las plantillas adjuntadas de subproyecto de la misma manera que crea un nuevo proyecto. Una vez hecho esto el administrador debe asociar los subproyectos al proyecto. Para ello acceder a Administracin Administrar del Proyecto especificado en la plantilla de peticin del proyecto (como proyecto principal del que dependen los subproyectos) y seleccionara de la lista desplegadle (en la seccin de subproyecto) el cdigo de los subproyectos. Una vez seleccionado el administrador debe apretar el botn de Aadir Como Subproyecto para que se complete el proceso de asociacin.

6.3.3.

Asociar campos personalizados

Para un correcto formato de incidencias de EJIE, es necesario aadir dos campos personalizados. En la seccin de campos personalizados, el administrador seleccionara sucesivamente los campos personalizados Entorno De Trabajo y Tiempo Estimado De Resolucin y pulsara el botn Aadir este campo personalizado. En caso de que esos dos campos no estaran creados, el administrador debe crearlos. El proceso de creacin viene descrito en la seccin 5.1. DEFINICION DE CAMPOS PERSONALIZADOS de este documento.

6.3.4.

Configuracin por defecto de e-mails

Para un correcto formato de incidencias de EJIE, es necesario configurar el envo por defecto de e-mails, que luego podr ser modificado en cada caso por el jefe de proyecto correspondiente. Para ello, vale con incluir la configuracin marcada en el punto 4.2.2. Configuracin por defecto de este documento.

Mantis. Manual de administracin

40/42

7
7.1

Recursos necesarios
Memoria

Mantis es una aplicacin 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 (256 MB).

7.2

Espacio en Disco

La estimacin de ocupacin en disco de un proyecto, depender del tamao del proyecto.

Tamao estimado

Estimacin de incidencias

Estimacin de adjuntos Estimacin de tamao por incidencia de adjunto

Tamao

Pequeo Medio Alto

100 1000 5000

1/5 1/4 1/4

100KB a 300KB 200KB a 500KB 200KB a 800KB

10 MBytes 100 MBytes 500 MBytes

El clculo de estas cifras, corresponde a la cantidad de espacio en disco que necesitara MySQL para almacenar los datos del proyecto (usuarios, ficheros del proyecto, datos del propio proyecto,), el espacio ocupado por los Bugs (histrico incluido) y los ficheros adjuntos a los errores. Hay que tener en cuenta, que estas cifras son variables y que dependen mucho de la cantidad y tamao de los ficheros que se pueden adjuntar con los errores. Nota: Esta estimacin 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 tamao del documento oscilara entre los 300k y los 1000k (Se ha configurado el sistema para no permitir ficheros con tamao superior a 1000Kb).

Mantis. Manual de administracin

41/42