//AADIDO ALFRESCO OPENCMS.

MANUAL DE INSTALACIN Y USO//

Edicin 01.

Sevilla, Julio de 2.007

//AADIDO ALFRESCO OPENCMS. MANUAL DE INSTALACIN Y USO//

Edicin 01.

Hoja de control del documento

Nombre del documento Cdigo del documento Edicin Fecha Edicin a la que modifica Autor Aprobado por Aadido Alfresco Opencms. Manual de Instalacin y uso. DOCTEC_Alfresco_Opencms 01 06/07/07 00 Unidad de Vigilancia Tecnolgica (UVT). Icoss S.L. Direccin de Produccin. Icoss S.L.

Control de modificaciones
Edicin 00 01 Fecha 25/06/07 06/07/07 Comentarios Primera versin. Correccin en el apartado: Creando las Reglas de Accin Autor UVT. Icoss S.L. UVT. Icoss S.L.

DOCTEC_Alfresco_Opencms

//AADIDO ALFRESCO OPENCMS. MANUAL DE INSTALACIN Y USO//

Edicin 01.

INDICE
1. INTRODUCCIN. ................................................................................................................. 4

1.1 OBJETIVO............................................................................................................................... 4 1.2 REQUISITOS PREVIOS......................................................................................................... 4 2. 3. 4. 5. DESEMPAQUETADO DEL AADIDO ALFRESCO OPENCMS .................................. 4 INSTALACIN DEL AADIDO ALFRESCO OPENCMS .............................................. 5 CREACIN DE LAS REGLAS DE ACCIN. ....................................................................... 8 PRUEBAS............................................................................................................................... 15

DOCTEC_Alfresco_Opencms

//AADIDO ALFRESCO OPENCMS. MANUAL DE INSTALACIN Y USO//

Edicin 01.

1. INTRODUCCIN.
1.1 Objetivo. El presente documento recoge las instrucciones y pasos necesarios para la instalacin del Aadido Alfresco Opencms desarrollado por Icoss S.L.. Dichas instrucciones se centran en la instalacin del Aadido dentro del sistema Alfresco y como crear reglas en una carpeta para poder sincronizarla con otra carpeta en el sistema Opencms.

1.2 Requisitos Previos. Para seguir los pasos indicados en este manual se debe disponer de una mquina con sistema operativo Windows o Linux y el siguiente software y versiones: Sun J2SDK 1.5.x Alfresco 2.x Opencms 6.x Adems de los siguientes usuarios en los sistemas Alfresco y Opencms: Usuario de Alfresco admin y con clave admin Usuario de Opencms Admin y con clave admin Por ltimo, es aconsejable un conocimiento bsico tanto del sistema operativo con el que cuente su mquina, como de Tomcat.

2. DESEMPAQUETADO DEL AADIDO ALFRESCO OPENCMS

El primer paso es descomprimir el fichero alfresco_ocms_0_0b.zip. Como resultado de esta operacin se obtendr (entre otros) los siguientes ficheros y directorios: src/: Contiene el cdigo fuente del Aadido. ocms_alfresco.jar: Fichero jar (librera java) con la versin compilada del cdigo fuente anteriormente mencionado. opencms.jsp: Fichero jsp que Alfresco usar para configurar los parmetros necesarios.

DOCTEC_Alfresco_Opencms

//AADIDO ALFRESCO OPENCMS. MANUAL DE INSTALACIN Y USO//

Edicin 01.

alfresco_setup.txt: Fichero de texto con las lneas de cdigo XML que configurarn Alfresco para usar el Aadido Alfresco-Opencms.

3. INSTALACIN DEL AADIDO ALFRESCO OPENCMS

Una vez descomprimido el Aadido y comprobado que se cuentan con los ficheros y carpetas mencionados, se debe localizar la carpeta de la instalacin de Alfresco. Si se est trabajando con sistema operativo Windows, dicha carpeta puede ser algo como C:\Alfresco. Para localizar este directorio de manera gil se puede realizar una bsqueda del fichero llamado alfresco.bat en Windows o del fichero alfresco.sh en Linux. Una vez localizada la carpeta de instalacin del Alfresco se debe comprobar que en su interior existen los ficheros y directorios siguientes: alfresco.bat (slo en Windows) alfresco.sh (slo en Linux) alf_data/ tomcat/ A continuacin se debe crear un directorio con nombre tmp, de forma que la estructura final de la carpeta de instalacin de Alfresco quedara: alfresco.bat (slo en Windows) alfresco.sh (slo en Linux) alf_data/ tomcat/ tmp/ (nueva carpeta creada) Llegados a este punto se deben realizar las siguientes operaciones: 1.- Copiar el fichero ocms_alfresco.jar dentro de la carpeta tomcat/webapps/alfresco/WEB-INF/lib/ 2.- Copiar los siguientes ficheros jar de Opencms, que deben buscarse en la instalacin de Opencms del equipo, dentro de la carpeta tomcat/webapps/alfresco/WEB-INF/lib/:

