Guía Avanzada de Athento ECM

Arquitectura y tecnología

100% basado en Java

Athento ECM está 100% construido sobre JAVA, por lo que lo que necesitas para ejecutar Athento ECM es una JVM (Java Virtual Machine) en el entorno destino. 

POJO y JEE

La plataforma está diseñada para que puedas ejecutar servicios y componentes en diferentes entornos, como en Java, en un contenedor JEE (Un EAR con enlaces EJB3) o en un contenedor de Servlets.

Modelo de componentes basado en OSGI

Los componentes y servicios de la plataforma están empaquetados de forma que cada parte del software está contenida por un paquete OSGI que declara:

• Sus dependencias
• Los componentes proporcionados
• Los servicios que ofrece

Otras plataformas de código libre integradas

• Drools: para gestión de reglas
• Seam: usado por el modelo de Componentes Web en el JSF UI toolkit
• Shindig: para OpenSocial
• Jena RDF: el proveedor RDF

Vista general de la arquitectura

En una vista general de la arquitectura podremos identificar cuatro elementos principales:

• Runtime: Contiene el modelo de despliegue, servicios y componentes para hacer funcionar la plataforma. Está basado en el modelo de componentes OSGI añadiendo algunas funcionalidades extra.
• Core: El núcleo de Athento ECM contiene todos los servicios y componentes necesarios para la gestión y almacenamiento de documentos.
• Servicios: Contiene la gestión de servicios y componentes: flujos de trabajo, servicios de auditoría, servicio de comentarios, etc. Todos los servicios usan el núcleo para la gestión de los documentos, son genéricos y configurables y no dependen de la capa de interfaz de usuario (o User Interface - UI).

Cómo configurar el sistema operativo para Athento

Para la ejecución de Athento ECM es necesaria la instalación de Java 7 como servicio del sistema o en un lugar accesible por la plataforma.

Puedes descargar Java 7 JDK desde este enlace. Para poder realizar la descarga necesitas registrarte en la página de Oracle. 

Si no deseas instalar Java 7 en tu equipo, puedes descomprimirlo y referenciarlo desde el fichero de configuración de Athento ECM.

Cómo instalar y configurar la base de datos

Athento ECM usa como base de datos Postgre SQL, por lo que en los siguientes apartados se describe el proceso de instalación en diferentes sistemas operativos y la creación de un rol y una base de datos para la aplicación.

Instalación en Linux

Para instalar Postgre SQL en linux con el repositorio APT, ejecuta desde consola los siguientes comandos:

sudo apt-get update
sudo apt-get install postgresql postgresql-contrib

También puedes usar pgAdmin como interfaz gráfica de usuario para tus bases de datos de Postgre SQL. Para instalar desde el repositorio APT la aplicación pgAdmin para Linux, usa este comando:

sudo apt-get install pgadmin3

Instalación en Windows

Descarga pgAdmin para Windows e instálalo mediante el wizard de la aplicación. 

Instalación en Mac OS

Descarga pgAdmin para Mac OS e instálalo mediante el wizard de la aplicación. 

Crea un rol y una base de datos para Athento ECM

Athento ECM necesita un rol y una base de datos en Postgre SQL, que puedes crearlas desde la consola de Linux o desde la consola de pgAdmin. 

Desde la consola de Linux: 

sudo su -m postgres
psqlCREATE ROLE athentoecm WITH PASSWORD 'athentoecm' LOGIN;
CREATE DATABASE athentoecm ENCODING 'UTF8' OWNER athentoecm;
\c athentoecm

Desde la consola de pgAdmin sólo son necesarios los últimos comandos: 

CREATE ROLE athentoecm WITH PASSWORD 'athentoecm' LOGIN;
CREATE DATABASE athentoecm ENCODING 'UTF8' OWNER athentoecm;
\c athentoecm

Cómo instalar y configurar el repositorio documental

Instalación en Linux

1. Descarga la versión multiplataforma de la página de descargas de Nuxeo. 
2. Descomprime el fichero zip.
3. Ve a la carpeta raíz de Nuxeo, a la carpeta /bin y dedita el fichero nuxeo.conf, incluyendo la ruta en la que se encuentra java 7 descomprimido, en el caso de que no sea un servicio del sistema. 
4. Arranca la consola, accede a la carpeta raíz de Nuxeo, después a la carpeta /bin, y arranca Nuxeo con el comando ./nuxeoctl start
5. Accede a la url http://localhost:8080/nuxeo y sigue los pasos de configuración, añadiendo las credenciales de la base de datos PSQL.

