You are on page 1of 81

Servicio de Gestin de Aplicaciones

Documento de Explotacin

INSTALACIN Y MIGRACIN - DESARROLLO


TLMAD00000195
N Ticket
Prioridad (U/A/M/B)
Descripcin Corta
(mx. 40 caracteres)

Descripcin Larga

Fecha de Creacin

01/06/2016

Tarea interna

XXXX

DDE de la plataforma Documentum 7.2


Migracin del gestor documental Documentum 6.5 SP2 a Documentum 7.2. Documento
de explotacin para el mantenimiento de la Plataforma de Gestin Documental basada
en Documentum 7.2 de Telemadrid

Documentum
Plataforma

LISTA DE DISTRIBUCIN
Usuario
Iniciales
Ana Isabel Ferrero
Lpez
Mara Rosario
Carrera Garcia
Alberto Martin
Burguillo Peragon
Andrs Izquierdo
Segarra
Beatriz Lpez
Herraiz
Antonio Burdallo
Berrocal
Jose Antonio
Rueda

PETICIONARIOS
Usuario
Iniciales

Fecha de Impresin: 12/07/2016

rea

Telfono

e-mail

ana.ferrero@telemadrid.es
maria.carrera@telemadrid.es
alberto.burguillo@telemadrid.es
andres.izquierdo@atos.net
beatriz.lopezh@atos.net
antonio.burdallo@atos.net
jose.rueda@atos.net

rea

Telfono

Ref.: 327481269.doc

e-mail

Pg.: 1 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin

VERSIN

REGISTRO DE CAMBIOS

DESCRIPCIN DEL CAMBIO

V1_0 Versin inicial

AUTOR
FECHA

REVISADO POR
FECHA

APROBADO
POR
FECHA

Beatriz Lpez Herraiz


Antonio Burdallo
Jose Antonio Rueda
01/06/2016

Modificacin de la arquitectura por introduccin de


V1_1 un balanceador NLB en vez de un balanceador
fsico para el servidor de aplicaciones

V1_2

Definicin de las listas de distribucin para Alertas,


Contratos Firmados y publicaciones de Multimedia

Beatriz Lpez Herraiz


Antonio Burdallo
Jose Antonio Rueda
23/06/2016
Beatriz Lpez Herraiz
Antonio Burdallo
Jose Antonio Rueda
29/06/2016

Informacin de las cuentas de correo (13.4)


Modo de modificacin de la ACL de facturas para
poder dar permisos de borrado (10.11)
V1_3
Acceso a la consola xPlore (12.2)
Recuperacin BPS por fallo (15.6)
Bsqueda por metadatos (16)

Fecha de creacin: 13/07/2016

Beatriz Lpez Herraiz


Antonio Burdallo
Jose Antonio Rueda
12/06/2016

Ref.: 327481269.doc

Pg.: 2 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
NDICE
1. INTRODUCCIN.......................................................................................................................................................
1.1.
1.2.
1.3.
1.4.
1.5.

PROPSITO DEL DOCUMENTO...........................................................................................................................


ALCANCE.........................................................................................................................................................
DOCUMENTACIN DE REFERENCIA....................................................................................................................
GLOSARIO DE TRMINOS..................................................................................................................................
ESTRUCTURA DEL DOCUMENTO........................................................................................................................

2. LICENCIAS ADQUIRIDAS POR TELEMADRID.......................................................................................................


2.1.

DESCRIPCIN DE LOS MDULOS ADQUIRIDOS POR TELEMADRID..........................................................................

3. DESCRIPCIN DE ENTORNO................................................................................................................................
3.1.

HARDWARE Y SOFTWARE DE ENTORNO DE PRODUCCIN.................................................................................


3.1.1.
3.1.2.
3.1.3.
3.1.1.
3.1.2.

Content Server............................................................................................................................................
xPlore..........................................................................................................................................................
Servidor de aplicaciones..............................................................................................................................
Base de datos..............................................................................................................................................
Productos de XCP.......................................................................................................................................

4. CONFIGURACIN DEL REPOSITORIO.................................................................................................................


4.1.
4.2.

DATOS BSICOS ENTORNO DE PRODUCCIN....................................................................................................


CONFIGURACIN CONTENT SERVERS PARA ACCESO A REPOSITORIO................................................................

5. INSTALACIN DE PERSONALIZACIONES EN EL REPOSITORIO......................................................................


5.1.
5.2.
5.3.
5.4.

BASE DE DATOS.............................................................................................................................................
CONTENT SERVER..........................................................................................................................................
SERVICIOS DOCUMENTUM XPLORE..................................................................................................................
CLIENTES DOCUMENTUM................................................................................................................................

6. ARQUITECTURA TELEMADRID............................................................................................................................
7. MONITORIZACIN DE PROCESOS.......................................................................................................................
7.1.
7.2.
7.3.
7.4.
7.5.
7.6.
7.7.
7.8.

CONTENT SERVER..........................................................................................................................................
XPLORE.........................................................................................................................................................
BUSINESS PROCESS INTEGRATOR...................................................................................................................
DOCUMENTUM ADMINISTRATOR.......................................................................................................................
DIAPOSITIVAS.................................................................................................................................................
FACTURAS.....................................................................................................................................................
TASKSPACE (ASESORA JURDICA)...................................................................................................................
TELEMADRID CONTRATACIN..........................................................................................................................

8. PROCEDIMIENTOS DE ARRANQUE Y PARADA..................................................................................................


8.1.
8.2.

ORDEN DE ARRANQUE....................................................................................................................................
ORDEN DE PARADA........................................................................................................................................

9. GESTIN DE LOGS................................................................................................................................................
10. TAREAS DE MANTENIMIENTO..............................................................................................................................
10.1.
10.2.
10.3.
10.4.
10.5.
10.6.
10.7.
10.8.
10.9.

ESTADO DE LOS SERVIDORES.........................................................................................................................


REVISAR LOS FICHEROS DE LOGS....................................................................................................................
REVISAR LOS JOBS DE MANTENIMIENTO..........................................................................................................
BACKUP EN FRO DE LA DOCBASE...................................................................................................................
CAMBIAR LA CONTRASEA DEL USUARIO DE CONEXIN A SQL.........................................................................
REINDEXAR UNA DOCBASE.............................................................................................................................
REPUBLICAR EL DICCIONARIO DE DATOS..........................................................................................................
CLONADO DE DOCBASE..................................................................................................................................
CONFIGURACIN LDAP..................................................................................................................................

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 3 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
10.10. ALTA DE NUEVOS USUARIOS............................................................................................................................
10.11. GESTIONAR PERMISOS DE ACCESO DE DOCUMENTOS DE TIPO FACTURA............................................................
11. CONFIGURACIN DE SQL EN EL SERVIDOR DE BBDD PARA CONTENT SERVER........................................
12. SERVIDORES DE APLICACIONES TOMCAT........................................................................................................
12.1.
12.2.
12.3.

CONFIGURACIN DE TOMCAT..........................................................................................................................
ACCESO Y CONFIGURACIN DE XPLORE (INDEXAGENT Y DSEARCH)................................................................
CONFIGURACIN COMN DE APLICACIONES.....................................................................................................

13. CONFIGURACIN DE LOS BUZONES DE CORREO...........................................................................................


13.1.
13.2.
13.3.
13.4.

CLIENTES DOCUMENTUM................................................................................................................................
BUZN DE ASESORA JURDICA........................................................................................................................
GRUPOS, ROLES Y LISTAS DE DISTRIBUCIN DE APLICACIONES.......................................................................
DESCRIPCIN DE LOS REMITENTES Y RECEPTORES DE CORREOS DENTRO DE LA APLICACIN.............................

14. MODELO DE TABLAS EXTERNAS........................................................................................................................


15. FALLOS Y CONTINGENCIAS.................................................................................................................................
15.1.
15.2.
15.3.
15.4.
15.5.

LOGIN FALLIDO..............................................................................................................................................
DOCBASE BLOQUEADA POR FALLO DE CONEXIN A BBDD..............................................................................
ESTADO INCONSISTENTE DEL CONTENT SERVER POR CADA/BAJADA DEL SERVICIO DE BB.DD...........................
ALMACENAMIENTO DE CORREOS ERRNEOS....................................................................................................
CAIDA DEL SERVICIO DE INDEXADO DE XPLORE QUE INHABILITA LAS BSQUEDAS POR METADATO Y
CONTENIDO................................................................................................................................................................
15.6. RECUPERACIN DE BPS EN CASO DE BLOQUEO DEL SERVICIO EN LOS DOS NODOS............................
16. EJECUCIN DE BSQUEDAS EN DOCUMENTUM XPLORE..............................................................................
16.1.

BSQUEDAS POR METADATOS ESPECFICOS DE APLICACIONES.........................................................................


16.1.1.
16.1.2.
16.1.3.

Fecha de creacin: 13/07/2016

Aplicacin de ASESORA JURDICA...........................................................................................................


Aplicacin de FACTURAS...........................................................................................................................
Aplicacin de DIAPOSITIVAS......................................................................................................................

Ref.: 327481269.doc

Pg.: 4 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin

1.

INTRODUCCIN
Este documento tiene por objetivo mostrar una descripcin detallada del entorno de
Produccin del Gestor Documental basado en Documentum, as como las tareas necesarias
para la correcta gestin y mantenimiento del sistema, una vez haya finalizado el proceso de
migracin del entorno productivo de la versin 6.5 SP2 a la nueva versin, 7.2.

1.1.

PROPSITO DEL DOCUMENTO


Como se ha comentado previamente, este documento recoger de forma detallada, la
infraestructura de la plataforma documental que alberga las aplicaciones del Gestor
Documental que Telemadrid est explotando actualmente en sus sistemas.
Adems, se detallarn las tareas de mantenimiento y correcciones necesarias de llevar a cabo
por usuarios administradores para el buen funcionamiento de los entornos.

1.2.

ALCANCE
Este documento est detallado para la explotacin y mantenimiento del entorno de
Produccin, pero las tareas de mantenimiento pueden ser extrapoladas a los entornos de
Integracin y Desarrollo.
El documento incluir tambin un apartado en el que se definirn las diferentes cuentas de
acceso a los sistemas, as como los buzones de correo electrnico usados en cada entorno y
que facilitarn las pruebas y posteriores evolutivos.
Adicionalmente, se aadir un apartado donde se explicarn el modo de definicin de los
parmetros de bsqueda que requiere Documentum xPlore a diferencia de las que requera su
predecesor Fast Index Server.
A modo de resumen y una vez finalizado el proceso de migracin, la explotacin de la
plataforma abarca los tres entornos creados con Documentum 7.2 y con el despliegue de las
aplicaciones personalizadas del gestor documental:

1.3.

Desarrollo: nuevo entorno que configurado desde cero para estar totalmente nivelado
en cuanto a productos y personalizaciones de Telemadrid.
Integracin: nuevo entorno configurado del mismo modo que Produccin para ofrecer
un entorno lo ms similar posible y que sirva de base para la deteccin y correccin
de errores surgidos en el entorno productivo.
Produccin: nuevo entorno que albergar el entorno productivo de Documentum en
la nueva versin en Alta Disponibilidad.

DOCUMENTACIN DE REFERENCIA
Descripcin

Archivo

Documento de Arquitectura y Plan de TM_2016_ARQ_DCTM_Migracion_DCTM_v1_6.doc


Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 5 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
Migracin
Gua de instalacin de Desarrollo
Gua de instalacin de Integracin
Documentum de Explotacin versin
DCTM 6.5 SP2
Procedimentos de arranque y parada
de plataforma Gestin Documental
Documentum 7.2
Documento de ayuda para la
monitorizacin de plataforma Gestin
Documental Documentum 7.2

1.4.

DDE_1.2.doc
TM_2016_Start&Stop_DCTM_Migracion_v1.0
TM_2016_MON_DCTM_Migracion_v1.0

GLOSARIO DE TRMINOS
Trmino

1.5.

TM_2016_INS_DCTM_Migracion_DES_v1_3.zip
TM_2016_INS_DCTM_Migracion_INT_v1_1.zip

Descripcin

ESTRUCTURA DEL DOCUMENTO


El contenido de este documento est estructurado en los captulos siguientes:
Introduccin, el presente apartado.
Licencias adquiridas por Telemadrid (Apartado Error: Reference source not found,
Pg.9)
Descripcin de entorno (Apartado 3, Pg.12)
Configuracin del repositorio (Apartado 4, Pg.15)
Instalacin de personalizaciones en el repositorio (Apartado 5, Pg.17)
Arquitectura Telemadrid (Apartado 6, Pg.21)
Monitorizacin de procesos (Apartado 7, Pg.24)
Procedimientos de arranque y parada (Apartado 8, Pg.33)
Gestin de logs (Apartado 9, Pg.36)
Tareas de mantenimiento (Apartado 10, Pg.38)
Configuracin de SQL en el servidor de BBDD para Content Server (Apartado 11,
Pg.56)

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 6 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
Servidores de aplicaciones Tomcat (Apartado 12, Pg.61)
Configuracin de los buzones de correo (Apartado 13, Pg.66)
Modelo de tablas externas (Apartado 14, Pg.70)
Fallos y contingencias (Apartado 15, Pg.75)
Ejecucin de bsquedas en Documentum xPlore (Apartado 16, Pg. 83)

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 7 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
2.

LICENCIAS ADQUIRIDAS POR TELEMADRID


