viafirma inbox :: manual de instalación

Configuración

Para la configuración de la aplicación, primeramente será necesario parar el tomcat:

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

y una vez realizados los cambios volver a arrancarlo:

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

Configuración del contexto

El war entregado inbox.war espera un fichero de configuración inbox.xml, el cual se encontrará, tras el despliegue, en el directorio de configuración del contenedor de aplicaciones.

/<tomcat-home>/conf/Catalina/localhost/inbox.xml

La configuración que debe incluirse será:

  • Configuración de la base de datos:

    <Resource auth="Container" driverClassName="oracle.jdbc.driver.OracleDriver"
    maxActive="100" maxIdle="30" maxWait="10000" name="jdbc/default_manager"
    password="inbox" type="javax.sql.DataSource"
    url="jdbc:oracle:thin:@192.168.10.239:1521:orcl" username="inbox" />
    

    Concretamente, habrá que incluir los datos correctos de las siguientes variables:

    • username: usuario que tiene permisos DML sobre todo el esquema y tiene visibilidad sobre los objetos del mismo (tables, constraints, sequences, etc.).
    • password: del usuario que tiene acceso a la base de datos.
    • url: cadena de conexión correcta para acceder al servidor de datos (en PostgreSQL un ejemplo podría ser jdbc:postgresql://127.0.0.1:5432/inbox; un ejemplo en MySQL sería jdbc:mysql://127.0.0.1:3306/inbox).
    • driverClassName: clase del driver JDBC para la base de datos elegida (en PostgreSQL sería org.postgresql.Driver y en MySQL com.mysql.jdbc.Driver).
  • Configuración activa: define el conjunto de variables con el que se configurará la aplicación (dichas variables se indicarán más adelante en el panel de control de administración de la aplicación). El valor que debe tener inicialmente es el que se inserta por defecto en los scripts de instalación de la base de datos: config_basica.

    <Environment description="Configuracion activa" name="CONFIGURACION_ACTIVA"
    override="false" type="java.lang.String" value="config_basica" />
    
  • Configuración de los sistemas de firma permitidos: viafirma inbox permite la firma de peticiones empleando varios sistemas de firma. Las implementaciones de los sistemas de firma permitidos se definen en la variable MANAGER_SIGN_IMPLS. Se podrá usar uno o varios sistemas de firma. En caso de emplearse más de uno se deberán indicar separados por coma.

    <Environment description="MANAGER_SIGN_IMPLS" name="MANAGER_SIGN_IMPLS"
    override="false" type="java.lang.String"
    value="com.viafirma.tray.sign.viafirma.ViafirmaSignImpl,
    com.viafirma.tray.sign.fortress.FortressSignImpl,
    com.viafirma.tray.sign.signador.SignadorSignImpl,
    com.viafirma.tray.sign.otpsms.OtpSmsSignImpl,
    com.viafirma.tray.sign.cosign.CosignSignImpl,
    com.viafirma.tray.sign.web.WebSignImpl"/>
    

    Los sistemas de firma soportados actualmente son:

    • Viafirma: com.viafirma.tray.sign.viafirma.ViafirmaSignImpl
    • Fortress: com.viafirma.tray.sign.fortress.FortressSignImpl
    • Signador: com.viafirma.tray.sign.signador.SignadorSignImpl
    • OTPSMS: com.viafirma.tray.sign.otpsms.OtpSmsSignImpl
    • COSIGN: com.viafirma.tray.sign.cosign.CosignSignImpl
    • Firma Web: com.viafirma.tray.sign.web.WebSignImpl

    En caso de no indicarse esta variable, el sistema de firma empleado será Viafirma.

<Environment name="MANAGER_SIGN_IMPLS"
    value="com.viafirma.tray.sign.viafirma.ViafirmaSignImpl,com.viafirma.tray.sign.fortress.FortressSignImpl"
    description="MANAGER_SIGN_IMPLS" override="false" type="java.lang.String"/>
  • Configuración del identificador del nodo: Cuando se instala en modo cluster, resulta recomendable definir un identificador del nodo en el fichero inbox.xml. Este valor es utilizado por ejemplo en "Estado del sistema". El identificador se define en la variable NODE_IDENTIFIER. ```

Configuración del archivo persistence.xml

Según la base de datos que usemos en la aplicación, habrá que definir la propiedad hibernate.dialect en el archivo persistence.xml:

/<tomcat-home>/webapps/inbox/WEB-INF/classes/META-INF/persistence.xml

Dicha propiedad estaría configurada de la siguiente forma:

<property name="hibernate.dialect" value="org.hibernate.dialect.Oracle10gDialect" />

Para PostgreSQL el valor sería org.hibernate.dialect.PostgreSQLDialect, mientras que para MySQL sería org.hibernate.dialect.MySQLDialect.

Configuración de escritura de logs

El war entregado ya cuenta con una configuración básica para la escritura de logs. En caso de necesitar modificar esta configuración, habrá que modificar el fichero de configuración siguiente:

/<tomcat-home>/webapps/inbox/WEB-INF/classes/log4j.properties