DOCTEC_Alfresco_Opencms

//AADIDO ALFRESCO OPENCMS. MANUAL DE INSTALACIN Y USO//

Edicin 01.

opencms.jar commons-email-1.0-mod.jar org.opencms.legacy.jar org.opencms.frontend.templateone.jar org.opencms.frontend.templateone.form.jar org.opencms.frontend.templateone.modules.jar commons-digester-1.7.jar alkacon-simapi-0.9.4.jar 3.- Borrar de la carpeta tomcat/webapps/alfresco/WEB-INF/lib/ el fichero commonsdigester-1.5,jar. 4.- Copiar el fichero opencms.jsp dentro de la carpeta tomcat/webapps/alfresco/jsp/actions/. 5.Localizar el fichero de configuracin tomcat/webapps/alfresco/WEB-

INF/classes/alfresco/action-services-context.xml e introducir el cdigo del fichero alfresco_setup.txt dentro de la etiqueta <beans>.

Ejemplo:
<?xml version='1.0' encoding='UTF-8'?> <!DOCTYPE beans PUBLIC '-//SPRING//DTD BEAN//EN' 'http://www.springframework.org/dtd/spring-beans.dtd'> <beans> <!-- Alfresco-Opencms --> <bean id="opencms-messages" class="org.alfresco.i18n.ResourceBundleBootstrapComponent"> <property name="resourceBundles"> <list> <value>alfresco_link.opencms</value> </list> </property> </bean> <bean id="opencms.dictionaryBootstrap" parent="dictionaryModelBootstrap" dependson="dictionaryBootstrap"> <property name="models">

DOCTEC_Alfresco_Opencms

//AADIDO ALFRESCO OPENCMS. MANUAL DE INSTALACIN Y USO//

Edicin 01.

<list> <value>alfresco/extension/opencmsModel.xml</value> </list> </property> </bean> <bean id="opencms" class="alfresco_link.OpencmsActionExecuter" parent="actionexecuter"> <property name="nodeService"> <ref bean="nodeService" /> </property> </bean> <!-- Alfresco-Opencms --> <!-- Action Service --> <bean id="actionService" class="org.alfresco.repo.action.ActionServiceImpl"> <property name="nodeService"> <ref bean="NodeService" /> </property> <property name="searchService"> <ref bean="SearchService" /> </property> <property name="authenticationComponent"> <ref bean="authenticationComponent" /> </property> <property name="dictionaryService"> <ref bean="DictionaryService" /> </property> <property name="asynchronousActionExecutionQueue"> <ref bean="asynchronousActionExecutionQueue"/> </property> </bean> ... Para que la instalacin funcione correctamente, la carpeta inicial de Alfresco (la carpeta desde la que se lanza el script para iniciar Alfresco y la que contiene las carpetas alf_data/ y tmp/) debe estar en la variable de entorno CLASSPATH del tomcat de Alfresco. En caso de recibir un error que indique: Fichero xxx no encontrado se debe modificar el fichero tomcat/bin/catalina.bat, sobre sistema operativo Windows, o catalina.sh, si se trabaja sobre sistema operativo Linux, y aadir la carpeta inicial de Alfresco a la variable de entorno CLASSPATH.

DOCTEC_Alfresco_Opencms

//AADIDO ALFRESCO OPENCMS. MANUAL DE INSTALACIN Y USO//

Edicin 01.

Ejemplo:
... rem Add on extra jar files to CLASSPATH if "%JSSE_HOME%" == "" goto noJsse set CLASSPATH=%CLASSPATH%;%JSSE_HOME%\lib\jcert.jar;%JSSE_HOME%\lib\ jnet.jar;%JSSE_HOME%\lib\jsse.jar :noJsse set CLASSPATH=%CLASSPATH%;%CATALINA_HOME%\bin\bootstrap.jar;C:\Alfre sco if not "%CATALINA_BASE%" == "" goto gotBase set CATALINA_BASE=%CATALINA_HOME% :gotBase ... Por ltimo, para terminar la configuracin, debe reiniciarse Alfresco.

4. CREACIN DE LAS REGLAS DE ACCIN.

Una vez que el Aadido Alfresco-Opencms ha sido instalado se proceder a realizar un test simple que tambin ser til para aprender a usarlo. Como se ha comentado anteriormente, este Aadido publica en una carpeta de Opencms los fichero que se depositan en una carpeta de Alfresco. Como primer paso del test se crear una carpeta en Opencms:

La nueva carpeta ser /sites/default/MyNewFolder/ y debe ser publicada.

DOCTEC_Alfresco_Opencms

//AADIDO ALFRESCO OPENCMS. MANUAL DE INSTALACIN Y USO//

Edicin 01.

