1. 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 de la base de datos de la aplicación, clear-<app_name>-<DD>-<MM>-<YYYY>.sql, si se va a instalar;
• Script de actualización de la base de datos de la aplicación, upgrade-<app_name>-<DD>-<MM>-<YYYY>.sql, si se va a actualizar;
• Script de la base de datos de Sphinx, clear-sphinx-<DD>-<MM>-<YYYY>.sql;
• Paquete Apache Tomcat, tomcats-v7.tar;
• Script de configuración setup.sh;
• Script Python auxiliar de configuración updatescript.py;
• Scripts de Pre-Instalación: setup_webapps.sh y, opcionalmente, setup_aliases.sh si desea crear Alias.

Important

Si falta algún archivo, póngase en contacto con el equipo de soporte de Griaule por correo electrónico: support@griaule.com.

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

1. Verifique si su sistema cumple con los Requisitos Previos
2. Realice 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 Manipulando las Aplicaciones

Para actualizar una aplicación, siga los pasos:

1. Verifique si su sistema cumple con los Requisitos Previos de la nueva versión
2. Actualice la aplicación mediante los comandos presentados
3. Verifique las Configuraciones
4. Verifique si la aplicación se está ejecutando mediante los comandos presentados en Manipulando las Aplicaciones

2. Requisitos Previos

• 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 (solo para el ETR);
• Google Tesseract OCR Engine 4.0.0 o mayor (solo para el CardScan);
• SmartSense Agent (solo para el SmartSense)
• CUPS (solo para el Print)

See also

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

3. Pre-Instalación

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

Note

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

yum install tomcat -y

Tip

En todos los comandos, recuerde reemplazar <app_name> con el nombre de la aplicación deseada y también <version> con 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úrate de que el paquete de Tomcats (archivo tomcats-v7.tar) proporcionado esté disponible en la máquina donde se instalará la aplicación.

Note

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

Danger

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/. Entonces, continúe con 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: Realiza la preinstalación de la aplicación utilizando el script proporcionado setup_webapps.sh.

Para realizar este procedimiento, ejecuta el script de preinstalación pasando el nombre de la aplicación que deseas instalar:

./setup_webapps.sh <app_name>

Paso 3: Configura los alias (opcional).

Opcionalmente, si desea crear alias 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

Note

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

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

vim /etc/my.cnf

Bajo [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, omita este paso.

Después de completar los procedimientos anteriores, continúe con la Instalación.

4. Instalación

Antes de comenzar 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.

Tip

En todos los comandos, recuerde reemplazar <app_name> con el nombre de la aplicación deseada y también <version> con 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 inicial 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, continúe con las Configuraciones de la aplicación.

5. Actualización

Para actualizar una aplicación, siga los siguientes pasos:

Tip

En todos los comandos, recuerde reemplazar <app_name> con el nombre de la aplicación deseada y también <version> con 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 inicial 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 volcados de actualización de la base de datos, si la versión los incluye:

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

Tip

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 este caso, ejecute también los otros scripts.

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 configuración:

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

6. Configuraciones

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

Tip

En todos los comandos, recuerde reemplazar <app_name> con el nombre de la aplicación deseada y también <version> con 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 de la base de datos:

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

Tip

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 este caso, ejecútelo también.

Paso 2: 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 Home Screen Server

Note

Asegúrese de que el parámetro de configuración Connector port=<port_number> esté correctamente especificado en el archivo server.xml, ubicado en /var/lib/tomcats/<app_name>/conf. Consulte los manuales de configuración específicos de las aplicaciones para obtener más detalles. 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 utilizados por otras aplicaciones.

Note

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 diferente y único.

Paso 3: Luego, ingrese a MySQL como root:

mysql -u root -p

Paso 4: Ejecute la siguiente consulta:

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 configuración:

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

Important

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

7. Manipulando las Aplicaciones

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

7.1. Alias

Los alias son comandos cortos definidos por el usuario que sirven como sustitutos para comandos más largos o complejos. Se crean para hacer más conveniente la ejecución de comandos que se utilizan con frecuencia. Cuando se invoca un alias, se reemplaza por el comando completo que representa antes de ejecutarse.

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

vim ~/.bashrc

Y agregue los siguientes alias, según la aplicación deseada:

# ETR
alias etrstart='systemctl start tomcat@etr.service'
alias etrstop='systemctl stop tomcat@etr.service'
alias etrstatus='systemctl status tomcat@etr.service'
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 tomcat@cardscan.service'
alias csstop='systemctl stop tomcat@cardscan.service'
alias csstatus='systemctl status tomcat@cardscan.service'
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 tomcat@best.service'
alias beststop='systemctl stop tomcat@best.service'
alias beststatus='systemctl status tomcat@best.service'
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 tomcat@intelligence.service'
alias intelstop='systemctl stop tomcat@intelligence.service'
alias intelstatus='systemctl status tomcat@intelligence.service'
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 tomcat@mir.service'
alias mirstop='systemctl stop tomcat@mir.service'
alias mirstatus='systemctl status tomcat@mir.service'
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 tomcat@bcc.service'
alias bccstop='systemctl stop tomcat@bcc.service'
alias bccstatus='systemctl status tomcat@bcc.service'
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 tomcat@control-panel.service'
alias cpstop='systemctl stop tomcat@control-panel.service'
alias cpstatus='systemctl status tomcat@control-panel.service'
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 tomcat@smart-sense.service'
alias smartstop='systemctl stop tomcat@smart-sense.service'
alias smartstatus='systemctl status tomcat@smart-sense.service'
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 tomcat@print.service'
alias printstop='systemctl stop tomcat@print.service'
alias printstatus='systemctl status tomcat@print.service'
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 tomcat@home-screen.service'
alias homestop='systemctl stop tomcat@home-screen.service'
alias homestatus='systemctl status tomcat@home-screen.service'
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'

7.2. Comandos Útiles

• Iniciar la Aplicación

systemctl start tomcat@etr.service
systemctl start tomcat@cardscan.service
systemctl start tomcat@best.service
systemctl start tomcat@intelligence.service
systemctl start tomcat@mir.service
systemctl start tomcat@bcc.service
systemctl start tomcat@control-panel.service
systemctl start tomcat@smart-sense.service
systemctl start tomcat@print.service
systemctl start tomcat@home-screen.service

o con el alias:

etrstart
csstart
beststart
intelstart
mirstart
bccstart
cpstart
smartstart
printstart
homestart

• Detener la Aplicación

systemctl stop tomcat@etr.service
systemctl stop tomcat@cardscan.service
systemctl stop tomcat@best.service
systemctl stop tomcat@intelligence.service
systemctl stop tomcat@mir.service
systemctl stop tomcat@bcc.service
systemctl stop tomcat@control-panel.service
systemctl stop tomcat@smart-sense.service
systemctl stop tomcat@print.service
systemctl stop tomcat@home-screen.service

o con el alias:

etrstop
csstop
beststop
intelstop
mirstop
bccstop
cpstop
smartstop
printstop
homestop

• Verificar el Estado de la Aplicación

systemctl status tomcat@etr.service
systemctl status tomcat@cardscan.service
systemctl status tomcat@best.service
systemctl status tomcat@intelligence.service
systemctl status tomcat@mir.service
systemctl status tomcat@bcc.service
systemctl status tomcat@control-panel.service
systemctl status tomcat@smart-sense.service
systemctl status tomcat@print.service
systemctl status tomcat@home-screen.service

o con el alias:

etrstatus
csstatus
beststatus
intelstatus
mirstatus
bccstatus
cpstatus
smartstatus
printstatus
homestatus

• Verificar 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