Esta documentación describe una instalación común en el contenedor de aplicaciones JEE.
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.
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.
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.
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:
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.
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.
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-home>/webapps/
<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
Cargar el ear proporcionado mediante la consola de WebLogic de forma visual, por ejemplo:
http://<host>/console
Desplegar .ear
En el panel derecho, haga clic en Instalar.
Mediante el Asistente de Instalación de la Aplicación, localice el archivo EAR.
Haga clic en "cargue los archivos".
Haga clic en Siguiente.
Pulse en Examinar y localice el archivo viafirma.ear
Haga clic en Siguiente.
Una vez subido el .ear, lo seleccionamos.
Haga clic en Siguiente.
Seleccione Instalar Despliegue como Aplicación y haga clic en siguiente.
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.