Como punto de partida, con el objetivo de ampliar el enfoque tecnolgico que aportan los
productos de gestin documental que ha adquirido Telemadrid y con la idea de ayudar a
determinar la perspectiva tecnolgica de cada uno de estos productos dentro del diseo de
arquitectura corporativa de Telemadrid plasmada en este documento y versiones posteriores
se describe en este apartado los componentes de la suite Documentum adquirida por
Telemadrid.
Listado de Productos
Process Engine
Process Integrator
Document Image Services
Retention Policy Services
Content Server
TaskSpace
Process Builder
Forms Builder
Developer Studio
Documentum Administrator
Documentum Webtop
Documentum xPlore
Documentum Reporting Services (DRS)

2.1.

DESCRIPCIN DE LOS MDULOS ADQUIRIDOS POR TELEMADRID

Producto
Documentum Content Server 7.2
(incluye la activacin de High Volume
Server)
Documentum Process Engine 2.2
Documentum Process Integrator 2.2

Fecha de creacin: 13/07/2016

Descripcin
Content Server: Gobierna el repositorio de contenidos de
Documentum y proporciona un espectro amplio de servicios
de gestin de contenidos para el control tanto de los
contenidos como de los procesos. Permite el almacenar,
gestionar, y disponer de todo tipo de contenido.
Process Engine: Proporciona funcionalidad para ejecutar los
procesos de negocios automatizados a travs de flujos de
trabajo
Process Integrator: Proporciona a las aplicaciones de
Documentum, especialmente a travs de los flujos de
trabajo, el intercambio de informacin mediante la integracin
Ref.: 327481269.doc

Pg.: 8 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin

Documentum Administrator (DA) 7.2

Documentum Taskspace 6.7 SP2


Collaborative Services 6.7 SP2
Document Image Service 6.7 SP2

con sistemas externos (servidores de correo, FTP, servicios


Web, etc.)
DA: Permite a los administradores monitorizar, administrar,
configurar, y mantener los repositorios de Documentum
(docbases) y sus servidores, as como tambin crear y
mantener ACLs y grupos. Al permitir la administracin desde
cualquier sistema dotado de un navegador Web, esta
herramienta simplifica enormemente la administracin de
Documentum Content Server.
Taskspace: Proporciona a los usuarios una interfaz
optimizada para la gestin y procesamiento de tareas a
travs de los flujos de trabajo.
Collaborative Services: Proporciona mejoras para dar
soporte a procesos colaborativos para los servicios de
gestin de contenidos.

Document Image Service : Proporciona funcionalidad para


la visualizacin de documentos
Documentum Reporting Services 6.7 DRS: Solucin para la generacin de informes sobre objetos
SP2
documentales de Documentum que permiten extraer
metadatos a travs de un JDBC
Documentum xPlore 1.4
xPlore: Nuevo servidor de indexacin del entorno de gestin
documental de Documentum.
Retention Policy Services 6.8
RPS: Proporciona polticas para gestionar la retencin del
contenido publicado en el gestor documental para cumplir las
imposiciones legales o de negocio.
Documentum Webtop 6.8.1
Webtop: Aplicacin web construida sobre WDK que sirve de
base para las aplicaciones web cliente de EMC2
Documentum. Estas aplicaciones puedes ser personalizadas
usando WDK.

Developer Studio :
Documentum Composer 7.2
Documentum Process Builder 6.7 SP2
Documentum Forms Builder 6.7 SP2

Fecha de creacin: 13/07/2016

WDK: Proporciona una herramienta de desarrollo basados


en estndares que facilitan la construccin de aplicaciones
web que se conectan a EMC2 Documentum Content Server
a travs de la API DFC.
Composer: Proporciona una plataforma unificada de
desarrollo, basada en el entorno Eclipse, para construir,
configurar y deplegar aplicaciones EMC2 Documentum.
Process Builder: Aplicacin cliente que permite la creacin
de plantillas de flujos de trabajo.
Forms Builder: Aplicacin cliente que permite la creacin de
plantillas de formularios que posteriormente sern usados en
tareas de flujos de trabajo o componentes de las
aplicaciones Web.

Ref.: 327481269.doc

Pg.: 9 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
3.

DESCRIPCIN DE ENTORNO
En este apartado se expone la relacin entre los servidores, requerimientos de software y
productos de la suite de Documentum instalados en la plataforma de Telemadrid en el entorno
de Produccin.

3.1.

HARDWARE Y SOFTWARE DE ENTORNO DE PRODUCCIN


La configuracin hardware y software de las mquinas utilizadas en el entorno de Produccin
est formado por mquinas virtuales que permiten ampliar, en un futuro si es necesario, los
recursos asignados inicialmente.
El dimensionamiento y configuracin de software estn basados en las recomendaciones y
requerimientos especificados por EMC2 en la gua de requisitos de entorno y sistemas.
El nuevo entorno de Produccin se configurar en Alta Disponibilidad para ofrecer una
disponibilidad total a los usuarios de la plataforma.
El sistema operativo elegido para cada mquina de todos los entornos includo Produccin es:

3.1.1.

Windows Server 2012 R2 x64 Edition

CONTENT SERVER

Datos globales

Virtualizacin

Base de Datos
Documentum

Observaciones

Hostname #1
Hostname #2
IP del servidor #1
IP del servidor #2
Usuario de instalacin/contrasea
Sistema Operativo
Tamao de unidades de disco duro
RAM
CPU
Arquitectura
Cliente de SQL Server 2008 R2
Content Server
Java Method Server
Process Engine
Docbroker
Puerto
G: es una unidad externa mapeada.

TORRE
ELGURUGU
10.100.8.205
10.100.8.206
Gestordocu/Documentum10
Windows 2012 Server R2
C: 80G G: 30GB F:100GB
8GB
2 ncleos, 2,4 GHz
64 bits
10.50.1600.1
2.2.0090.3015 P11
JBoss 7.1.1
7.2.0090.0239 P09
7.5.2.0.54
1489

F: es un recurso de disco en clster accesible por la mquina que tenga el recurso


Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 10 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
Datos globales

Hostname #1
TORRE
habilitado: DCTMCS\DISCOF (10.100.8.208)
2 mquinas configuradas para Alta Disponibilidad mediante la configuracin
proporcionada por EMC2 Documentum.

3.1.2. XPLORE
Datos globales

Virtualizacin

Documentum
Requerimientos

Observaciones

Hostname #1
Hostname #2
IP del servidor #1
IP del servidor #2
Usuario de instalacin/contrasea
Sistema Operativo
Tamao de unidades de disco duro
RAM
CPU
Arquitectura
Xplore
Deshabilitar el escaneo del antivirus en
la unidad F
Deshabilitar
las
actualizaciones
automticas de Windows
G: es una unidad externa mapeada.

LOSANTOS
BAZTAN
10.100.8.211
10.100.8.212
Gestordocu/Documentum10
Windows 2012 Server R2
C: 80G G: 30GB F:112GB
8GB
2 ncleos, 2,4 GHz
64 bits
1.4.0.216
OK
OK

F: es un recurso de disco en clster accesible por la mquina que tenga el recurso


habilitado: DCTMIS\DISCOF (10.100.8.214)
2 mquinas configuradas para Alta Disponibilidad
3.1.3.

SERVIDOR DE APLICACIONES

Datos globales

Virtualizacin

Documentum
Requerimiento
software
Observaciones

Hostname #1
Hostname #2
IP del servidor #1
IP del servidor #2
Usuario de instalacin/contrasea
Sistema Operativo
Tamao de unidades de disco duro
RAM
CPU
Arquitectura
Bussines Process Integrator
Documentum Administrator
de Tomcat
Java 7 Update 80
F: es una unidad externa mapeada.

LOSANTOS
BAZTAN
10.100.8.211
10.100.8.212
Gestordocu/Documentum10
Windows 2012 Server R2
C: 80G G: 30
8GB
2 ncleos, 2,4 GHz
64 bits
2.2.0090.3015 P11
7.2.0.0081
7.0.53
7.0.800

2 mquinas configuradas para Alta Disponibilidad mediante un balanceador


Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 11 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
Datos globales

3.1.1.

Hostname #1
fsico

LOSANTOS

BASE DE DATOS

SERVIDOR
EMC2 certifica varias versiones de SQL Server para la versin de Documentum 7.2. Para esta
migracin y por requerimientos de licencias por parte de Telemadrid, la versin elegida y
compatible con las directrices de EMC2 es:
o

SQL Server 2008 R2 SP2 x64

CLIENTE
Las mquinas donde se instala el Content Server, necesitan tambin la instalacin del Cliente
SQLServer para poder realizar las conexiones con la base de datos.
o

3.1.2.

Cliente SQLServer x64 + SQL Server Management Studio

PRODUCTOS DE XCP

Este apartado detalla los productos de xCP que formarn parte de la nueva plataforma
Documentum 7.2 en el entorno de Produccin.
Aplicacin y Contexto
Documentum Process Builder 6.7 SP2 Parche 25

Servidor(es)
TORRE

Documentum Forms Builder 6.7 SP2 Parche 25

ELGURUGU

Collaborative Services 6.7 SP2 Parche 25


Document Image Service 6.7 SP2
DARs Taskspace 6.7 SP2 Parche 25
Aplicacin Asesora Jurdica (Taskspace 6.7 SP2 VALVERDE y PEZUELA
Parche 25)

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 12 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
4.

CONFIGURACIN DEL REPOSITORIO

4.1.

DATOS BSICOS ENTORNO DE PRODUCCIN

4.2.

Nombre el
repositorio

repro

ID del repositorio

145530

Descripcin

Repositorio de Documentum

Tamao

MEDIUM 180 MB

Dominio de
autenticacin

Telemadrid

Arranque del
servicio

Automtico

Modo de conexin

Native and Secure

CONFIGURACIN CONTENT SERVERS PARA ACCESO A REPOSITORIO

Para que los servidores de Content Server (TORRE, ELGURUGU) puedan acceder al repositorio de
documentos, durante la instalacin del producto se crea y completa un fichero llamado server.ini; un
archivo de configuracin que es ledo durante el arranque de los servicios de Content Server. En este
fichero se configuran los parmetros para acceder al repositorio. Contiene la siguiente informacin:
o
o
o
o
o
o
o
o
o
o

El nombre del repositorio


ID del repositorio
Nombre del objeto que guarda la configuracin del servidor
Parmetros para conectar a la BBDD
Modo de encriptacin de datos
Parmetros de conexin de ambos docbrokers
Modo IPv4/IPv6
N mximo de sesiones concurrentes
N mximo de hilos concurrentes
Otras opciones de configuracin de Documentum.

Esta configuracin puede cambiarse posteriormente para habilitar o deshabilitar diversas opciones, las
cuales se aplicarn tras aplicar los procedimientos de parada y arranque descritos en el punto 8 de
este documento.
Su ruta es:
Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 13 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
G:\Documentum\dba\config\repro
Y su nombre difiere dependiendo de si el servidor de Content Server es primario o secundario. En el
entorno de Produccin:
o
o

Primario: TORRE. Nombre: server.ini


Secundario: ELGURUGU. Nombre: server_elgurugu_repro.ini

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 14 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
5.

INSTALACIN DE PERSONALIZACIONES EN EL REPOSITORIO

Cuando planteamos una instalacin de la plataforma Documentum podemos decir que se trata del
modelo de tres capas en una arquitectura de sistemas, distribuyendo los distintos servicios en
diferentes servidores. El grfico siguiente muestra este planteamiento:

Clientes Documentum
(Capa de presentacin)

Content Server
(Lgica de negocio)

Sistema de Archivos

BBDD

(Directorio de Windows, Unix,)


(Oracle, SQL Server,..)

Documentum es una base de datos documental y como se puede observar en la grfica anterior, para
su funcionamiento necesita de dos componentes bsicos, un sistema de base de datos y un sistema, o
varios, de ficheros donde almacenar los ficheros electrnicos.
Se pretende hacer un planteamiento desde el punto de vista de la arquitectura de sistemas tanto en lo
que se refiere al hardware y a su redimensionamiento como a los servicios y a su distribucin.

5.1.

BASE DE DATOS
Para poder hacer gestin documental y proporcionar servicios de librera, Documentum necesita
de una base de datos relacional donde almacenar los metadatos de los documentos y sus
relaciones. En este esquema, la base de datos es la encargada de mantener informacin
relativa a:
o
o

Descriptores de los documentos


Informacin de relacin entre documentos.

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 15 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
o
o
o
o
o
o
o

Control de versiones
Permisos y ACLs
Auditoria
Informacin de sistemas como:
Usuarios
Grupos
Etc.

Es por tanto un subsistema imprescindible para el funcionamiento del sistema Documentum.


Entre las bases de datos de mercado con las que actualmente es capaz de funcionar y esta
certificado el sistema Documentum, Telemadrid ha optado por utilizar SQL Server, que ha sido la
base de datos usada en la plataforma Documentum 6.5 previa a la migracin::
o
o
o
o

Oracle
SQL Server
DB2
Sybase

La configuracin permitida para acceso a base de datos desde Documentum es a travs del
cliente estndar de SQL Server. Por lo tanto se ha configurado el sistema en un servidor al que
se accede a travs de una red que soporta TCP/IP.

5.2.

CONTENT SERVER
El servidor de Documentum es el encargado de proporcionar los servicios de librera
necesarios para poder realizar sin desarrollos iniciales gestin documental con las
funcionalidades bsicas necesarias para ello. Algunas de estas funcionalidades son:
o
o
o
o
o
o
o
o
o
o
o
o
o

Versionado
Check-in, Check-out
Usuarios
Permisos
Trazabilidad y auditoria
Rendiciones
Documentos virtuales y composicin de documentos
Relacin entre documentos
Workflow
Ciclo de vida
Importacin
Exportacin
Etc.

