Instalación y Configuración FOREST BPMS

Ambiente de Preproducción

Contraloria de Bogotá – Macro Proyectos

Febrero de 2018
Tabla de contenido
1. INTRODUCCIÓN .......................................................................................................................... 4
2. RUTAS DE INSTALACIÓN: ............................................................................................................ 4
2.1. Servidor de Aplicaciones .................................................................................................... 4
2.2. Servidor Web ...................................................................................................................... 4
2.3. Servidor Base de Datos:...................................................................................................... 5
3. CONFIGURACIONES JBOSS ......................................................................................................... 5
3.1. Configuración de Java ......................................................................................................... 5
3.1.1. JAVA_HOME................................................................................................................ 5
3.1.2. JBOSS_HOME .............................................................................................................. 5
3.1.3. Conexiones a Base de Datos....................................................................................... 6
3.1.4. Configuraciones de Memoria ..................................................................................... 6
3.1.5. Usuarios y Contraseñas Base de Datos: ..................................................................... 7
3.1.6. Nombre de Contexto Principal ................................................................................... 8
3.2. Configuraciones de Base de Datos ..................................................................................... 8
3.2.1. Creación de usuarios en el servidor base de datos: .................................................. 8
3.3. Configuraciones Servidor Web ......................................................................................... 11
3.3.1. Ruta de instalación ................................................................................................... 11
3.3.2. Directorio de Publicaciones ...................................................................................... 11
3.3.3. Contextos de Aplicaciones ....................................................................................... 11
3.3.4. Nombre del Servidor ................................................................................................ 12
4. SUBIDA DE SERVICIOS............................................................................................................... 13
4.1. Inicio de Base de Datos .................................................................................................... 13
4.2. Inicio de Servidor Web ..................................................................................................... 13
4.3. Iniciar Servidor de Aplicaciones: ...................................................................................... 14
5. CONFIGURACIONES FOREST BPMS .......................................................................................... 14
5.1. Configuraciones dentro de FOREST.................................................................................. 14
5.2. Configuraciones en Base de Datos ................................................................................... 15
5.3. Configuraciones en Apache .............................................................................................. 16
6. URLS DE APLICACIÓN ................................................................................................................ 16
7. EVIDENCIAS DE FUNCIONAMIENTO ......................................................................................... 17
7.1. Cargue del entorno y autenticación:................................................................................ 17
7.2. Descarga y Ejecución Notificador:.................................................................................... 17
7.3. Cargue de Reportes: ......................................................................................................... 17
7.4. Impresión (virtual) de Rotulo ........................................................................................... 18
7.5. Búsqueda de Radicados.................................................................................................... 18
 1. INTRODUCCIÓN
El día 16 de febrero del año 2018 la Contraloría de Bogotá solicita la instalación del ambiente
de preproducción. Este entorno se instalará con una copia del entorno de producción a
fecha de corte 09/02/2018. Se instalará sobre el servidor con IP: 192.168.120.43,
Hostname: ARANDA_PRU.
Este servidor hará de Servidor de Aplicaciones, Servidor Web y Servidor de Base de datos al
mismo tiempo.
Las características de Hardware de este servidor son:
Memoria RAM: 16384MB
Procesador: Intel Xeon E312xx (Sandy Bridge) (4 CPUs) – 2.4GHz
Almacenamiento: Unidad SO (C: ) 79.6 GB – Unidad Filesystem (E: ) 1.95TB

Los requisitos de software necesarios para el correcto funcionamiento de FOREST BPMS

son:
Servidor de Aplicaciones: JBoss AS 7.2
Servidor Web: Apache HTTP Server Versión 2.2
Base de datos: Microsoft SQL Server 2012 (SP4) Enterprise Edition
Java: Oracle Java JDK 1.7

2. RUTAS DE INSTALACIÓN:
La entidad se encargó de realizar la restauración de los componentes necesarios para el
correcto funcionamiento de FOREST BPMS en las siguientes rutas:
2.1. Servidor de Aplicaciones
Ruta de Instalación $JBOSS_HOME: E:\Jboss_SIGESPRO\jboss7_2
2.2. Servidor Web
Ruta de Instalación $APACHE_HOME:
E:\ApacheProd_SIGESPRO_SIVICOF\Apache2.2\htdocs
 2.3. Servidor Base de Datos:
Nombre Base de Datos: SIGESPRO
Usuario Administrador: sa
Contraseña Administrador: Contraloria2014

