Instalación de GBS Web Apps

Introducción

Este manual describe el procedimiento de instalación y actualización de los servidores Griaule para las Aplicaciones Web.

Para realizar la instalación, algunos archivos deben estar disponibles en la máquina en la que se instalará la aplicación:

• Archivo .war de la aplicación, gbs-<app_name>-web-server-<version>.war;

• Script de volcado (dump) de la base de datos, clear-<app_name>-<DD>-<MM>-<YYYY>.sql, si está instalando;

• Script de actualización de la base de datos, upgrade-<app_name>-<DD>-<MM>-<YYYY>.sql, si está actualizando;

• Script de la base de datos Sphinx, clear-sphinx-<DD>-<MM>-<YYYY>.sql;

• Paquete Apache Tomcat, tomcats-v7.tar;

• Script de setup setup.sh;

• Script Python auxiliar para configuración updatescript.py;

• Scripts de Pre-Instalación: setup_webapps.sh y, opcionalmente, setup_aliases.sh si desea crear Aliases.

Si falta algún archivo, contacte al Equipo de Soporte de Griaule por correo electrónico: [email protected].

Para realizar una nueva instalación, siga los siguientes pasos:

1. Verifique si su sistema cumple con los Pre-Requisitos

2. Haga la Pre-Instalación utilizando el script

3. Instale la aplicación

4. Configure la aplicación

5. Verifique si la aplicación se está ejecutando mediante los comandos presentados en Manejo de las Aplicaciones

Para actualizar una aplicación, siga los pasos:

1. Verifique si su sistema cumple con los Pre-Requisitos de la nueva versión

2. Actualice la aplicación a través de los comandos presentados

3. Verifique las Configuraciones

4. Verifique si la aplicación se está ejecutando mediante los comandos presentados en Manejo de las Aplicaciones

Pre-Requisitos

• Linux (CentOS 7 / Red Hat 7 / Oracle Linux 7 / Oracle Linux 8);

• Java Development Kit versión 1.8+;

• Apache: Tomcat versión 7+;

• Base de datos: MySQL/MariaDB 5.7+;

• libusb, libpng12, compat-libtiff3;

• GBDS: API;

• GBDS: Matcher;

• GBDS: Notifier (solamente para el ETR);

• Google Tesseract OCR Engine 4.0.0 o superior (solamente para el CardScan);

• SmartSense Agent (solamente para el SmartSense)

• CUPS (solamente para el Print)

Para saber más sobre los productos del Griaule Biometric Suite (GBS), consulte Visión General del GBS.

Pre-Instalación

Algunos pasos deben hacerse antes del proceso de instalación.

Si Tomcat no está instalado, instálelo con el siguiente comando:

yum install tomcat -y

En todos los comandos, recuerde reemplazar <app_name> por el nombre de la aplicación deseada y también <version> por la versión correspondiente. El <app_name> puede ser: bcc, cardscan, etr, mir, best, intelligence, smart-sense, print, control-panel o home-screen.

Primero, asegúrese de que el paquete Tomcats (archivo tomcats-v7.tar) proporcionado esté disponible en la máquina en la que se instalará la aplicación.

El paquete tomcats-v7.tar contiene una carpeta para cada aplicación. La estructura de carpetas es la siguiente:

/var/lib/tomcats/
├── bcc
├── best
├── cardscan
├── control-panel
├── etr
├── home-screen
├── intelligence
├── mir
├── print
└── smart-sense

Cada carpeta contiene las siguientes subcarpetas:

/var/lib/tomcats/<app_name>/
├── conf
├── logs
├── temp
├── webapps
└── work

Si no está realizando una instalación nueva de todas las aplicaciones, NO extraiga el paquete tomcats-v7.tar en el directorio /var/lib/tomcats/ (Paso 1). En su lugar, extraiga el paquete en un directorio temporal y mueva solo la carpeta de la aplicación que se está instalando al directorio /var/lib/tomcats/. Luego, continúe en el Paso 2.