Este servicio se instala como un servicio ms del sistema. Teniendo en cuenta que por cada
instancia documental de base de datos se crea un servicio, tendremos en el servidor de
Documentum tantos servicios como repositorios. Para la fcil localizacin de las distintos
repositorios documentales, en el momento de la instalacin de la plataforma se instala un
Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 16 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
servicio de connection broker como otro servicio ms del sistema operativo. Dicho servicio,
es el encargado de mantener el listado de repositorios documentales disponibles y accesible por
los clientes en el sistema instalado.
El tercer servicio que instala la plataforma Documentum es Java Method Server. Este servicio
es el encargado de ejecutar mtodos y procedimiento creados para Documentum dentro de una
nica maquina virtual, de manera que no se ejecute una nueva mquina virtual por cada
ejecucin que se solicite desde los diferentes clientes de Documentum.
A modo de resumen podemos decir que los servicios bsicos de Documentum que se instalan
en el sistema operativo son:
Docbase (Servicio de repositorio)
Docbroker
Java Method Server

o
o
o

Estos tres servicios han de residir en el/los servidor(es) de Content Server.


Documentum permite la instalacin de sus servicios en Alta Disponibilidad. La configuracin
elegida es Activo/Activo utilizando la funcionalidad propocionada por DFCs para la gestin de la
Alta Disponibilidad de los Content Server.

5.3.

SERVICIOS DOCUMENTUM XPLORE


El servidor de indexacin que proporciona EMC2 es xPlore. Para la indexacin por contenido,
se crean dos servicios de sistema operativo ms, estos servicios son:
o
o

Dsearch (correspondiente al servidor de indexacin)


Index Agent (agente encargado de gestionar la cola de indexado)

Estos dos servicios residen conjuntamente en el/los servidor(es) de indexacin

5.4.

CLIENTES DOCUMENTUM
En este apartado comentamos las aplicaciones de Documentum utilizadas en el gestor
documental de Telemadrid:
o

o
Fecha de creacin: 13/07/2016

Clientes Web
o Documentum Administrator
o Documentum TaskSpace, correspondiente con la aplicacin de Asesora
Jurdica
o Documentum Webtop, correspondiente con las aplicaciones web de
Facturas y Diapositivas
o Documentum DRS
Clientes desktop
o Composer
Ref.: 327481269.doc

Pg.: 17 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin

Fecha de creacin: 13/07/2016

o Forms Builder
o Process Builder
Clientes desarrollados a medida
o Aplicaciones hechas a media utilizando la librera de acceso a Documentum
DFC: Telemadrid_Contratacion y Carga_Facturas.

Ref.: 327481269.doc

Pg.: 18 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
6.

ARQUITECTURA TELEMADRID

Este apartado pretende mostrar una fotografa de la distribucin de las mquinas en la nueva
plataforma documental de Telemadrid despus de la migracin.
La nueva plataforma de Produccin cuenta con las siguientes mquinas para la instalacin de la
plataforma Documentum y la Base de Datos.
NOMBRE
TORRE
ELGURUGU
DCTMCS\DISCOF

IP
10.100.8.205
10.100.8.206
10.100.8.208

VALVERDE
PEZUELA
LOSANTOS
BAZTAN
DCTMIS\DISCOF

10.100.8.209
10.100.8.210
10.100.8.211
10.100.8.212
10.100.8.204

SGDB2\DOCU

10.100.8.216

DESCRIPCION
Content Server
Content Server
Disco compartido F: para el filestore del Content
Server a travs del rol de MCS
DA, Tomcat y aplicaciones
DA, Tomcat y aplicaciones
Servidor de indexacin
Servidor de indexacin
Disco compartido F: para el ndice de contenidos
de xPlore a travs del rol de MCS
Clster de SQLServer
El clster de BBDD est formado porlos siguientes
servidores:
CHINCHON (10.100.8.215)
HOYO (10.100.8.217)

Las mquinas TORRE y ELGURUGU alberga el Content Server, el cual se configura en Alta
Disponibilidad con Balanceo de Carga (Activo-Activo). Esta configuracin es posible mediante
las herramientas que proporciona EMC2 a travs de la propia funcionalidad y modo de
configuracin del Content Server. Por lo tanto, no ha sido necesaria la utilizacin de ningn
software de terceros.
Las mquinas VALVERDE y PEZUELA, albergan el Servidor de Aplicaciones y todas las
aplicaciones web, que igualmente se configuran en Alta Disponibilidad con Balanceo de Carga
(Activo-Activo). Esta configuracin ha sido proprocionada por Telemadrid mediante la
configuracin con un balanceador software (NLB) que proporciona persistencia de sesiones.
El cambio de tipologa de balanceador de fsico (tipo F5) a lgico (NLB) se realiza para poder
mantener la funcionalidad que permite abrir documentos almacenados en el gestor
documental, a travs de los enlaces incluidos en los correos electrnicos que enva la
plataforma y que estn en un servidor Outlook y en los correos electrnicos que se almacenan
tambin como documentos en el gestor documental (carpeta CORREOS). Los correos
enviados previos a la migracin tendrn, referenciado en la URL del enlace, la IP de la
mquina DUERO (10.100.4.93). Es necesario redirigir esas peticiones por el balanceador de
carga para que sea ste el que remita la peticin del documento a las mquinas del Content
Server del nuevo entorno. Debido a que la subred de la plataforma antigua y de la plataforma
nueva son distintas, Telemadrid no puede realizar esta redireccin con el balanceador fsico,
de ah la necesidad de modificar la arquitectura e integrar un balanceador software.
ALIAS
documentum-p
Fecha de creacin: 13/07/2016

IP
10.201.0.18

DESCRIPCION

Alias e IP de acceso a las aplicaciones web de


Ref.: 327481269.doc

Pg.: 19 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
Documentum a travs del balanceador. El
alias documentum-p slo es resuelto si el
usuario est dentro de la red de Telemadrid.
Los accesos a travs de Firepass deben
hacerse con documentum-p.telemadrid.org.
Las mquinas LOSANTOS e BAZTAN, donde estn instalados los servidores de indexacin
xPlore, estn configuradas en Alta Disponibilidad (Activo-Pasivo) utilizando las herramientas
que proporciona EMC2 para este tipo de configuracin.
Adems de este conjunto de mquinas, tambin forman parte de la plataforma los siguientes
servidores con los que interacta el Gestor Documental para su funcionamiento:
NOMBRE
mailapp.telemadrid.es
telemadrid.org

IP
10.20.20.100
10.20.20.101
10.100.4.151:389

DESCRIPCION

Servidor de correo Exchange 2010


Servidor de LDAP

La instalacin y configuracin de todo el software Documentum se encuentra en la unidad G:,


quedando destinada la unidad F: para el contenido documental (filestore) y el ndice de
contenidos.
RUTA
G:\Documentum
F:\Documentum\data

G:\Program Files\Documentum
G:\Tomcat 7.0
G:\xPlore
F:\xPlore\data

DESCRIPCION

Ruta principal de instalacin de Documentum en TORRE y


ELGURUGU
Ruta donde se almacena el contenido documental
(filestore). Esta ruta tendr que ser accesible tanto por
TORRE como por ELGURUGU
Ruta donde se configura el directorio Shared de
Documentum en TORRE y ELGURUGU
Ruta principal de instalacin de Tomcat en VALVERDE y
PEZUELA
Ruta principal de instalacin del servidor de indexacin en
LOSANTOS e BAZTAN
Ruta donde se almacena el ndice generado durante el
proceso de indexacin. Esta ruta es accesible tanto por
LOSANTOS como por BAZTAN

Las unidades F: tanto para el conjunto TORRE-ELGURUGU como para el conjunto


LOSANTOS-BAZTAN, se configuran incluyendo en ambos servidores del conjunto el rol de
MCS con un disco compartido F:\, el cual est disponible en uno de los dos nodos (TORRE y
LOSANTOS respectivamente), aunque accesible por red por el otro nodo del conjunto
(ELGURUGU y BAZTAN respectivamente). Con esta configuracin se asegura Alta
Disponibilidad para el File Server. Es importante sealar que en el proceso de instalacin y
configuracin de los productos Documentum, se indic que el acceso a los datos se realice
por UNC.
La siguiente imagen muestra la arquitectura del nuevo entorno de Produccin:

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 20 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 21 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
7.

MONITORIZACIN DE PROCESOS

En este apartado se exponen los procesos propios de la plataforma de documentum instalados en


Telemadrid que deben de estar activos en el sistema y el mtodo de chequeo que debe de realizar el
administrador del sistema para comprobar el buen funcionamiento de los mismos.
Para informacin ms detallada, consultar el documento de monitorizacin de la plataforma
TM_2016_MON_DCTM_Migracion_v1.0.

7.1.

CONTENT SERVER

Los Servicios que tienen que estar activos en ambas mquinas de Content Server (TORRE y
ELGURUGU) son los siguientes:
o

Documentum docbroker Services


o Tipo de Inicio: Automtico
o Usuario: Gestordocu
prodocbroker en el entorno de produccin
Documentum docbase Services
o Tipo de Inicio: Automtico
o Usuario: Gestordocu
repro en el entorno de produccin
Documentum Java Method Server
o Tipo de Inicio: Automtico
o Usuario: Gestordocu

Imagen Ilustrativa.

Chequeo:

Desde el administrador de tareas comprobar que estn ejecutndose los siguientes procesos:

7.2.

dm_agent_exec.exe
java.exe
documentum.exe
dctmservice.exe
dmdocbroker.exe

usuario Gestordocu
usuario Gestordocu
usuario Gestordocu
usuario Gestordocu
usuario Gestordocu

XPLORE

Los Servicios que tienen que estar activos en los servidores de xPlore (LOSANTOS, BAZAN) son los
siguientes:
o

Fecha de creacin: 13/07/2016

Documentum xPlore PrimaryDsearch (Primary) / Documentum xPlore DsearchNode2


(Secondary)
o Tipo de Inicio: Automtico
Ref.: 327481269.doc

Pg.: 22 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
o

o Usuario: Gestordocu
Documentum xPlore Watchdog G-xPlore
o Tipo de Inicio: Automtico
o Usuario: Sistema local
Documentum Indexagent
o Tipo de Inicio: Automtico
o Usuario: Gestordocu

Imagen Ilustrativa:
Servidor primario

Servidor secundario

Chequeo:
En esta pantalla

Realizar la siguiente
accin
Acceder a la direccin http de y
puerto donde escucha el Index
Agent:
Produccin:
http://losantos:9200/IndexAgent
http://baztan:9200/IndexAgent
Introducir los datos de acceso
del usuario, usuario, contrasea
y repositorio:

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 23 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
En esta pantalla

Realizar la siguiente
accin
Aparecer
el
siguiente
formulario con el estado del
IndexAgent.
El estado de funcionamiento
normal es Started.

.
Acceder a la direccin http de y
puerto donde escucha el
Dsearch para abrir la consola de
administracin:

Produccin:
http://losantos:9300/dsearchadm
in
http://baztan:9300/dsearchadmi
n

Introducir los datos de acceso y


la contrasea (admin):

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 24 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
En esta pantalla

Realizar la siguiente
accin
Aparecer en la ventana la
siguiente
consola
de
administracin.
Para verificar que ambas
instancias
estn
en
funcionamiento, basta con
pulsar en System Overview:

Y verificar que el estado de


ambos nodos es Normal y que
el estado de todos los servicios
es Enabled.

7.3.

BUSINESS PROCESS INTEGRATOR


Ha de estar ejecutndose el servidor de aplicaciones Tomcat en VALVERDE y PEZUELA.
-

Chequeo:

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 25 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
En esta pantalla

Realizar la siguiente
accin
En ambos servidores, acceder a
la direccin http donde se est
ejecutando el Bussines Process
Integrator para comprobar que
todos los servicios estn
accesibles.
Produccin:
http://localhost:8080/bps/inboun
d_details.jsp

7.4.

DOCUMENTUM ADMINISTRATOR
Ha de estar ejecutndose el servidor de aplicaciones Tomcat en VALVERDE y PEZUELA.
-

Chequeo:

En esta pantalla

Realizar la siguiente
accin
En ambos servidores, acceder a
la direccin http donde se est
ejecutando
Documentum
Administrator, deber aparecer
el formulario de login con la lista
de repositorios disponibles.
Produccin:
http://localhost:8080/da

7.5.

DIAPOSITIVAS
Ha de estar ejecutndose el servidor de aplicaciones Tomcat en VALVERDE y PEZUELA.

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 26 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
-

Chequeo:

En esta pantalla

Realizar la siguiente
accin
En ambos servidores, acceder a
la direccin http donde se est
ejecutando
la
aplicacin
Diapositivas, deber aparecer
directamente la pantalla de
Archivadores.
Produccin:
http://localhost:8080/diapositivas

7.6.

FACTURAS
Ha de estar ejecutndose el servidor de aplicaciones Tomcat en VALVERDE y PEZUELA.
-

Chequeo:

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 27 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
En esta pantalla

Realizar la siguiente
accin
En ambos servidores, acceder a
la direccin http donde se est
ejecutando
la
aplicacin
Facturas, deber aparecer el
formulario de login con la lista
de repositorios disponibles.
Produccin:
http://localhost:8080/facturas

7.7.

TASKSPACE (ASESORA JURDICA)


Ha de estar ejecutndose el servidor de aplicaciones Tomcat en VALVERDE y PEZUELA.
-

Chequeo:

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 28 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
En esta pantalla

Realizar la siguiente
accin
En ambos servidores, acceder a
la direccin http donde se est
ejecutando la aplicacin de
Taskspace llamada Asesora
Jurdica, deber aparecer el
formulario de login con la lista
de repositorios disponibles.
Produccin:
http://localhost:8080/taskspace?
appname=asesoriajuridica

