Primera instalación

Entregables

Versión distribuible

Esta documentación describe una instalación común en el contenedor de aplicaciones JEE.

  • Empaquetado (.war o .ear) de viafirma platform

El empaquetado inicialmente no estará configurado. La configuración podrá realizarse a partir del fichero de configuración de ejemplo distribuido junto a los entrebables, o bien, contar con uno propio definido por el cliente siguiendo esta documentación.

Licencia

Junto a los entregables, se hará entrega de la licencia de uso, y deberá ser registrada en el primer arranque de la aplicación, accediendo mediante un navegador a la siguiente URL:

http://<host>/license

En el anexo Localización de Licencias se muestran más información sobre la ubicación de instalación.

Kit de Desarrollo

De forma adicional se podrá hacer entrega de recursos con utilidades para integradores, como aplicaciones de ejemplo, snippets de código para integradores, ficheros de de configuración, o certicados digitales de prueba.

Instalación Base de Datos

Una instalación básica de viafirma platform NO requiere el uso de base de datos. Sólo se contemplan dos casos en los que se bebe hacer uso de ella:

Custodia sobre oracle

Viafirma platform permite varios mecanismos para la custodia de documentos firmados, entre ellos, la persistencia en Oracle.

En este caso, se deberá solicitar adicionalmente los scripts SQL para la creación de la DB en Oracle que se usará para este propósito.

Integración con HSM de Safenet

Si se integra con un HSM de Safente y además se va a hacer uso de los procedimientos de exportación segura de claves, viafirma platform deberá tener acceso la DB de Oracle sobre la que se encuentrasn las claves exportadas.

En este caso, se deberá solicitar adicionalmente los scripts SQL para la creación de la DB en Oracle que se usará para este propósito.

Consultar más detalles en ANEXOS.

Ejemplos de dspliegue

Esta documentación describe una instalación típica en los contenedores JEE Apache Tomcat 7 y Oracle WebLogic 12c, por lo que si se usa otro contenedor JEE, los pasos descritos podrán variar sensiblemente.

Tomcat 7

  • copiar el war proporcionado en la ruta de despliege del tomcat, por ejemplo:
<tomcat-home>/webapps/
  • arrancar servidor
<tomcat-home>/bin/catalina.sh start

Si los wars ya estaban pre-configurados, se podrá acceder al servicio para comprobar su correcto arranque.

http://<host>/viafirma

En caso de que los wars no estuvieran pre-configurados, se deberá consultar el capítulo de configuración para la modificación de los respectivos ficheros de configuración. Cualquier cambio en el fichero de configuración requerirá que el servidor sea parado y arrancado nuevamente para que la nueva configuración tenga efecto.

<tomcat-home>/bin/catalina.sh stop
<tomcat-home>/bin/catalina.sh start

WebLogic 12c

  • Cargar el ear proporcionado mediante la consola de WebLogic de forma visual, por ejemplo:

    • Acceso a la consola
      http://<host>/console
      
    • Desplegar .ear

      1. En el panel izquierdo de la consola, seleccione Despliegues.
      2. En el panel derecho, haga clic en Instalar.

        Install1

      3. Mediante el Asistente de Instalación de la Aplicación, localice el archivo EAR.

        1. Haga clic en "cargue los archivos".

          Install2

          Haga clic en Siguiente.

        2. Pulse en Examinar y localice el archivo viafirma.ear

          Install3

          Haga clic en Siguiente.

        3. Una vez subido el .ear, lo seleccionamos.

          Install4

          Haga clic en Siguiente.

      4. Seleccione Instalar Despliegue como Aplicación y haga clic en siguiente.

      5. Actualice opcionalmente los valores sobre el despliegue, como por ejemplo el Nombre.
      6. Haga clic en Terminar.

Volveremos a la pantalla de Despliegues, donde se ha añadido la aplicación al listado, en cuya fila podemos observar, entre otros datos, el estado del despliegue.

Si el ear ya estaba pre-configurado, se podrá acceder al servicio para comprobar su correcto arranque.

http://<host>/viafirma

En caso de que el ear no estuviera pre-configurado, se deberá consultar el capítulo de configuración para la modificación de los respectivos ficheros de configuración. Cualquier cambio en el fichero de configuración requerirá que la aplicación sea apagada y arrancada nuevamente para que la nueva configuración tenga efecto.

Install5