sistema nacional de información básica en materia de salud

Manual de Instalación Modalidad Fuera de Línea

Sistema Nacional de Información Básica en Materia de Salud



Versión 1.3

Página 2 de 16

Control de cambios

Elabora Revisa Autoriza Fecha de cambio

Páginas afectadas

Cambio Versión

Ing. Federico Cárdenas Peña, Coordinador de Proyectos

Ing. Ernesto Aguirre Sobrevilla, Director de Tecnologías de Información y Comunicaciones


27/03/2017 Todo del

documento Creación del documento. 1.0




30/03/2017 Todo del

documento Ajustes de contenido y forma.

1.1



Dr. Alejandro Ledesma Zarate, Director de Planeación

21/04/2017 4,5

En requerimientos de instalación se específica Win XP como versión mínima del sistema operativo y Win XP o superior como la deseable.

1.2




21/04/2017 7

El Título ‘6.1.1 Configuración de nodos no conectados a red’ se remplaza por ‘6.1.1 Configuración en computadoras independientes’, y el título ‘6.1.2 Configuración de nodos conectados en red’ cambia a ‘6.1.2 Configuración en computadoras conectadas en red’. En punto 6.1.2 se amplía explicación de lo que es instalar el sistema en computadoras aisladas.

1.2




21/04/2017 11

En punto 6.1.2 se amplía explicación acerca de lo que es instalar el sistema en ambiente cliente – servidor.

1.2




21/04/2017 12

En el paso 3 se especifica procedimiento para modificar el archivo de configuración de actualizaciones.

1.2




21/04/2107 12

En el punto ‘7 Cliente de actualizaciones’ se especifica lo que es un nodo de actualizaciones.

1.2



Versión 1.3

Página 3 de 16

Elabora Revisa Autoriza Fecha de cambio

Páginas afectadas

Cambio Versión



06/11/2017 5

Se aclara en el punto “1. Introducción” la situación de instalar el sistema en una sola computadora para operar como servidor, o bien en uno solo dadas las limitaciones de red

1.3



06/11/2017 5 y 6

Se agrega a los requerimientos, punto ‘4. Capítulo I. Requerimientos tecnológicos’, el uso del navegador Google Chrome

1.3



06/11/2017 13 y 14

Se detalla en el punto ‘6.1.2 Configuración de computadoras conectadas en red’ la configuración del sistema en dos servidores diferentes, uno para base de datos y otro para la publicación del sistema

1.3



Versión 1.3

Página 4 de 16

Índice 1. Introducción................................................................................................................................................................ 5

2. Objetivo ...................................................................................................................................................................... 5

3. Alcance ........................................................................................................................................................................ 5

4. Capítulo I. Requerimientos tecnológicos .................................................................................................................... 5

5. Capítulo II. Contenido del material de instalación ..................................................................................................... 6

6. Instalación del sistema ............................................................................................................................................... 8

6.1 Modalidades Fuera de Línea / Híbrida ................................................................................................................... 8

6.1.1 Configuración en computadoras independientes .............................................................................................. 8

6.1.2 Configuración de computadoras conectadas en red ........................................................................................ 12

7. Cliente de actualizaciones ........................................................................................................................................ 14

8. Material y documentos de referencia ...................................................................................................................... 16



Versión 1.3

Página 5 de 16

1. Introducción

La Modalidad Fuera de Línea / Híbrida consiste en operar SINBA en varias computadoras configuradas en una red local, donde una funciona como servidor y los demás están enlazadas como clientes, o bien, por limitaciones de la red en una computadora funciona tanto el cliente como el servidor. La modalidad demanda un proceso posterior de la importación de información capturada para su correspondiente integración a la plataforma en línea.

2. Objetivo

Elaborar a partir de los recursos entregados por la Dirección General de Información en Salud de la Secretaría de Salud Federal, acerca de la Plataforma tecnológica para la conformación del Sistema Nacional de Información Básica en Materia de Salud (SINBA), el documento para el despliegue de dicho sistema bajo las modalidades fuera de línea e híbrida en las Unidades Médicas de la Secretaría de Salud del Estado de Guanajuato.

