[ Alfresco Administration ] · ALFRESCO ADMINISTRATION Dr. Ciencias Físicas UPV/EHU. 10 años de experiencia en empresa en el desarrollo de portales java open source. Experto en

ALFRESCO ADMINISTRATION

[ Alfresco Administration ]

César Capillas


Dr. Ciencias Físicas UPV/EHU.

10 años de experiencia en empresa en el desarrollo de portales java open source.

Experto en tecnologías y arquitecturas java open-source de portales (Alfresco, Liferay Portal), BI (Pentaho) y firma digital (Sinadura).

Cesar Capillas

https://www.linkedin.com/in/cesarcapillas


Miembro de la comunidad de Alfresco “Order of the bee”, y participante en los foros y eventos de Alfresco.

Blog de Alfresco (“No Blogo”)

Desarrollador de addons de Alfresco

Certificado con ACA001, ACA501, ACE501

Cesar Capillas

http://www.zylk.net/es/web/guest/web-2-0/blog

https://github.com/CesarCapillas


Indice

M1: Instalación

● Introducción

● Características de Alfresco ECM

● Casos de uso de Alfresco

● Diferencias entre las versiones CE y EE

● Nociones de arquitectura

● Instalación de Alfresco

● Configuración básica y logs

● Módulos de Alfresco


Indice

M2: Gestión del repositorio

● Subsistemas de autenticación

● Sincronización de usuarios LDAP/AD

● Sistemas de ficheros

● Seguridad y permisos

● Gestión de usuarios y grupos

● Administración del repositorio:

● Consola de administración de Alfresco Share

● Consola del repositorio

● Navegador de nodos

● Consolas de despliegue dinámico de modelos y workflows

● Consola de Javascript

● Consola de Activiti

● Subsistema de búsqueda e indexación SOLR


Indice

M3: Gestión del servidor

● Backups y monitorización

● Seguridad

● Upgrades, parches y hotfixes de Alfresco

● Tuning JVM

● Logs en Alfresco

● Administración via consola JMX

● Gestión del almacenamiento

● Alta disponibilidad y balanceo de carga


Entorno de prácticas

● VMware Player

● Máquina virtual VMware

● Usuarios:

● MV: alfresco/alfresco (usuario ubuntu sudoer)

● Mysql Server: root (sin password)


[ M1: Instalación ]

César Capillas <cesar at zylk.net>


Introducción


¿ Qué es Alfresco ECM ?

Alfresco es un gestor documental empresarial open source

ECM = Enterprise Content Management


¿ Que es un ECM ?

● Es una infraestructura normalmente de tipo web:

● … que proporciona el conjunto de estrategias y tecnologías para la gestión del ciclo de vida de los contenidos (documentos) de una organización

● … permitiendo la gestión de la información no estructurada de una organización.

● … y facilitando el trabajo colaborativo y la compartición de la misma.


¿ Que es un ECM ?

● Debe incorporar ciertas capacidades como:

● Una gestión de documentos con sistema granular de permisos así como capacidades de auditado y versionado de documentos.

● Una gestión de imágenes que permita la captura, trasformación de imágenes.

● Una gestión de registros que permita el archivado y custodia de documentos de larga duración.

● Una herramienta para definir procesos de negocio.● Una herramienta colaborativa para compartir

información.


¿ Cuales son los usos típicos ?

● Alfresco como servidor de ficheros web (Dropbox, Google Drive).

● Alfresco como unidad compartida en red (CIFS, Webdav, NFS).

● Alfresco como backend de digitalización.

● Alfresco como repositorio multimedia.

● Alfresco como intranet colaborativa de documentos (estilo Sharepoint).

● Alfresco como repositorio de aplicaciones.

● Alfresco como backend de procesos BPM embebido.


Alfresco en el mercado ECM


Escenario ECM/CMS Open Source


¿ Porqué productos open-source ?

● Potencian la innovación utilizando estándares abiertos y reutilizando otros proyectos de software libre.

● Tienen una mayor flexibilidad y permiten la integración con soluciones de terceros.

● No son dependientes de una única plataforma.

● Protegen a los usuarios de los riesgos y desventajas de las soluciones de proveedor único.

● Aunque software libre no significa software gratuito, en general, implica unos costes de implantación y licencias menores.


Licencias de Alfresco

● Alfresco Community:● QA básico

● Versiones mayores solamente

● Licencia LGPL (sin costes)

● Soportada por la comunidad: Wiki, Forum....

● No JMX, no Cluster, no Oracle y SQLServer...

● Alfresco Enterprise (Alfresco One):● Certificado y Garantizado

● QA completo

● Versiones de mantenimiento

● Soportado por Alfresco y partners