Paso 1: Transfiera y descomprima el paquete tomcats-v7.tar en el directorio /var/lib/tomcats.

mkdir -p /var/lib/tomcats && tar -xf tomcats-v7.tar -C /var/lib/tomcats

Paso 2: Realice la pre-instalación de la aplicación utilizando el script setup_webapps.sh proporcionado.

Para realizar este procedimiento, ejecute el script de pre-instalación pasando el nombre de la aplicación que desea instalar:

./setup_webapps.sh <app_name>

Paso 3: Configure los aliases (opcional).

Opcionalmente, si desea crear aliases para facilitar el manejo de la aplicación, ejecute el siguiente script:

./setup_aliases.sh <app_name>

Luego, aplique el archivo .bashrc:

source ~/.bashrc

Estos scripts harán:

• Crear enlaces simbólicos del tomcat para cada servicio

• Actualizar/modificar scripts del servidor tomcat

• Agregar aliases para facilitar el manejo de la aplicación

Después de estos pasos, si el Cardscan Server y/o ETR se están instalando, siga los pasos a continuación.

Abra el archivo de configuración de la base de datos:

vim /etc/my.cnf

En [mysqld], si se está instalando CardScan, agregue la siguiente línea:

# CARDSCAN Required
max_allowed_packet=500M

Si se está instalando ETR, agregue la siguiente línea:

# ETR Required
sql-mode=""

Si ya está configurado, ignore este paso.

Después de completar los procedimientos anteriores, proceda a Instalación.

Instalación

Antes de iniciar el procedimiento de instalación, asegúrese de que el archivo .war de la aplicación esté disponible en la máquina en la que se instalará la aplicación.

En todos los comandos, recuerde reemplazar <app_name> por el nombre de la aplicación deseada y también <version> por la versión correspondiente. El <app_name> puede ser: bcc, cardscan, etr, mir, best, intelligence, smart-sense, print, control-panel o home-screen.

Paso 1: Mueva el archivo .war de la aplicación al directorio raíz de la aplicación:

mv *.war /var/lib/tomcats/<app_name>/

Paso 2: Cambie al directorio webapps de la aplicación:

cd /var/lib/tomcats/<app_name>/webapps

Paso 3: Cree un enlace simbólico en el directorio webapps para el archivo .war de la aplicación.

ln -s /var/lib/tomcats/<app_name>/gbs-<app_name>-web-server-<version>.war gbs-<app_name>-server.war

Paso 4: Cambie de directorio:

cd /var/lib/

Paso 5: Cambie la propiedad de los archivos en el directorio tomcats al usuario tomcat:

chown -R tomcat:tomcat tomcats/

Luego, proceda con las Configuraciones de la aplicación.

Actualización

Para actualizar una aplicación, proceda con los siguientes pasos:

En todos los comandos, recuerde reemplazar <app_name> por el nombre de la aplicación deseada y también <version> por la versión correspondiente. El <app_name> puede ser: bcc, cardscan, etr, mir, best, intelligence, smart-sense, print, control-panel o home-screen.

Paso 1: Detenga la aplicación:

systemctl stop tomcat@<app_name>.service

Paso 2: Elimine los archivos antiguos:

sudo rm -rf /var/lib/tomcats/<app_name>/webapps/*

Paso 3: Coloque el archivo .war de la aplicación en el directorio raíz de la aplicación:

mv *.war /var/lib/tomcats/<app_name>/

Paso 4: Cambie al directorio webapps de la aplicación:

cd /var/lib/tomcats/<app_name>/webapps

Paso 5: Cree un enlace simbólico en el directorio webapps para el archivo .war de la aplicación:

ln -s /var/lib/tomcats/<app_name>/gbs-<app_name>-web-server-<version>.war gbs-<app_name>-server.war

Paso 6: Ejecute los dumps de actualización de la base de datos, si la release los incluye:

mysql -u root -p < <path/to/script>.sql

El script específico de la aplicación generalmente se llama upgrade-<app_name>-<DD>-<MM>-<YYYY>.sql. Puede haber más de un script. En ese caso, ejecute los otros scripts también.

Paso 7: Inicie la aplicación:

systemctl start tomcat@<app_name>.service

Paso 8: Cambie al directorio tomcats:

cd /var/lib/tomcats

Paso 9: Ejecute el script de setup:

/var/lib/tomcats/setup.sh <app_name>

Configuraciones

Cada componente tiene su configuración individual. Estas se presentan en su respectivo manual.

En todos los comandos, recuerde reemplazar <app_name> por el nombre de la aplicación deseada y también <version> por la versión correspondiente. El <app_name> puede ser: bcc, cardscan, etr, mir, best, intelligence, smart-sense, print, control-panel o home-screen.

Paso 1: Ejecute el volcado (dump) de la base de datos:

mysql -u root -p < <path/to/script>.sql

El script de volcado de la base de datos específico de cada aplicación generalmente se llama clear-<app_name>-<DD>-<MM>-<YYYY>.sql. Puede haber otro script, generalmente llamado clear-sphinx-<DD>-<MM>-<YYYY>.sql. En ese caso, ejecútelo también.

Paso 2: Luego, edite el archivo config.properties:

vim /var/lib/tomcats/<app_name>/conf/config.properties

Para entender los procedimientos de configuración, consulte el manual de configuración específico:

• Manual de Configuración del BCC Web Server

• Manual de Configuración del Cardscan Web Server

• Manual de Configuración del ETR Web Server

• Manual de Configuración del MIR Web Server

• Manual de Configuración del BEST Web Server

• Manual de Configuración del Intelligence Web Server

• Manual de Configuración del SmartSense Server

• Manual de Configuración del Control Panel Web Server

• Manual de Configuración del Print Server

• Manual de Configuración del Home Screen Server

Asegúrese de que el parámetro de configuración Connector port=<port_number> esté especificado correctamente en el archivo server.xml, ubicado en /var/lib/tomcats/<app_name>/conf. Para más información, consulte los manuales de configuración específicos para cada aplicación. Los puertos de conexión (Connector port=<port_number>) y de apagado (Server port=... shutdown=...) no deben ser iguales entre sí ni coincidir con puertos usados por otras aplicaciones.

Asegúrese de que los parámetros de configuración <app_name>.ip, <app_name>.port y <app_name>.protocol estén correctamente especificados en el archivo config.properties. La dirección IP debe coincidir con la configurada en el archivo server.xml. En muchos casos, la IP será la misma para varias aplicaciones. Sin embargo, cada aplicación tendrá un puerto distinto y único.

Paso 3: A continuación, ingrese en MySQL como root:

mysql -u root -p

Paso 4: Ejecute la siguiente query:

SET GLOBAL sql_mode=(SELECT REPLACE(@@sql_mode,'ONLY_FULL_GROUP_BY',''));

Paso 5: Salga de MySQL:

exit

Paso 6: Luego, inicie la aplicación.

systemctl start tomcat@<app_name>.service

Paso 7: Cambie al directorio tomcats:

cd /var/lib/tomcats

Paso 8: Si es la primera vez que ejecuta la aplicación, ejecute el script de setup:

/var/lib/tomcats/setup.sh <app_name>

Si está instalando el SmartSense, asegúrese de que el ELK también esté instalado. Para más instrucciones, consulte el Manual de Instalación del Elastic Stack (ELK).

Manejo de las Aplicaciones

Esta sección presenta algunos comandos para monitorear y manejar los servicios Griaule, así como sus respectivos aliases.

Aliases

Los aliases son comandos cortos definidos por el usuario que sirven como sustitutos para comandos más largos o complejos. Se crean para hacer que los comandos usados con frecuencia sean más convenientes de ejecutar. Cuando se invoca un alias, se sustituye por el comando completo que representa antes de ejecutarlo.

Si no está utilizando el script setup_aliases.sh, como se describe en Pre-Instalación, es posible agregar los aliases manualmente. Para hacer esto, edite el archivo .bashrc raíz:

vim ~/.bashrc

Y agregue los siguientes aliases, de acuerdo con la aplicación deseada:

# ETR
alias etrstart='systemctl start [email protected]'
alias etrstop='systemctl stop [email protected]'
alias etrstatus='systemctl status [email protected]'
alias etrhome='cd /var/lib/tomcats/etr'
alias etrconf='vim /var/lib/tomcats/etr/conf/config.properties'
alias etrsetup='/var/lib/tomcats/setup.sh'
alias etrlogt='journalctl -u tomcat@etr -f'
alias etrlog='journalctl -u tomcat@etr | less'

# CARDSCAN
alias csstart='systemctl start [email protected]'
alias csstop='systemctl stop [email protected]'
alias csstatus='systemctl status [email protected]'
alias cshome='cd /var/lib/tomcats/cardscan'
alias csconf='vim /var/lib/tomcats/cardscan/conf/config.properties'
alias cssetup='/var/lib/tomcats/setup.sh'
alias cslogt='journalctl -u tomcat@cardscan -f'
alias cslog='journalctl -u tomcat@cardscan | less'

# BEST
alias beststart='systemctl start [email protected]'
alias beststop='systemctl stop [email protected]'
alias beststatus='systemctl status [email protected]'
alias besthome='cd /var/lib/tomcats/best'
alias bestconf='vim /var/lib/tomcats/best/conf/config.properties'
alias bestsetup='/var/lib/tomcats/setup.sh'
alias bestlogt='journalctl -u tomcat@best -f'
alias bestlog='journalctl -u tomcat@best | less'

# INTELLIGENCE
alias intelstart='systemctl start [email protected]'
alias intelstop='systemctl stop [email protected]'
alias intelstatus='systemctl status [email protected]'
alias intelhome='cd /var/lib/tomcats/intelligence'
alias intelconf='vim /var/lib/tomcats/intelligence/conf/config.properties'
alias intelsetup='/var/lib/tomcats/setup.sh'
alias intellogt='journalctl -u tomcat@intelligence -f'
alias intellog='journalctl -u tomcat@intelligence | less'

# MIR
alias mirstart='systemctl start [email protected]'
alias mirstop='systemctl stop [email protected]'
alias mirstatus='systemctl status [email protected]'
alias mirhome='cd /var/lib/tomcats/mir'
alias mirconf='vim /var/lib/tomcats/mir/conf/config.properties'
alias mirsetup='/var/lib/tomcats/setup.sh'
alias mirlogt='journalctl -u tomcat@mir -f'
alias mirlog='journalctl -u tomcat@mir | less'

# BCC
alias bccstart='systemctl start [email protected]'
alias bccstop='systemctl stop [email protected]'
alias bccstatus='systemctl status [email protected]'
alias bcchome='cd /var/lib/tomcats/bcc'
alias bccconf='vim /var/lib/tomcats/bcc/conf/config.properties'
alias bccsetup='/var/lib/tomcats/setup.sh'
alias bcclogt='journalctl -u tomcat@bcc -f'
alias bcclog='journalctl -u tomcat@bcc | less'

# CONTROL PANEL
alias cpstart='systemctl start [email protected]'
alias cpstop='systemctl stop [email protected]'
alias cpstatus='systemctl status [email protected]'
alias cphome='cd /var/lib/tomcats/control-panel'
alias cpconf='vim /var/lib/tomcats/control-panel/conf/config.properties'
alias cpsetup='/var/lib/tomcats/setup.sh'
alias cplogt='journalctl -u tomcat@control-panel -f'
alias cplog='journalctl -u tomcat@control-panel | less'

# SMARTSENSE
alias smartstart='systemctl start [email protected]'
alias smartstop='systemctl stop [email protected]'
alias smartstatus='systemctl status [email protected]'
alias smarthome='cd /var/lib/tomcats/smart-sense'
alias smartconf='vim /var/lib/tomcats/smart-sense/conf/config.properties'
alias smartsetup='/var/lib/tomcats/setup.sh'
alias smartlogt='journalctl -u tomcat@smart-sense -f'
alias smartlog='journalctl -u tomcat@smart-sense | less'

# PRINT
alias printstart='systemctl start [email protected]'
alias printstop='systemctl stop [email protected]'
alias printstatus='systemctl status [email protected]'
alias printhome='cd /var/lib/tomcats/print'
alias printconf='vim /var/lib/tomcats/print/conf/config.properties'
alias printsetup='/var/lib/tomcats/setup.sh'
alias printlogt='journalctl -u tomcat@print -f'
alias printlog='journalctl -u tomcat@print | less'

# HOME SCREEN
alias homestart='systemctl start [email protected]'
alias homestop='systemctl stop [email protected]'
alias homestatus='systemctl status [email protected]'
alias homehome='cd /var/lib/tomcats/home-screen'
alias homeconf='vim /var/lib/tomcats/home-screen/conf/config.properties'
alias homesetup='/var/lib/tomcats/setup.sh'
alias homelogt='journalctl -u tomcat@home-screen -f'
alias homelog='journalctl -u tomcat@home-screen | less'

Comandos Útiles

• Iniciar la Aplicación

systemctl start [email protected]
systemctl start [email protected]
systemctl start [email protected]
systemctl start [email protected]
systemctl start [email protected]
systemctl start [email protected]
systemctl start [email protected]
systemctl start [email protected]
systemctl start [email protected]
systemctl start [email protected]

o con el alias:

etrstart
csstart
beststart
intelstart
mirstart
bccstart
cpstart
smartstart
printstart
homestart

• Detener la Aplicación

systemctl stop [email protected]
systemctl stop [email protected]
systemctl stop [email protected]
systemctl stop [email protected]
systemctl stop [email protected]
systemctl stop [email protected]
systemctl stop [email protected]
systemctl stop [email protected]
systemctl stop [email protected]
systemctl stop [email protected]

o con el alias:

etrstop
csstop
beststop
intelstop
mirstop
bccstop
cpstop
smartstop
printstop
homestop

• Comprobar el Estado de la Aplicación

systemctl status [email protected]
systemctl status [email protected]
systemctl status [email protected]
systemctl status [email protected]
systemctl status [email protected]
systemctl status [email protected]
systemctl status [email protected]
systemctl status [email protected]
systemctl status [email protected]
systemctl status [email protected]

o con el alias:

etrstatus
csstatus
beststatus
intelstatus
mirstatus
bccstatus
cpstatus
smartstatus
printstatus
homestatus

• Comprobar los Logs de la Aplicación

# tail log
journalctl -u tomcat@etr -f
journalctl -u tomcat@cardscan -f
journalctl -u tomcat@best -f
journalctl -u tomcat@intelligence -f
journalctl -u tomcat@mir -f
journalctl -u tomcat@bcc -f
journalctl -u tomcat@control-panel -f
journalctl -u tomcat@smart-sense -f
journalctl -u tomcat@print -f
journalctl -u tomcat@home-screen -f

# full log
journalctl -u tomcat@etr | less
journalctl -u tomcat@cardscan | less
journalctl -u tomcat@best | less
journalctl -u tomcat@intelligence | less
journalctl -u tomcat@mir | less
journalctl -u tomcat@bcc | less
journalctl -u tomcat@control-panel | less
journalctl -u tomcat@smart-sense | less
journalctl -u tomcat@print | less
journalctl -u tomcat@home-screen | less

o con el alias:

# tail log
etrlogt
cslogt
bestlogt
intellogt
mirlogt
bcclogt
cplogt
smartlogt
printlogt
homelogt

# full log
etrlog
cslog
bestlog
intellog
mirlog
bcclog
cplog
smartlog
printlog
homelog