7.8.

TELEMADRID CONTRATACIN
Ha de estar ejecutndose el servidor de aplicaciones Tomcat en VALVERDE y PEZUELA.
-

Chequeo:

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 29 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
En esta pantalla

Realizar la siguiente
accin
En ambos servidores, acceder a
la direccin http donde se est
ejecutando
la
aplicacin
Telemadrid Contratacin, deber
aparecer el formulario de nueva
solicitud de redaccin de
documentos .
Produccin:
http://localhost:8080/Telemadrid
_contratacion/inicio.jsp?
uid=usuario_consulta
donde el valor del parmetro
uid puede ser cualquier
usuario
de
LDAP
o
Documentum.

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 30 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
8.

PROCEDIMIENTOS DE ARRANQUE Y PARADA

En este apartado se describen los procedimientos ordenados de arranque y parada de los


componentes de la suite de Documentum que conforman la plataforma documental de Telemadrid.
Apuntar antes de comenzar a detallar este procedimiento que el arranque y parada de los servicios es
independiente al sistema operativo donde se encuentren instalados.
El usuario propietario de la instalacin de todos los mdulos de la suite de Documentum instalados en
Telemadrid es Gestordocu, por lo que es requisito acceder al sistema con este usuario para acometer
los procesos de arranque y parada de forma manual.
Para los procesos que se ejecuten como servicios de Windows hay que atenerse a levantar cada
mquina en el orden de prelacin que se indica a continuacin segn cada producto.
Con el fin de no interrumpir el servicio para los usuarios, estos procedimientos deben ejecutarse
secuencialmente (primero se detiene y arranca un servidor, a continuacin el otro) aprovechando la Alta
Disponiblidad de los servicios con el fin de mantener a un servidor de cada pareja funcionando.
Para ms informacin, consultar los procedimientos descritos en el documento de procedimientos de
arranque y parada TM_2016_Start&Stop_DCTM_Migracion_v1.0.doc:

8.1.

ORDEN DE ARRANQUE
Producto

Orden

Servicio

Content Server (TORRE y ELGURUGU)


1

Docbroker

Content Server

Java Method Server

Documentum Docbroker Service


prodocbroker / Documentum Docbroker
Service docbroker2
Documentum Docbase Service repro /
Documentum Docbase Service repro for
Repository repro
Documentum Java Method Server

Index Server (LOSANTOS y BAZTAN)


Primary Dsearch
4

Documentum Xplore PrimaryDSearch


(Primary) / Documentum xPlore DsearchNode2
(Secondary)

Index Agent

Documentum Indexagent

WatchDog

Documentum xPlore Watchdog G -xPlore

Servidor de Aplicaciones (VALVERDE y PEZUELA)


Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 31 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
Producto

Orden

Servicio

Aplicaciones Web: Documentum


Administrator, Facturas,
Diapositivas, Taskspace,
Telemadrid_Contratacin

Apache Tomcat 7.0 Tomcat 7

10

Business Process Integrator

Apache Tomcat 7.0 Tomcat 7

11

Documentum Reporting Services

Apache Tomcat 7.0 Tomcat 7

8.2.

ORDEN DE PARADA
Producto

Orden

Servicio

Servidor de Aplicaciones (VALVERDE y PEZUELA)

Aplicaciones Web: Documentum


Administrator, Facturas,
Diapositivas, Taskspace,
Telemadrid_Contratacin

Apache Tomcat 7.0 Tomcat 7

Business Process Integrator

Apache Tomcat 7.0 Tomcat 7

Documentum Reporting Services

Apache Tomcat 7.0 Tomcat 7

Index Server (LOSANTOS y BAZTAN)


4

WatchDog

Documentum xPlore Watchdog G -xPlore

Index Agent

Documentum Indexagent

Primary Dsearch

Documentum Xplore PrimaryDSearch


(Primary) / Documentum xPlore DsearchNode2
(Secondary)

Content Server (TORRE y ELGURUGU)


7

Java Method Server

Content Server

Docbroker

Fecha de creacin: 13/07/2016

Documentum Java Method Server


Documentum Docbase Service repro /
Documentum Docbase Service repro for
Repository repro
Documentum Docbroker Service
prodocbroker / Documentum Docbroker
Service docbroker2

Ref.: 327481269.doc

Pg.: 32 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
9.

GESTIN DE LOGS

En este captulo se exponen las rutas donde se encuentran los ficheros de logs de los distintos
productos instalados en Telemadrid.
-

Content Server (TORRE, ELGURUGU)


o Docbroker:
G:\Documentum\dba\log\prodocbroker.Docbroker.log
G:\Documentum\dba\log\docbroker2.Docbroker.log
o Java Method Server:
G:\Documentum\jboss7.1.1\server\DctmServer_MethodServer\logs\ServerA
pp.log
o Docbases:
G:\Documentum\dba\log\repro.log
G:\Documentum\dba\log\elgurugu_repro.log
Index Server XPlore (LOSANTOS, BAZTAN)
o Index Server (Dsearch):
G:\xPlore\jboss7.1.1\server\DctmServer_PrimaryDsearch\logs\dsearch.log
G:\xPlore\jboss7.1.1\server\DctmServer_DsearchNode2\logs\dsearch.log
o Index Agent:
G:\xPlore\jboss7.1.1\server\DctmServer_Indexagent\logs\Indexagent.log
Aplicaciones Web desplegadas sobre servidor de aplicaciones Tomcat (VALVERDE,
PEZUELA).
o Se definen en los ficheros log4j de cada aplicacin desplegada. La ruta genrica es:
G:\Tomcat 7.0\webapps\[aplicacin]\WEB-INF\classes\ log4j.properties
donde [aplicacin] puede ser:
bps (Business Process Server)
da (Documentum Administrator)
drs_cr (Documentum Reporting Services)
diapositivas
facturas
taskspace (Asesora Jurdica)
Telemadrid_contratacion no tiene log definido, ya que es una
aplicacin personalizada no basada en Webtop, Taskspace, ... Para
verificar si existe algn tipo de problema con el envo de correos de
solicitud, comprobar el log de la salidad estndar del servidor de
aplicaciones (G:\Tomcat 7.0\logs\ tomcat7-stdout.log).
La ruta del log de la aplicacin se define con la variable:
log4j.appender.file.File (log4j.appender.F1.File para BPS)
o Siguiendo esta pauta, la configuracin actual en Produccin de la definicin de la ruta
de los log de aplicaciones es la siguiente:
Log de BPS: C\:/Documentum/logs/bps-all.log
Log de DA: C\:/Documentum/logs/da.log
Log de Diapositivas: C\:/Documentum/logs/diapositivas.log
Log de DRS: C\:/Documentum/logs/drs_cr.log
Log de Facturas : C\:/Documentum/logs/facturas.log
Log de Taskspace : C\:/Documentum/logs/facturas.log

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 33 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 34 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
10.

TAREAS DE MANTENIMIENTO

A continuacin se detallan las tareas de mantenimiento que deber de realizar el administrador de la


plataforma.

10.1.

ESTADO DE LOS SERVIDORES

Periodicidad: Diaria.
Tareas: Conectarse por Terminal Server a los servidores y comprobar que estn arrancados los
procesos o servicios de Documentum desde la consola de Microsoft Manager Console. Los servicios a
comprobar estn listados en los puntos 8.1 y 8.2 de este documento.

10.2.

REVISAR LOS FICHEROS DE LOGS

Periodicidad: Diaria.
Tareas: Conectarse por Terminal Server a los servidores y revisar los ficheros de Log del Content
Server y de las aplicaciones correspondientes comprobando que no hay errores. En caso de haberlos,
investigar su causa. La totalidad de las rutas de los ficheros de Logs a revisar estn listadas en el punto
9 de este documento.
Los ficheros de Log que hay que revisar son los siguientes:
o
o
o
o

10.3.

Content Server:
Index Server xPlore
Aplicaciones Documentales: (Documentum Administrator, Webtop, BPS)
El que est definido en el fichero \WEB-INF\classes\log4j.properties de cada
aplicacin

REVISAR LOS JOBS DE MANTENIMIENTO

Periodicidad: Diaria.
Tareas: Conectarse a travs del Documentum Administrator, a la seccin de Jobs Management, y
comprobar que se estn ejecutando dentro del periodo establecido, as como el resultado de la
ejecucin en los reports que deja cada Job que se encuentran dentro del repositorio en la siguiente
ruta: Cabinets/Temp/Jobs
Los Jobs que hay que comprobar, junto con su frecuencia de ejecucin son:
o
o
o
o
o

dm_ContentWarning 1 vez al da
dm_ContentWarningelgurugu_repro 1 vez al da
dm_DataDictionaryPublisher Cada 30 minutos
dm_DMClean 1 vez a la semana
dm_DMCleanelgurugu_repro 1 vez a la semana

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 35 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
o
o
o
o
o
o
o
o
o

10.4.

dm_DMFilescan 1 vez a la semana


dm_DMFilescanelgurugu_repro 1 vez a la semana
dm_GwmClean 1 vez al da
dm_GwmTask_Alert Cada 55 minutos
dm_LDAPSynchronization 1 vez al da
dm_LogPurge 1 vez al da
dm_LogPurgeelgurugu_repro 1 vez al da
dm_StateOfDocbase 1 vez al da
Jobs customizados de Telemadrid
tm_ajge_job_actualizaanexos2 Cada hora
tm_ajge_job_alertascomision 1 vez a la semana
tm_ajge_job_alertasvigenciapreaviso 1 vez a la semana
tm_ajge_job_tramites 1 vez al da

BACKUP EN FRO DE LA DOCBASE

Periodicidad: Bajo demanda y Peridico


Tareas: Un repositorio (docbase) est compuesto de tablas en una BBDD relacional y ficheros de
contenidos de los documentos.
El procedimiento adecuado para ello es el siguiente:
1. Detener los servicios de Documentum (como se indica en Procedimientos de Arranque y
Parada de Documentum). En especial el servidor donde reside la docbase. Se aconseja
tambin parar los servicios del servidor de aplicaciones y del xPlore.
2. Realizar un export del tablespace de la BB.DD, de cada repositorio creado para las Docbases.
La informacin del usuario de SQL y de la conexin se encuentran en el fichero
G:\Documentum\dba\config\repro\server.ini de los repositorios.
3. Realizar una copia de los ficheros de contenidos, situados en los equipos del Content Server
en F:\Producto\data\repro.
4. Realizar un Backup de todos los ficheros del producto, situados bajo G:\Documentum
5. Realizar backup de las aplicaciones Web situadas en los servidores VALVERDE y PEZUELA,
G:\Tomcat 7.0\webapps . Copiamos todo el directorio.

10.5.

CAMBIAR LA CONTRASEA DEL USUARIO DE CONEXIN A SQL

Periodicidad: Bajo demanda.


Tareas: Por verse comprometida la password o por polticas de renovacin de contraseas, se puede
requerir cambiar el password del usuario de Oracle con el que una docbase conecta a la base de
datos, tambin llamado docbase owner.
Esta password se almacena encriptada en los servidores de Content Server (TORRE, ELGURUGU) en
G:\Documentum\dba\config\repro\dbpasswd.txt
Para cambiar el cambiar el password:
Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 36 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
1.
2.
3.
4.
5.

Detener el Content Server


Cambiar el password desde la Herramienta de administracin de SQL
Hacer login en el equipo del Content Server como install owner (Gestordocu)
Ir al directorio G:\Documentum\product\7.2\bin
Ejecutar el comando: $dm_encrypt_password docbase <nombre_docbase> rdbms encrypt
<nuevo_password>
Por ejemplo, si queremos cambiar el password del usuario de la docbase repro y como nuevo
password user_repo, se ejecutara el comando:
dm_encrypt_password docbase repro rdbms encrypt user_repo

Esto cambiaria en el fichero G:\Documentum\dba\config\repro\dbpasswd.txt


6. Levantar el servicio del Content Server que sirven a la docbase
Para ms informacin sobre el proceso consultar el apartado Changing an encrypted
password de Content Server Administrators Guide

10.6.

REINDEXAR UNA DOCBASE

Periodicidad: Bajo demanda.


Tareas: En ocasiones, un ndice de fulltext se ve corrompido y no se dispone de Backup para
restaurarlo, o bien se ha cambiado la parametrizacin en el fichero indexserverconfig.xml ubicado en
la unidad F: (F:\xPlore\config) compartida por los servidores de indexacin (LOSANTOS y BAZTAN),
tras lo cual hace falta volver a reindexar el repositorio. Si se necesita recrear el ndice, se har uso del
la consola de ambos Index Agent.
En esta pantalla

Realizar la siguiente
accin
En ambos servidores, acceder a
la direccin http del Index Agent
e introducir los datos de
autentificacin .
Produccin:
http://losantos:9200/IndexAgent
http://baztan:9200/IndexAgent

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 37 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
En esta pantalla

Realizar la siguiente
accin
Una vez se ha accedido al
gestor del Index Agent, Pulsar
Stop IA para detener el
servicio de indexacin.

Seleccionar Start a new


reindexing operation y pulsar
el botn Submit para reiniciar
desde cero una nueva
indexacin del contenido del
repositorio.

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 38 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
En esta pantalla

Realizar la siguiente
accin
Una vez ha comenzado la
reindexacin,
pulsar
peridicamente
el
botn
Refresh para verificar el
estado
del
proceso
de
indexacin.

Tras esperar el tiempo


requerido, se pulsa el botn
Refresh hasta que el proceso
se haya completado.

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 39 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
En esta pantalla

