[ alfresco administration ] · alfresco administration dr. ciencias físicas upv/ehu. 10 años de...
TRANSCRIPT
ALFRESCO ADMINISTRATION
[ Alfresco Administration ]
César Capillas
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 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
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
Entorno de prácticas
● VMware Player
● Máquina virtual VMware
● Usuarios:
● MV: alfresco/alfresco (usuario ubuntu sudoer)
● Mysql Server: root (sin password)
ALFRESCO ADMINISTRATION
[ M1: Instalación ]
César Capillas <cesar at zylk.net>
ALFRESCO ADMINISTRATION
Introducción
ALFRESCO ADMINISTRATION
¿ Qué es Alfresco ECM ?
Alfresco es un gestor documental empresarial open source
ECM = Enterprise Content Management
ALFRESCO ADMINISTRATION
¿ 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.
ALFRESCO ADMINISTRATION
¿ 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.
ALFRESCO ADMINISTRATION
¿ 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 ADMINISTRATION
Alfresco en el mercado ECM
ALFRESCO ADMINISTRATION
Escenario ECM/CMS Open Source
ALFRESCO ADMINISTRATION
¿ 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.
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
Características de Alfresco ECM
ALFRESCO ADMINISTRATION
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.
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
Casos de uso de Alfresco
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
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.
ALFRESCO ADMINISTRATION
Caso I: Repositorio de trabajo
● 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
ALFRESCO ADMINISTRATION
Caso I: Repositorio de trabajo
● 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.
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
Caso II: Repositorio de conocimiento
● Solución colaborativa de gestión de documentos de empresa, por ej. contratos, nominas...
● Biblioteca comercial: Ofertas
● Gestión administrativa: Contratos, Nominas
ALFRESCO ADMINISTRATION
Caso II: Repositorio de conocimiento
● A que tipo de documentación hace referencia ?
● 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.
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
Caso III: Repositorio de aplicaciones
● A que tipo de documentación hace referencia ?
● 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.
ALFRESCO ADMINISTRATION
Caso III: Repositorio de aplicaciones
ALFRESCO ADMINISTRATION
Caso III: Integración de portal empresarial
ALFRESCO ADMINISTRATION
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).
ALFRESCO ADMINISTRATION
Diferencias entre las versiones Enterprise y Community
ALFRESCO ADMINISTRATION
Alfresco CE y EE
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
Principales diferencias
● 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 ADMINISTRATION
Principales diferencias
● 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)
ALFRESCO ADMINISTRATION
Nociones de arquitectura
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
Nociones de arquitectura de Alfresco
ALFRESCO ADMINISTRATION
Nociones de arquitectura de Alfresco
ALFRESCO ADMINISTRATION
Nociones de arquitectura de Alfresco
ALFRESCO ADMINISTRATION
Nociones de arquitectura de Alfresco
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 ADMINISTRATION
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
Nociones de arquitectura de Alfresco
HINT: Simples comandos de linux nos pueden ayudar a estimar el crecimiento y el dimensionamiento de un repositorio
ALFRESCO ADMINISTRATION
Nociones de arquitectura de Alfresco
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.
ALFRESCO ADMINISTRATION
Nociones de arquitectura de Alfresco
ALFRESCO ADMINISTRATION
Nociones de arquitectura de Alfresco
ALFRESCO ADMINISTRATION
Nociones de arquitectura de Alfresco
ALFRESCO ADMINISTRATION
Instalación de Alfresco
ALFRESCO ADMINISTRATION
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]
ALFRESCO ADMINISTRATION
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)
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
/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
El archivo alfresco-global.properties
ALFRESCO ADMINISTRATION
Configurando las propiedades
/opt/alfresco/tomcat/shared/classes/alfresco-global.properties
dir.root=/opt/alfresco/alf_data
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
ALFRESCO ADMINISTRATION
|-- 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
ALFRESCO ADMINISTRATION
Estructura de directorios
|-- 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
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
ALFRESCO ADMINISTRATION
Estructura de directorios
|-- 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
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 ADMINISTRATION
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
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
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á.
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
Configuración básica y logs
ALFRESCO ADMINISTRATION
/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=rootdb.password=secretdb.name=alfresco423db.url=jdbc:mysql://localhost/alfresco423
authentication.chain=alfrescoNtlm1:alfrescoNtlm
El archivo alfresco-global.properties
En la versión 5 de Alfresco se pueden cifrar las passwords !!
ALFRESCO ADMINISTRATION
<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>
ALFRESCO ADMINISTRATION
<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>
ALFRESCO ADMINISTRATION
<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/
ALFRESCO ADMINISTRATION
<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.
ALFRESCO ADMINISTRATION
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)
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
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á...
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
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.
ALFRESCO ADMINISTRATION
Módulos de Alfresco
ALFRESCO ADMINISTRATION
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/
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
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.
ALFRESCO ADMINISTRATION
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 ADMINISTRATION
Alfresco addons
Alfresco add+ons es el lugar donde encontrar extensiones, customizaciones para tu instalación de Alfresco
http://addons.alfresco.com/
ALFRESCO ADMINISTRATION
Sesión práctica (I)
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
Lab 1: Instalación del bundle de Alfresco
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
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 ?
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
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)
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
Lab 2: Zero day configuration guidelines
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
Sesión práctica
Ejercicio 2: Zero Day Configuration Guide
1. Chequear la lista de stacks soportados para Alfresco 5.1.12. Esta nuestro entorno soportado ?
http://www.alfresco.com/services/subscription/supported-platforms
ALFRESCO ADMINISTRATION
Sesión práctica
ALFRESCO ADMINISTRATION
Sesión práctica
Ejercicio 2: Zero Day Configuration Guide
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
ALFRESCO ADMINISTRATION
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 ADMINISTRATION
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 ADMINISTRATION
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
ALFRESCO ADMINISTRATION
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)
ALFRESCO ADMINISTRATION
Lab 3: Capa web con Apache
ALFRESCO ADMINISTRATION
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 ?
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
Lab 4: Ajustar la heap del servicio
ALFRESCO ADMINISTRATION
# 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 ?
ALFRESCO ADMINISTRATION
Lab 5: Más alfresco-global.properties
ALFRESCO ADMINISTRATION
$ 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 ?
ALFRESCO ADMINISTRATION
$ 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
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 ?
ALFRESCO ADMINISTRATION
$ 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
Ejercicio 5: Más propiedades en el alfresco-global.properties
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
ALFRESCO ADMINISTRATION
$ 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
Ejercicio 5: Más propiedades en el alfresco-global.properties
ALFRESCO ADMINISTRATION
$ 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
Ejercicio 5: Más propiedades en el alfresco-global.properties
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
ALFRESCO ADMINISTRATION
Lab 6: Detalle de logs en Alfresco
ALFRESCO ADMINISTRATION
$ 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 ?
ALFRESCO ADMINISTRATION
$ 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 ?
ALFRESCO ADMINISTRATION
Lab 7: Desactivar SOLR o Share en un nodo
ALFRESCO ADMINISTRATION
$ 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
ALFRESCO ADMINISTRATION
$ 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
ALFRESCO ADMINISTRATION
$ 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)
ALFRESCO ADMINISTRATION
Lab 8: Instalar módulos
ALFRESCO ADMINISTRATION
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.
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
https://addons.alfresco.com/addons/support-tools-admin-console
Módulos de interés: Support Tools
ALFRESCO ADMINISTRATION
https://addons.alfresco.com/addons/javascript-console
Módulos de interés: Javascript Console
ALFRESCO ADMINISTRATION
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
ALFRESCO ADMINISTRATION
Muchas gracias !!