● Suscripciones anuales por CPU (y tmb #usuarios)

5.1.g (201606GA)

5.1.1


Características de Alfresco ECM


Características generales

● Repositorio de documentos:● Un sistema de permisos basado en reglas de control de

acceso (ACL).

● Integrable en un contexto de empresa (SSO y Directorio Activo).

● Escalable, replicable y clusterizable.

● Intranets colaborativas de documentos● Indexado automático de documentos y búsquedas.

● Previsualizaciones.

● Motores de categorización, etiquetado y control de versiones.


Más características ...

● Sistemas virtuales de unidad compartida:● CIFS, Webdav, NFS, FTP e IMAP.

● Edición online de documentos:● Protocolos Sharepoint & Webdav.

● Modelos personalizados de contenidos● Motores de modelización y metadatos de negocio.

● Motores de reglas de contenido y workflows● jBPM y Activiti

● API's de desarrollo: ● CMIS, REST/Webscript, Foundation API, WS


Casos de uso de Alfresco


Tipos de uso

● Una clasificación de los tipos de uso puede ser:

● Repositorio de trabajo colaborativo

● Repositorio de conocimiento

● Repositorio de aplicaciones

● Repositorio de archivo


Caso I: Repositorio de trabajo

● Solución colaborativa de documentación para repositorios de trabajo

● Acceso a través de:

– Unidades compartidas en red (webdav, CIFS, FTP).

– Acceso web a través de Alfresco Share.

– Acceso móvil a través de Alfresco Mobile.● Sistema de control de accesos

● Sistema de control de versiones

● Feed de actividad y notificaciones

● Previsualizadores web

● Edición online de documentos.

● Motores básicos de clasificación: Etiquetas y/o categorías.

● Buscadores de contenido.



● Ejemplos de uso colaborativo de repositorio

● Documentación típica alojada en unidades en red

● Intranet colaborativas departamentales

● Documentación de colaboración e intercambio con clientes externos a nuestra empresa

● Repositorios multimedia:

– Previsualizaciones– Etiquetas– Plantillas de metadatos– Metadatos EXIF– Cliente Movil



● A que tipo de documentación hace referencia ?

● A un sistema típico de carpetas compartidas en red con mucha información no estructurada y clasificada jerárquicamente.

● Orientada a trabajar de manera continua, diaria y colaborativa con documentos.

● Sus documentos no están tipificados ni clasificados.

● No hay en general buscadores, ni manera de clasificar las carpetas.


Caso II: Repositorio de conocimiento

● Solución colaborativa de gestión de documentos de empresa, por ej. contratos, nominas...

● (todas las características del caso I)

● Tipos documentales personalizados con metadatos de negocio

● Buscadores facetados y avanzados de contenido y metadatos

● Sistema de auditado

● Reglas de contenido

● Flujos de trabajo de validación y aprobación de tareas

● Sistemas de firma digital



● Solución colaborativa de gestión de documentos de empresa, por ej. contratos, nominas...

● Biblioteca comercial: Ofertas

● Gestión administrativa: Contratos, Nominas




● Un repositorio de conocimiento almacena conocimiento explícito de la organización, es decir, una selección de la documentación que constituye conocimiento desde un punto de vista de negocio (sectorial-tecnológico-metodológico) y que tenga una perspectiva de reutilización posterior.

● La documentación almacenada suele estar relacionada en determinados procesos y actividades críticas de la organización.


Caso III: Repositorio de aplicaciones

● Repositorio de documentos de aplicaciones

● Alfresco como backend documental

● Se habla de “content centric apps”:

– Aplicación a medida como “frontend”– APIs CMIS y REST de Alfresco– Capa de servicios de negocio– Sistemas de carpetización de documentos

● Ejemplos:

– Intranet del empleado (nóminas, contratos, dietas..)– Integración de un portal empresarial




● Un repositorio de aplicaciones depende de una aplicación que almacena el conocimiento explícito del proceso.

● El usuario final sólo accederá a la documentación a través de la aplicación web.

● El consumo de recursos de la aplicación en el backend documental es a través de una capa de servicios.




Caso III: Integración de portal empresarial


Caso IV: Repositorio de archivo

● Repositorio de archivo de aplicaciones

● Es un subtipo del anterior.

● Está más integrado con el ECM, definiendo tipologías y series documentales corporativas, metadatos, períodos de conservación y de vigencia y/o procedimientos de expurgo.

● Puede exigir mayores capacidades de auditado (LOPD), formatos de almacenamiento de larga duración (PDF/A) y/o firma digital.

● Ejemplos:

– Sistemas de registro de documentación y expedientes.– Sistema de firma de actas, boletines y/o tramites

● HINT: Alfresco tiene un módulo de Record Management (con subscripción).


Diferencias entre las versiones Enterprise y Community


Alfresco CE y EE


Principales diferencias

● Fase QA y soporte de la matriz

● Consola de administración de Alfresco

● Capacidades JMX:

● Es posible gestionar en caliente numerosos parámetros del servidor de aplicaciones y del gestor documental tales como: modo read only del servidor, reiniciar subsistemas (autenticación transformación, actividades...) y ejecutar tareas programadas (sincronización).

● Capacidades híbridas de sincronización en la nube

● La consola de Activiti (workflow)

● Existe un módulo de monitorización para Nagios



● Content Store Selector

● Almacenes distribuidos según reglas de negocio (por ejemplo, mimetype o un determinado de espacio lógico en el repositorio.

● Clustering

● En las últimas versiones CE de Alfresco, no se incorpora código para clustering.

● Soporte Oracle y SQL Server

● No disponibles en Alfresco CE● JodConverter

● En vez de Libreoffice como servidor de transformación.



● Alfresco Office Services

● Escalabilidad:

● Servidor SOLR externalizado (con licencia adicional)● Servidor de transformación de documentos MS-Office

(con licencia adicional)● Conectores XAM para cabinas de disco

● Seguridad:

● Streams cifrados● Módulos de terceros

● Kofax (digitalización)


Nociones de arquitectura


Nociones de arquitectura de Alfresco

Muy importante !!!

● El cliente de Alfresco Share es una aplicación frontal de Alfresco para acceder al repositorio de Alfresco.

● Puede desplegarse en una capa o máquina diferente y se comunica con el repositorio a través de servicios REST (Webscripts) y CMIS









Muy importante !!!

● Los ficheros se guardan en el almacén (contentstore) que es un punto del sistema de ficheros local de Alfresco (normalmente una unidad escalable NFS), según una estructura de AÑO > MES > DIA > HORA > MINUTO

● Los metadatos se guardan en base de datos.

● Los índices se guardan en el almacén de indices de SOLR.


alfresco@lemmy /opt/alfresco/alf_data/contentstore $ tree.|-- 2015| |-- 10| | |-- 13| | | `-- 20| | | `-- 10| | | |-- 208dd2e5-7eea-4509-977e-00e16a5d2a9f.bin| | | |-- 2bb9dbd5-119a-480d-aee2-d03cc885d89d.bin| | | |-- 2feed801-26c3-4830-93e2-6467760aac84.bin| | | |-- 5ea39961-967c-4d3c-955c-02d043ef9d55.bin| | | `-- dadb6eae-0e46-4be9-ac7f-6586c3c1448f.bin| | `-- 14| | `-- 11| | |-- 12| | | |-- 00723d5b-71f7-412e-90fb-65c64d373b7f.bin| | | |-- 03fd4ca1-8c33-4a3f-a578-3f3ac66daadf.bin| | | |-- 0510988d-8a57-42e8-911e-be2ebf8cb63c.bin| | | |-- 08ec385d-2819-49af-98fe-44f7b80caf52.bin| | | |-- 0c89ab69-44f2-4532-a7d7-ccddf2045415.bin


HINT: Simples comandos de linux nos pueden ayudar a estimar el crecimiento y el dimensionamiento de un repositorio



Muy importante !!!● Por defecto en Alfresco, se indexa el contenido de “dentro” de

de los documentos de Office y PDF, y se extraen los metadatos comunes de los ficheros de Office e imágenes (EXIF).

● Esto puede ser interesante o no...

● Como recomendaciones de arquitectura:

● .. más de 4G la memoria heap JVM del servidor.

● .. los recursos de las maquinas virtuales sean lo más dedicados posibles, principalmente de la base de datos.

● .. los discos tengan un throughput de 200Mb/s.

● .. los discos de índices de SOLR sean los más rápidos.








Instalación de Alfresco


Instalación

[En el curso instalaremos las tres capas en la misma máquina virtual, lo cual no es lo más adecuado en un entorno productivo]


Conexión con MySQL

Si usamos una base de datos propia:

$ mysql -u root > create database alfresco511 character set utf8;> grant all on alfresco511.* to 'alfresco'@'localhost' identified by 'alfresco' with grant option;

[ !!! ] Es muy importante el character set utf8 en la creación del esquema en Mysql, o AL32UTF8 (en Oracle)


Instalación en consola....

En /opt/alfresco511:

$ sudo -i$ mkdir /opt/alfresco511$ chown -R alfresco:alfresco /opt/alfresco511

# Como usuario alfresco$ ./alfresco-one-installer-5.1.1-linux-x64.bin --mode text --prefix /opt/alfresco511

[ !!! ] Utilizamos un usuario para la instalación, nunca root


El archivo alfresco-global.properties

● Permite configurar:● Directorios para el contentstore

● La cadena de autenticación

● Las urls y contextos de Alfresco

● Configuración de la conexión con BBDD

● Conexión con programas externos

● Los subsistemas (email, búsqueda, actividades, transformación, edicion online con sharepoint....)

● Las unidades compartidas (subsistema de fileserver).

/opt/alfresco/tomcat/shared/classes/alfresco-global.properties



dir.root=/opt/alfresco/alf_data

alfresco.context=alfrescoalfresco.host=127.0.0.1alfresco.port=8080alfresco.protocol=http

share.context=shareshare.host=127.0.0.1share.port=8080share.protocol=http

### database connection properties ###db.driver=org.gjt.mm.mysql.Driverdb.username=alfrescodb.password=secretdb.name=alfresco511db.url=jdbc:mysql://localhost/alfresco511

authentication.chain=alfrescoNtlm1:alfrescoNtlm



Configurando las propiedades



db.driver=org.gjt.mm.mysql.Driverdb.name=alfrescodb.username=alfrescodb.password=alfrescodb.host=localhostdb.port=3306db.url=jdbc:mysql://${db.host}:${db.port}/${db.name}

ooo.exe=/usr/lib/openoffice/program/sofficeimg.root=/usrswf.exe=pdf2swf

[!!!] Debemos copiar el driver de mysql en la ruta /opt/alfresco/tomcat/lib antes de iniciar el servidor Tomcat


|-- alf_data| |-- contentstore| |-- contentstore.deleted| |-- keystore| `-- solr4|-- amps|-- amps_share|-- apps|-- bin|-- common|-- java| |-- bin|-- libreoffice|-- licenses|-- scripts|-- solr4| |-- alfrescoModels| |-- archive-SpacesStore| |-- lib| |-- templates| `-- workspace-SpacesStore`-- tomcat |-- bin |-- conf |-- endorsed |-- lib |-- logs |-- scripts |-- shared |-- temp |-- webapps `-- work

Estructura de directorios




El almacén principal de los contenidos.

Configuración y parametrización

Despliegue de los wars

Directorio de índices (archive)

Directorio de índices (workspace)

Logs de Tomcat




almacén de contenido borrado

Script de arranque ctl.sh

directorio de cache de modelos de contenido para SOLR

directorio de instalación de AMPS (Alfresco Module Packages)

script de apply_amps.sh


alfresco@lemmy /opt/alfresco/alf_data/contentstore $ tree.|-- 2015| |-- 10| | |-- 13| | | `-- 20| | | `-- 10| | | |-- 208dd2e5-7eea-4509-977e-00e16a5d2a9f.bin| | | |-- 2bb9dbd5-119a-480d-aee2-d03cc885d89d.bin| | | |-- 2feed801-26c3-4830-93e2-6467760aac84.bin| | | |-- 5ea39961-967c-4d3c-955c-02d043ef9d55.bin| | | `-- dadb6eae-0e46-4be9-ac7f-6586c3c1448f.bin| | `-- 14| | `-- 11| | |-- 12| | | |-- 00723d5b-71f7-412e-90fb-65c64d373b7f.bin| | | |-- 03fd4ca1-8c33-4a3f-a578-3f3ac66daadf.bin| | | |-- 0510988d-8a57-42e8-911e-be2ebf8cb63c.bin| | | |-- 08ec385d-2819-49af-98fe-44f7b80caf52.bin| | | |-- 0c89ab69-44f2-4532-a7d7-ccddf2045415.bin

Almacén de contenidos


Notas de la instalación

● Se instala un contenedor Tomcat 7 con cuatro aplicaciones

● alfresco.war, share.war, solr4.war, _vti_bin.war● Es inseguro usar el usuario root.

● Utilizar un usuario sin privilegios (p.ej. alfresco o zylk)● No se pueden utilizar puertos menores que 1024.

● Tomcat → 8080,8443,8009,8005,50500 entre otros● Necesitaremos un script de inicio


Iniciar y parar el servidor

● El servidor se inicia con:

$ sh alfresco.sh start

● El servidor se para con:

$ sh alfresco.sh stop

El script alfresco.sh se encuentra en el directorio de instalación /opt/alfresco ($ALF_HOME)

[!!!] Esto no es un script de inicio del servicio, necesitaremos uno que invoque a este


Iniciar y parar el servidor

● En el archivo setenv.sh definimos la memoria JVM

$ALF_HOME/tomcat/conf/setenv.sh

JAVA_HOME=/opt/alfresco502/javaJRE_HOME=$JAVA_HOMEJAVA_OPTS="-XX:+DisableExplicitGC -XX:+UseConcMarkSweepGC -XX:+UseParNewGC -Djava.awt.headless=true -Dalfresco.home=/opt/alfresco502 -Dcom.sun.management.jmxremote -XX:ReservedCodeCacheSize=128m $JAVA_OPTS "JAVA_OPTS="-Xms512M -Xmx2048M $JAVA_OPTS " # java-memory-settingsexport JAVA_HOMEexport JRE_HOMEexport JAVA_OPTS

[!!!] Necesitaremos >4Gb de RAM en la máquina, si no, la instalación se quejará.


Las trazas del servidor son:

● Las trazas de error de Tomcat son la primera y una esencial fuente de información:

● En el directorio logs de CATALINA_HOME

$ tail f /opt/alfresco/tomcat/logs/catalina.out


Configuración básica y logs




alfresco.context=alfrescoalfresco.host=127.0.0.1alfresco.port=8080alfresco.protocol=http

share.context=shareshare.host=127.0.0.1share.port=8080share.protocol=http

### database connection properties ###db.driver=org.gjt.mm.mysql.Driverdb.username=rootdb.password=secretdb.name=alfresco423db.url=jdbc:mysql://localhost/alfresco423

authentication.chain=alfrescoNtlm1:alfrescoNtlm


En la versión 5 de Alfresco se pueden cifrar las passwords !!


<configRoot>

● El directorio <configRoot> es el lugar donde se guardan y extienden los archivos de configuración por defecto de Alfresco.

● Para Tomcat:

● /opt/alfresco/webapps/alfresco/WEB-INF/classes

● En WEB-INF/classes/alfresco/model está el modelo de contenido por defecto de Alfresco.

● IMPORTANTE → No es recomendable modificar estos ficheros directamente sino modificarlos y extenderlos en el directorio <extension>


<configRoot>

● El directorio <configRoot> es el lugar donde se guardan y extienden los archivos de configuración por defecto de Alfresco.

● Para Tomcat:

● /opt/alfresco/webapps/alfresco/WEB-INF/classes

● En WEB-INF/classes/alfresco/model está el modelo de contenido por defecto de Alfresco.

● IMPORTANTE → No es recomendable modificar estos ficheros directamente sino modificarlos y extenderlos en el directorio <extension>


<extension>

● El directorio <extension> es donde se guardan los archivos de configuración que extienden y solapan los archivos de configuración por defecto de Alfresco.

● Cuando se instala Alfresco, hay archivos de configuración de ejemplo (.sample), que deben ser renombrados para activarse.

● En este directorio se despliegan los modelos de contenido.

● En Tomcat:

● /opt/alfresco/tomcat/shared/classes/alfresco/extension/


<web-extension>

● El directorio <web-extension> es donde se guardan los archivos de configuración que extienden y solapan los archivos de configuración por defecto de Alfresco Share.

● En Tomcat:

● /opt/alfresco/tomcat/shared/classes/alfresco/web-extension/

● En este directorio se configuran los formularios de Alfresco Share.


Logs de sistema

● Los logs del sistema, errores en los despliegues pueden visualizarse en:

● /opt/alfresco/tomcat/logs/catalina.out

● Se configuran en los archivos log4j.properties de cada aplicación → appenders a medida o para logging remoto...

● Es necesaria una herramienta de tipo tail para visualizar en tiempo real los logs correspondientes.

● Desde Windows resultan muy útiles aplicaciones como BareGrep y BareTail.

● Desde Linux multitail también puede aportar cosas.

● Existen consolas de log web como probe para estos trabajos e incluso un módulo de Alfresco (Support tools)


Debugging (repositorio)

● Para obtener el detalle de DEBUG en un componente del Alfresco podemos activar las trazas via custom-log4j.properties

● /opt/alfresco/tomcat/shared/alfresco/extension/

● Y reiniciar el servicio de Alfresco.

log4j.logger.org.alfresco.repo.security.sync=debug

log4j.logger.org.alfresco.repo.content.transform.TransformerDebug=debuglog4j.logger.org.alfresco.util.exec.RuntimeExecBootstrapBean=debuglog4j.logger.org.alfresco.util.exec.RuntimeExec=debug


Ejemplo

custom-vti.properties (Alfresco 4.x)

vti.server.port=7070vti.server.port=7070vti.server.protocol=httpvti.server.url.path.prefix=/alfrescovti.server.external.host=ehudoku.ehu.es#vti.server.external.port=${vti.server.port}vti.server.external.port=7070#vti.server.external.protocol=${vti.server.protocol}vti.server.external.protocol=https

El archivo alfresco-global.properties tendrá preferencia frente a la configuración de este y la sobreescribirá...


Tareas de mantenimiento

● Borrar el contenido del directorio contentstore.deleted (via cron)

● Borrar ficheros temporales de Tomcat (clean_tomcat.sh)

● Comprimir y/o borrar logs debajo de $TOMCAT_LOGS

http://www.fegor.com/2011/08/mantenimiento-diario-de-alfresco.html


Ficheros dependientes del entorno

● Por ejemplo: ● /etc/hosts → host

● /etc/init.d/alfresco → host

● /etc/fstab → alf_data

● alfresco-global.properties → urls, contraseña bbdd

● share-config-custom.xml → bind del repo

● ldap-authentication.properties → passwd ldap admin

● alfresco-jmxrmi.password → passwd jmx


Problemas comunes

● Problemas de gestión de la configuración:

● Muchos entornos → 4 entornos● Muchos ficheros a desplegar: texto, jars, AMPs.● Passwords en los archivos de configuración.

● Problemas de gestión de los despliegues:

● Instalación de AMPs y reinicios.● Problemas de organización de la configuración:

● Archivos comunes de configuración.● Modulos independientes.


Módulos de Alfresco


Módulos de Alfresco

● Los módulos en Alfresco se instalan:

● Mediante AMP: Para el repositorio o para Share● Mediante JAR: en $ALF_HOME/tomcat/shared/


Módulos de Alfresco (AMPs)

● Por ejemplo (AMPs):

● El protocolo de Sharepoint → opcional en la instalación

● La gestión del borrado de la papelera → Thrascan


Instalando módulos

● Los módulos (con extensión amp) se gestionan con alfresco-mmt.jar (en la version 3.x de Alfresco) y con el script apply_amps.[sh|bat] en versiones superiores.

● Para ello hay que ubicarlos en las carpetas amps y amps_share.


Los módulos de Alfresco (AMP)

● Un fichero AMP es básicamente un archivo ZIP comprimido con una estructura definida que se despliega en la estructura de Alfresco.

● Una vez instalado es necesario redesplegar el war.

|- /config |- /lib |- /licenses |- /web |- /jsp |- /css |- /images |- /scripts |- module.properties |- file-mapping.properties

|- /config |- /lib |- /licenses |- /web |- /jsp |- /css |- /images |- /scripts |- module.properties |- file-mapping.properties


Alfresco addons

Alfresco add+ons es el lugar donde encontrar extensiones, customizaciones para tu instalación de Alfresco

http://addons.alfresco.com/


Sesión práctica (I)


Sesión práctica I

Ejercicios:

* Lab1: Instalación del bundle de Alfresco con Mysql (+ prerequisitos). * Lab2: Zero day configuration guidelines * Lab3: Configuración de la capa web Apache * Lab4: Ajustar la heap del servicio * Lab5: Más alfresco-global.properties * Lab6: Detalle de logs en Alfresco * Lab7: Desactivar el servidor de SOLR4. Cuando se necesita esto ? Y Share ? * Lab8: Instalación de módulos AMP y JAR

user: alfrescopass: alfresco

user: alfrescopass: alfresco


Lab 1: Instalación del bundle de Alfresco


Sesión práctica

Ejercicio 1: Instalación de Tomcat de Alfresco con Mysql

Instalar Alfresco mediante consola en la ruta /opt/alfresco511

1. Localizar el directorio tomcat y el directorio de logs de Tomcat. 2. Localizar el archivo alfresco-global.properties 3. Copiar el driver de mysql en el directorio lib de Tomcat 4. Crear el esquema de base de datos alfresco511 en Mysql 5. Configurar el pool de base de datos en el alfresco-global.properties 6. Ejecutar el script alfresco.sh y comprobar qué base de datos se está ejecutando

en las trazas de log de Tomcat. 7. Comprobar la memoria asignada al proceso Java por defecto 8. Comprobar la versión de java y la ubicación de java 9. Conectarse a http://localhost:8080/share 10. Conectarse a http://localhost:8080/alfresco 11. Comprobar los WARN, ERROR de las trazas de Tomcat si las hubiera. 12. Deshabilitar las propiedades de los subsistemas ftp y cifs 13. Verificar los puertos abiertos mediante:

i) inspección de los archivos de configuraciónii) comandos nmap, nc, telnet o netstat