Realizar la siguiente
accin
Cuando se ha completado el
proceso, pulsar el botn Stop
IA.

Seleccionar Start Index Agent


in Normal Mode y pulsar
Submit. De esta manera, el
indexador vuelve a su estado
normal y slo indexar en
adelante los nuevos contenidos
que se aadan al repositorio.

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 40 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin

10.7.

REPUBLICAR EL DICCIONARIO DE DATOS

Periodicidad: Bajo demanda.


Tareas: Si el diccionario de datos resulta alterado o corrompido por alguna instalacin irregular, esto se
manifestar en la visualizacin incorrecta de literales de Documentum en aplicaciones web. Por
ejemplo, en el dilogo de bsqueda de Documentum Administrator, nos aparecen en una lista de
valores a elegir la cadena null repetida en vez del valor real. Una forma de solucionarlo seria haciendo
una republicacin completa del diccionario de datos para los locales instalados en la docbase.
Los pasos a seguir son:
1. Hacer conexin remota como install owner (Gestordocu) al equipo de Content Server principal,
(TORRE)
2. Desde el directorio G:\Documentum\Product\7.2\bin ejecutar el comando:
dmbasic -f dd_populate.ebs -e Entry_Point -- <nombre_docbase>
<login_install_owner>
<password_install_owner>
$DOCUMENTUM/dba/config/<nombre_docbase>/data_dictionary.ini
Un ejemplo podra ser el siguiente:
dmbasic -f dd_populate.ebs -e Entry_Point -- repro Gestordocu
Documentum10 G:\Documentum\dba\config\repro\data_dictionary.ini
Antes de ejecutar este comando se debe comprobar que el fichero
data_dictionary.ini tiene descomentadas las lneas que hacen referencia a los
locales instalados (en este caso el en y el es). Si no existe, como suele ocurrir
con el locale ingls (en) se aade al fichero la ruta del fichero que contiene la
informacin de publicacin del locale.
3. Cuando termine el comando anterior, desde la misma conexin remota se debe ejecutar un
comando de api. Para ello ejecutaremos desde una consola de Windows:
iapi
Nos conectaremos como Gestordocu a la docbase repro, para la cul se quiere
republicar el DD.
4. Dentro del programa iapi introduciremos las sentencia:
publish_dd,c,es
y
publish_dd,c,en

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 41 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
As como para cualquier otro locale que se haya instalado. Si se quiere hacer
una publicacin de todo el diccionario de datos (todos los locales instalados), se
ejecutar el comando:
publish_dd,c
5. Una vez terminado esto, los valores correctos de los operadores de bsqueda avanzada
aparecern en las aplicaciones pasados unos minutos. Si esto no sucede se deber reiniciar
el proceso del servidor de aplicaciones de las aplicaciones.

10.8.

CLONADO DE DOCBASE

Periodicidad: Bajo demanda.


Tareas: Debido a una migracin de servidores, una actualizacin de versin de Documentum o para
tener una rplica de una docbase, se realizar una copia de una docbase existente (Consultar Content
Server Installation Guide para ver el procedimiento completo).
Para evitar una posible corrupcin de datos, la docbase clonada debe estar parada mientras est
levantada la copia, o bien encontrarse en redes distintas.
Los pasos a seguir son:
1. Parar la docbase a clonar
2. En el host de destino de la copia, si no existe ya, crear una instalacin del software de Content
Server.
3. En el host de destino de la copia, crear una docbase teniendo en cuenta los siguiente:
o Se debe usar el mismo nombre de docbase, docbase id, docbase owner (usuario
de BBDD) y password del docbase owner que en la docbase original
o No se puede instalar docbases de instalaciones diferentes en un mismo entorno.
Esto se debe a que como parte del proceso de clonado, se debe copiar el fichero
aek.key, nico por cada instalacin y asociado a la docbase de forma nica en el
momento de su creacin. Una docbase no puede funcionar sin el aek.key con la
que se cre.
o Se debe de usar una instancia de BBDD diferente a la de la docbase original.
o La docbase clonada no debe proyectarse a los mismos docbrokers que la
docbase original.
o Se debe sustituir en el entorno destino el fichero
G:\Documentum\dba\secure\aek.key por el de la instalacin de la docbase
original
4. Aplicar a la nueva docbase los mismos parches que los de la docbase original
5. Exportar todos los elementos del docbase owner (usuario BBDD) con las herramientas de
exportacin de SQL
6. Si se van a clonar tambin los contenidos, hacer Backup del directorio
G:\Documentum\data\repro
7. Si no lo est, parar el repositorio destino.

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 42 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
8. Eliminar los tablespace del usuario de BBDD de la docbase destino. Las sentencias para
hacerlo se encuentra en el fichero
G:\Documentum\dba\dba\config\repro\dm_DeleteTableSpace.sql
9. Eliminar los ficheros de tablespace de BBDD de la docbase destino.
10. Importar en la base de datos destino la exportacin de la base de datos origen
11. Conectando con un cliente de SQL, comprobar y/o actualizar los valores de los siguientes
campos:
o En la tabla dm_server_config_s, el valor r_host_name debe ser el del equipo
donde reside la docbase de destino
o En la tabla dm_mount_point_s el valor host_name debe ser el del equipo donde
reside la docbase de destino
o En la tabla dm_job_s el valor target_server debe ser el del equipo donde reside
la docbase de destino
o En la tabla dm_server_config_r, si est definido, el valor projection_target debe
corresponder al del entorno de destino
12. Ejecutaremos la siguiente sentencia SQL para que Documentum recree las vistas:
update dm_type_s set views_valid=0

13. Si se van a hacer pruebas con los contenidos, copiaremos el Backup de datos al entorno
destino al directorio G:\Documentum\data\repro
14. Comprobamos que en el fichero G:\Documentum\dba\config\repro\server.ini exista la entrada
preserve_existing_types=T
15. Arrancamos la copia de la docbase
16. Si los mount point o los location de almacenamiento se encuentran en distintos puntos en la
docbase original y en la copia ( es decir, el lugar al que hemos copiado el Backup de los
contenidos), los actualizaremos con las siguientes sentencias DQL:
update dm_location objects
set file_system_path='nuevopath' where
file_system_path='anteriorpath'
update dm_mount_point objects
set file_system_path='nuevopath' where
file_system_path='anteriorpath'

10.9.

CONFIGURACIN LDAP

Con el fin de conectar la plataforma Documentum a un repositorio LDAP para que los usuarios del
directorio puedan conectarse y autentificarse a las diversas aplicaciones de Documentum, es necesario
registrar los datos de conexin en Documentum Administrator.

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 43 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
En esta pantalla

Realizar la
siguiente
accin
Desde la aplicacin de
Administracin
Documentum
Administrator, acceder a
las
opciones
de
configuracin de LDAP
Server y seleccionar File
New LDAP Server
Configuration:

Introducir la siguiente
informacin
en
el
formulario de la pestaa
Info:
O Name:
tm_ajge_LDAP_conf
O Status: Enable
O Directory Type: Microsoft
Active Directory
O Host name:
telemadrid.org
O Port: 389
O Binding Name:
CN=solicitudcontratosasj,O
U=DIR-ASESORIAJURIDICA,OU=DIRGRAL,OU=RTVM,DC=tele
madrid,DC=org
O Password: Abcdef1
Click OK.

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 44 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
En esta pantalla

Realizar la
siguiente
accin
En la pestaa Sync &
Authentification :
O Import: Users and
Groups
O Sync Type: Incremental
O Deleted users: set to
inactive
O Update names into
repository, users and
groups
O User type: dm_user
O Bind to user DN: Use
DN stored with user record
in repository
En el formulario Mapping:
O User Object Class: user
O User Search Base:
OU=RTVM,DC=telemadrid,
DC=org
O User search Filter:
(sAMAccountName=*u)
O Group Object Class:
group
O Group Search Base:
OU=RTVM,DC=telemadrid,
DC=org
O Group Search Filter:
(cn=*)

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 45 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
En esta pantalla

Realizar la
siguiente
accin
Por ltimo, en Property
Mappings:
O user_name
displayname
O user_login_name
sAMAccountName
O user_address mail
O group_name cn
Dejar los valores
defecto del Failover.

por

Desde el men lateral,


seleccionar Job
Management / Jobs y ver
las propiedades del job
dm_LDAPSynchronization.

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 46 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
En esta pantalla

Realizar la
siguiente
accin
Habilitar Job
dm_LDAPSyncronization:

Modificar la planificacin si
se desea:

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 47 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
En esta pantalla

Realizar la
siguiente
accin
Revisin del log del Job
dm_LDAPSyncronization

10.10. ALTA DE NUEVOS USUARIOS


Para que el Job de sincronizacin incorpore nuevos usuarios del LDAP, se debern aadir dichos
usuarios al grupo U=RTVM,DC=telemadrid,DC=org.

10.11. GESTIONAR PERMISOS DE ACCESO DE DOCUMENTOS DE TIPO FACTURA


En ocasiones necesitaremos ampliar o restringir los accesos por parte de los usuarios a ciertos
documentos como los de tipo Factura. Para ello, se deber acceder al men Security de Documentum
Administrator y buscar por la ACL con nombre cabinet_telemadrid_ACL, que es la ACL que gestiona
los permisos del cabinet Telemadrid, el cual contiene la carpeta Telemadrid/Histrico, que almacena
todos los documentos de tipo Factura:

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 48 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
En esta pantalla

Realizar la
siguiente
accin
Buscar por la ACL con
nombre
cabinet_telemadrid_ACL

Acceder a las propiedades


de la ACL.

Pulsar en la
Permissions.

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

pestaa

Pg.: 49 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
En esta pantalla

Realizar la
siguiente
accin
Una vez estamos en la
pantalla de gestin de los
permisos de la ACL,
vemos que dentro de la
lista de acceso se
encuentran los grupos
Usuario carga facturas y
dm_owner:

Para editar los permisos


del usuario Usuario carga
facturas en el cabinet
Telemadrid, seleccionar
el grupo de la lista y pulsar
el botn Edit.

Del mismo modo, para


editar los permisos de los
grupos grs_facturasjde o
grs_facturasjde-lectura
en el cabinet Telemadrid,
seleccionar el grupo de la
lista y pulsar el botn
Edit.

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 50 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
En esta pantalla

Realizar la
siguiente
accin

Desplegar el combo Basic


Permissions, ortogar los
permisos oportunos al
grupo seleccionando un
valor y pulsar OK en esta
ventana y en la siguiente
para validar los cambios.

Nota: En caso de querer gestionar el acceso sobre el cabinet Telemadrid de cierto usuario en
particular para otorgar o quitar accesos a los documentos de tipo Facturas guardados en
Telemadrid/Histrico, se debe gestionar la pertenencia o no a los grupos de la aplicacin facturas:
grs_facturasjde (escritura/lectura) o grs_facturasjde-lectura (slo lectura). Para ello buscar el usuario
en el men Users, seleccionarlo y pulsar Assign Group Membership.

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 51 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
11.

CONFIGURACIN DE SQL EN EL SERVIDOR DE BBDD PARA CONTENT


SERVER

Datos de conexin:
o
o
o
o
o
o
o

Versin de Base de Datos: 10.50.4000.1


Usuario: repro
Contrasea: Documentum10
Database: TM_repro_docbase
Language: Espaol (Espaa)
Collation: SQL_Latin1_General_CP1_CS_AS
CS = Case Sensitive

La cuenta de Usuario repro debe de tener los siguientes privilegios y roles:

Privilegios:
o
o
o
o

Conectar a la base de datos.


Creacin de tablas, vistas, e ndices en la base de datos.
Insertar los registros (filas) en tablas.
Eliminar tablas, vistas e ndices.

Roles:
o
o

Connect
Resource

En las mquinas del Content Server (TORRES, ELGURUGU) hay que crear un DSN de usuario en
orgenes de datos ODBC para conectar a la BBDD:

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 52 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
En esta pantalla

Realizar la
siguiente
accin
Le debemos de dar un
nombre, en este caso
ODBC_DCTM
y una
descripcin
(opcional),
para conectar al clster de
SQLServer (CHINCHON,
HOYO) y a la instancia del
servidor: SGDB2\DOCU.
Para ello pulsar el botn
Agregar.

Elegir la opcin SQL


Server Native Client 10.0.

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 53 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
En esta pantalla

Realizar la
siguiente
accin
Escribir el nombre del
origen de datos y escribir
SGDB2\DOCU
para
apuntar al clster de SQL
Server.
Pulsar Siguiente.

Escribir el Id. de inicio de


sesin y la contrasea.
Pulsar Siguiente.

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 54 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
En esta pantalla

Realizar la
siguiente
accin
Pulsar Siguiente.

Pulsamos Finalizar

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 55 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
En esta pantalla

Realizar la
siguiente
accin
Probamos el origen de
datos.

Una vez que nos ha dicho


que los test se han
completado
satisfactoriamente
pulsamos Aceptar.

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 56 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin

12.

12.1.

SERVIDORES DE APLICACIONES TOMCAT

CONFIGURACIN DE TOMCAT

Para las aplicaciones web que se desplieguen en Tomcat lo primero que hay que hacer es arrancarlo.
Para ello, se ha de ejecutar el archivo Tomcat7e.exe, ubicado en G:\Tomcat 7.0\bin y pulsar Start o
bien iniciar el servicio Apache Tomcat 7.0 Tomcat7.

