Sistema de Gestin Documental Manual de Configuracin

Marzo, 2008

INDICE
Introduccin...................................................................................................................... 3 Instalacin......................................................................................................................... 3
Instalacin de Alfresco.................................................................................................... 3

Configuracin ................................................................................................................... 4
Configuracin de autenticacin ........................................................................................ 4 Configuracin de Acceso al sistema de archivos con FTP.................................................... 5 Configuracin de Calendarizacin de Sincronizacin con LDAP ............................................ 5 Configuracin de Cliente Web.......................................................................................... 7 Configuracin de Interfaces............................................................................................. 7

Introduccin
El presente manual tiene por objeto indicar las personalizaciones realizadas sobre la implementacin realizada en Alfresco. En general, las personalizacin sobre Alfresco se lo realiza modificando los archivos de configuracin xml.

Instalacin
Instalacin de Alfresco
Los pasos para la instalacin de Alfresco Enterprise 2.1 sobre RedHat Linux y MySql es la siguiente: 1. Crear el directorio /opt/alfresco 2. Descomprimir el archivo alfresco-enterprise.x.tar.gz 3. Crear el repositorio de base de datos de Alfresco sobre MySql. a. Cd alfresco/extras/databases/mysql b. Ejecutar mysql u root p < db_setup.sql c. Especificar nombre de base de datos, usuario y contrasea. d. Modificar el archivo /opt/alfresco/tomcat/shared/classes/alfresco/extension/ custom-hibernate-dialect.properties # HSQL dialect # #hsql#hibernate.dialect=org.hibernate.dialect.HSQLDialect # # MySQL dialect (default) # hibernate.dialect=org.hibernate.dialect.MySQLInnoDBDialect # # Oracle dialect # #oracle#hibernate.dialect=org.hibernate.dialect.Oracle9Dialect 4. Iniciar por primera vez Alfresco para que cree el repositorio y compile la aplicacin. 5. Probar ingresando a la pagina web http://hostname:8080/alfresco

Configuracin
Configuracin de autenticacin
El sistema de gestin documental Alfresco, tiene una configuracin de autenticacin basada en un servidor LDAP. Con el objetivo de evitar que los usuarios posean mltiples contraseas, Alfresco fue personalizado para que valide las conexiones con el sistema de autenticacin del correo Electrnico Zimbra. Actualmente existe una configuracin de sincronizacin de usuarios de cada hora, en el cual todos los nuevos usuarios y grupos se replicaran a Alfresco. Para realizar esta configuracin fue necesario realizar lo siguiente: Definicin de direccion IP / hostname, definicin de ruta de acceso y definicin de contrasea de autenticacin con LDAP. /opt/alfresco/tomcat/shared/classes/alfresco/extensin/ ldap-authentication-context.xml
<entry key="java.naming.provider.url"> <value>ldap://172.16.1.16:389</value> </entry> <entry key="java.naming.security.principal"> <value>uid=zimbra,cn=admins,cn=zimbra</value> </entry> <entry key="java.naming.security.credentials"> <value>zimbraadmin</value> </entry>

Definicin de ruta de acceso y mapeo de atributos de usuarios. Definicin de ruta de acceso y mapeo de atributos de grupos. /opt/alfresco/tomcat/shared/classes/alfresco/extension/ ldap-synchronisation-context.xml
<property name="searchBase"> <value>ou=people,dc=asambleaconstituyente,dc=gov,dc=ec</value> </property> <property name="attributeMapping"> <map> <entry key="cm:userName"> <value>uid</value> </entry> <entry key="cm:firstName"> <value>givenName</value> </entry> <entry key="cm:lastName"> <value>sn</value> </entry>

<entry key="cm:email"> <value>mail</value> </entry> <entry key="cm:organizationId"> <value>co</value> </entry> </map> </property> <property name="searchBase"> <value>ou=people,dc=asambleaconstituyente,dc=gov,dc=ec</value> </property> <property name="groupIdAttributeName"> <value>uid</value> </property> <property name="groupType"> <value>zimbraDistributionList</value> </property>

Configuracin de Acceso al sistema de archivos con FTP

