Identificación del documento

Historial de edición del documento

Índice

1      Introducción. 4

1. 1    Objetivo del documento. 4

2      Instrucciones de instalación. 5

1. 1    Instrucciones especificas para la versión v2.1.4. 5

1. 2    Estructura de entrega de la aplicación. 5

1. 2.1   Estructura de aplicaciones. 6

1. 2.1.1    Estructura de aplicación arcacore: 6

1. 2.2   Ficheros de configuración. 6

1. 2.3   Ficheros estáticos. 6

1. 2.4   Scripts de base de datos. 7

3      Comprobación del servicio. 8

1               Introducción

Aplicación web para la gestión completa del Archivo Electrónico Único del Gobierno de Aragón, sustituyendo a las aplicaciones de CLASE, BKM-BRS, SISCAR y otros procesos realizados de manera externa.

La denominación de la aplicación registrada en la Base de Datos de Gestion de la Configuración (CMDV), o código de aplicación es ARCA.

1.1       Objetivo del documento

El objetivo de este documento es describir los pasos necesarios para realizar una instalación de dicha aplicación para su alojamiento en servidores de aplicaciones WebLogic del Gobierno de Aragón.

2               Instrucciones de instalación

Para generar el desplegable de la aplicación será necesario pasar el entorno como parámetro de la tarea Ant. Los posibles valores, siguiendo el documento ESPEC_PeticionesDespliegue.pdf son:

·         des: entorno de integración

·         pre: entorno de preproducción

·         pro: entorno de producción

Como ejemplo de la ejecución, se necesitaría navegar hasta la carpeta principal del entregable y ejecutar el comando: ant –Dentorno=des.

2.1       Instrucciones especificas para la versión v2.1.4

Para el despliegue de esta versión, será necesario:

·         Eliminar las versiones desplegadas anteriormente para evitar posibles cacheos. (en esta versión la apliacion arcaweb_internal no se desplegara de nuevo, pero si que será necesario eliminarla)

·         Generar el entregable a partir de la tarea ant como se indica anteriormente.

·         Eliminar del servidor el contenido de la carpeta /compartido/app/arca/.

·         Copiar en la carpeta del servidor /compartido/app/arca/, los directorios y ficheros contenidos en los mismo ubicados en la ruta del entregable /arca/compartido/.

·         Para el despliegue en los entornos de PRE y PRO ejecutar los scripts ubicados en la ruta del entregable /arca/setup/scripts/. (En el entorno de DES no es necesario)

·         Desplegar el fichero arca.ear generado.

·         Ejecutar las pruebas de validación tal como se indica en el apartado 3 Comprobación del servicio.

2.2         Estructura de entrega de la aplicación

El contenido del entregable facilitado sigue las pautas marcadas en el documento distribuido ESPEC_EspecificacionesTecnicasWebLogic.doc. En él se establece una estructura de carpetas determinada para un proyecto Java EE complejo, donde se incluyen las aplicaciones web (ficheros WAR) dentro del fichero general (fichero EAR).

Las carpetas más importantes a las que se debe prestar atención son:

·         apps: Directorio con las diferentes aplicaciones generadas.

·         compartido: Directorio donde se encuentran los ficheros estáticos a incluir en las rutas definidas.

·         dist: Se encuentra el entregable (.ear) que se deberá desplegar sobre el Weblogic.

·         docs: Manuales necesarios para la instalación y mantenimiento, y documentación relativa al proyecto.

·         setup: Informacion necesaria para la instalación de la aplicación.

2.2.1      Estructura de aplicaciones

Dentro del directorio apps, se informan las aplicaciones incluidas en el proyecto:

·         arcacore

2.2.1.1           Estructura de aplicación arcacore:

Se identifica la estructura de un proyecto web.

Las carpetas existentes en el directorio son:

·         build: Contiene los componentes resultado de la compilación del proyecto. En nuestro caso arcacore.war.

·         lib: Librerías externas que son necesarias para la compilación o ejecución del proyecto.

·         src: Ficheros fuente de la aplicación.

·         web: directorio que almacena el WEB-INF a incluir en el proceso.

2.2.2      Ficheros de configuración

Tras el proceso de generación del ear, los ficheros de propiedades quedarán en la ruta:

·         build/properties/{cod_entorno}/

Los ficheros existentes en el directorio de properties son:

·         application.properties

·         log4j2.xml

Estos ficheros se tendrán que distribuir al directorio específico para este proyecto en el classpath del servidor.

2.2.3      Ficheros estáticos

Esta aplicación tiene la necesidad de acceder a unos ficheros estáticos desde todos los nodos del clúster del servidor de aplicaciones.

Lo ficheros estáticos están disponibles en la carpeta del entregable “/compartido” y los mismos son:

·         Directorio reports

·         Directorio plantillas

Esto ficheros deberan configurarse en la ruta “/compartido/app/arca/”.

2.2.4      Scripts de base de datos

Dentro de la carpeta setup/ se ha creado un directorio scripts/ con los ficheros a ejecutar en BBDD.

Para esta versión solamente serán necesario la ejecución de los scripts para los entornos de PRESAE y PROSAE

3               Comprobación del servicio

Debido a la casuística de esta aplicación no es necesario realizar ninguna configuración ni adaptación particular, únicamente comprobar que se ha desplegado.

Para comprobar que la aplicación arcacore se ha desplegado correctamente:

La ruta de comprobación de un servicio dummy será:

http://<host>:<port>/arcacore/rest/stateApp

Ej: http://desaplicaciones.aragon.es/arcacore/rest/stateApp

Open