En la pestaa Java se debe verificar que el campo Java Options contiene la siguientes variables y
valores:
-Dcatalina.home=G:\Tomcat 7.0
-Dcatalina.base=G:\Tomcat 7.0
-Djava.endorsed.dirs=G:\Tomcat 7.0\endorsed
-Djava.io.tmpdir=G:\Tomcat 7.0\temp
Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 57 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager
-Djava.util.logging.config.file=G:\Tomcat 7.0\conf\logging.properties
-Xms1024m
-Xmx2048m
-XX:MaxPermSize=1024m
-XX:+UseParallelOldGC

Para verificar el correcto inicio de las aplicaciones, se pueden consultar los ficheros de log ubicados en
la carpeta G:\Tomcat 7.0\logs, principalmente:
o
o
o

catalina.log
tomcat7-stderr.log
tomcat7-stdout.log

Para verificar que Tomcat est arrancado acceder a http://localhost:8080/ . Hay que asegurarse de que
en el sistema no haya ningn proceso o servicio que est utilizando el puerto 8080 y liberar dicho
puerto en el Firewall de Windows. Tambin se puede acceder al Gestor de Aplicaciones de Tomcat
(consola de administracin de Tomcat) pulsando el botn ManagerApp, en la que se muestran todas
las aplicaciones que se estn ejecutando en el servidor, o acceder directamente a
http://localhost:8080/manager . Para acceder al gestor har falta autentificarse (usuario: admin ,
password: admin).
Para detener el servidor de aplicaciones Tomcat se deber parar el servicio indicado anteriormente o
pulsar Stop desde la ventana desplegada por el ejecutable G:\Tomcat 7.0\bin\Tomcat7e.exe.

12.2.

ACCESO Y CONFIGURACIN DE XPLORE (INDEXAGENT Y DSEARCH)

Para acceder a la consola de los Index Agent de xPlore, es necesario acceder a las URLs siguientes:

http://losantos:9200/IndexAgent
http://baztan:9200/IndexAgent

E introducir el usuario y contrasea correctos. Desde esta consola se puede reindexar una docbase
(ver punto 10.6)

Para configurar el Index Agent de xPlore, se debe modificar la parametrizacin en el fichero


indexserverconfig.xml ubicado en la unidad F: (F:\xPlore\config) compartida por los servidores de
indexacin (LOSANTOS y BAZTAN) y reiniciar los servicios de ambos Index Agent.
Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 58 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin

Es importante saber que, cada vez que se desee actualizar este fichero, antes de reindexar el
contenido del repositorio se debe cambiar la versin del fichero modificando la etiqueta revision al
comienzo del archivo:

Entre otras opciones, en este documento se puede configurar qu atributos/metadatos de los


documentos del repositorio pueden ser indexados o no para las bsquedas por contenido (full text
search). Las definiciones de esta funcionalidad se encuentran englobadas en la etiqueta indexes del
fichero .xml:

Para acceder a la consola de los administracin de DSearch de xPlore, es necesario acceder a las
URLs siguientes:

http://losantos:9300/dsearchadmin
http://baztan:9300/dsearchadmin

E introducir la contrasea correcta (mirar punto 7.2). En concreto, para configurar Dsearch, se debe
acceder a la direccin, autenticarse y pulsar el botn Global Configuration desde System Overview
para ajustar las opciones generales:

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 59 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin

Desde esta consola de administracin tambin se puede navegar por los diferentes apartados para
activar/desactivar servicios (Indexing Service, Search Service, Content Processing Service, Logging) en
las diferentes instancias de Dsearch as como ejecutar las herramientas de diagnostico y utilidades
(Diagnostic and Utilities).

12.3.

CONFIGURACIN COMN DE APLICACIONES

Para todas las aplicaciones J2EE que se provean de servicios de los Content Server hay que
configurarlas el fichero dfc.properties que se ubica en el directorio de la aplicacin /WEB-INF/classes.
Los elementos son los siguientes:
- Entorno de Produccin:
dfc.docbroker.host[0]= 10.100.8.205
dfc.docbroker.port[0]=1489
dfc.docbroker.host[1]= 10.100.8.206
dfc.docbroker.port[1]=1489
dfc.globalregistry.repository=repro
dfc.globalregistry.username=dm_bof_registry
dfc.globalregistry.password=GrRNPhLJrkoTDAZE0RGJow==
dfc.diagnostics.resources.enable=false

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 60 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
NOTA: Siguiendo las directrices proporcionadas por el soporte de EMC2, los nmeros de IP son
preferibles a los nombres de servidor (DNS) en estos y otros ficheros de configuracin, en el caso de
que el servidor tenga ms de una tarjeta de red, para evitar posibles errores de conexin. Es
importante tener en cuenta este aspecto en el caso de que la direccin IP de cierto servidor sea
modificada para ajustar correctamente los valores de los ficheros de configuracin.
El elemento dfc.globalregistry.password contiene la contrasea cifrada del usuario dm_bof_registry. A
partir de la versin Documentum 7.x, EMC2 modific el modo de cifrado de modo que la contrasea
generada es distinta a las de las versiones Documentum 6.x. En el caso de Telemadrid, nos
encontramos con la siguiente configuracin de versiones:
1.
2.
3.
4.
5.
6.

Content Server 7.2


Webtop 6.8.1 (Aplicaciones de Facturas y Diapositivas)
Documentum Administrator 7.2
BPS 2.2
Taskspace 6.7 SP2 (Aplicacin de Asesora Jurdica)
DRS 6.7 SP2

Los 4 primeros elementos estn configurados bajo la versin 7.2, por lo que la contrasea de
dm_bof_registry se regir por el nuevo mtodo de cifrado.
Los dos ltimos elementos, en la versin 6.7 SP2 seguirn usando el modo de cifrado antiguo.
Este modo de cifrado siempre generaba la misma contrasea; en nuestro caso
GrRNPhLJrkoTDAZE0RGJow==, cuyo valor no cifrado es dm_bof_registry.
Sin embargo, el nuevo mtodo de cifrado puede generar distintas contraseas cifradas
dependiendo de la aplicacin. Es decir, cada instancia de dfc puede dar un resultado cifrado
distinto.
En caso de que sea necesario regenerar la clave cifrada para una determinada aplicacin, se
siguen los siguientes pasos:
1. Conectarse al servidor de aplicaciones donde queremos cifrar la contrasea (VALVERDE,
PEZUELA).
2. Abrir una ventana de comando de Windows y navegar al directorio F:\Tomcat
7\webapps\<aplicacion>\WEB-INF\classes
3. Ejecutar el siguiente comando
java
-cp
"..\lib\dfc.jar;"
dm_bof_registry

com.documentum.fc.tools.RegistryPasswordUtils

4. La clave obtenida se copiar en la propiedad dfc.globalregistry.password del fichero


F:\Tomcat 7\webapps\<aplicacion>\WEB-INF\classes\dfc.properties y se reiniciar el
servidor de aplicaciones Tomcat.

13.

CONFIGURACIN DE LOS BUZONES DE CORREO

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 61 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
13.1.

CLIENTES DOCUMENTUM

Las solicitudes y toda la gestin de la correspondencia se realiza a travs de dos buzones de correo:
o
o

solicitudcontratosasj@telemadrid.es, para las nuevas solicitudes.


recibedocaj@telemadrid.es, para la gestin de la correspondencia dentro de
los procesos de contratacin.

Para un funcionamiento adecuado de la aplicacin estos dos buzones tienen que tener aplicadas las
siguientes reglas.
1. Crear la carpeta en el buzn de correo "Recibidos" en ambos buzones de correo.
2. Crear una regla para que todos los correos que se reciban (entrantes) en estos dos buzones
se muevan automticamente a la carpeta "Recibidos"
3. Para todas las cuentas de los usuarios autorizados para realizar la solicitud de contratacin
crear una regla que mueva los correos recibidos a estas dos cuentas al directorio "Inbox".

13.2.

BUZN DE ASESORA JURDICA

Actualmente la Direccin de Asesora Jurdica utiliza un buzn comn para recibir correos de la
organizacin GDAsesoria@telemadrid.es, este uso tambin lo utiliza la aplicacin para enviarle las
notificaciones relativas a la recepcin de documentacin y los informes con los estados de los
expedientes. Los correos que se envan desde la aplicacin no tienen el dominio telemadrid.es por lo
que el servidor de correo los trata como spam. Para evitar este efecto es necesario configurar este
buzn para todos los usuarios aceptando el dominio @Gestordocu como dominio de confianza para
que no ubique los correos que enva la aplicacin como spam. Tamben se puede crear una regla en el
buzn para todos los usuarios que mueva los correos recibidos desde @Gestordocu al inbox de la
cuenta.

13.3.

GRUPOS, ROLES Y LISTAS DE DISTRIBUCIN DE APLICACIONES

A modo informativo se listan, los grupos o roles que existen en las siguientes aplicaciones y
funcionalidades (si procede), con el fin de informar de las capacidades y permisos de cada grupo o rol:

Facturas:
o
o

grs_facturasjde: usuarios con permisos de lectura y escritura sobre los objetos de


tipo Factura.
grs_facturasjde_lectura: usuarios con permisos de slo lectura sobre los objetos de
tipo Factura.

Asesora Jurdica (Listas de distribucin):

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 62 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin

tm_ajge_gr_listadistri_alertas: Grupo con la lista de distribucin de los usuarios


que reciben las notificaciones por correo electrnico con las Alertas de expedientes.
Este grupo tiene como miembros:

revisor1 este usuario no tiene un correo vlido, por lo que no le llegar


notificacin alguna.

Mara Rosario Carrera Garca esta usuaria ser eliminada de este


grupo durante el proceso de migracin del entorno productivo.

buzona sesoria GDAsesoria@telemadrid.es

tm_ajge_gr_listadistri_ctodef: Grupo con la lista de distribucin de los usuarios que


reciben la notificacin de contrato definitivo. Este grupo tiene como miembros:

Toms Morales Rafael

Miguel ngel Bernado Villena

David Alonso Gomara

Jos Roales-Nieto Martnez

tm_ajge_gr_listadistri_publicaci: Grupo con la lista de distribucin de los usuarios


del grupo Multimedia que reciben las notificaciones de publicacin. Este grupo tiene
como miembros:

TODOS USUARIOS GRUPO MULTIMEDIA: Usuario de Documentum que


representa a al buzn de correo de los usuarios de
GRD_MULTIMEDIA@telemadrid.es

Asesora Jurdica (roles de aplicacin):


o
o
o

ts_designer: Rol de Administrador de la aplicacin. Este rol puede acceder a las


pestaas de Configuracin y Administracin de Taskspace.
contratos: Rol con permisos para acceder a la vista de Contratos.
juicios: Rol con permisos para acceder a la vista de Juicios.

13.4. DESCRIPCIN DE LOS REMITENTES Y RECEPTORES DE CORREOS DENTRO


DE LA APLICACIN
En este punto se va a indicar por cada tipo de correo que se enva durante los flujos de Asesora
Jurdica, quienes sern los remitentes y los receptores de dichos correos:

Telemadrid Contratacin
o Correo de envo de solicitud:

From: usuario que enva el formulario

To: solicitudcontratosasj@telemadrid.es
Flujo Inicio de Expediente
o Correo de confirmacin al solicitante:

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 63 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
From: Gestordocu@PRODUCCION
To: usuario que enva el formulario de solicitud anterior
Correo de aviso de cancelacin de la tramitacin:

From: Gestordocu@mailapp.telemadrid.es

To: usuario que enva el formulario con la solicitud

Cc: GDAsesoria@telemadrid.es
Correo de aviso a Comisin de expediente mayor a 600000:

From: Gestordocu@mailapp.telemadrid.es

To: GDAsesoria@telemadrid.es
Correo de aviso de inicio de proceso de Contratacin:

From: Gestordocu@mailapp.telemadrid.es

To: usuario que enva el formulario con la solicitud


Correo de aviso de inicio de proceso de Liciticacin:

From: Gestordocu@mailapp.telemadrid.es

To: usuario que enva el formulario con la solicitud


Correo de aviso de autorizacin por Comisin Delegada en expedientes anexo:

From: Gestordocu@mailapp.telemadrid.es

To: reyes.jimenez@telemadrid.es, ana.civera@telemadrid.es,


mercedes.delaheras@telemadrid.es
Correo de aviso de inicio de proceso de Contratacin de expediente anexo:

From: Gestordocu@mailapp.telemadrid.es

To: usuario que enva el formulario con la solicitud

o
o
o
o

Flujo de Expedientes de Contratos


o Correo con el Borrador del contrato adjunto:

From: recibedocaj@telemadrid.es

To: usuario que enva el formulario con la solicitud

Cc: GDAsesoria@telemadrid.es
o Correo con el Borrador del contrato no adjunto:

From: recibedocaj@telemadrid.es

To: usuario que enva el formulario con la solicitud


o Correo con enlace al documento de Contrato Firmado:

From: Gestordocu@mailapp.telemadrid.es

To: Receptores seleccionados de la siguiente por el usuario de la aplicacin:


tomas.morales@telemadrid.es
miguel.bernardo@telemadrid.es
david.alonso@telemadrid.es
jose.roales@telemadrid.es

Cc: usuario que enva el formulario con la solicitud

Flujo de Licitacin
o Correo con el Pliego Jurdico adjunto:

From: recibedocaj@telemadrid.es

To: usuario que enva el formulario con la solicitud

Cc: GDAsesoria@telemadrid.es
o Correo con el Pliego Jurdico no adjunto:

From: recibedocaj@telemadrid.es

To: usuario que enva el formulario con la solicitud


o Correo con el Pliego Tcnico adjunto:

From: recibedocaj@telemadrid.es

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 64 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
To: usuario que enva el formulario con la solicitud
Cc: GDAsesoria@telemadrid.es
Correo con el Pliego Tcnico no adjunto:

From: recibedocaj@telemadrid.es

To: usuario que enva el formulario con la solicitud

Flujo de Recepcin de Documentacin


o Correo de entrada de documentacin:

From: remitente del correo con la nueva documentacin

To: recibedocaj@telemadrid.org
o Correo de notificacin de entrada de documentacin:

From: recibedocaj@telemadrid.es

To: GDAsesoria@telemadrid.es

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 65 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
14.

MODELO DE TABLAS EXTERNAS

La aplicacin de gestin de Expedientes para la Direccin de Asesora Jurdica se apoya en un modelo


entidad relacin de tablas maestras y externas al producto Documentum. Este modelo permite
modificar, aadir y borrar los metadatos (filas) que los usuarios van a utilizar en la aplicacin para
informar los metadatos tanto de los expedientes como de los documentos sin necesidad de modificar la
aplicacin. Estas tablas son consideradas de tipo estticas porque la aplicacin solamente acceder a
ellas en modo consulta, nunca modificar los datos.
Estas tablas aunque son denominadas externas se encuentran en el mismo tablespace donde se ha
instalado la base de datos correspondiente a Documentum.
Las tablas tienen la siguiente nomenclatura (tm_ajge_table_descripcion):
o
o
o
o

tm = telemadrid.
ajge = codigo de proyecto "asesoria juridica gestion documental".
table = identificador del objeto "tabla"
descripcin = descripcin de la naturaleza de la tabla.

Las tablas que utiliza la aplicacin son las siguientes:

El diagrama entidad relacin entre estas tablas es el siguiente:


a) Tablas sin dependencias.

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 66 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin

b) Tablas con dependencias entre si.

pk = primary key, fk = foreign key.

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 67 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin

c) Dependencias entre las tablas y los tipos documentales de Documentum.

Tabla

Tipo
docume
ntal

Atributo

tm_ajge_table_tipoimp
orte

tm_s_s_attr_tipoi
mporte

tm_ajge_table_tipoexp
ediente

tm_s_s_attr_tipoa

tm_ajge_table_organo
autorizador

tm_s_s_attr_autor
izacion

tm_ajge_table_moned
a

tm_s_s_attr_mon
eda

tm_ajge_table_estado
s

tm_s_s_attr_estad
o

tm_ajge_table_tipocon
trato

Fecha de creacin: 13/07/2016

tm_ajge_td_ex
pediente

tm_s_s_attr_tipoc
to

Ref.: 327481269.doc

Consulta
select tipoimporte_c from
dm_dbo.tm_ajge_table_tipoi
mporte
select tipo_expediente_c
from
dm_dbo.tm_ajge_table_tipo
expediente
select organoauto_c from
dm_dbo.tm_ajge_table_orga
noautorizador
select moneda_c from
dm_dbo.tm_ajge_table_mon
eda
select estado_c from
dm_dbo.tm_ajge_table_esta
dos
select tipo_contrato_c from
dm_dbo.tm_ajge_table_tipoc
ontrato
Pg.: 68 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
tm_ajge_table_subtipo
contrato

tm_s_s_attr_subti
pocto

select subtipo_contrato_c
from
dm_dbo.tm_ajge_table_subti
pocontrato s,
dm_dbo.tm_ajge_table_tipoc
ontrato t where t.pk = s.fk
and t.tipo_contrato_c like '%
$value(tm_s_s_attr_tipocto)
%'
Atributo del tipo
documental
tm_ajge_td_expediente que
provee el dato
subtipo_contrato_c

tm_ajge_table_depart
amento

tm_s_s_attr_depa
rtamento

select departamento_c
from
dm_dbo.tm_ajge_table_direc
cion dir,
dm_dbo.tm_ajge_table_dep
artamento der where dir.pk
= der.fk and dir.direccion_c
like '%
$value(tm_s_s_attr_direccio
n)%'
Atributo del tipo
documental
tm_ajge_td_expediente que
provee el dato
departamento_c

tm_ajge_table_tipodoc
umento

tm_s_i_attr_tipod
oc

Tm_ajge_table_subtip
odocumento

tm_s_i_attr_subti
podoc

tm_ajge_td_do
cumctos

select tipo_documento_c
from
dm_dbo.tm_ajge_table_tipo
documento
select subtipo_documento_c
from
dm_dbo.tm_ajge_table_tipo
documento t,
dm_dbo.tm_ajge_table_subti
podocumento s where t.pk
= s.fk and
tipo_documento_c like '%
$value(tm_s_i_attr_tipodoc)
%'
Atributo del tipo
documental
tm_ajge_td_expediente que
provee el dato
subtipo_documento_c

d) Explotar los datos de las tablas


Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 69 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin

El campo pk (clave primaria) es un campo autoincremental, por tanto este columna se


autogestiona y no hay que introducir en ninguno de los casos valores en esta columna.
- Acciones sobre las Tablas sin dependencias.
o
o
o

Aadir: se aadirn registros informando los campos acabados en _c, el campo descripcin
informa de la funcionalidad del campo.
Modificar: se modificarn los campos acabados en _c ejecutando una instruccin update de
sql.
Borrar: Se borrar el registro utilizando una instruccin delete de sql sobre el registro.

- Tablas con dependencias.


o
o
o
o

El modelo entidad relacin se obtiene por la vinculacin entre los campos pk -> fk
Para las tablas primarias el funcionamiento es idntico al de las tablas sin dependencias.
Para las tablas con dependencias hay que tener en cuenta que la clave fk debe de tener su
par en la tabla primaria.
Se modificaran los campos acabados en "_c".

A continuacin se adjuntan los scripts necesarios para la creacin desde el inicio de las Tablas
Registradas en el entorno de Produccin (tambin vlido para Integracin). El orden de ejecucin es el
siguiente:
o
o

Script de tipo CREATE


Scripts de tipo INSERT: en primer lugar las tablas sin dependencias y a continuacin las
tablas con dependencias

Script de tipo UPDATEPERMIT

Estos scripts definen el tipo primitivo, longitud, depencias (si procede) y posibles valores de los tipos
documentales definidos previamente:

Registered_Tables_INT-PROD.zip

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 70 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
15.

FALLOS Y CONTINGENCIAS

A continuacin, pasamos a describir los posibles errores y contingencias que pueden ocurrir en el
sistema y las medidas para atajarlos.

15.1.

LOGIN FALLIDO

Descripcin: Un usuario intenta hacer login mediante una de las aplicaciones y el sistema responde
que no se ha podido validar.
Causa:
o
o
o
o

El Content Server no se encuentra levantado


El usuario est Inactive a nivel de Documentum por exceder el mximo de intentos de
hacer login
El usuario est desactivado a nivel de LDAP por exceder el mximo de intentos de hacer
login
Existen problemas de conexin entre los Content Server y el servidor de LDAP

Accin:
o
o
o
o

15.2.

Reiniciaremos el Content Server


Usando Documentum Administrator, en Administracin->User Management, cambiaremos
el estado de Inactive a Active
Solicitar al administrador LDAP la activacin del usuario
Verificacin por parte del equipo de Sistemas de Telemadrid entre los servidores de
Content Server y el de LDAP

DOCBASE BLOQUEADA POR FALLO DE CONEXIN A BBDD

Descripcin: La docbase de documentum no est operativa y se observa en el log de la docbase un


mensaje similar al siguiente:
returned a failed status for the request: (check-point)
.
Error message from docbroker: (Docbroker Update request
rejected:
(Mon
Jul
16
11:01:10
2007
468960[DM_DOCBROKER_E_ID_ALREADY_REGISTERED]:
The docbase id:
(106022) is already used by the docbase named: ().))."

Causa:
o

Perdida de la conexin al servidor de SQL debido a una parada de estos

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 71 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin

Accin:
o

Reiniciaremos todos los docbroker ,docbases y Documentum java Method servers. El


proceso de la docbase solo puede detenerse matando los procesos, ya que el script de
parada de la docbase necesita al docbroker funcionando correctamente para funcionar.
Nos aseguraremos de que en un momento dado no haya ningn servicio de docbase y
docbroker levantado, y procederemos a levantar los servicios del Content Server. No ser
necesario reiniciar los servicios de los servidores de aplicaciones.

15.3. ESTADO INCONSISTENTE DEL CONTENT SERVER POR CADA/BAJADA DEL


SERVICIO DE BB.DD
Descripcin: Si estando arrancado CS la BBDD deja de dar servicio por parada o cada espontnea,
CS muestra el siguiente error en el log:
[DM_SESSION_E_CANT_MAKE_TEMP_CONNECTION]error:
"Could not establish
an internal, temporary database connection (database_name = ,
docbase_owner = gdocum_u, connection_string = GDMDE1); database
system error was: ORA-12537: TNS:connection closed"
[DM_SESSION_E_CANT_MAKE_TEMP_CONNECTION]error: "Could not establish
an internal, temporary database connection (database_name = ,
docbase_owner = gdocum_u, connection_string = GDMDE1); database
system error was: ORA-01034: ORACLE not available ORA-27101: shared
memory realm does not exist SVR4 Error: 2: No such file or directory"

Al restablecerse la BBDD, CS muestra el siguiente mensaje:


[DM_SESSION_E_CANT_MAKE_TEMP_CONNECTION]error: "Could not establish
an internal, temporary database connection (database_name = ,
docbase_owner = gdocum_u, connection_string = GDMDE1); database
system error was: ORA-01033: ORACLE initialization or shutdown in
progress"

[DM_OBJ_MGR_E_CURSOR_FAIL]error:
"In operation Exec an attempt to
create cursor failed; query was: 'SELECT * FROM DM_DOCBASE_CONFIG_RV
CF_, DM_DOCBASE_CONFIG_SV BF_
WHERE (BF_.R_OBJECT_ID=:handle AND
BF_.R_OBJECT_ID=CF_.R_OBJECT_ID)
ORDER
BY
CF_.R_OBJECT_ID,CF_.I_POSITION'; error from database system was: ORA03113: end-of-file on communication channel"

Como consecuencia, content server queda en un estado inconsistente:


[DM_OBJ_MGR_E_FETCH_FAIL]error:
handle 3c019e2780000103 failed"

"attempt

to

[DM_SYSOBJECT_E_CANT_FETCH_INVALID_ID]error:
sysobject - Invalid object ID 3c019e2780000103"
Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

fetch

object

"Cannot

with

fetch

a
Pg.: 72 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
[DM_DCNFG_E_INVALID_SECURITY]error:
in dm_docbase_config."
[DM_OBJ_MGR_E_FETCH_FAIL]error:
handle 3d019e2780000905 failed"

"Invalid security mode '' found

"attempt

to

fetch

object

with

Causa: la BBDD deja de dar servicio.


Accin: La nica solucin posible pasa por eliminar todos los procesos de Content Server y levantar
servicios.

15.4.

ALMACENAMIENTO DE CORREOS ERRNEOS.

En los servidores de Content Server (TORRE, ELGURUGU) esta ejecutndose el proceso que se
encarga de recibir y enviar los correos entre el servidor de gestin documental y los usuarios.
A parte de los ficheros Logs propios de la aplicacin que se encuentran definidos en apartados
anteriores es muy importante monitorizar el siguiente directorio. G:\Producto\MessageStore.
Por debajo de este directorio encontramos la siguiente estructura:

En esta estructura se almacenan los correos recibidos que han generado error al iniciar El proceso de
Gestin de contratos y al iniciar el proceso de correspondencia entre usuarios.
Estos se identifican en la estructura de directorios con las siguientes rutas:
repro/tm_ajge_bpm_wf_exp/Recibe Solicitud para el proceso de inicio de contratacin y

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 73 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
repro/tm_ajge_bpm_wf_recepdoc/Receive
correspondencia.

Application

via

Email

para

el

proceso

de

Por debajo de esta estructura se encuentran los correos fallidos con sus adjuntos, El icono de correo se
identifica con un sobre y se editar con el cliente Outlook de Windows, La accin que deber realizarse
ser notificar al usuario de este hecho para que repita la operacin de envo de solicitud.

15.5. CAIDA DEL SERVICIO DE INDEXADO DE XPLORE QUE INHABILITA LAS


BSQUEDAS POR METADATO Y CONTENIDO
La configuracin actual del servicio de indexado, tal y como se ha visto, consiste en dos instancias
primarias de xPlore en servidores separados. Ambas instancias mantienen indexados los documentos
existentes del repositorio (contenido y metadatos) as como los nuevos documentos. Esta configuracin
de Alta Disponibilidad activo-pasivo permite que el servicio de indexado se mantenga en caso de error.
Para ello se debe aplicar un procedimiento que indica qu instancia es la que recibe las peticiones
enviadas por el aplicativo.
Cada instancia est representada en Documentum por un objeto dm_ftengine_config que a su vez
tiene asociado un objeto dm_fulltext_index, el cual contiene la configuracin de bsqueda por
contenido para dicha instancia.
Para obtener los ID de ambos objectos de indexacin por contenido, accedemos a DA >tools> DQL
Editor:

Se ejecuta la consulta:
select * from dm_ fulltext_index

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 74 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin

El atributo is_standby indica cul es la instancia en modo activo actualmente. Si el valor es 0, la


instancia est activa, en caso contrario su valor es 1.
En este caso, el nodo identificado como repro_ftindex_01 es el nodo primario. El nodo identificado
como repro_ftindex_INT_00 es el nodo secundario. Para proceder al cambio del nodo activo:

Caida/parada del nodo primario