El sistema de archivos permite que los usuarios accedan al Alfresco utilizando el protocolo FTP. Para realizar la configuracin de acceso via FTP se requiere modificar dos parmetros contenidos en el siguiente archivo (carpeta de acceso y direccin IP): /opt/alfresco/tomcat/shared/classes/alfresco/extension/ file-servers-custom.xml
<config evaluator="string-compare" condition="FTP Server"> <serverEnable enabled="true"/> <port>21</port> <bindto>172.16.1.18</bindto> <rootDirectory>/Alfresco/FTP/</rootDirectory> </config>

Configuracin de Calendarizacin de Sincronizacin con LDAP

Para que el proceso de sincronizacin se ejecute peridicamente, es necesario calendarizarlo. Para realizar esta configuracin es necesario configurar el siguiente archivo, en el cual se indica el tipo de evento a calendarizar y la frecuencia de ejecucin.

/opt/alfresco/tomcat/webapps/alfresco/WEB-INF/classes/alfresco Scheduled-jobs-context.xml
<bean id="ldapPeopleTrigger" class="org.alfresco.util.CronTriggerBean"> <property name="jobDetail"> <bean id="ldapPeopleJobDetail" class="org.springframework.scheduling.quartz.JobDetailBean"> <property name="jobClass"> <value>org.alfresco.repo.importer.ImporterJob</value> </property> <property name="jobDataAsMap"> <map> <entry key="bean"> <ref bean="ldapPeopleImport"/> </entry> </map> </property> </bean> </property> <property name="cronExpression"> <value>0 30 * * * ?</value> <!-- JV: Verifier, each 30 minutes, every day --> </property> <property name="scheduler"> <ref bean="schedulerFactory" /> </property> </bean>

<bean id="ldapGroupTrigger" class="org.alfresco.util.CronTriggerBean"> <property name="jobDetail"> <bean id="ldapGroupJobDetail" class="org.springframework.scheduling.quartz.JobDetailBean"> <property name="jobClass"> <value>org.alfresco.repo.importer.ImporterJob</value> </property> <property name="jobDataAsMap"> <map> <entry key="bean"> <ref bean="ldapGroupImport"/> </entry> </map> </property> </bean> </property> <property name="cronExpression"> <value>0 30 * * * ?</value> <!-- JV: Verifier, each 30 minutes, every day --> </property> <property name="scheduler"> <ref bean="schedulerFactory" /> </property> </bean>

Configuracin de Cliente Web

El presente archivo de configuracin permite principalmente configurar dos funcionalidades: 1. Definir los idiomas a utilizar 2. Agregar nuevos iconos de carpetas El archivo a configurar es el siguiente: /opt/alfresco/tomcat/shared/classes/alfresco/extension web-client-config-custom.xml
<config evaluator=string-compare" condition="Languages" replace="true"> <languages> <language locale="es_ES">Espanol</language> </languages> </config> <config evaluator="string-compare" condition="cm:folder icons"> <icons> <icon name="space-icon-default_aprobado" path="/images/icons/space-icondefault_aprobado.gif" /> <icon name="space-icon-default_filtro" path="/images/icons/space-icondefault_filtro.gif" /> <icon name="space-icon-default_mesa" path="/images/icons/space-icondefault_mesa.gif" /> <icon name="space-icon-default_plenario" path="/images/icons/space-icondefault_plenario.gif" /> <icon name="space-icon-default_rechazado" path="/images/icons/space-icondefault_rechazado.gif" /> </icons> </config>

Configuracin de Interfaces
En la personalizacin de las interfaces web del Alfresco se realizaron las siguientes adecuaciones: 1. Cambio de Imgenes Se realiz el reemplazo de las imgenes ubicadas en la ruta /opt/alfresco/tomcat/webapps/alfresco/images/logo por imgenes con el logotipo de la Asamblea Constituyente. Los archivos de imgenes reemplazados por el logotipo de la asamblea fueron: alfresco_enterprise.gif AlfrescoLogo16.gif AlfrescoLogo200.png AlfrescoLogo32.gif alfresco_logo.gif

2. Redireccionamiento por defecto a login.jsp El archivo de configuracin /opt/alfresco/tomcat/webapps/alfresco/ index.jsp es la pantalla por defecto de Alfresco. Esta pantalla redirecciona automticamente a un sitio publico. El cambio obliga a que la pantalla de login sea por defecto para cualquier conexin.
if (NavigationBean.LOCATION_MYALFRESCO.equals(location)) { response.sendRedirect(request.getContextPath() + "/faces/jsp/login.jsp"); } else { response.sendRedirect(request.getContextPath() + "/faces/jsp/login.jsp"); }