Instalación en Windows

1. Descarga la versión ejecutable (.exe) de la página de descargas de Nuxeo.
2. Ejecuta el fichero .exe descargado.
3. Indica la ruta de instalación y sigue los pasos del wizard.

Instalación en Mac OS

1. Descarga la versión multiplataforma de la página de descargas de Nuxeo. 
2. Descomprime el fichero zip.

Arranque y parada del servidor

La aplicación puede ser arrancada y parada desde el panel de control. 

Para acceder al panel de control en Linux:

./bin/nuxeoctl gui

Para acceder al panel de control en Windows y Mac OS, ejecuta Nuxeo desde la ubicación de los programas instalados. Se abrirá el panel de control de la aplicación. 

En el panel de control hay un botón "Start" para arrancar el servidor, que cambia a "Stop" una vez arrancado para pararlo.

Desde el panel de control se pueden consultar los logs del servidor. 

Configuración inicial

Al instalar la aplicación, ésta será accesible desde http://127.0.0.1:8080/nuxeo. Accede a esta url desde un navegador de internet, como Mozilla Firefox, Google Chrome o Edge. 

Al acceder por primera vez, aparecerá la página de configuración inicial de la plataforma. Tienes que prestar especial atención a la pestaña Database Settings:

• Selecciona como base de datos Postgre SQL.
• Introduce las credenciales de acceso a tu base de datos (las creadas en el apartado anterior.

En la pestaña Module Installation selecciona los módulos que quieres incluir en tu instalación y pulsa continuar.

Upgrades

Los upgrades consisten en actualizaciones de versión de la plataforma. Puedes consultar cómo realizar un upgrade entre dos versiones en esta página. 

Además, frecuéntemente se publican Hotfix que corrigen bugs que hayan sido detectados en la plataforma. Para instalar un Hotfix, accede a la aplicación, ve al Centro de Administración (en el menú superior), después al menú Centro de Actualizaciones (a la izquierda), y finalmente a la pestaña Actualizaciones de software.

Para instalar un Hotfix es necesario realizarlo en tres pasos: 

• En la lista de actualizaciones de software, selecciona el hotfix que quieres instalar, y pulsa el botón Descargar (situado a la derecha).
• Una vez descargado, pulsa el botón Instalar (que ahora sustituye al botón Descargar, a la derecha).
• Finalmente, reinicia el servidor. Te aparecerá un botón con la letra en color rojo, sustituyendo a los anteriores de Descargar e Instalar.

Backups and recovery

Copia de seguridad de los documentos

Los documentos se encuentran en:

$NUXEO_HOME/nxserver/data

Copia de seguridad de la base de datos

Se puede hacer una copia de seguridad de las bases de datos desde consola. 

La sintaxis para realizar copias de seguridad desde consola es la siguiente: 

pg_dump -U <usuario> -W <nombre_bbdd> -f <nombre_fichero_dump.sql>

Recuperación a partir de una copia de seguridad

Para recuperar las bases de datos a partir de una copia de seguridad:

1. Crear una base de datos con el mismo nombre que tenía la original.
2. Conectar la nueva base de datos por PostgreSQL
3. Importar la nueva base de datos desde PostgreSQL mediante el siguiente comando:

\i <ruta_del_fichero_dump.sql>

También te puede interesar:

/wiki/spaces/DES/pages/30539823

/wiki/spaces/DES/pages/31129769

Usuarios y grupos

Consulta la documentación sobre gestión de usuarios y grupos.

Permisos

Consulta la documentación sobre gestión de permisos de acceso.

Gestión de Vocabularios

Consulta la documentación sobre gestión de vocabularios.

Definición de tipos documentales en el repositorio con la herramienta Studio

Consulta la documentación de Nuxeo sobre personalizaciones de la plataforma con la herramienta Studio.

Servicios Web de Athento ECM

Consulta la documentación de Nuxeo sobre los servicios web provistos por la plataforma y la REST API disponible.