SIDOFA
MANUAL DE INSTALACIN Y CONFIGURACIN EN GLASSFISH -SOLARIS
Sistema Documental de las Fuerzas Armadas
JULIO - 2013
Control de versin
VersinFechaAutorDescripcin del cambio
1.002/06/13Vernica IrigoyenManual de Instalacin y Configuracin
del Sistema Documental del las Fuerzas Armadas en Glassfish
ContenidoPROPOSITO5Creacin de Usuario Alfresco5INSTALACIN Y
CONFIGURACIN DE ALFRESCO5Parmetros de configuracin11 Iniciar el
servidor Glassfish.14Configuraciones Adicionales14INSTALACINDE
ZIMBLET EN ZIMBRA18Paso 1: Instalar el Zimlet en el servidor de
Zimbra18Paso 2: Instalar Webscripts en el Content Management de
Alfresco19Paso 3: Configurar y validar la instalacin21CONFIGURACIN
INICIAL DEL SISTEMA23Administracin de Catlogos24Administracin de
Normas de Conservacin26Administracin de Usuarios27Administracin de
Estructura Orgnica29Administracin de Cargos31
PROPOSITOEn este documento se detallan los pasos para instalar
el ambiente del Gestor Documental de las Fuerzas Armadas, se
incluyen capturas de pantalla en cada punto.Creacin de Usuario
AlfrescoSe debe crear el usuario Alfresco en la base de datos
correspondiente a la institucin, los privilegios de dicho usuario
deben ser de dueo del esquema.1. Se ingresan los datos:a. Nombre de
Usuario: Ej :alfrescob. Contrasea: Ej :alfresco
INSTALACIN Y CONFIGURACIN DE ALFRESCO
1. Copiar el instalador glassfish-3.1-unix.sh, en una ubicacin
del servidor para su ejecucin.2. Ejecutar el comando sh
glassfish-3.1-unix.sh, esto lanzara la pantalla para instalacin,
ejecutar siguiente en el wizard.
3. Seleccionar instalacin personalizada.
4. Seleccionar instalar y configurar.
5. Seleccionar directorio de instalacin.
6. Seleccionar ubicacin del JDK (JDK DEBE SER VERSION 1.6)
7. No seleccionar auto actualizaciones
8. En las siguientes pantallas se mostrara el resumen de
instalacin
9. Seleccionar la opcin crear un dominio de servidor
10. Seleccionar los nombre para el dominio = domain1,
seleccionar los puertos de administracin, http. Adems, seleccionar
el nombre y password del usuario administrador del Glassfish.
11. Resumen de instalacin
Parmetros de configuracin
1. Antes de iniciar es necesario asegurarse que el servidor
glassfish est detenido.2. Se definir con las siguientes anotaciones
de los directorios de instalacin de glassfish, alfresco y
alf_data:$GLASSFISH = /disco/glassfish3$ALF_DATA =
/zpool3/gestorDocumental/alf_data (archivos de indices solr)Se
define los puetos que fueron configurados durante la
instalacin.$SSL_PORT = 8181 (Puerto por default ssl
glassfish)$HTTP_PORT = 8080 (Puerto definido durante
instalacin)$instalacion.zip = instalador_glassfish (Directorio
adjunto a este manual, que contiene archivos de configuracin de
alfresco)$JAVA_HOME=directorio donde se encuentra instalado el JDK
3. Copiar los archivos de la carpeta $instalacion.zip/domain1/lib/*
al directorio $GLASSFISH/domain1/lib/*.
4. Modificar el archivo
$GLASSFISH/domain1/lib/classes/alfresco-global.properties, con las
siguientes
configuraciones:dir.root=$ALF_DATAsolr.port.ssl=$SSL_PORT
5. Copiar los archivos de la carpeta
$instalacion.zip/opt/alf_data* al directorio $ALF_DATA 6. Modificar
los siguientes archivos: 1. 2. 3.1. 3.2. 3.3. 3.4. 1.
$ALF_DATA/solr/archive-SpacesStore/conf/solrcore.properties, con
las siguientes
configuraciones:data.dir.root=$ALF_DATA/solralfresco.port.ssl=$SSL_PORT2.
$ALF_DATA/solr/workspace-SpacesStore/conf/solrcore.properties, con
las siguientes
configuraciones:data.dir.root=$ALF_DATA/solralfresco.port.ssl=$SSL_PORT3.
$ALF_DATA/keystore/generate_keystores.sh, con las siguientes
configuraciones:ALFRESCO_HOME= $GLASSFISH
ALFRESCO_DATA=$ALF_DATAJAVA_HOME=$JAVA_HOME4.
$ALF_DATA/keystore/generate_ssl.sh, con las siguientes
configuraciones:JAVA_HOME=$JAVA_HOME GLASSFISH_DOMAIN_DIR=
$GLASSFISH/glassfish/domains/domain1ALF_DATA=$ALF_DATA(En este
punto es necesario verificar que se pueda ejecutar el comando
openssl, en el caso de no poder ejecutarlo directamente es
necesario colocar la ubicacin absoluta del archivo openssl)
7. Iniciar Glassfish e ingresar va web al administrador
(http://localhost:4848/)
8. Ingresar a
configuraciones/server-config/JVM-Settings/JVM-Options y agregar
las siguientes configuraciones:
-Dsun.security.ssl.allowUnsafeRenegotiation=true-Duser.region=ES-Duser.language=es-Xmx2048m
-XX:MaxPermSize=512m
9. Reiniciar el servidor Glassfish10. Desplegar en el orden
especificado los siguientes .war:1)
$instalacion.zip/archivos-war/alfresco.war (previamente parchado
con el gestor.amp)2) $instalacion.zip/archivos-war/solr.war
Configuracin Glassfish Autentificacin Kerberos1.- Modificar el
archivo $GLASSFISH/domain1/lib/classes/alfresco-global.properties,
agregando la siguiente configuracin (si existe eliminar la
configuracin ldap): authentication.chain=kerberos-navy:Kerberos2.
Aadir al archivo $GLASSFISH/domain1/config/domain.xml :(Colocar los
datos de username, password, ipserver, puerto-server, SID;
correspondientes a la configuracin de conexin de bdd ) 3. Aadir al
archivo $GLASSFISH/domain1/config/login.conf :
alfrescoPoolRealm
{ec.adv.alfresco.security.AlfrescoJDBCArmyLoginModule required
dataSourceName="jdbc/armysec";};4. Copiar la librera
$instalacion.zip/kerberos-lib/alfresco-glassfish-jdbc-realm-1.0.jar
a $GLASSFISH/glassfish/modules:5. Iniciar el servidor
Glassfish.
Configuraciones Adicionales
1. En la ruta:
/opt/alfresco-glassfish3/glassfish/domains/domain1/lib/clases se
encuentra el archivo: alfresco-global.properties, donde se debe
contar con la siguiente configuracin de base de datos:###
Propiedades de conexin de base de datos##### Actualizacin de
esquema de BD solo debe colocarse en true en la instalacin##
db.schema.update=true ## Driver para conexin con Oracle##
db.driver=oracle.jdbc.OracleDriver## Usuario de la base de datos##
db.username=alfresco## Contrasea de la base de datos##
db.password=alfresco## Nombre de la base de datos##
db.name=alfresco
db.port=1521db.url=jdbc:oracle:thin:@localhost:1521:XEhibernate.dialect=org.alfresco.repo.domain.hibernate.dialect.AlfrescoOracle9Dialecthibernate.default_schema=alfrescoLa
propiedad db.schema.update debe estar en true la primera vez que se
levanta el ambiente; es muy importante que a partir de la segunda
vez esta propiedad est en false.
2. Adicionalmente se deben aadir las siguientes propiedades para
el gestor en el mismo archivo:### Motor de flujos del gestor
documental###system.workflow.engine.jbpm.enabled=true### Cadena de
autenticacin servidor
LDAP###authentication.chain=ldap-comaco:ldap
Configuraciones del servidor de email## Direccin del servidor de
email##mail.host=ac-techsolutions.com## Protocolo de envo de
email##mail.protocol=smtp## Puerto para envo de
email##mail.port=25## Direccin de correo desde la que se
enva##[email protected]## Codificacin para envo
de email##mail.encoding=UTF-8## Parmetro que indica autenticacin de
email##mail.smtp.auth=false## Tiempo en segundos para
timeout##mail.smtp.timeout=30000## Parmetro debug para
errores##mail.smtp.debug=true## Envo de mail al iniciar
servidor##mail.testmessage.send=true## Direccin a la que se enva el
email al iniciar servidor
##[email protected]## Ttulo del email que se
enva al iniciar servidor ##mail.testmessage.subject=Notificacion de
Gestor Documental## Mensaje del email que se enva al iniciar
servidor ##mail.testmessage.text=El servidor de aplicaciones del
Gestor Documental Fui Iniciado Correctamente......Configuraciones
de auditora## Auditora deAlfresco
servidor##audit.enabled=trueaudit.tagging.enabled=trueaudit.repository.enabled=trueaudit.cmischangelog.enabled=trueaudit.alfresco-access.enabled=trueaudit.alfresco-access.sub-actions.enabled=trueaudit.alfresco-access.sub-events.enabled=trueaudit.useNewConfig=false
### FILTROS
###audit.filter.alfresco-access.transaction.type=$transaction.content.typestransaction.content.types=$general.content.typesgeneral.content.types=cm:folder;cm:content;na:doc;na:memorandum;na:internalDocument;na:externalDocument;na:radiogram;na:docAttachment;na:conservationStandard;na:desclassificationStandard;na:classSpace;na:recordSpace;na:volumeSpace;na:navyUser#
Setting this flag to true will force startup failure when invalid
audit configurations are
detectedaudit.config.strict=falseConfiguraciones de institucin##
Parmetro que indica a que institucin pertenece la instalacin####
Fuerza Area= FA## Fuerza Terrestre= FT## Comando Conjunto= CCFFAA
system.type=FA 3. En la ruta: ..\glassfish\domain\domain1\ \lib se
deben agregar las libreras proporcionadas:a. db2jcc.jarb.
ojdbc14.jarc. postgresql-9.0-801.jdbc4.jard. sqlj.zip
INSTALACIN DE ZIMBLET DE ZIMBRA
Paso 1: Instalar el Zimlet en el servidor de Zimbra
1) Loguearse a la consola de Administracin de Zimbra (ej:
https://su.servidor.zimbra:7071/))
2) Ubicar la seccin Zimlets en la barra de navegacin izquierda.
Emplear el boton Deploy para subir el archivo zip del zimlet que se
proporciona con los archivos de
instalacin(org_alfresco_zimbra.zip)
Luego de la instalacin,es necesario reiniciar el servidor de
Zimbra empleando el comando: /opt/zimbra/bin/zmmailboxdctl restart
).Paso 2: Instalar Webscripts en el Content Management de
Alfresco
1) Ubicar el archive alfzimlet_webscripts.zip que se proporciona
con los archivos de instalacin.
2) Abrir el browser para ingresar al cliente web de Alfresco y
loguearse como administrador.
3) Ir a la direccin Espacio institucional Data Dictionary ->
Web Scripts Extensions.
4) Hacer click en ms Acciones y luego en la opcin Importar.
Seleccionar el archivo proporcionado y seleccionar subir.
Paso 3: Configurar y validar la instalacin
Una vez que los dos componentes se encuentran instalados1)
Loguearse con el usuario administrador del zimbra y correr el
siguiente comando:zmprov mc default zimbraProxyAllowedDomains
*(COMPROBAR COMANDO)
2) Ingresar con el cliente de Zimbra e ingresar al link de
Zimlets que se muestra en el panel de navegacin de la
izquierda.
3) Hacer click derecho en el Zimlet de Alfresco y seleccionar
Preferencias, colocar la ubicacin del servidor de Alfresco,
indicando la ip y el puerto al igual que el usuario y contrasea del
servidor de Alfresco.
Hacer click en el botn OK.
4) Hacer click derecho en el zimlet de Alfresco y seleccionar la
opcin Acerca de Si se muestra una ventana emergente con los
detalles del servidor de Alfresco la instalacin ha sido
exitosa.
CONFIGURACIN INICIAL DEL SISTEMA
Una vez instalado el sistema de debe realizar la configuracin
inicial para que el Sistema Documental pueda trabajar, esta
configuracin la debe realizar el usuario administrador designado.1.
Se accede a la aplicacin con las credenciales.
2. Se ingresa a la consola de administracin
Administracin de Catlogos
En esta pantalla se ingresan o actualizan catlogos que necesita
el Sistema para poder operar.1. Se selecciona Administrar
Catlogos.
2. En este formulario se pueden consultar los catlogos
creados.3. Se selecciona Nuevo.
4. Se ingresa los datos del catlogo y se selecciona Aceptar.
5. El nuevo catlogo se crear con xito.
Administracin de Normas de Conservacin
En esta pantalla se debe ingresar las Normas de Conservacin, se
debe realizar el proceso siguiente para las 5 normas (Secretsimo,
Secreto, Reservado, Confidencial y Ordinario)1. Se selecciona
Administracin de Normas de Conservacin.
2. Se selecciona Nuevo y el sistema presenta un formulario para
ingresar los datos de creacin de normas de conservacin.(PREGUNTAR
QUE DEBE ESTAR CHEKEADO)
3. Se selecciona Aceptar y la nueva norma se crear
correctamente. Se puede consultar las normas creadas.
Administracin de Usuarios
En esta pantalla se debe actualizar la informacin de los
usuarios, no olvidar que antes de realizar este proceso se debi
haber corrido el script de actualizacin de usuarios especficamente
los archivos usuarios_comaco.sql o usuarios_fae.sql o
usuarios_terrestre.sql dependiendo de la Fuerza.
1. Se selecciona Administracin de Usuarios.
2. Se ingresa el nombre de usuario del cual se requiere
completar los datos.
3. Se selecciona Actualizar y el sistema presenta un formulario
donde se ingresan los datos de dicho usuario.
4. Se selecciona Aceptar y los datos habrn sido completados
correctamente.
Administracin de Estructura Orgnica
En esta pantalla se va a generar los espacios, no olvidar que
antes de realizar este proceso se debi haber corrido el script de
ingreso de estructura orgnica especficamente los archivos
organico_comaco.sql o organico_fae.sql o organico_terrestre.sql
dependiendo de la Fuerza.
1. Se selecciona Administrar Estructura Orgnica.
2. Se selecciona el botn Generar Estructura Presente Ao.
3. Este proceso puede tardar algunos momentos, al finalizar el
sistema presentar un mensaje de confirmacin.
Administracin de Cargos
Y por ltimo en esta pantalla se debe asignar los cargos a los
usuarios y colocarles dentro de alguna dependencia. 1. Se
selecciona Administrar Cargos.
2. Se selecciona Nuevo y el sistema desplegar un formulario
donde se asigna un cargo al usuario seleccionado.
3. Se ingresa el nombre de usuario y se selecciona
Consultar.
4. Se presentarn los resultados y se debe escoger el usuario
requerido, el cual se cargar para ser asignado a un cargo.
5. Se ingresan los datos del cargo que se necesita asignar al
usuario y se selecciona Aceptar.
3Manual de Instalacin y Configuracin en Glassfish - Solaris
