Manual de instalación de Viafirma Documents

Instalación

Revisión: 17-abr-2019

Instalaciones previas

Para explicar la instalación de Viafirma Documents partiremos de dos situaciones previas:

  • Base de Datos: ya cuentas con un usuario y un esquema creado a partir de las instrucciones y scripts SQL facilitados en el KIT DE INSTALACIÓN. Puedes revisar el capítulo de Base de Datos para más información.
  • Apache Tomcat: ya cuentas con un servidor de aplicaciones Apache Tomcat 8 instalado.

Carpeta de configuración DOCUMENTS_HOME

  • crea una carpeta de configuración que usaremos más adelante para definir la variable DOCUMENTS_HOME. También usaremos esta carpeta más adelante en los ajustes de arranque del Apache Tomcat.
  • una vez creada ya puedes copiar en ella el contenido de la carpeta DOCUMENTS_HOME de tu KIT DE INSTALACIÓN.

Configuración

config.properties

Dentro de la carpeta DOCUMENTS_HOME tienes el fichero general de propiedades, config.properties. Revisa que contiene la configuración adecuada que te permita arrancar por primera vez Viafirma Documents. Podrás completar el resto de configuración avanzada en otro momento.

La siguiente configuración mínima te permitirá arrancar Viafirma Documents:

URL_PROTOCOL=http

JDBC_DRIVER=org.postgresql.Driver
JDBC_URL=jdbc:postgresql://127.0.0.1:5432/vdocuments
JDBC_USER=myUser
JDBC_PASSWORD=****

Para conocer todas las opciones de configuraciones revisa el capítulo de Configuración.

logback.xml

También encontrarás dentro de la carpeta de configuración el fichero logback.xml, que se utiliza para configurar todo el sistema de LOGS del producto. En el siguiente enlace encontrarás la documentación oficial del framework con las opciones de configuración:

Configuration logback.xml

Ajustes en Apache Tomcat

A continuación te explicamos los ajustes recomendados en servicio de arranque del servidor, modificando el Catalina.sh:

CATALINA_OPTS="-Dfile.encoding=UTF-8 -Dcom.sun.management.jmxremote
-Djava.awt.headless=true -Xmx1512M -server -Xms512M  -XX:NewSize=128m
-XX:MaxNewSize=256m -XX:SurvivorRatio=5 -XX:TargetSurvivorRatio=30
-XX:PermSize=128m -XX:MaxPermSize=256m -Xincgc -XX:+CMSIncrementalMode
-XX:+CMSIncrementalPacing -XX:+CMSParallelRemarkEnabled -XX:+UseParNewGC
-XX:+UseTLAB -XX:+CMSPermGenSweepingEnabled -XX:+CMSClassUnloadingEnabled
-Dsun.jnu.encoding=ISO-8859-15 -Djava.net.preferIPv4Stack=true -Dviafirma.documents.home.path=/home/viafirma/documents-home"
CATALINA_PID=/tmp/tomcat.pid

Nota: fíjate que agregamos el path donde la carpeta donde puedes dejar el fichero de configuración. Revisa que coincide con tu path de instalación y en caso contrario puedes modificarlo.

Dviafirma.documents.home.path={ruta donde se encuentra la carpeta documents-home}

Deploy

En este punto ya tienes todo preparado para desplegar Viafirma Documents, para ello sólo tienes que copiar documents.war incluido en el KIT DE INSTALACIÓN en el directorio webapp de tu Apache Tomcat.

Una vez desplegado, Viafirma Documents se publicará por defecto en la URL http://localhost:8080/documents

Licencia

Para el primer acceso tendrás que informar la licencia contenida en tu KIT DE INSTALACIÓN. Para ello ve a la URL de licencia y la adjuntas:

http://localhost:8080/documents/license