Uso de Google Docs con Alfresco… «en la vida real»

23 de May de 2011

Vamos a seguir con nuestros casos de uso en la vida real utilizando Alfresco. Para eso, nuestra ficticia aseguradora FEGOR necesita compartir documentos con los peritos, comerciales y asegurados. José Grillo, antes era perito de la compañía, actualmente lo han cambiado al departamento comercial, necesita de vez en cuando crear y modificar contratos y para ello usa Google Docs que le es muy cómodo ya que puede usarlo desde cualquier ordenador con navegador, además puede compartirlo con otras personas tanto sus jefes como asegurasdos (clientes) para que incluso terminen de rellenar datos que falten.

Como siempre, vamos a suponer que la aseguradora es pequeña y no tiene infraestructura propia para correo, web, etc., excepto el pequeño servidor de oficina con Alfresco instalado, un ADSL y la configuración para poder entrar desde fuera. Vamos a aprovechar las ventajas de Google para hacer esto de forma gratuita y no tener que contratar los servicios de terceros por lo que suponemos que hemos configurado Google Apps para nuestro correo y tenemos las siguientes direcciones:

Para la autenticación de Alfresco con Google Docs: alfresco@fegor.com
Usuario José Grillo que es ahora comercial: josegrillo@fegor.com
Usuario Toni Fuente es el director del departamento de contratos: tonifuente@fegor.com

José Grillo dejará una «copia de trabajo» de un contrato de seguro en Google Docs para que Toni Fuente pueda verificarla y dar el visto bueno o incluso modificar lo que haga falta desde su casa.

Para la configuración de la integración de Alfresco con Google Docs recomiendo los siguientes enlaces:

1. Toni de la Fuente tiene un magnífico vídeo que explica tanto la configuración como el funcionamiento de esta integración. (http://blyx.com/2011/05/23/screencast-sobre-integracion-de-alfresco-y-google-docs)

[vimeo http://www.vimeo.com/24042851 w=400&h=320]

2. http://wiki.alfresco.com/w/images/7/78/Getting_Started_with_Using_Google_Docs_with_Alfresco.pdf

Hay que crear el fichero googledocs.properties en extensionsubsystemsgoogledocsdefaultdefault y poner los siguites valores:

Fichero: googledocs.properties

googledocs.googleeditable.enabled=true
googledocs.application.name=Alfresco ECM system
googledocs.url=https://docs.google.com/feeds/default/private/full
googledocs.downloadurl=https://docs.google.com/feeds/download
googledocs.username=alfresco@fegor.com
googledocs.password=password_de_la_cuenta
googledocs.spreadsheet.service.name=wise

Actualización (10/10/2011), Rodrigo Tardioli Moreira me avisa que debido a la política de seguridad de Google Docs, el valor de «googledocs.url» debe usar el protocolo HTTPS en lugar de HTTP, por tanto, la línea sería:

googledocs.url=https://docs.google.com/feeds/default/private/full

Para más información se puede ir a la siguiente dirección: http://googleappsdeveloper.blogspot.com/2011/09/requiring-ssl-for-documents-list.html

Para que visualice las opciones de creación de los documentos en Google Docs desde Alfresco Share hay que activarlo explícitamente en web-config-custom.xml de la carpeta web-extension. (Para la versión 4.x no es necesario activarlo ya que viene por defecto descomentado)

[…]

true

application/msword
application/vnd.ms-excel
application/vnd.ms-powerpoint

[…]

En el perfil del usuario José Grillo (Email=josegrillo@fegor.com y Usuario Google=josegrillo@fegor.com) y en el perfil de Toni Fuente (Email=tonifuente@fegor.com y Usuario Google=tonifuente@fegor.com)

Además, esto es opcional, si el usuario administrador va a crear todos los espacios donde los usuarios suban documentos y estos no van a ser administradores de dicho sitio, para que no haya problemas en la asignación de roles de escritura a los usuarios que suben los documentos (ya que el propietario o «owner» del documento en Google Docs será el que haya creado el sitio) recomiendo que (usuario admin) sea el mismo usuario de Google que el usado en el fichero de propiedades. En este caso, tanto el «Email» como el «Usuario Google» los he puesto como alfresco@fegor.com.

Vamos a crear un nuevo sitio colaborativo (privado) llamado «Contratos» y dentro de la Biblioteca de documentos crearemos carpetas para «Hogar», «Vehículos» y «Vida» que serán los tipos de contratos. Este sitio lo creará el usuario Toni Fuente ya que es el responsable de este departamento e invitará a José Grillo al que asignará el rol de Coordinador. José Grillo deberá responder desde su correo a esta solicitud de invitación, evidentemente.

Una vez realizado ambos usuarios deben tener acceso al sitio colaborativo (privado) y poder crear documentos.

Ahora ya puede entrar José Grillo y crear su primer contrato para ser enviado a Google Docs, para ello debe seleccionar la opción de «Crear contenido…» de «Google Docs documento» en la Biblioteca de documentos.

Una vez creado el documento (no el contenido) y rellenado todos los metadatos, puede subirlo (José Grillo) a Google Docs para poder editarlo desde cualquier lugar donde se tenga acceso. De hecho, lo que crea es una copia de trabajo del documento.

Desde este momento ya puede editarse mediante Google Docs utilizando el enlace que Alfresco Share crea para este directamente, «Este documento ha sido subido por usted a Google Docs para su edición». Además, José Grillo recibe un mensaje a su cuenta de google con el enlace del documento a editar.

Pulsando el enlace iremos directamente al documento y si no hay sesión inicializada en google, se solicitará. En este caso se solicita una autenticación desde Google Apps.

Al entrar, José Grillo puede modificar el documento de contrato con la ventaja de no tener que instalar un programa ofimático en su ordenador o mejor aún, puede editar y modificar el contrato desde cualquier lugar donde pueda acceder a una navegador desde un ordenador.

Pero, además, en este caso, José Grillo necesita dar permisos a su jefe Toni Fuente porque necesita que realice unos cambios. Para ello directamente en el botón «Share» de Google Docs puede incluirlo y asignarle el rol de modificar el documento.

Es evidente que además, si necesita que el «asegurado» pueda editar el documento o simplemente visualizarlo en modo lectura para imprimirlo, puede invitarlo igualmente. Solo tendrá que tener una cuenta en google.

Pero, ¿y si necestita que toda la aseguradora tenga acceso a dicho documento?, es decir, todos los que pertenezcan al dominio fegor.com deben poder modificar/ver el documento. Pues, desde el mismo Google Docs cuando estamos dentro de un dominio Google Apps podemos asignar permisos a nivel de la misma organización. Para ello pinchamos en el enlace «Change» o «Compartir» de la primera línea de permisos que se visualiza, en este caso se puede observar en la imagen anterior. De esta forma podemos hacer que las cuentas creadas dentro de fegor.com tengan acceso vía un link o acceso directamente.

Una vez modificado, José Grillo puede «desproteger» el documento con lo que es borrado del acceso desde Google Docs y ya puede tener acceso desde el entorno Alfresco.

Solo comentaros que, igual que se ha creado desde cero el documento, para subir un documento a Alfresco y poder compartirlo en Google Docs necesitamos asignarle el aspecto «Editable en Google Docs» y ya podremos realizar todas las tareas que hemos visto.

Ahora toda la aseguradora FEGOR puede modificar, ver e imprimir contratos de seguros y además pueden enviar links compartidos a los asegurados, lo que le reporta un gran beneficio y flexibilidad a la hora de trabajar de forma deslocalizada y colaborativa…

… y espero que este artículo sirva de ayuda para extrapolarlo a otras situaciones similares 🙂

Uso del correo electrónico en Alfresco en la vida real – parte 2

18 de May de 2011

Sobre la configuración de Alfresco, primero debemos crear el usuario Jose Grillo para que pueda autenticarse y enviar los emails. Este usuario además debe tener una cuenta de correo electrónico válida para recibir notificaciones, en este caso es josegrillo@fegor.com

No hay que olvidarse de añadirlo al grupo EMAIL_CONTRIBUTORS para tener permisos de enviar correos hacia Alfresco.

Ahora debemos configurar el correo electrónico saliente y entrante. Para la configuración del correo recomiendo la lectura de los siguientes enlaces en los que se explican perfectamente todas las posibilidades:

http://blyx.com/2010/02/08/integracion-de-alfresco-con-el-correo-electronico/
http://wiki.alfresco.com/wiki/Inbound_SMTP_Email_Server_Configuration
http://wiki.alfresco.com/wiki/Outbound_E-mail_Configuration

Vamos a configurar seguidamente el correo saliente de Alfresco para poder realizar notificaciones a los asegurados y peritos. La configuración de correo saliente para GMail a través de Google Apps en Alfresco se realiza en el fichero outboundSMTP.properties del subsistema email, en concreto en la ubicación …/extension/subsystems/email/OutboundSMTP/outbound

Fichero: outboundSMTP.properties

mail.host=smtp.googlemail.commail.port=465
mail.protocol=smtps
mail.username=alfresco@fegor.com
mail.password=alfresco
mail.encoding=UTF-8
mail.from.default=alfresco@fegor.com
mail.smtps.starttls.enable=true
mail.smtps.auth=true

Como se observa, se ha creado también una cuenta llamada alfresco@fegor.com para la autenticación SMTP.

La configuración del correo entrante, para que Alfresco haga de servidor SMTP se realiza en el fichero inboundSMTP.properties en …extension/subsystems/email/InboundSMTP/inbound

Fichero: inboundSMTP.properties

email.inbound.enabled=true email.inbound.unknownUser=anonymous email.server.enabled=true email.server.port=25 email.server.domain=alfresco.fegor.com email.server.connections.max=10 email.server.allowed.senders=.*@fegor.com email.server.blocked.senders=

Ahora debemos configurar en Share un fichero para que nos muestre el campo «alias» en la carpeta a la que asignaremos el aspecto «Atributos de Email». Este fichero se llama share-config-custom.properties y se encuentra en la carpeta web-extension (…/share/classes/alfresco/web-extension). Esto es así porque por defecto, en Afresco Share, no está configurado para que este campo esté visible como pasaba con Alfresco Explorer.

Fichero: share-config-custom.properties

     <!–
         Used by the «Change Type» action

         Define valid subtypes using the following example:

         Remember to also add the relevant i18n string(s):
            cm_mysubtype=My SubType
      –>






      <!– forms
      –>

Realizadas las configuraciones se arranca Alfresco y continuamos con la configuración desde el propio Alfresco Share.

Uso del correo electrónico en Alfresco en la vida real – parte 1

18 de May de 2011

Vamos a ver un caso de vida real en una PYME usando Alfresco y configurando el correo electrónico tanto de salida como de entrada para gestionar documentos.

El escenario es el siguiente: Imaginamos una pequeña aseguradora llamada FEGOR en la que se dispone de un pequeño servidor de Alfresco y un ADSL. Todos los demás servicios se realizan a través de Google Apps (http://www .google.com/apps/intl/es/group/index.html y pulsar Introducción). Es decir, al menos el correo electrónico. Así mismo, en Hospedaje y Dominios se tiene comprado el dominio fegor.com.

Los peritos podrán enviar correo electrónico con los ficheros necesarios, expediente y fotografías de los siniestros o accidentes que periten. Una vez recibido el correo, Alfresco moverá cada fichero a sus carpetas correspondientes.

Toda la configuración en Alfresco se realizará a través de Alfresco Share.

Configuración de Google Apps: La configuración es muy sencilla, solo hay que seguir los tutoriales y pasos para crear cuentas de correo, sites, etc. En nuestro caso, creamos una cuenta para «Jose Grillo» con el email josegrillo@fegor.com

Una de las particularidades de Google Apps es la de ofrecer la redirección de un dominio que ya hubiésemos comprado en algún ISP tanto para los «sites» o páginas webs, como para blogs (http://blogspot.com) como para el correo electrónico (gmail) lo que hace que podamos usar el dominio para crear cuentas de correo (hasta 50) más profesionales. Para ello hay que modificar los DNS del registrador o ISP (Internet Service Provider) donde está alojado el dominio siempre que no lo compremos directamente a Google. Los datos a poner en el sistema de DNS (cada ISP tiene su propio sistema e interface o panel de control para hacerlo) serán los siguientes:

Introducir los siguientes registros MX con las siguientes prioridades:

ASPMX.L.GOOGLE.COM. 10
ALT1.ASPMX.L.GOOGLE.COM. 20
ALT2.ASPMX.L.GOOGLE.COM. 20
ASPMX2.GOOGLEMAIL.COM. 30
ASPMX3.GOOGLEMAIL.COM. 30
ASPMX4.GOOGLEMAIL.COM. 30

ASPMX5.GOOGLEMAIL.COM. 30

Una vez hecho esto, el correo se puede manejar desde el dominio que tengamos alojado en el ISP de turno. En Hospedaje y Dominios (http://www.hospedajeydominios.com) es muy fácil ya que incluso incluye un enlace que rellena esta información en la gestión de DNS. En la imagen se ve la configuración tanto del correo electrónico como de los «alias» para redireccionar al sitio web, google docs, blog, etc.

Se configura seguidamente (si se quiere solamente, ya que GMail provee de interface web y si está bien configurada con acceso desde el dominio propio, p.e. mail.fegor.com) la cuenta en Thunderbird (http://www.mozillamessaging.com/es-ES/thunderbird/) que es muy fácil teniendo los datos. Podemos ver tutoriales desde el propio Google Apps o incluso en el asistente de «Herramientas->Configuración de las cuentas…->Opciones sobre la cuenta->Añadir cuenta de correo electrónico» que es prácticamente automático introduciendo 3 campos de información: nombre, correo electrónico y contraseña.

Esta es una cuenta normal de GMail a través de Google Apps que nos ofrece un buzón de 7GB. más que suficientes para un uso normal de una pequeña empresa. José Grillo es el perito de la aseguradora que creará un expediente y sacará fotos de los siniestros (accidentes) y las enviará a través de su correo electrónico al sistema de gestión documental.

Una vez realizadas las operaciones sobre Google Apps podremos tener toda la infraestructura necesaria de la empresa en internet excepto el pequeño servidor con Alfresco que principalmente se usa dentro de la oficina y al que necesitaremos abrir hacia fuera el puerto 25 del correo saliente SMTP configurando el NAT (Network Address Translator) de nuestro router o modem ADSL. Para esto podemos informarnos en http://www.adsl4ever.com/

Algo de tuning con grandes cantidades de documentos (II)

21 de March de 2011

Este es el segundo artículo sobre tuning cuando se encuentran muchos documentos dentro del mismo nivel o espacio de trabajo y es continuación del artículo anterior: http://fegor.blogspot.com/2011/03/algo-de-tuning-con-grandes-cantidades.html

Seguimos con la configuración de un sistema con 60 mil documentos (muy pequeños) en el el mismo nivel de espacio de trabajo. Se me olvidó decir que las pruebas se han realizado sobre una máquina virtual en Virtual Box.

Partimos de la última cadena de configuración que usamos en el artículo anterior añadiendo también los parámetros para poder conectar vía JMX con la utilidad jconsole que es la usada para monitorizar los arranques:

export IP_ADDR=»`hostname -i`»

export JAVA_OPTS=»-server»

export JAVA_OPTS=»${JAVA_OPTS} -Xms720m -Xmx720m -Xss128k -XX:NewSize=256m -XX:MaxPermSize=128m»

export JAVA_OPTS=»${JAVA_OPTS} -XX:+UseConcMarkSweepGC -XX:+CMSIncrementalMode -XX:CMSInitiatingOccupancyFraction=80″

export JAVA_OPTS=»${JAVA_OPTS} -Dalfresco.home=${ALF_HOME} -Dcom.sun.management.jmxremote»

export JAVA_OPTS=»${JAVA_OPTS} -Djava.rmi.server.hostname=${IP_ADDR}»

Seguidamente se «optimiza» más la propia configuración de Alfresco ECM añadiendo al fichero alfresco-global.properties lo siguiente:

# Desconectar auditorías
audit.enabled=false
audit.useNewConfig=false

# Conexiones máximas a la BD
db.pool.max=275

# Reducción de conexión (8 por defecto)
db.pool.idle=-1

# Tamaño de filas para consultas (10 por defecto)
hibernate.jdbc.fetch_size=150

# Límite de tiempo mínimo para indexar en background
lucene.maxAtomicTransformationTime=0

# Tiempo para el tracking
index.tracking.cronExpression=0/5 * * * * ?

Cortesía de las Alfresco Master Classes y Toni de la Fuente.

Los resultados han sido los siguientes: (Tiempo de arranque: 565879 ms)

Ahora cambiamos en contentModel.xml en el tipo cm:content la propiedad «atomic» a «false», y remodificamos los parámetros de la JVM y volvermos a probar por última vez…

export JAVA_OPTS=»-server»

export JAVA_OPTS=»${JAVA_OPTS} -Xms720m -Xmx720m -Xss128k -XX:NewSize=128m -XX:MaxPermSize=128m»

export JAVA_OPTS=»${JAVA_OPTS} -XX:+UseConcMarkSweepGC -XX:+CMSIncrementalMode -XX:CMSInitiatingOccupancyFraction=50″

export JAVA_OPTS=»${JAVA_OPTS} -XX:MaxGCPauseMillis=1500 -XX:GCTimeRatio=9″

export JAVA_OPTS=»${JAVA_OPTS} -Dalfresco.home=${ALF_HOME} -Dcom.sun.management.jmxremote»

export JAVA_OPTS=»${JAVA_OPTS} -Djava.rmi.server.hostname=${IP_ADDR}»

El resultado final es: (Tiempo de arranque: 520523 ms)

Bien, Pero ¿que pasa si queremos introducir 150 mil documentos o más por nivel? Para esto antes modificaremos los valores de ehcache-context.xml para que puedan almacenar valores muy elevados así como en el fichero ehcache-transactional.xml subiremos el número de elementos en memoria (maxElementsInMemory=»150000″) y el parámetro de JVM «-XX:NewSize» lo ajustaremos según las necesidades.

Por ejemplo:

Fichero: ehcache-transactional.xml

[…]

         org.alfresco.cache.contentDataTransactionalCache


         150000

[…]

         org.alfresco.storeAndNodeIdTransactionalCache


         150000

[…]

Un script para crear documentos de prueba podría ser:

Fichero: crear_documentos.js
var doc;
for(var i=1; i<150000; i++)
{
   doc = companyhome.createFile(«doc-» + i + «.txt»);
   doc.content = «Texto-» + i + «. Esto es una prueba de creación de documento para comprobar la capacidad de indexación, recuperación, etc. ABCDEFGHYJKLMNÑOPQRSTUVWXYZ0123456789 ABCDEFGHYJKLMNÑOPQRSTUVWXYZ0123456789 «;
   doc.save();
}

El principal problema que nos encontramos aquí es que al crearse objetos dentro de un bucle, estos no son liberados tan rápidamente y pasan a la parte de «CMS Old Gen» de la heap que es la que recibe más carga por lo que habrá que ajustar tanto los tiempos de pasadas del GC como el tamaño de la memoria «a corto plazo» o «New Gen», esto puede establecerse con el parámetro -XX:NewSize.

También hay que tener en cuenta la configuración y optimización de MySQL.

Finalmente, una cadena de arranque para la JVM que es bastante útil en el caso de cargas masivas para plataformas 32 bit (para 64 bit se puede incrementar la heap al doble o al triple) sería:

export IP_ADDR=»`hostname -i`»

export JAVA_OPTS=»-server»
export JAVA_OPTS=»${JAVA_OPTS} -Xms1384m -Xmx1384m -Xss128k -XX:MaxPermSize=128m -XX:NewRatio=2″
export JAVA_OPTS=»${JAVA_OPTS} -XX:+OptimizeStringConcat -XX:+UseLargePages -XX:+UseFastAccessorMethods -XX:+AggressiveOpts -XX:-UseParallelGC»
export JAVA_OPTS=»${JAVA_OPTS} -XX:+UseConcMarkSweepGC -XX:+CMSIncrementalMode -XX:CMSInitiatingOccupancyFraction=80″
export JAVA_OPTS=»${JAVA_OPTS} -XX:GCTimeRatio=9″
export JAVA_OPTS=»${JAVA_OPTS} -Dalfresco.home=${ALF_HOME} -Dcom.sun.management.jmxremote»
export JAVA_OPTS=»${JAVA_OPTS} -Djava.rmi.server.hostname=${IP_ADDR}»
export JAVA_OPTS=»${JAVA_OPTS} -Djava.io.tmpdir=${ALF_HOME}/tomcat/temp»

La memoria asignada a la máquina virtual (Virtual Box) es de 1GB. y la de la JVM es más de 1GB. (1385 MB.) por lo que esta hará «swaping» a disco.

En resumen, el tema de optimización de la JVM y Alfresco ECM con cargas masivas de documentos o creación de estos y más en el mismo nivel no es trivial pero siempre se puede «forzar» para que al menos realice el trabajo inicial y posteriormente ir descargando los espacios de trabajo en estructuras de más profundidad para disminuir la carga en memoria de tantas referencias.

Algo de tuning con grandes cantidades de documentos (I)

16 de March de 2011

Cuando se tienen grandes cantidades de documentos a un mismo nivel de espacio de trabajo, del orden de 60000 por ejemplo, a la hora de indexar completamente o de requerir un listado, la JVM hace un uso intensivo de la memoria, sobre todo de la heap y en concreto de la llamada «Old Gen» (o «Tenured Gen», según casos) ya que son bucles donde se crean muchos objetos que tardan en ser liberados.

Las pruebas se han realizado en una máquina virtual con 1GB de RAM con CentOS 5 (i386), JVM 1.6.0_22 y Alfresco Enterprise 3.3.4

Todos los arranques se hacen borrando previamente el directorio «lucene-indexes» y estableciendo en alfresco-global.properties la propiedad «index.recovery.mode=FULL».

La primera prueba es arrancar con los parámetros normales que se suelen poner:

export JAVA_OPTS=»-server»
export JAVA_OPTS=»${JAVA_OPTS} -Xms128m -Xmx512m -XX:MaxPermSize=256m»

El resultado es el siguiente: (Tiempo de arranque: 630614 ms)

Se pueden observar las caídas en las gráficas cuando es lanzado el recolector de basura…

Además, al poner tantos elementos obtenemos avisos de la ehcache al sobrepasar los elementos posibles, bien, usamos la configuración que explico en el artículo http://fegor.blogspot.com/2011/01/avisos-de-alfresco-sobre-saturacion-de.html para evitar estos avisos y poder cargar más en la caché.

Además vamos a mejorar los parámetros de memoria, por un lado comprobamos que la «Perm Gen» está demasiado dimensionada con lo que la vamos a acortar para tener más posibilidades de asignarla a la heap. Además usaremos un menor tamaño de «New Gen» para adaptar mejor el tamaño a la parte «Tenured Gen», y dejaremos el tamaño de heap como está…

export JAVA_OPTS=»-server»
export JAVA_OPTS=»${JAVA_OPTS} -Xms512m -Xmx512m -XX:NewGen=128m -XX:MaxPermSize=128m»

El resultado mientras se arranca y reindexa, estando al rededor del 70% de reindexación completa es el siguiente: (Tiempo de arranque: 702462 ms)

Como observamos, no se aprecian grandes diferencias con respecto a la primera configuración, simplemente hemos eliminado los avisos de llenado de la ehcache pero ha tardado más en arrancar. Bien, sigamos, ahora vamos a realizar una configuración más «agresiva» usando los siguientes parámetros:

export JAVA_OPTS=»-server»
export JAVA_OPTS=»${JAVA_OPTS} -Xms640m -Xmx640m -Xss128k -XX:NewSize=320m -XX:MaxPermSize=128m»
export JAVA_OPTS=»${JAVA_OPTS} XX:+UseConcMarkSweepGC -XX:+CMSIncrementalMode -XX:CMSInitiatingOccupancyFraction=80″

Este es el resultado:(Tiempo de arranque: 670572 ms)

Se observa un mejor comportamiento de la memoria, si bien, la parte de «Old Gen» está algo elevada. También se ha recogido la muestra mientras indexaba sobre el 70%.

Por último vamos a retocar un poco los parámetros de la JVM y eliminar la modificación sobre el fichero hibernate-context.xml que se ha seguido en el artículo anterior.

Los parámetros establecidos quedan como:

export JAVA_OPTS=»-server»
export JAVA_OPTS=»${JAVA_OPTS} -Xms720m -Xmx720m -Xss128k -XX:NewSize=256m -XX:MaxPermSize=128m»
export JAVA_OPTS=»${JAVA_OPTS} -XX:+UseConcMarkSweepGC -XX:+CMSIncrementalMode -XX:CMSInitiatingOccupancyFraction=80″

Y el resultado es: (Tiempo de arranque: 568476 ms)

En este último caso, la reindexación y arranque ha tardado menos tiempo si bien la memoria parece que está más aprovechada ya que se observa una mayor carga de instancias y ocupación de esta sin llegar en ningún momento a colapsarse.

Como se observa, existen múltiples configuraciones y aunque a priori parezca que no haya grandes diferencias, en muchas ocasiones puede optimizar el trabajo tanto a la hora de reindexar muchos documentos como de respuesta hacia el interface gráfico.

También se observa que Alfresco ECM cada vez se comporta mejor con grandes cantidades de documentos (obsérvese que se han creado con un tamaño pequeño y tipo texto solamente) dentro del mismo espacio de trabajo.

En la segunda parte se tocarán no solo parámetros de la JVM sino también de Alfresco ECM para acortar estos tiempos de arranque así como mejorar la gestión de la memoria.

Para obtener más información se pueden consultar los siguientes enlaces:

http://wiki.alfresco.com/wiki/JVM_Tuning#Maximum_JVM_Heap_Size_32.2F64bit
http://www.oracle.com/technetwork/java/javase/tech/vmoptions-jsp-140102.html
http://fegor.blogspot.com/2011/01/avisos-de-alfresco-sobre-saturacion-de.html

Forzar el HOST en JMX (RMI) para Alfresco ECM

15 de March de 2011

En algunas ocasiones necesitamos forzar el HOST para las conexiones JMX vía RMI de Alfresco.

En la configuración (alfresco-shared.properties) encontramos dos propiedades que son las siguientes:

alfresco.rmi.services.port=50500

alfresco.rmi.services.host=localhost

Pero en realidad hacen referencia a la parte de «virtualización» de servidor de Alfresco y no de los servicios que este proporciona. Para ello hay que recurrir a una propiedad en la llamada a la JVM que es java.rmi.server.hostname

En efecto, si necesitamos forzar una IP determinada de «escucha» para conectar alguna consola tipo jconsole, VisualVM, etc. necesitaremos hacer uso de esta variable.

Lo mejor es ponerla en el script de arranque de Alfresco, por ejemplo en Linux, esta sería una forma:

[…]

export IP_ADDR=»`hostname -i`»

export JAVA_OPTS=»-Xms256m -Xmx524m -Xss128k -XX:PermSize=196m -XX:MaxPermSize=196m -server»
export JAVA_OPTS=»${JAVA_OPTS} -Dalfresco.home=${ALF_HOME} -Dcom.sun.management.jmxremote -Djava.rmi.server.hostname=${IP_ADDR} -Djava.rmi.server.port=50500″
[…]

Ahora solo queda arrancar y probar que se está listando correctamente el puerto y desde la dirección IP adecuada con:

netstat -putan | grep java

Y el resultado sería algo así:

tcp        0      0 ::ffff:192.168.1.112:50500 :::*                        LISTEN      5560/java
tcp        0      0 ::ffff:127.0.0.1:8005       :::*                        LISTEN      5560/java
tcp        0      0 :::50501                    :::*                        LISTEN      5560/java
tcp        0      0 :::50502                    :::*                        LISTEN      5560/java
tcp        0      0 :::55142                    :::*                        LISTEN      5560/java
tcp        0      0 :::50503                    :::*                        LISTEN      5560/java
tcp        0      0 :::50504                    :::*                        LISTEN      5560/java
tcp        0      0 :::8009                     :::*                        LISTEN      5560/java
tcp        0      0 :::50505                    :::*                        LISTEN      5560/java
tcp        0      0 :::50506                    :::*                        LISTEN      5560/java
tcp        0      0 :::50507                    :::*                        LISTEN      5560/java
tcp        0      0 :::139                      :::*                        LISTEN      5560/java
tcp        0      0 :::50508                    :::*                        LISTEN      5560/java
tcp        0      0 :::53453                    :::*                        LISTEN      5560/java
tcp        0      0 :::8080                     :::*                        LISTEN      5560/java
tcp        0      0 :::41715                    :::*                        LISTEN      5560/java
tcp        0      0 :::38324                    :::*                        LISTEN      5560/java
tcp        0      0 :::445                      :::*                        LISTEN      5560/java
tcp        0      0 ::ffff:127.0.0.1:42540      ::ffff:127.0.0.1:3306       ESTABLISHED 5560/java
tcp        0      0 ::ffff:127.0.0.1:42541      ::ffff:127.0.0.1:3306       ESTABLISHED 5560/java
tcp        0      0 ::ffff:127.0.0.1:42542      ::ffff:127.0.0.1:3306       ESTABLISHED 5560/java
tcp        0      0 ::ffff:127.0.0.1:42543      ::ffff:127.0.0.1:3306       ESTABLISHED 5560/java
tcp        0      0 ::ffff:127.0.0.1:42544      ::ffff:127.0.0.1:3306       ESTABLISHED 5560/java
tcp        0      0 ::ffff:127.0.0.1:42545      ::ffff:127.0.0.1:3306       ESTABLISHED 5560/java
tcp        0      0 ::ffff:127.0.0.1:42546      ::ffff:127.0.0.1:3306       ESTABLISHED 5560/java
tcp        0      0 ::ffff:127.0.0.1:42547      ::ffff:127.0.0.1:3306       ESTABLISHED 5560/java
tcp        0      0 ::ffff:192.168.1.112:50508 ::ffff:192.168.1.103:53427 ESTABLISHED 5560/java
tcp        0      0 ::ffff:192.168.1.112:50508 ::ffff:192.168.1.103:53428 ESTABLISHED 5560/java
udp        0      0 :::137                      :::*                                    5560/java
udp        0      0 :::7500                     :::*                                    5560/java
udp        0      0 :::7500                     :::*                                    5560/java

Crear módulos AMP para share (Alfresco)

07 de March de 2011

Mi amigo Toni de la Fuente ha modificado un componente en WebScript (repository) para visualizar todas las consolas de que disponemos en la versión Enterprise de Alfresco: http://blyx.com/2011/03/07/anade-mas-utilidades-de-administracion-en-alfresco-share/ y ha creado un proyecto en google code a partir de este en: http://code.google.com/p/alfresco-useful-admin-links/

Para instalar este WebScript solo hay que copiarlo en la ruta indicada directamente (ver información en su proyecto) o bien, también se puede crear un módulo AMP para que pueda ser instalado dentro del fichero share.war

Bien, eso es lo que vamos a hacer, crearemos un fichero AMP con los ficheros de WebScript para que pueda dejarlo para descarga en su proyecto.

La creación de módulos para «share» de Alfresco es la misma que cuando se crean módulos para el «explorer». Evidentemente cambian las localizaciones, dónde vamos a dejar los ficheros y que en este caso la mayoría de las veces serán archivos relacionados con WebScripts más que clases Java.

Si tenemos el SDK de Alfresco se puede realizar una copia de su «SDK Basic AMP» y a partir de ahí continuar, si no es así se puede crear un proyecto Java en Eclipse y dotarlo de la siguiente estructura:

En build/dist se creará el fichero de módulo, este se generará a partir de un fichero .jar generado, a su vez, a partir de lo que se tenga en el directorio source; así como también de los ficheros que hay en el directorio config.

Dentro del directorio config podemos crear la estructura misma que usa Alfresco (share) para almacenar los componentes y en concreto los de la consola para el administrador; y que está en alfresco/site-webscripts/org/alfresco/components/console

Lo más importante aquí es tener un buen fichero de ant para que pueda ser «compilado» todo correctamente.

Mi fichero ant para esto (build.xml) es el siguiente:

Una vez que todos los componentes están en su sitio solo hay que ejecutar el archivo build.xml (botón derecho encima del fichero build.xml en Eclipse y elegir «Run as…->Ant Build») y comprobar el resultado.

¿Ventajas de tener un módulo?, creo que están claras, mejora la administración y mantenimiento del producto, mayor facilidad para instalación, etc. Por supuesto es lo aconsejado por Alfresco.

¿Desventajas?, pue sí, como con todo, también las hay, la más importante es que copiando los ficheros directamente en el despliegue de la aplicación solo hay que «refrescar» el «inventario» de WebScripts para tenerlos disponibles y en caliente, mientras que de la otra forma aunque no paremos el servidor o la aplicación share, al modificar el .war se autodesplegará produciendo al menos que tengámos que volver a autenticarnos, siempre y cuando no tengamos activado el Single Sign On (SSO)… 😉

El blog de Fegor

Un informático muy humanista

Uso de Google Docs con Alfresco… «en la vida real»

23 de May de 2011

Algo de tuning con grandes cantidades de documentos (II)

21 de March de 2011

Algo de tuning con grandes cantidades de documentos (I)

16 de March de 2011

Forzar el HOST en JMX (RMI) para Alfresco ECM

15 de March de 2011

Uso de cookies