3. CONFIGURACIONES JBOSS
Las siguientes son las configuraciones que se tienen que hacer en el servidor de aplicaciones
JBoss para el correcto funcionamiento de FOREST BPMS. Como el JBoss se encuentra
instalado en modo dominio las configuraciones se realizarán en los siguientes archivos con
sus respectivas rutas de ubicación:
- domain.conf.bat: E:\Jboss_SIGESPRO\jboss7_2\bin
- domain.xml: E:\Jboss_SIGESPRO\jboss7_2\domain\configuration
- host.xml: E:\Jboss_SIGESPRO\jboss7_2\domain\configuration
Nota:
- Estos archivos deben ser editados con un editor de texto avanzado (recomendado Notepad++).
- Cada configuración que se realice en uno de estos archivos requiere un reinicio del servidor de aplicaciones.

3.1. Configuración de Java

Como la copia se realizó desde un entorno clonado (entorno de producción) este ya está
configurado con algunas rutas predefinidas.
3.1.1. JAVA_HOME
Una de estas es la ruta de instalación de JAVA, lo que se conoce como JAVA_HOME. En el
archivo domain.conf.bat se debe realizar esta edición en donde se debe ubicar la línea set
"JAVA_HOME y editarla con la ruta de instalación del JDK de Java:
ANTES:

DESPUES:

3.1.2. JBOSS_HOME
JBOSS_HOME es la variable de entorno que indica la ruta de instalación base del servidor
de aplicaciones JBoss, esta configuración se realiza también en el archivo domain.conf.bat
donde se debe ubicar la línea set “JBOSS_HOME y editarla con la ruta de instalación del
JBoss:
ANTES:

DESPUES:

3.1.3. Conexiones a Base de Datos

Con el fin de evitar que el servidor de aplicaciones se conecte a la base de datos del entorno
de producción se realiza la recomendación de colocar una regla en el firewall para evitar
que las IP’s del servidor de preproducción puedan verse con los servidores de
preproducción. Esto con el fin de que ninguna conexión se realice desde Pre Producción a
Producción. Al mismo tiempo se realiza la configuración de la conexión a la base de datos,
esta configuración se realiza en el archivo domain.xml, se debe ubicar el subsistema de Base
de Datos <datasource> y por cada datasource que exista se debe editar la línea
<connection-url> con la dirección IP y el puerto listener de la base de datos del servidor de
preproducción, como FOREST BPMS requiere de 3 datasources, esta configuración se realiza
esa misma cantidad de veces y como el servidor de base de datos está en el mismo servidor
de aplicaciones debe quedar como localhost.
ANTES:

DESPUES:

3.1.4. Configuraciones de Memoria

Los recursos de hardware del entorno de producción son superiores al entorno de
preproducción por lo tanto hay que reducir el uso que el JBoss le puede dar a estos recursos,
especialmente en la memoria RAM, esta configuración se debe realizar en el archivo
host.xml donde se debe ubicar la línea <server name="forestX" donde X hace referencia al
número de instancias del servidor de aplicaciones, como se tienen instaladas 5 instancias la
siguiente configuración se debe realizar esa misma cantidad de veces, en donde dentro de
la etiqueta <server name=”forestx” se debe ubicar la etiqueta <heap size="x1g" max-size="
x2g"/> donde x1 es el tamaño mínimo de memoria que usará la instancia en GB y x2 es el
máximo de memoria que usará la instancia en GB. La configuración puede también ser
configurada en MB con la letra m y queda de la siguiente manera:
ANTES:

DESPUES:

3.1.5. Usuarios y Contraseñas Base de Datos:

La creación de los nuevos usuarios y contraseñas se detalla en el numeral 3.2.1. Los usuarios
que se crearon para la aplicación fueron:

Usuario Contraseña
forestpre f0r3st
quartzpre qu4rtz
rptpre rpt

Para que el servidor de aplicaciones tome los nuevos usuarios y contraseñas se debe editar
el archivo domain.xml donde nuevamente se deben ubicar la etiqueta <datasource> y para
cada uno de estos ubicar la etiqueta <username> y <password> donde se deben cambiar
los usuarios y contraseñas por los de la tabla anterior.
 3.1.6. Nombre de Contexto Principal
Al entorno de producción se accede a FOREST BPMS a través de la URL
http://sigespro.contraloriabogota.gov.co/forest al entorno de pruebas a través de la URL
http://sigespro.contraloriabogota.gov.co/forestPruebas estos nombres que van después
del dominio de la entidad se llaman contexto de la aplicación, como es un entorno copia de
producción, el contexto quedó como forest, para preproducción quedará forestPre. Para
realizar esto se debe editar el archivo domain.xml y ubicar las líneas:
<property name="xxxx.jndi"
<property name="xxxx.engine"
<property name="xxxx.quartz.jndi"
<property name="xxxx.quartz.engine”

Donde xxxx hace referencia al nombre que se le dejará a la aplicación, en este caso
forestPre:

ANTES:

DESPUES:

3.2. Configuraciones de Base de Datos