Sesión práctica

# Creacion del esquema de base de datos$ mysql -u root

> create database alfresco511 character set utf8

# Copiar el driver de mysql $ cp ~/Escritorio/Instalacion/mysql*jar /opt/alfresco511/tomcat/lib/

# Revisar los logs de Tomcat$ tail -f /opt/alfresco511/tomcat/logs/catalina.out

Ejercicio 1: Preliminares

http://docs.alfresco.com/5.1/concepts/db-config-properties.html

https://wiki.alfresco.com/wiki/Database_Configuration

HINT: Respetar el stack de Alfresco (version y driver) y revisar las configuraciones de los parámetros avanzados de base de datos


Sesión práctica

### Content Storesdir.root=/opt/alfresco511/alf_datadir.contentstore=/opt/alfresco511/alf_data/contentstoredir.contentstore.deleted=/opt/alfresco511/alf_data/contentstore.deleteddir.auditcontentstore=/opt/alfresco511/alf_data/audit.contentstore

### database connection properties ###db.driver=org.gjt.mm.mysql.Driverdb.username=rootdb.password=db.name=alfresco511db.url=jdbc:mysql://localhost/alfresco511

### cifs y ftpftp.enabled=falsecifs.enabled=false

Ejercicio 1: Editar alfresco-global.properties