3. Alcance Este manual aporta los elementos necesarios para instalar en los equipos del ISAPEG que cumplan con los requerimientos tecnológicos para operar SINBA en las modalidades Fuera de Línea e Híbrida.

4. Capítulo I. Requerimientos tecnológicos Para instalar SINBA en equipos no conectados en red (Modalidad Fuera de Línea):

Equipo

Requerimientos técnicos1

Hardware / Software Internet

Mínimos Deseables Mínima Deseable

Cliente / Servidor

CPU Pentium Dual Core o similar Core i5 o similar

Sin conexión / 2 MBPS


RAM 4 GB 6 GB

DD 15 GB 25 GB

SO Windows XP Windows XP o superior

Navegador FireFox, Chrome FireFox, Chrome

1 Requerimientos técnicos emitidos por la Dirección General de Información en Salud

Internet

Configuración de usuarios

estatales

Instalación versión fuera

de línea

Captura fuera de línea

Exportación de la

información

Registro en formatos

Carga de la información

Validación de la

información

Consulta de la estadística



Versión 1.3

Página 6 de 16

Para instalar SINBA en equipos conectados en red (Modalidades Fuera de Línea / Híbrida):

Equipo

Requerimientos técnicos2

Hardware / Software Internet

Mínimos Deseables Mínima Deseable

Cliente

RAM 512 MB 1 GB

No aplica No aplica SO Windows XP Windows XP o superior

Navegador FireFox, Chrome FireFox, Chrome

Servidor (1 a 10 usuarios)

CPU 2vCPU 2vCPU



RAM 4 GB 8 GB

DD 50 GB 50 GB

Servidor (11 a 50 usuarios)

CPU 4vCPU 4vCPU

RAM 8 GB 16 GB

DD 100 GB 150 GB

5. Capítulo II. Contenido del material de instalación El paquete para la instalación de nodos fuera de línea se distribuye mediante archivo comprimido ‘HDK-CONTAINER.zip’, mismo que considera los siguientes elementos de interés para la funcionalidad del despliegue de la aplicación:

HDK-CONTAINER\ |____ bin |____ config |____ database |____ download |____ java |____ logs |____ server |____ temp |____ update |____ update-center bin. Contiene los ejecutables que gestionan el despliegue del motor de base de datos, generación de archivos

de intercambio para contenido de base de datos, importación de contenido de base de datos y el despliegue de la aplicación web.

bin\ |___ 0_runDatabaseServer.bat |___ 0_runDatabaseServer.sh |___ 1_generateChangeLog.bat

2 Requerimientos técnicos emitidos por la Dirección General de Información en Salud



Versión 1.3

Página 7 de 16

|___ 1_generateChangeLog.sh |___ 2_importChangeLog.bat |___ 2_importChangeLog.sh |___ 3_runHttpServer.bat |___ 3_runHttpServer.sh |___ ehcos-updater-client.bat |___ ehcos-updater-client.sh |___ README.txt

Los archivos con extensión ‘.bat’ se ejecutan en sistemas operativos Windows, y los archivos con extensión ‘.sh’ se ejecutan en sistemas operativos Linux. La secuencia de ejecución se especifica en puntos siguientes del documento.

config. Contiene las propiedades de la aplicación web que se despliega en el nodo. config\ |___ peiis.properties |___ peiis-log4j.xml

Estos archivos se configuran para cumplir con las reglas de distribución y asignación de nodos en la red de salud entre otros elementos claves del despliegue. Debe ser editado con conocimientos de causa o la aplicación no iniciará en el nodo.

database. Contiene el motor de base de datos.

database\ |___ hsqldb Estos contenidos no deben ser accedidos ya que se gestionan desde los ejecutables correspondientes de la carpeta ‘bin’.

download. Contiene los archivos de actualización descargados. java. Contiene la máquina virtual de java que será desplegada en el nodo.

java\ |___ windows Estos contenidos no deben ser accedidos. La máquina virtual ya se encuentra referenciada en el archivo ‘HDK-CONTAINER/server/apache-tomcat/bin/setenv.bat’.

logs. Aquí se almacenan los archivos de log que genera la aplicación web. server. Contiene el servidor de la aplicación web.



Versión 1.3

Página 8 de 16