La restauración del backup completo de la base de datos del entorno de producción se
realizó sobre un servidor nuevo, es por esto que este servidor no tiene los mismos usuarios
que tiene la base de datos de producción, inicialmente se crean los usuarios y estos se ligan
a una base de datos, en este caso ya hay unos usuarios ligados a la base de datos pero no
hay usuarios con los cuales hacer login en el motor de la base de datos.
3.2.1. Creación de usuarios en el servidor base de datos:
Cuando se habla de servidor de base de datos se habla del motor, distinto a las bases de
datos que es donde se almacena la información, como se mencionó anteriormente hay unos
usuarios creados en la base de datos pero ninguno creado en el motor, por eso es que hay
que crear usuarios en el motor y ligarlos a los usuarios en la base de datos, esto se realiza a
través del software SQL Server Management Studio de la siguiente manera:
 - Se realiza login en la base de datos:

- Si la autenticación es correcta en la parte izquierda se visualizará la conexión:

- Se expande la carpeta “Security”

- Clic derecho a la carpeta Logins > New Login y se diligenciará el formulario de la
siguiente manera para el primer usuario “forestpre” :

Esto mismo se realiza para cada uno de los tres usuarios requeridos por la aplicación:
forestpre, rptpre y quartzpre en donde el último pantallazo cambia el esquema por
defecto por forest, rpt y quartz respectivamente
 3.3. Configuraciones Servidor Web
El servidor Web es Apache HTTP Server en su versión 2.2. Las configuraciones que se deben
realizar en este servidor web se hacen sobre el siguiente archivo
- httpd.conf: E:\ApacheProd_SIGESPRO_SIVICOF\Apache2.2\conf
Nota:
- Este archivo debe ser editado con un editor de texto avanzado (recomendado Notepad++).
- Cada configuración que se realice en este archivo requiere un reinicio del servidor web.

3.3.1. Ruta de instalación

Como es una copia del servidor web de producción, la ruta de instalación cambia con el
servidor de preproducción, para ajustar esta ruta debe editarse el archivo httpd.conf y
ubicar la línea ServerRoot, donde se edita de la siguiente manera:
ANTES:

DESPUES:

3.3.2. Directorio de Publicaciones

Al igual que la ruta de instalación, la ruta de publicaciones cambia con el servidor de
preproducción, para ajustar esta ruta debe editarse el archivo httpd.conf y ubicar la línea
DocumentRoot, donde se edita de la siguiente manera:
ANTES:

DESPUES:

3.3.3. Contextos de Aplicaciones

Como se mencionó en el numeral 3.1.6. el contexto de las aplicaciones es el nombre con el
cual se accederá a ellas a través de una URL, como el servidor web hace las veces de
balanceador, hay que editar las IP’s y los nuevos nombres de los contextos para que el
servidor web haga correctamente el re direccionamiento al servidor de aplicaciones. Esta
configuración se realiza en el archivo httpd.conf donde se eliminan los contextos de la
aplicación STORM y forestPruebas y forestDesarrollo para dejar únicamente los nuevos de
forestPreproduccion, luego se buscan las líneas ProxyPass /xxxxx ajp://xx.xx.xx.xx donde
xxxxx hace referencia al nombre de los contextos y xx.xx.xx.xx hace referencia a la IP donde
se realizarán los re direccionamientos, si el servidor de aplicaciones estuviera en otra
máquina distinta al servidor de producción esa IP iría allí pero como todo está instalado en
el mismo servidor se usará la dirección de loopback (127.0.0.1):
ANTES:

DESPUES:

3.3.4. Nombre del Servidor

El nombre del servidor hace referencia al hostname con el que apache identificará a la
máquina, es otra configuración que se trae del servidor de producción y para cambiarla es
necesario ubicar en el archivo httpd.conf la línea ServerName y editarla con el hostname de
la máquina:
ANTES:

DESPUES:
 4. SUBIDA DE SERVICIOS
Para arrancar los servicios y que FOREST BPMS quede funcional se deben arrancar los
servicios en el siguiente orden:
- Iniciar Base de Datos.
- Iniciar Servidor Web.
- Iniciar Servidor de Aplicaciones.

4.1. Inicio de Base de Datos

Para iniciar el servicio de base de datos, se debe ubicar en los servicios de Windows el
servicio SQL Server (SIGESPRO_2) e iniciarlo, se recomienda dejar el inicio de este servicio
automático para que en caso de un reinicio de la máquina, este suba con todos los servicios
base de Windows.

4.2. Inicio de Servidor Web

Para iniciar el servicio de Apache se debe ubicar en la ruta de instalación de apache y luego
en la carpeta bin, allí se debe ejecutar el archivo httpd.exe y se ejecutará una consola de
comandos que en caso de errores se cerrará automáticamente y en caso de que esté todo
correcto se quedará estática allí mismo sin mostrar nada:
Nota:
- En el escritorio del servidor queda un acceso directo para ejecutar el Apache:

4.3. Iniciar Servidor de Aplicaciones:

Para arrancar el JBoss hay que ubicarse en la carpeta de instalación, luego en la carpeta bin
y ejecutar el archivo domain.bat. Se abrirá otra ventana de comandos (cmd) en donde se
irán mostrando los logs de la aplicación:

Nota:
- En el escritorio del servidor queda un acceso directo para ejecutar el JBoss:

5. CONFIGURACIONES FOREST BPMS

Para que FOREST BPMS funcione correctamente hay que editar algunas propiedades para
identificar que el entorno es un entorno de preproducción, es decir editar nombres de
propiedades, IP’s rutas, entre otros.

5.1. Configuraciones dentro de FOREST

Esto se realiza en el módulo sistema > pestaña propiedades forest en donde las
propiedades a editar son:
 NOMBRE DESCRIPCIÓN VALOR ANTIGUO NUEVO VALOR
PROPIEDAD
contact.postdata Texto que se enviara cada vez que Vacío ESTE ES UN
el sistema envíe un correo CORREO DE
PRUEBA FAVOR
HACER CASO
OMISO
downloads.BPMSCo Ruta de descarga del componente http://sigespro.contral http://192.168.12
mponents de word oriabogota.gov.co/des 0.43/descargas/Fo
cargas/Forest_BPMS_C rest_BPMS_Comp
omponents.4.0.5.exe onents.4.0.5.exe

downloads.notifyjnl Ruta de descarga del notificador http://sigespro.contral http://192.168.12

p oriabogota.gov.co/des 0.43/descargas/fo
cargas/forestNotify/no restNotify/notify.j
tify.jnlp nlp
downloads.scanner Ruta de descarga del escáner http://sigespro.contral http://192.168.12
oriabogota.gov.co/des 0.43/descargas/Fo
cargas/ForestScanner_ restScanner_4.0.5.
4.0.5.exe exe
forest.reports.server URL del administrador de reportes http://sigespro.contral http://192.168.12
Rpt oriabogota.gov.co/fore 0.43/forestReport
stReports s
FORESTMSG.register URL’s que se involucran en el 127.0.0.1,localhost,sig 127.0.0.1,localhos
Host sistema espro.contraloria.gov.c t,192.168.120.43,s
o,192.168.120.12,192. igespro.contralori
168.120.13 abogota.gov.co
help URL de ayuda base de forest http://sigespro.contral http://192.168.12
oriabogota.gov..co/ayu 0.43/ayuda/help.j
da/help.jsp sp
SERVERMENSAJESU URL + path de servicios del http://192.168.120.13: http://192.168.12
RL.server2 servidor de mensajes 18080/ForestMSG/serv 0.43:18080/Forest
ices/notify MSG/services/noti
fy
FORESTMSG.forestEJ Contexto de forest forest forestPre
BForestContext
Nota:
- Cada configuración que se realice en forest requiere un reinicio del servidor de aplicaciones.

5.2. Configuraciones en Base de Datos

En base de datos se debe configurar el apuntamiento de los reportes, estas propiedades

se ubican en la tabla RPT.DEF_PROPERTIES, los registros son:

PROPIEDAD DESCRIPCIÓN VALOR ANTIGUO NUEVO VALOR

reporteador.folde Filesystem de reportes C:\MacroProyectos\r E:\filesystem_re
rbase eportes portes
 reporteador.url URL del administrador de http://sigespro.contr http://192.168.1
reportes aloriabogota.gov.co/ 20.43/forestRep
forestReports orts
Nota:
- Cada configuración que se realice en base de datos requiere un reinicio del servidor de aplicaciones.

5.3. Configuraciones en Apache

Las configuraciones del apache son aquellas que se le aplican al componente de FOREST
NOTIFY para que apunte al nuevo entorno, estos ajustes se hacen en el archivo notify.jnlp
que debe ser editado con un editor de texto avanzado, este archivo se encuentra ubicado
en la ruta: E:\ApacheProd_SIGESPRO_SIVICOF\Apache2.2\htdocs\descargas\forestNotify
las propiedades dentro de este archivo a editar son:

ANTES:

----------------

----------------

DESPUES:

----------------

----------------

6. URLS DE APLICACIÓN

APLICACION URL
FOREST PREPRODUCCION http://192.168.120.43/forestPre
FOREST REPORTS PREPRODUCCION http://192.168.120.43/forestReports
SERVIDOR DE MENSAJES PREPRODUCCION http://192.168.120.43 /ForestMSG/
WEBFILE PQRS PREPRODUCCION http://192.168.120.43/webfilePQRS/
7. EVIDENCIAS DE FUNCIONAMIENTO

7.1. Cargue del entorno y autenticación:

7.2. Descarga y Ejecución Notificador:

7.3. Cargue de Reportes:

7.4. Impresión (virtual) de Rotulo

7.5. Búsqueda de Radicados