o Ejecutar las siguientes consultas
update dm_fulltext_index object
index_name='repro_ftindex_01'
update dm_fulltext_index object
index_name='repro_ftindex_INT_00'
Caida/parada del nodo secundario
o Ejecutar las siguientes consultas
update dm_fulltext_index object
index_name='repro_ftindex_01'
update dm_fulltext_index object
index_name='repro_ftindex_INT_00'

set

is_standby=1

where

set

is_standby=0

where

set

is_standby=0

where

set

is_standby=1

where

Tras esto, reiniciar el content server primario y una vez arrancado reiniciar el content server secundario.
Para ms informacin, consultar los procedimientos descritos en los siguientes puntos del documento
TM_2016_Start&Stop_DCTM_Migracion_v1.0.doc:

Error: Reference source not found Parada del Content Server


Error: Reference source not found Arranque del Content Server

15.6. RECUPERACIN DE BPS EN CASO DE BLOQUEO DEL SERVICIO EN LOS DOS


NODOS
Documentum Process Integrator (BPS) est configurado en Alta Disponibilidad, desplegado en
los Tomcats de VALVERDE y PEZUELA. La Alta Disponibilidad de este componente es
Activo/Pasivo gestionado por el Content Server. El BPS principal est configurado en el Tomcat
de VALVERDE (bps1) y el que acta como pasivo es el BPS del Tomcat de PEZUELA (bps2).
Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 75 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
Cuando falla bps1, el Content Server inmediatamente configura a bps2 como servicio activo. En
el momento en que bps1 vuelve a estar disponible, ste pasar a ser nuevamente el servicio
activo, pasando bsp2 a modo pasivo. La siguiente DQL ejecutada en Documentum Administrator
dice cul es el nodo que est activo en cada momento (campo active_instance).

Cuando las solicitudes de contratacin no entren en el sistema, debern realizarse dos


comprobaciones:

Ejecutar la query anterior y ver el valor de active_instance


Ver los logs de ambos BPS ubicados en C:\Documentum\logs\bps.log en VALVERDE
y PEZUELA, respectivamente.

Si active_instance est vaco, indica que hay un problema en los dos servicios de BPS.
Adems si en los logs de ambos BPS encontramos la siguiente traza, indica que los servicios de
BPS no se ha recuperado de una cada en la conexin con el Content Server:
2016-07-12 15:03:51,310 ERROR [Timer-0] [com.documentum.bps.inbound.BPSInboundFramework] - Could not
reinitialize listener manager for docbase repro
DfDocbrokerException:: THREAD: Timer-0; MSG: [DFC_DOCBROKER_REQUEST_FAILED] Request to Docbroker
"torre.telemadrid.org:1489" failed; ERRORCODE: ff; NEXT: null
at com.documentum.fc.client.DfDocbrokerException.newRequestFailedException(DfDocbrokerException.java:12)
at com.documentum.fc.client.impl.connection.docbroker.DocbrokerConnection.<init>(DocbrokerConnection.java:30)
at
com.documentum.fc.client.impl.connection.docbroker.DocbrokerConnectionFactory.newDocbrokerConnection(Docbro
kerConnectionFactory.java:27)
at com.documentum.fc.client.impl.docbroker.MapBuilder.issueRequest(MapBuilder.java:27)
at com.documentum.fc.client.impl.docbroker.ServerMapBuilder.getDataFromDocbroker(ServerMapBuilder.java:76)
at com.documentum.fc.client.impl.docbroker.ServerMapBuilder.getMap(ServerMapBuilder.java:35)
at com.documentum.fc.client.impl.docbroker.DocbrokerClient.getServerMap(DocbrokerClient.java:152)
Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 76 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
at
com.documentum.fc.client.impl.connection.docbase.ServerChoiceManager.updateServerChoices(ServerChoiceMana
ger.java:159)
at
com.documentum.fc.client.impl.connection.docbase.ServerChoiceManager.updateServerChoicesIfNecessary(Server
ChoiceManager.java:150)
at
com.documentum.fc.client.impl.connection.docbase.ServerChoiceManager.getServerChoices(ServerChoiceManager.j
ava:47)
at
com.documentum.fc.client.impl.connection.docbase.DocbaseConnection.getServerChoices(DocbaseConnection.java:
273)
at
com.documentum.fc.client.impl.connection.docbase.DocbaseConnection.establishNewRpcClient(DocbaseConnection
.java:227)
at com.documentum.fc.client.impl.connection.docbase.DocbaseConnection.open(DocbaseConnection.java:126)
at com.documentum.fc.client.impl.connection.docbase.DocbaseConnection.reopen(DocbaseConnection.java:564)
at
com.documentum.fc.client.impl.connection.docbase.DocbaseConnection.evaluateRpc(DocbaseConnection.java:1112)
at
com.documentum.fc.client.impl.connection.docbase.DocbaseConnection.applyForBool(DocbaseConnection.java:1190
)
at com.documentum.fc.client.impl.connection.docbase.DocbaseConnection.apply(DocbaseConnection.java:1175)
at com.documentum.fc.client.impl.docbase.DocbaseApi.beginTrans(DocbaseApi.java:1749)
at com.documentum.fc.client.impl.connection.docbase.DocbaseConnection.begin(DocbaseConnection.java:781)
at com.documentum.fc.client.impl.session.Session.begin(Session.java:456)
at com.documentum.fc.client.impl.session.Session.beginTrans(Session.java:422)
at com.documentum.fc.client.impl.session.SessionHandle.beginTrans(SessionHandle.java:601)
at com.documentum.bps.inbound.DocbaseListenerManager.startUp(DocbaseListenerManager.java:124)
at
com.documentum.bps.inbound.BPSInboundFramework.reinitDocbaseListenerManager(BPSInboundFramework.java:
197)
at com.documentum.bps.inbound.BPSInboundFramework.reInitLsnrMgr(BPSInboundFramework.java:180)
at com.documentum.bps.inbound.BPSInboundFramework.access$000(BPSInboundFramework.java:22)
at com.documentum.bps.inbound.BPSInboundFramework$1.run(BPSInboundFramework.java:211)
at java.util.TimerThread.mainLoop(Unknown Source)
at java.util.TimerThread.run(Unknown Source)
Caused by: DfIOException:: THREAD: Timer-0; MSG: [DM_SESSION_E_RPC_ERROR]error:
"Server
communication failure"; ERRORCODE: 100; NEXT: null
at com.documentum.fc.client.DfIOException.newCommunicationFailureException(DfIOException.java:16)
at
com.documentum.fc.client.impl.connection.docbroker.netwise.NetwiseDocbrokerRpcClientFactory.newDocbrokerRpc
Client(NetwiseDocbrokerRpcClientFactory.java:45)
at com.documentum.fc.client.impl.connection.docbroker.DocbrokerConnection.<init>(DocbrokerConnection.java:25)
... 27 more
Caused by: java.io.IOException: DFC_DOCBROKER_EXCLUDED
at
com.documentum.fc.client.impl.connection.docbroker.netwise.NetwiseDocbrokerRpcClientFactory.connect(NetwiseDo
cbrokerRpcClientFactory.java:127)
at
com.documentum.fc.client.impl.connection.docbroker.netwise.NetwiseDocbrokerRpcClientFactory.openSocket(Netwis
eDocbrokerRpcClientFactory.java:77)
at
com.documentum.fc.client.impl.connection.docbroker.netwise.NetwiseDocbrokerRpcClientFactory.newDocbrokerRpc
Client(NetwiseDocbrokerRpcClientFactory.java:41)
... 28 more

En caso de encontrarnos en este caso de que ambos BPS estn fallando, se recuperar el
servicio con los siguientes pasos:

Parar y arrancar posteriormente el Tomcat del nodo NO activo en el balanceador (NBL)

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 77 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin

Configurar el NBL para que el nodo activo pase a ser el que se ha iniciado en el punto
anterior
Parar y arrancar posteriormente el otro Tomcat que ahora est como NO activo en el
balanceador (NBL).
En un navegador comprobar que ambos BPS han arrancado correctamente:
o http://valverde.telemadrid.org:8080/bps/inbound_details.jsp
o http://pezuela.telemadrid.org:8080/bps/inbound_details.jsp
Ejecutar la DQL indicada al inicio de este punto y comprobar que se obtiene el
siguiente resultado

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 78 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
16.

EJECUCIN DE BSQUEDAS EN DOCUMENTUM XPLORE


La migracin de la plataformal documental de Telemadrid a la versin de Documentum 7.2,
requiere la instalacin de un nuevo indexador de contenidos que sustituye al antiguo
Documentum Fast Index Server, que ya dej de estar soportado, adems de no ser compatible
con las ltimas versiones de Documentum.
Este nuevo servidor de indexacin es Documentum xPlore. La versin instalada en Telemadrid
es la versin 1.4. No se ha optado por la versin ms actual (1.5) porque esta versin
presentaba un problema de indexacin en gran parte de los documentos PDF que Telemadrid
tiene en la Aplicacin de Asesora Jurdica. El ndice de contenidos generado aada un espacio
en blanco entre caracteres, haciendo inviable la bsqueda por contenido. En la versin 1.4 no
se presenta este problema y por lo tanto, hasta un prximo arreglo del problema en versiones
posteriores de Documentum xPlore, sta ser la versin desplegada.
Documentum xPlore presenta adems diferencias con su antecesor en cuanto al modo en el
que realiza las bsquedas y presenta los resultados a los usuarios finales de la aplicacin. A
continuacin, se presentan estos cambios para que los usuarios sean conscientes de estas
modificaciones y puedan aplicarlas en su trabajo diario con la Aplicacin de Asesora Jurdica:

xPlore tiene configurado el operador lgico AND si al buscar por contenido se incluyen
dos o ms palabras. Fast Index Server realizaba las bsquedas con el operador OR.
Ejemplo: El usuario introduce en la caja de texto de bsqueda empresa contrato.
xPlore devolver aquellos documentos cuyo contenido contenga, al menos una vez, las
palabras empresa y contrato.

xPlore permite la bsqueda de un conjunto de palabras en el orden especificado por el


usuario en la caja de texto de bsqueda. Para ello hay que entrecomillar (dobles
comillas) las palabras en cuestin.
Ejemplo: El usuario introduce en la caja de texto la empresa contratada. xPlore
devolver todos aqullos documentos en los que aparezca, al menos una vez, la
cadena de texto la empresa contratada.

xPlore realiza bsquedas por palabras completas, por lo que se si quiere buscar por
partes de una palabra hay que utilizar los llamados wildcards. xPlore permite los
siguientes wildcards:
o
o

* sustituye a uno o ms caracteres y puede ser usado al principio, en


medio o al final de una palabra
? sustituye a un nico carcter y puede ser usado al principio, en medio o
al final de una palabra

xPlore sustituye por espacio en blanco los siguientes caracteres especiales: @#$
%^_~&:.()-+=<>/\[]{}
Ejemplo: Si en la bsqueda el usuario escribe en la caja de texto S-062016-A, la
bsqueda que realizar xPlore ser S 2016 A; es decir, buscar aquellos documentos
que contengan al menos una vez, una S sola, una A sola y 2016.

Fecha de creacin: 13/07/2016

Ref.: 327481269.doc

Pg.: 79 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin
Esta opcin es configurable, pudiendo excluir caracteres especiales de esta
funcionalidad.
La
configuracin
se
realiza
en
el
fichero
F:\xPlore\config\indexserverconfig.xml, requiriendo despus una reindexacin completa
de todo el contenido (Apartado 10.6 de este documento).

16.1.

BSQUEDAS POR METADATOS ESPECFICOS DE APLICACIONES


Para evitar que xPlore incluya en las bsquedas por contenido los valores guardados en los
metadatos de los documentos, se configur el servidor de indexacin para que excluyera a los
metadatos de la bsquedas.
Sin embargo, por requerimientos de las aplicaciones de Telemadrid, es necesario que ciertos
metadatos s qu estn disponibles para poder filtrar por ellos en las bsquedas. A continuacin
se listan estos metadatos y en las aplicaciones en las que son utilizados. Estas configuraciones
se realiza en el fichero indexserverconfig.xml de xPlore:

Losantos.telemadrid.org \\Dctmis\discof\losantos\config\indexserverconfig.xml
Baztan.telemadrid.org \\Dctmis\discof\baztan\config\indexserverconfig.xml

16.1.1. APLICACIN DE ASESORA JURDICA


Tipo tm_ajge_td_documctos
o
o
o

Nombre del documento (object_name)


Tipo de documento (tm_s_i_attr_tipodoc)
Subtipo de documento (tm_s_i_attr_subtipodoc)

16.1.2. APLICACIN DE FACTURAS


Tipo tm_fac_td_factura
o
o
o
o
o
o
o
o

Sociedad (attr_s_s_sociedad)
Ao factura (attr_s_s_anyo)
Proveedor (attr_s_s_sellcorpname)
Nombre documento (attr_s_s_idfinanciero)
Uusario creador (attr_s_s_creador)
Clase documento (attr_s_s_tipodoc)
Mes factura (attr_s_s_mes)
Identificador de factura (attr_s_s_batchid)

16.1.3. APLICACIN DE DIAPOSITIVAS


Tipo tm_gfd_fotografia
o
o

Tipo tm_gfd_programa
o

Fecha de creacin: 13/07/2016

Nombre del documento (object_name)


Personajes (attr_s_r_personajes)
Nombre del documento (object_name)
Ref.: 327481269.doc

Pg.: 80 / 81

Servicio de Gestin de Aplicaciones


Documento de Explotacin

Tipo tm_gfd_temporada
o

Fecha de creacin: 13/07/2016

Nombre del documento (object_name)

Ref.: 327481269.doc

Pg.: 81 / 81

You might also like