server\ |___ apache-tomcat Estos contenidos no deben ser accedidos a menos que se desee alterar el comportamiento del servidor web.

temp. Almacena los elementos temporales utilizados en los periodos de actualización de la aplicación del nodo.

update. Contiene el archivo ‘update.xml’ que será utilizado para actualizar la aplicación del nodo.

update-center. Contiene la aplicación que realizará el proceso de actualización del nodo.

6. Instalación del sistema

6.1 Modalidades Fuera de Línea / Híbrida

6.1.1 Configuración en computadoras independientes

En seguida se explican los pasos para la configuración de nodos no configurados en red, es decir, computadoras aisladas a las cuales deberá instalárseles los servicios de base de datos y de publicación del sistema para la captura de información. Paso 1. Identificar la arquitectura del sistema operativo (32 o 64 bits) de la computadora a configurar como cliente y servidor; con base a ello utilizar el archivo de instalación correspondiente.

Paso 2. Descomprimir el archivo ‘HDK-CONTAINER.zip’ en el directorio raíz del disco duro (‘c:\’) para evitar conflictos.

Paso 3. Configurar las propiedades del nodo especificando el número de red y el número de nodo. El número de red será entregado a quien realice la configuración. Para ello, en los siguientes archivos editamos las líneas correspondientes con los valores establecidos: Archivo: ‘c:\HDK-CONTAINER\config\peiis.properties’

Línea(s): network.id=<número de id de red> ehcos.ehhealthkernel.center_id=<node_id>

Ejemplo: network.id= 1000021164 ehcos.ehhealthkernel.center_id= 2118907100

Archivo: ‘c:\HDK-CONTAINER\update-center\ehcos-updater\conf\ehcos-update-client.properties’

Línea(s): ehcos.update.client.localnode.id=<node_id> Ejemplo: ehcos.update.client.localnode.id=2118907100

Paso 4. Arrancar el servidor de base de datos ejecutando el comando ‘c:\HDK-CONTAINER\bin\‘0_runDatabaseServer.bat’ por ventana de comandos de Windows (cmd). Para validar que el servicio se haya ejecutado correctamente, en la última línea deberá aparecer lo siguiente:



Versión 1.3

Página 9 de 16