Tras la publicacin de la carpeta, se procede al logon en Alfresco. Al conectarse a Alfresco se debe seleccionar el idioma del mismo, en este caso, espaol o ingles, ya que actualmente el Aadido Alfresco-Opencms slo est traducido a estos dos idiomas.

Una vez dentro de Alfresco, en la seccin Personal se debe crear un nuevo espacio, el nombre del mismo no es relevante:

DOCTEC_Alfresco_Opencms

//AADIDO ALFRESCO OPENCMS. MANUAL DE INSTALACIN Y USO//

Edicin 01.

Una vez creado el espacio, se debe crear una nueva regla. A la hora de seleccionar la condicin en la creacin de la regla, se puede elegir la que mejor se adecue a las necesidades del espacio.

El siguiente paso es crear la accin. Para ello se debe elegir la opcin: Publica en OpenCMS. A continuacin se debe pulsar sobre la opcin Ajustar valores y Aadir:

DOCTEC_Alfresco_Opencms

10

//AADIDO ALFRESCO OPENCMS. MANUAL DE INSTALACIN Y USO//

Edicin 01.

En el ajuste de valores de la accin es importante prestar atencin a la ltima / en los nombres de las carpetas:

Como se ha comentado anteriormente, se ha usado el usuario Admin de Opencms a modo de ejemplo aunque no es recomendable por motivos de seguridad. Por lo tanto, sera conveniente usar otro usuario de Opencms que tenga permisos para escribir, borrar y publicar en la carpeta correspondiente de Opencms. Cuando se hayan ajustado los valores de la accin, se debe pulsar Aceptar y a continuacin la opcin Siguiente, esto deber desembocar en la pantalla de detalles:

En esta pantalla es necesario elegir el tipo Actualizar ya que esta regla de accin crear y actualizar el contenido en el sistema Opencms. Posteriormente se crear otra regla para borrar el contenido. Por ltimo, pulse el botn Finalizar y la regla quedar creada:

DOCTEC_Alfresco_Opencms

11

//AADIDO ALFRESCO OPENCMS. MANUAL DE INSTALACIN Y USO//

Edicin 01.

A continuacin debe crear una nueva regla siguiendo los pasos anteriores con la nica diferencia de que en el paso tres (Detalles) debe indicar que el tipo es Entrante:

Con las reglas que se han creado, es posible poner un contenido en una carpeta de Alfresco y el mismo aparecer en la correspondiente carpeta de Opencms. Si se procede a la eliminacin del contenido en la carpeta de Alfresco, este no se borrar en la carpeta de Opencms; para realizar esta operacin se debe crear una nueva regla siguiendo los pasos anteriores pero con dos salvedades: En la pantalla de ajuste de valores de la accin, se debe marcar la opcin es una accin para borrar?. En la seccin de detalles de la regla, se debe seleccionar el tipo como Saliente. A continuacin se muestran las pantallas con todos los pasos a seguir:

DOCTEC_Alfresco_Opencms

12

//AADIDO ALFRESCO OPENCMS. MANUAL DE INSTALACIN Y USO//

Edicin 01.

DOCTEC_Alfresco_Opencms

13

//AADIDO ALFRESCO OPENCMS. MANUAL DE INSTALACIN Y USO//

Edicin 01.

Como resultado de la creacin de reglas se debe contar con tres reglas, una para crear, otra para modificar y una ltima para eliminar contenido:

DOCTEC_Alfresco_Opencms

14

//AADIDO ALFRESCO OPENCMS. MANUAL DE INSTALACIN Y USO//

Edicin 01.

5. PRUEBAS.
Para probar que la configuracin ha sido realizada correctamente se puede proceder a crear un contenido nuevo en una carpeta:

Se puede crear cualquier tipo de contenido en la carpeta (como ejemplo se ha creado una pgina html) y ste deber aparecer en el sistema de ficheros de Opencms. Si dicho contenido no apareciese, debe proceder a salir de Opencms y volver a entrar para comprobar que los cambios han tenido efecto.

DOCTEC_Alfresco_Opencms

15

//AADIDO ALFRESCO OPENCMS. MANUAL DE INSTALACIN Y USO//

Edicin 01.

Para consultar los mensajes de error/depuracin, se debe consultar el fichero de log de tomcat (catalina.out).

Ejemplo:
... 24-may-2007 13:07:37 org.apache.jk.common.ChannelSocket init INFO: JK: ajp13 listening on /0.0.0.0:8099 24-may-2007 13:07:37 org.apache.jk.server.JkMain start INFO: Jk running ID=0 time=0/116 config=null 24-may-2007 13:07:37 org.apache.catalina.storeconfig.StoreLoader load INFO: Find registry server-registry.xml at classpath resource 24-may-2007 13:07:37 org.apache.catalina.startup.Catalina start INFO: Server startup in 70595 ms Thu May 24 13:28:29 CEST 2007 UPDATE:/sites/default/MyNewFolder/test.html

DOCTEC_Alfresco_Opencms

16