Manual de instalación de Viafirma Documents

Instalación

  1. Crear esquemas de base de datos y ejecutar los scripts correspondientes a la base de datos empleada.
  2. Descargar tomcat
  3. Modificar Catalina.sh en el tomcat
    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"
    CATALINA_PID=/tmp/tomcat.pid
    
  4. Configurar los accesos a base de datos y el directorio del DOCUMENTS_HOME en el fichero documents.xml.
  5. Copiar el fichero documents.xml modificado en el punto anterior al directorio conf/Catalina/localhost del tomcat.
  6. Crear la carpeta definida en la variable DOCUMENTS_HOME del contexto.
  7. Copiar en la carpeta DOCUMENTS_HOME el contenido de la carpeta documents-home del kit de instalación.
  8. Configurar los ficheros config.properties, logback.xml y hazelcast.xml con los valores correspondientes a nuestra instalación.
  9. Copiar el driver correspondiente a la base de datos seleccionada a la carpeta lib del tomcat.
  10. Copiar documents.war al directorio webapp de tomcat
  11. Iniciar tomcat y acceder a la aplicación desde http://localhost:8080/documents
  12. La primera vez que accederemos la aplicación detectará que no tiene instalada una licencia valida por lo que redirigirá a la url http://localhost:8080/documents/license donde se debe incorporar la licencia suministrada.

Entornos con SSL

Para entornos con SSL se recomienda la activación de preservación de la url de usuario.

Por ejemplo en apache:

proxypreserverhosts on