Esta ventana solo podrá ser minimizada y no cerrada; de lo contario se detendrá el servicio de activación de la base de datos. En caso de que el motor de base de datos no inicie como se espera y presente conflicto con el puerto, se puede cambiar este valor editando el archivo ‘c:\HDK-CONTAINER\bin\0_runDatabaseServer.bat’. Un ejemplo indicando el puerto 9002: Agregar a la línea ‘…bin\java -Xms384m -Xmx1536m -classpath .;../database/hsqldb/lib/*

org.hsqldb.server.Server --port 9002 --database.0 file:../database/hsqldb/data/sinba --dbname.0 sinba’, la opción del puerto.

Reemplazar el valor del puerto de la línea que se agregó para especificar la máquina virtual, ‘.../lib/sqltool.jar --inlineRc=url=jdbc:hsqldb:hsql://localhost:9002/sinba,user=SA,password= < ../update-center/data/schemas.sql’.

Realizados los cambios se procede a iniciar el servidor de datos como se indicó al principio de este paso. Nota. Cambiar el puerto del motor de base de datos implica la modificación de las referencias al puerto 9001 de las propiedades de la base de datos en el archivo ‘c:\HDK-CONTAINER\config\peiis.properties’. Paso 5. En caso de ser necesario, verificar e instalar actualizaciones:

Por ventana de comandos de Windows (cmd) verificamos la versión del sistema ejecutando el

comando ‘c:\HDK-CONTAINER\bin\ehcos-updater-client.bat -l’

Si la versión del PEIIS no es reciente, por ventana de comandos de Windows (cmd) descargamos actualizaciones contenidas en la carpeta ‘c:\HDK-CONTAINER\update’ del material de instalación ejecutando el comando ‘c:\HDK-CONTAINER\bin\ehcos-updater-client.bat -c’.



Versión 1.3

Página 10 de 16

En caso de haber encontrado actualizaciones, en la ventana se indicará la descarga de archivos así como la versión del producto descargado. La carpeta ‘c:\HDK-CONTAINER\download\’ contiene los archivos descargados.

Mediante ventana de comandos de Windows (cmd) instalamos los archivos descargados ejecutando el comando ‘c:\HDK-CONTAINER\bin\ehcos-updater-client.bat -i’.

Paso 6. Por ventana de comandos de Windows (cmd) arrancamos el servidor web de la aplicación ejecutando el comando ‘c:\HDK-CONTAINER\bin\3_runHttpServer.bat’. Al ejecutar la rutina se desplegará una segunda ventana correspondiente al servidor ‘Tomcat’. Para validar que el servicio se haya ejecutado correctamente en la ventana ‘Tomcat’ deberá presentarse el tiempo de arranque del servicio:

En caso que el servidor web no inicie como se espera y presente conflictos con el puerto se puede cambiar su valor en el archivo ‘c:\HDK-CONTAINER\server\apache-tomcat\conf\server.xml’ en la línea ‘<Connector port="8080" protocol="HTTP/1.1"’ con otro número de puerto. Un ejemplo indicando el puerto 8090 es ‘<Connector port="8090" protocol="HTTP/1.1"’. Realizados los cambios se procede a iniciar el servidor web como se indicó al principio de este paso. Nota. Cambiar el valor del puerto del servidor web implica la modificación de las referencias al puerto 8080 indicadas en las propiedades globales del archivo ‘c:\HDK-CONTAINER\config\peiis.properties’.

Paso 7. Verificar el despliegue del sistema ingresando al navegador la URL: ‘http://localhost:8080/peiis-ui’. En instalaciones fuera de línea en donde el servidor de datos y de aplicación no está asignado a una red local, el Host por defecto es ‘localhost’ y el puerto, en caso de no haberse modificado, es el ‘8080’. De ser correcta la instalación se presentará la siguiente página:



Versión 1.3

Página 11 de 16

Para ingresar al sistema debe proporcionar las credenciales de acceso (usuario y contraseña) provistas por el administrador del nodo.

Se debe seleccionar la opción PEIIS para acceder al menú del nodo:



Versión 1.3

Página 12 de 16

Al llegar a esta pantalla aseguramos que tanto servidor de datos y como de aplicación están desplegados correctamente en el nodo. Una vez ingresado a alguna opción de captura, para salir del sistema seleccione el elemento ‘General’ y posteriormente ‘Salir’.

6.1.2 Configuración de computadoras conectadas en red

Enseguida se indican los pasos para instalar y configurar SINBA en caso de utilizar equipo(s) servidor(es) y computadoras para captura de información (clientes), enlazados mediante red de cómputo local. Paso 1. Identificar la arquitectura del sistema operativo (32 o 64 bits) de la computadora a configurar como servidor; con base a ello descargar el archivo de instalación correspondiente.



Versión 1.3

Página 13 de 16

Paso 2. Descomprimir el archivo ‘HDK-CONTAINER.zip’ en el directorio raíz del disco duro(‘c:\’) para evitar conflictos. En caso de instalar por separado el servidor de base de datos y el servidor de aplicación, deberá ejecutarse este paso en cada servidor. Paso 3. Además de las modificaciones indicadas en el Paso 3 del Punto 6.1.1, y en caso de utilizar un solo servidor, se deberá especificar en las propiedades de la base de datos la dirección IP del servidor que aloja el servicio: Archivo: ‘c:\HDK-CONTAINER\config\peiis.properties’

Línea(s): jdbc.url=jdbc:hsqldb:hsql://localhost:9001/sinba Ejemplo: jdbc.url=jdbc:hsqldb:hsql://192.168.10.3:9001/sinba

Y en la sección ‘Propiedades Globales’ deberá reemplazar todas las direcciones locales (localhost) por la dirección IP del servidor que publicará la aplicación:

Archivo: ‘c:\HDK-CONTAINER\config\peiis.properties’

Línea(s): Cambiar localhost por la dirección IP donde se publicará la aplicación. Ejemplo: http://localhost:8080/ehCS-ui/ws cambia a http:// 192.168.10.11:8080/ehCS-ui/ws

Asimismo, se debe indicar en el archivo de propiedades del actualizador del sistema, la dirección IP del servidor de la base de datos:



En caso de utilizar dos servidores, uno para la base de datos y otro para la publicación de la aplicación, se deberán tomar en consideración las siguientes instrucciones para la modificación de los archivos de configuración del sistema. Servidor de base de datos. Especificar la IP del servidor de base de datos en los archivos y líneas mencionadas a continuación:

Archivo: ‘c:\HDK-CONTAINER\config\peiis.properties’ Línea(s): jdbc.url=jdbc:hsqldb:hsql://localhost:9001/sinba Ejemplo: jdbc.url=jdbc:hsqldb:hsql://192.168.10.78:9001/sinba



Servidor web. Especificar la IP del servidor web en los archivos y líneas mencionadas a continuación:

Archivo: ‘c:\HDK-CONTAINER\config\peiis.properties’



Versión 1.3

Página 14 de 16

Línea(s): En la sección ‘Propiedades Globales’ deberá reemplazar todas las direcciones locales

(localhost) por la dirección IP del servidor que publicará la aplicación Ejemplo: http://localhost:8080/ehCS-ui/ws cambia a http:// 192.168.10.11:8080/ehCS-ui/ws

Archivo: ‘c:\HDK-CONTAINER\server\apache-tomcat\webapps\cas\WEB-INF\cas.properties’

Línea(s): Cambiar en la primera línea la palabra localhost por la IP del servidor WEB …service=http://localhost:8080/cas/services… …loginUrl=http://localhost:8080/cas/logincas… …casServerUrlPrefix=http://localhost:8080/cascas… Cambiar en la primera línea la palabra local localhost por la IP del servidor de base de

datos …hsqldb:hsql://localhost:9001/sinbadatabase… Ejemplo: …service=http:// 192.168.10.11:8080/cas/services… …loginUrl=http:// 192.168.10.11:8080/cas/logincas… …casServerUrlPrefix=http:// 192.168.10.11:8080/cascas… …hsqldb:hsql:// 192.168.10.78:9001/sinbadatabase…

Paso 4. En caso de haber instalado el servidor de base de datos y el servidor web en un solo servidor ejecutar los Pasos 4, 5 y 6 del Punto 6.1.1. Si los servicios están separados en dos servidores se deberá activar únicamente el servidor de base de datos en el servidor correspondiente (pasos 4 y 5 del Punto 6.1.1), así como el solamente servidor web en el servidor seleccionado (paso 6 del Punto 6.1.1)

Paso 5. Verificar el despliegue del sistema ingresando al navegador la URL con el Host configurado para la publicación de la aplicación, por ejemplo, ‘http://192.168.10.11:8080/peiis-ui’.

7. Cliente de actualizaciones

El cliente de actualizaciones es una aplicación que debe ejecutarse por ventana de comandos a nivel del sistema operativo en el nodo que se desea instalar: computadora servidor o computadora cliente – servidor. El cliente permite revisar las actualizaciones disponibles, instalar aplicaciones nuevas, registrar el estado del servidor (en caso de estar en línea) y listar las versiones instaladas en el nodo. Nota. El gestor de base de datos debe encontrarse en ejecución antes de realizar los siguientes pasos. Para mayor información de cómo iniciar el motor de base de datos revisar el punto ‘6. Instalación del sistema’ del presente documento. 1. Configuración de cliente de actualizaciones. Se debe validar que el archivo ‘c:\HDK-CONTAINER\update-

center\ehcos-updater\conf\ehcos-update-client.properties’ tenga la configuración deseada del nodo:



Versión 1.3

Página 15 de 16

Activación del modo en línea. En la línea ‘ehcos.update.client.online.mode’ se especifica si la modalidad de

actualización es, o no, en línea. Por defecto el valor es ‘N’, ‘ehcos.update.client.online.mode=N’, y cuando opere en línea deberá actualizarse a ‘Y’ así como los demás valores que corresponda

Propiedades de la base de datos. En la línea ‘jdbc.url=jdbc:hsqldb:hsql://localhost:9001/sinba’ se especificar el valor del host configurado para la base de datos. En caso de una configuración híbrida es necesario colocar la IP donde se encuentra el servicio. Por ejemplo, asumiendo que el motor de base de datos vaya a ser iniciado en una computadora con IP 192.168.10.10 entonces la línea se ajusta a ‘jdbc.url=jdbc:hsqldb:hsql://192.168.10.10:9001/sinba’.

Propiedades de instalación. Contiene las referencias a la ubicación de los elementos necesarios para el

cliente de actualizaciones. Se debe dejar el valor default provisto a menos que se realice un cambio de comportamiento del cliente de actualizaciones. El elemento principal a ser editado es ‘ehcos.update.client.localnode.id=<número de id de nodo>’. Suponiendo que el valor es 17 entonces ‘ehcos.update.client.localnode.id=17’

Configuración del contenedor. El elemento a ser modificado es ‘ehcos.update.client.rest.url=C:/HDK-

CONTAINER/update/update.xml’ con la ruta donde obtendrán nuevas versiones. Por default está configurado en forma local; sin embargo, una vez que opere el servidor de actualizaciones deberá remplazarse el archivo el archivo ‘c:\HDK-CONTAINER\update\update.xlm’.

2. Actualizar aplicación

2.1. Detener el servidor web. Se debe detener el servidor web antes de realizar actualización a la aplicación.

De esta forma se garantiza que los contenidos sean desplegados correctamente. Para detenerlo basta con pulsar ctrl + c en la ventana de ‘Tomcat’. En caso de responder, basta con cerrar la ventana.

2.2. Ejecutar el cliente de actualización. La ejecución del comando ‘c:\HDK-CONTAINER\bin\ehcos-updater-cliente.bat -h’ da acceso a las opciones que provee el cliente de actualizaciones:

c – check-updates. Revisa las actualizaciones disponibles en el servidor.

i – install. Instala la versión más reciente que encuentra en el servidor en caso de que la versión actual

en el nodo no sea la última.

r – register-status. Envía el estado del nodo al servidor para el registro de versiones instaladas.

l – list-versions. Lista las versiones instaladas en el cliente. Permite al administrador comparar con respecto a las versiones disponibles por el servidor.

h – help. Presenta el menú de ayuda para revisar las opciones disponibles.

El administrador que realice la actualización de aplicaciones debe acceder y ejecutar la aplicación en la siguiente secuencia:



Versión 1.3

Página 16 de 16

1. Revisar las versiones publicadas para confirmar la necesidad de una actualización mediante ‘ehcos-

updater-client.bat -c’.

2. Instalar la versión más reciente publicada en el servidor mediante ‘ehcos-updater-client.bat -i’.

3. Después de la instalación, listar las versiones instaladas en el nodo mediante ‘ehcos-updater-client.bat -l’.

4. Después de validar la correcta instalación de la aplicación en el nodo al revisar las versiones instaladas,

enviar el estado del nodo al servidor (solo nodos en línea) mediante ‘ehcos-updater-client.bat –r’.

2.3. Eliminar aplicación previa. Al ejecutar la instalación de actualizaciones, el cliente ubica en la carpeta ‘c:\HDK-CONTAINER\server\apache-tomcat\webapss\’ respaldo de los contenidos modificados. En el caso de haber actualizado la aplicación PEIIS-UI se debe eliminar la carpeta ‘c:\HDK-CONTAINER\server\apache-tomcat\webapss\peiis-ui’.

2.4. Iniciar servidor web. Ejecutar los pasos indicados en el punto ‘6. Instalación de la aplicación’ del presente manual.

8. Material y documentos de referencia

Material:

o Software de instalación facilitado por la Dirección General de Información de Salud de la Secretaría de Salud Federal; Última actualización 8 de marzo de 2016.

Documentación:

o Plataforma Tecnológica para la Conformación del Sistema Nacional de Información Básica en Materia

de Salud (SINBA); Anexo Manual de Usuario; Versión 1.0; 17 de noviembre de 2016. Dirección General de Información en Salud, Secretaría de Salud Federal.

o Capacitación Nacional Técnica; Sistema Nacional de Información Básica en Materia de Salud (SINBA); 17 de noviembre de 2016; Dirección General de Información en Salud, Secretaría de Salud Federal.

sistema nacional de información básica en materia de salud

Documents