ConversionModule (instalación y configuración)

Introducción

El módulo de conversión se corresponde con el proyecto Maven "ConversionModule".

Obtención

Está disponible vía subversion de la web del proyecto en SourceForge. Carpeta 'ConversionModule'

Compilación

El código fuente se proporciona con un 'make' (en ConversionModule\module\) con 2 perfiles:

·'Desarrollo' que genera un module-ear.ear CON 'components' incluido (scope=compile),

para ser utilizado en un dominio de GlassFish en el que no esté en el lib/ext.

·'integration(localhost)' que genera un module-ear.ear SIN 'components' incluido (scope=provided)

para ser utilizado en un dominio de GlassFish en el que sí esté en el lib/ext.

Puesto que en edita se comparte el dominio de GlassFish 'applications' entre varios módulos, tendremos 'components' en el lib/ext

Instalación

a) Verificar que en el lib/ext/ del dominio GlassFish (applications) en el que implementará el módulo tiene una versión de components actual.

b) Implementar el EAR del ConversionModule en el servidor de aplicaciones

module-ear.ear

c) Copiar el gateway al lib/ext/ de pasarela

org-proyectoedita-conversion-gateway-1.0.2.jar

d) Configurar arranque de soffice

+Verificar que OpenOffice.org está instalado

>whereis soffice

soffice: /usr/bin/soffice

+[si no se tuviera]

+Crear en /etc/init.d un fichero para el inicio (e.g.: fichero 'soffice' adjunto)

+Yast -> System -> System services (Runlevel)

Service Enabled Runlevels

soffice Yes 3 5

+Iniciar el servicio

Configuración del módulo

Conf. pasarela:

Configurar pasarela, mediante el OSID Configuration (o su equivalente UI), para que el gateway sepa dónde está el módulo.

Para este módulo se tiene que indicar la dirección del WSLD del WebService.

La configuración es "crosswalk/modules/Conversion", el tag Uri" y el valor, e.g.: "http://edita.selfip.org:9080/ConversionModuleService/ConversionModule?wsdl"

Nota 1: En el fichero properties que persiste la configuración aparecería una línea parecida a la siguiente:

Uri=http\://127.0.0.1\:9080/ConversionModuleService/ConversionModule?wsdl

Nota 2: Se adjunta a esta página dicho fichero 'Conversion' por si interesara modificarlo y copiarlo.

Conf. conversión:

La configuración del módulo es un fichero 'configuration.xml' en

/opt/glassfish/domains/applications/config/

donde 'applications' es el dominio de GlassFish en el que se ha instalado anteriormente.

Si no existe el fichero, se crea automáticamente una configuración por defecto. Nota: Lo hace:

ConversionModuleBean.crearConfiguration()

Una vez existe, se puede editar y cambiar la configuración para, por ejemplo, añadir nuevas extensiones del módulo de conversión.

Verificación

Ejecutar los JUnit tests (ConversionGatewayTest) en 'components'. Paquete "org.proyectoedita.conversion.gateway".

Son 6 tests que se tienen que superar.

Errores y soluciones

[1]Servicio 'soffice' no arranca

Puede deberse a que la variable SOFFICE_BIN del fichero /etc/init.d/soffice no apunte a la ubicación correcta del ejecutable 'soffice'

e.g.: SOFFICE_BIN=/usr/bin/soffice

También puede deberse al export LD_LIBRARY_PATH del fichero /etc/init.d/soffice

e.g.: export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/lib64/ooo3/ure/lib/:/usr/lib64/ooo3/basis-link/program/

[2]Error 126 al inciar el servicio 'soffice'

Asegurarse de que el fichero de configuración de arranque del servicio es ejecutable:

chmod a+x /etc/init.d/soffice

[3]"FAILED: Unknown Tag"

El gateway está pidiendo al diccionario el valor de un tag inexistente.

En el caso que nos ocupa, se debía a estar utilizando una versión del gateway antigua.

Se soluciona al poner la nueva versión en el lib/ext/ de pasarela y reiniciar el dominio "crosswalk" de GlassFish.

[4]REG_WITH_DURABLE_FAILED_0022

En la UI de conversión este error significa que falta configurar, en el dominio GlassFish en el que está instalado el módulo de conversión, la JVM option que indica cómo encontrar la pasarela edit@. Por ejemplo, en el entorno 'Desarrollo' es:

-Dedita.urlBase=http://localhost:8080

[5]Deploying application in domain failed; WSGEN FAILED WSGEN FAILED

Revisando el log del dominnio GlassFish hemos visto que daba un error ZIP relativo a lib/ext/mysql-connector-java-5.1.13-bin.jar

Se ha quitado esta biblioteca.

Se ha instalado la oficial de OpenSUSE

# zypper in mysql-connector-java

Ver dónde se ha instalado

# rpm -ql mysql-connector-java

Likar del lib/ext del dominio de aplicaciones de GlassFish a la anterior biblioteca

# ln -s /usr/share/java/mysql-connector-java-5.1.6.jar