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