P: Las passwords están visibles en estos ficheros de configuración ?


Sesión práctica

# Iniciar alfresco$ cd /opt/alfresco511$ sh alfresco.sh start

# Comprobar un puerto$ nc -v localhost 8080Connection to localhost 8080 port [tcp/http-alt] succeeded!^C

$ nmap localhostStarting Nmap 5.21 ( http://nmap.org ) at 2016-09-08 13:43 CESTNmap scan report for localhost (127.0.0.1)Host is up (0.00012s latency).Not shown: 991 closed portsPORT STATE SERVICE22/tcp open ssh53/tcp open domain80/tcp open http631/tcp open ipp3306/tcp open mysql8009/tcp open ajp138080/tcp open http-proxy8100/tcp open unknown8443/tcp open https-alt

Ejercicio 1: Iniciar y comprobar puertos


Sesión práctica

$ netstat -putan| grep 8080

tcp 0 0 0.0.0.0:8080 0.0.0.0:* ESCUCHAR 3385/java $ ps aux | grep java

alfresco 3385 18.4 40.3 5771148 1239016 pts/1 Sl 13:40 6:05 /opt/alfresco511/java/bin/java -Djava.util.logging.config.file=/opt/alfresco511/tomcat/conf/logging.properties -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager -Xms512M -Xmx2048M -XX:+DisableExplicitGC -XX:+UseConcMarkSweepGC -XX:+UseParNewGC -Djava.awt.headless=true -Dalfresco.home=/opt/alfresco511 -XX:ReservedCodeCacheSize=128m -Djava.endorsed.dirs=/opt/alfresco511/tomcat/endorsed -classpath /opt/alfresco511/tomcat/bin/bootstrap.jar:/opt/alfresco511/tomcat/bin/tomcat-juli.jar -Dcatalina.base=/opt/alfresco511/tomcat -Dcatalina.home=/opt/alfresco511/tomcat -Djava.io.tmpdir=/opt/alfresco511/tomcat/temp org.apache.catalina.startup.Bootstrap start

Ejercicio 1: Iniciar, comprobar proceso y puertos

http://docs.alfresco.com/5.0/concepts/port-number-defaults.html

http://blyx.com/2014/06/02/where-and-how-to-change-any-alfresco-related-port/

HINT: En sistemas de la familia RHEL hay que activar los puertos relevantes via iptables (por defecto estan capados)


Sesión práctica

# Iniciar alfresco$ cd /opt/alfresco511$ sh alfresco.sh start

# Comprobar un puerto local o remoto – es como llamar a la puerta de un servicio$ nc -v localhost 8080Connection to localhost 8080 port [tcp/http-alt] succeeded!^C

# Escanear los puertos de un host $ nmap localhostStarting Nmap 5.21 ( http://nmap.org ) at 2016-09-08 13:43 CESTNmap scan report for localhost (127.0.0.1)Host is up (0.00012s latency).Not shown: 991 closed portsPORT STATE SERVICE22/tcp open ssh53/tcp open domain80/tcp open http631/tcp open ipp3306/tcp open mysql8009/tcp open ajp138080/tcp open http-proxy8100/tcp open unknown8443/tcp open https-alt

Ejercicio 1: Iniciar y comprobar puertos


Lab 2: Zero day configuration guidelines


Sesión práctica

Ejercicio 2: Zero Day Configuration Guide

1. Chequear la lista de stacks soportados2. Optimizar los settings de hardware

→ Procesador de 64 bits → CPU speed > 2.5GHz 3. Validar la base de datos 4. Validar el sistema operativo 5. Validar y tunear la JVM

→ de 64 bits

http://www.alfresco.com/services/subscription/supported-platforms


Sesión práctica


1. Chequear la lista de stacks soportados para Alfresco 5.1.12. Esta nuestro entorno soportado ?

http://www.alfresco.com/services/subscription/supported-platforms


Sesión práctica


Sesión práctica


1. Validación de entornos

- Validar que el hostname del servidor se resuelve en el DNS

- Validar la latencia de la red con el resto de componentes: bbdd, frontal

- Validar que los siguientes puertos están accesibles:

FTP → 21SMTP → 25SMB / CIFS → 137 UDP, 138 UDP , 139 UDP, 445IMAP → 143Tomcat → 8005, 8080 (http), 8009 (ajp13)RMI → 50500

- Validar que el usuario que ejecuta Alfresco puede abrir más de 4096 descriptores de ficheros (File Handlers)

- Deshabilitar servicios innecesarios


Sesión práctica

$ ulimit -n1024

$ sudo vim /etc/security/limits.conf

alfresco soft nofile 8192 alfresco hard nofile 8192

$ #salgo de la terminal y vuelvo a entrar

$ ulimit -n8192

$ sudo vim /etc/pam.d/su

# Descomentar la linea session required pam_limits.so $ for pid in `pidof java`; do echo "$(< /proc/$pid/cmdline)"; egrep 'files|Limit' /proc/$pid/limits; echo "Currently open files: $(ls -1 /proc/$pid/fd | wc -l)"; echo; done

Limit Soft Limit Hard Limit Units Max open files 8192 8192 files Currently open files: 537

Ejercicio 2: Descriptores de ficheros (File Handlers)


alfresco-global.properties

### FTP Server Configuration ###ftp.enabled=falseftp.port=2121

### CIFS Server Configuration ###cifs.enabled=falsecifs.pseudoFiles.enabled=falsecifs.pseudoFiles.explorerURL.enabled=false

### Disable unneeded services ###

### Usershome.folder.creation.eager=falsesystem.usages.enabled=false

### Audit and tagging#audit.enabled=false#audit.tagging.enabled=falseaudit.sync.enabled=falseaudit.alfresco-access.enabled=falseaudit.filter.alfresco-access.default.enabled=false

### Alfresco cloud synctransferservice.receiver.enabled=falsesync.mode=OFFsyncService.mode=OFFsync.pullJob.enabled=falsesync.pushJob.enabled=false

### Subscription and activitiessubscriptions.enabled=false#activities.feed.notifier.enabled=false

Ejercicio 2: Deshabilitar servicios innecesarios


alfresco-global.properties

### BPM Engine ###system.workflow.engine.jbpm.enabled=falsesystem.workflow.engine.activiti.enabled=false

### Replication ###replication.enabled=falsereplication.transfer.readonly=false

### Thumbnails ###system.thumbnail.generate=falsesystem.quickshare.enabled=false

### E-mail site invitation setting ###notification.email.siteinvite=falseactivities.feed.notifier.enabled=false

### Disable metadata extractors ###extracter.PDFBox=falseextracter.Office.doc.enabled=falseextracter.Office.xls.enabled=false extracter.Office.ppt.enabled=falseextracter.TikaAuto.enabled=falseextracter.Poi.enabled=false

# Disable SOLR archive backupssolr.backup.archive.cronExpression=0 0 4 * * ? 2199

imap.server.enabled=falseimap.server.imap.enabled=falseimap.server.imaps.enabled=falseimap.server.attachments.extraction.enabled=falseemail.inbound.enabled=falseemail.server.enabled=false


Test EVT

http://code.google.com/p/alfresco-environment-validation/

https://artifacts.alfresco.com/nexus/content/repositories/alfresco-docs/alfresco-environment-validation/latest/index.html

Ejercicio 2: Test EVT (Alfresco 4.x)


Lab 3: Capa web con Apache


Sesión práctica

Ejercicio 3: Configuración de la capa web con Apache

1. Instalar Apache2 via repositorio (hecho)2. Configurar el módulo proxy_http y proxy_ajp 3. ¿ Cúal de los módulos es más seguro?4. Realizar la misma config con mod_jk (opcional) ¿ Cual de los dos módulos

eligirías mod_proxy o mod_jk ?5. Si tuviéramos que securizar una capa, ¿ cual sería ? Securizarla.6. ¿ Es la arquitectura planteada la más adecuada ?


Sesión práctica

$ sudo aptitude install apache2$ sudo a2enmod proxy$ sudo a2enmod proxy_http$ sudo a2enmod proxy_ajp$ sudo a2enmod ssl

$ sudo vim /etc/apache2/sites-enabled/000-default

<Proxy *> AddDefaultCharset off Order deny,allow Allow from all</Proxy>

ProxyPass /alfresco ajp://localhost:8009/alfrescoProxyPassReverse /alfresco ajp://localhost:8009/alfrescoProxyPass /share ajp://localhost:8009/shareProxyPassReverse /share ajp://localhost:8009/share

Ejercicio 3: Virtual host de apache


Sesión práctica

Ejercicios:

* Lab9: Autenticar contra subsistemas LDAP y external

* Lab10: Crear un script de inicio y un servicio de sistema en linux.

* Lab11: Configurar unidades compartidas Webdav, CIFS y FTP

* Lab12: Script de hot backup para Alfresco


Lab 4: Ajustar la heap del servicio


# Load Tomcat Native LibraryLD_LIBRARY_PATH=/opt/alfresco511/common/lib:$LD_LIBRARY_PATH

JAVA_HOME=/opt/alfresco511/javaJRE_HOME=$JAVA_HOMEJAVA_OPTS="-XX:+DisableExplicitGC -XX:+UseConcMarkSweepGC -XX:+UseParNewGC -Djava.awt.headless=true -Dalfresco.home=/opt/alfresco511 -XX:ReservedCodeCacheSize=128m $JAVA_OPTS "JAVA_OPTS="-Xms512M -Xmx2048M $JAVA_OPTS " # java-memory-settingsexport JAVA_HOMEexport JRE_HOMEexport JAVA_OPTSexport LD_LIBRARY_PATH

Sesión práctica

Ejercicio 4: Ajustar la heap del servicio

1. Localizar el archivo setenv.sh2. Que variable java es la encargada de definir los parámetros de memoria

mínimos y máximos ?


Lab 5: Más alfresco-global.properties


$ cd /opt/alfresco511/tomcat/webapps/alfresco$ grep -r repository.properties *

Coincidencia en el archivo binario WEB-INF/lib/alfresco-repository-5.1.1.jarCoincidencia en el archivo binario WEB-INF/lib/alfresco-enterprise-repository-5.1.1.jar

$ grep "^db" repository.properties

db.schema.name=db.schema.stopAfterSchemaBootstrap=false..

Sesión práctica

Ejercicio 5: Más propiedades en el alfresco-global.properties

- Cuantas propiedades pueden definirse en el alfresco-global.properties ? - Donde podemos consultar el listado completo de propiedades ? - Siempre es necesario reiniciar Alfresco para setear propiedades ?


$ cd /opt/alfresco511/tomcat/webapps/alfresco$ grep -r repository.properties *

Coincidencia en el archivo binario WEB-INF/lib/alfresco-repository-5.1.1.jarCoincidencia en el archivo binario WEB-INF/lib/alfresco-enterprise-repository-5.1.1.jar

$ grep "^db" repository.properties

db.schema.name=db.schema.stopAfterSchemaBootstrap=false..

Sesión práctica


1. El listado completo de propiedades está disponible en el archivo:repository.properties

2. Buscarlo y extraer el archivo. 3. Inspeccionarlo.

Cuantas propiedades son parametrizables a traves de este archivo ?


$ grep rootPath repository.properties

system.webdav.rootPath=${protocols.rootPath}protocols.rootPath=/${spaces.company_home.childname}opencmis.connector.default.rootPath=/${spaces.company_home.childname}imap.config.home.rootPath=/${spaces.company_home.childname}imap.config.server.mountPoints.default.rootPath=${protocols.rootPath}imap.attachments.folder.rootPath=/${spaces.company_home.childname}

Sesión práctica


4. Algunas propiedades importantes son: dir.* : directorios del contentstore

db.* : base de datos index.* : indices audit.* : auditado

5. Buscar entre las propiedades el tamaño máximo de fichero admitido 6. Buscar las raices de los protocolos de unidad compartida


$ grep max repository.properties

# The value for the maximum permitted size in bytes of all content.system.content.maximumFileSizeLimit=download.maxContentSize=2152852358

# Maximum thumbnail sizesystem.thumbnail.mimetype.maxSourceSizeKBytes.pdf=-1

# Max number of users connectedserver.maxusers=-1

# Maximum number of connections to databasedb.pool.max=275

# Maximum number of activities reportedactivities.feed.max.size=200

# The maximum number of filefolder list resultssystem.filefolderservice.defaultListMaxResults=5000

opencmis.bulkUpdateProperties.maxItemsSize=1000

Sesión práctica



$ grep rootPath repository.properties

system.webdav.rootPath=${protocols.rootPath}protocols.rootPath=/${spaces.company_home.childname}opencmis.connector.default.rootPath=/${spaces.company_home.childname}imap.config.home.rootPath=/${spaces.company_home.childname}imap.config.server.mountPoints.default.rootPath=${protocols.rootPath}imap.attachments.folder.rootPath=/${spaces.company_home.childname}

Sesión práctica


4. Algunas propiedades importantes son: dir.* : directorios del contentstore

db.* : base de datos index.* : indices audit.* : auditado

5. Buscar entre las propiedades el tamaño máximo de fichero admitido 6. Buscar las raices de los protocolos de unidad compartida


Lab 6: Detalle de logs en Alfresco


$ cd /opt/alfresco511$ mv *log* tomcat/logs

$ vim alfresco.sh

# En la linea 17 añadircd $INSTALLDIR/tomcat/logs

$ vim tomcat/scripts/ctl.sh

# comentar las lineas 27, 28 y 42

$ cd /opt/alfresco511/tomcat/shared/classes/alfresco/extension$ mkdir sample$ mv *.sample sample/

Sesión práctica

Ejercicio 6: Detalle de logs en Alfresco

1. Localizar el directorio de logs de Alfresco ¿ no aparecen en diferentes sitios ? 2. ¿ Porque hay tantos logs ? 3. Configurar el archivo custom-log4j.properties del repositorio de Alfresco,

reiniciar y trazar el detalle de una clase disponible en Alfresco en el archivo de logs. 3. ¿ De qué archivo podemos tomar una referencia ? 4. Siempre es necesario reiniciar Alfresco para aumentar el detalle de los logs ?


$ locate log4j.properties | grep alfresco511

/opt/alfresco511/tomcat/shared/classes/alfresco/extension/sample/custom-log4j.properties.sample/opt/alfresco511/tomcat/webapps/alfresco/WEB-INF/classes/log4j.properties/opt/alfresco511/tomcat/webapps/share/WEB-INF/classes/log4j.properties

$ vim /opt/alfresco511/tomcat/shared/classes/alfresco/extension/custom-log4j.properties# Webdavlog4j.logger.org.alfresco.webdav.protocol=debug#log4j.logger.org.alfresco.webdav.protocol=info

# Metadata extraction#log4j.logger.org.alfresco.repo.content.metadata.AbstractMappingMetadataExtracter=warnlog4j.logger.org.alfresco.repo.content.metadata.AbstractMappingMetadataExtracter=info

Sesión práctica

Ejercicio 6: Detalle de logs en Alfresco

1. Localizar el directorio de logs de Alfresco ¿ no aparecen en diferentes sitios ? 2. ¿ Porque hay tantos logs ? 3. Configurar el archivo custom-log4j.properties del repositorio de Alfresco,

reiniciar y trazar el detalle de una clase disponible en Alfresco en el archivo de logs. 3. ¿ De qué archivo podemos tomar una referencia ? 4. Siempre es necesario reiniciar Alfresco para aumentar el detalle de los logs ?


Lab 7: Desactivar SOLR o Share en un nodo


$ cd /opt/alfresco511/tomcat$ mkdir webapps.orig$ mv webapps/host-manager webapps.orig$ mv webapss/manager webapps.orig

$ vim conf/logging.properties

# Comentar todas las lineas relativasa 2localhost,3manager,4host-manager

Sesión práctica

Ejercicio 7: Desactivar SOLR de la instalación

0. Desactivar las webapps por defecto de Tomcat 1. Parar la instancia de Alfresco

2. Comentar el descriptor de despliegue de SOLR3. Borrar el directorio webapps/solr desplegado


$ cd /opt/alfresco

$ ./alfresco.sh stop

$ cd /opt/alfresco/tomcat/conf/Catalina/localhost/

$ mv solr4.xml solr4.xml.disabled

$ rm -rf /opt/alfresco/tomcat/webapps/solr4/

$ ./alfresco.sh start

Sesión práctica

Ejercicio 7: Desactivar SOLR de la instalación

0. Desactivar las webapps por defecto de Tomcat 1. Parar la instancia de Alfresco

2. Comentar el descriptor de despliegue de SOLR3. Borrar el directorio webapps/solr desplegado


$ cd /opt/alfresco

$ ./alfresco.sh stop

$ cd /opt/alfresco/tomcat/webapps

$ mv share.war share.war.disabled

$ rm -rf share

$ ./alfresco.sh start

Sesión práctica

Ejercicio 7: Desactivar Share de la instalación

1. Parar la instancia de Alfresco2. Borrar o mover el war y borrar el directorio desplegado (si existe)


Lab 8: Instalar módulos


Sesión práctica

Ejercicio 8: Instalación de módulos AMPS

1. Descargar los módulos AMPs: - Consola de Javascript para Alfresco Share - El módulo de Support Tools

2. Instalar los módulos aplicando el script de instalación de módulos

3. Reiniciar el servidor

4. Comprobar en las trazas del Tomcat que los módulos han sido cargados

NOTA: Teniendo en cuenta que la instalación de un módulo .amp consiste en incluirlo el archivo alfresco.war debemos asegurarnos que alfresco.war se redespliega correctamente.


Instalación de AMPS (Support Tools)

$ cd /opt/alfresco511/$ sh alfresco.sh stop$ cp ~/support_tools.amp /opt/alfresco511/amps/$ ./bin/apply_amps.sh$ sh alfresco.sh start

http://localhost:8080/alfresco/s/enterprise/admin/admin-systemsummary

Ejercicio 8: Ejemplo:

https://github.com/Alfresco/alfresco-support-tools/releases

https://github.com/share-extras/js-console/releases


Instalación de AMPS (Support Tools)

$ cd /opt/alfresco511/$ sh alfresco.sh stop$ cp ~/support_tools.amp /opt/alfresco511/amps/$ ./bin/apply_amps.sh$ sh alfresco.sh start

http://localhost:8080/alfresco/s/enterprise/admin/admin-systemsummary

Ejercicio 8: Ejemplo:

https://github.com/Alfresco/alfresco-support-tools/releases

https://github.com/share-extras/js-console/releases


https://addons.alfresco.com/addons/support-tools-admin-console

Módulos de interés: Support Tools


https://addons.alfresco.com/addons/javascript-console

Módulos de interés: Javascript Console


Sesión práctica

Ejercicio 8: Instalación de módulos via JAR

0. Chequear en el catalina.properties que shared/lib esta incluido en el classpath de java.

1. Crear un directorio lib en shared si no existe2. Copiar site-tags-dashlet-2.1-es.jar en shared/lib


Muchas gracias !!

Documents

[ Alfresco Administration ] · ALFRESCO ADMINISTRATION Dr. Ciencias Físicas UPV/EHU. 10 años de experiencia en empresa en el desarrollo de portales java open source. Experto en