1. Introducción¶

Este manual describe el proceso de instalación y actualización de los servidores Griaule para aplicaciones web. Estos incluyen el servidor MIR, el servidor CardScan, el servidor ETR, el servidor Intelligence, el servidor BEST, el servidor BCC y el servidor Control Panel.

Para proceder con la instalación, algunos archivos deben estar disponibles: el archivo .war de la aplicación, el paquete de Apache Tomcat y los scripts preconfigurados.

Important

Si falta algún archivo, contacte al equipo de soporte de Griaule.

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

Verifique si su sistema cumple con los Requisitos previos
Elija entre la Preconfiguración con script o la Preconfiguración manual
Instale la aplicación
Configure la aplicación
Verifique si la aplicación está en funcionamiento a través de los comandos presentados en Manejo de aplicaciones

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

Verifique si su sistema cumple con los nuevos Requisitos previos de la versión
Actualice la aplicación a través de los comandos presentados
Verifique las Configuraciones
Verifique si la aplicación está en funcionamiento a través de los comandos presentados en Manejo de aplicaciones

2. Requisitos previos¶

Linux (CentOS 7/RedHat 7);
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 ETR);
Motor de OCR Google Tesseract 4.0.0 o posterior (Solo para CardScan) (https://github.com/tesseract-ocr/tesseract/releases);

3. Preconfiguración¶

Se deben realizar algunos pasos antes del proceso de instalación. Esta preconfiguración se puede hacer de dos formas diferentes, utilizando los scripts .sh o manualmente. Ambos procesos se describen a continuación. Elija solo uno para seguir la instalación.

3.1. Preconfiguración con script¶

Para realizar este procedimiento, ejecute ambos scripts disponibles:

./setup_webapps.sh
./setup_aliases.sh

Esos scripts harán lo siguiente:

Crear enlaces simbólicos de Tomcat para cada servicio
Actualizar/modificar los scripts del servidor Tomcat
Agregar un alias para facilitar el manejo de la aplicación

Note

Después de estos pasos, si se está instalando el servidor CardScan, vaya al archivo de configuración de la base de datos y agregue lo siguiente debajo de [mysql]:

vim /etc/my.cnf

# CARDSCAN Required max_allowed_packet=500M

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

3.2. Preconfiguración manual¶

Para instalar manualmente, primero es necesario crear enlaces simbólicos de Tomcat para cada servicio.

Vaya al directorio systemd y cree enlaces dirigidos a cada servicio que desee instalar.

cd /etc/systemd/system/multi-user.target.wants/
ln -s /usr/lib/systemd/system/tomcat@.service tomcat@<app_name>.service

Note

Recuerde sustituir <app_name> por el nombre de la aplicación deseada.

Tip

El nombre de la aplicación puede ser: mir, best, etr, cardscan, intelligence, bcc, controlpanel o smart-sense.

Vaya a la biblioteca de usuario para ejecutables y actualice el script de inicio de Tomcat para obtener la información necesaria durante el inicio.

vim /usr/libexec/tomcat/server

#!/bin/bash

. /usr/libexec/tomcat/preamble

MAIN_CLASS=org.apache.catalina.startup.Bootstrap

# SERVICIOS DE GRIAULE
APP_NAME=`echo "${CATALINA_BASE}" | cut -d "/" -f 5`
APP_CONFIG=${CATALINA_BASE}/conf
APP_TMP_DIR=${CATALINA_BASE}/temp
FLAGS="$JAVA_OPTS"
OPTIONS="-Dcatalina.base=$CATALINA_BASE \
-Dcatalina.home=$CATALINA_HOME \
-Djava.endorsed.dirs=$JAVA_ENDORSED_DIRS \
-Djava.io.tmpdir=${APP_TMP_DIR} \
-Djava.util.logging.config.file=${LOGGING_PROPERTIES} \
-Dgbs-${APP_NAME}-server.config.location=${APP_CONFIG} \
-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager"

if [ "$1" = "start" ]; then
    FLAGS="${FLAGS} $CATALINA_OPTS"
    if [ "${SECURITY_MANAGER}" = "true" ]; then
        OPTIONS="${OPTIONS} \
        -Djava.security.manager \
        -Djava.security.policy==${CATALINA_BASE}/conf/catalina.policy"
    fi
    run start
elif [ "$1" = "stop" ]; then
    run stop
fi

Note

Si se está instalando CardScan Server, aumente el tamaño del paquete de la base de datos agregando el parámetro bajo [mysqld]:

vim /etc/my.cnf

# CARDSCAN Requerido max_allowed_packet=500M

Vaya al servicio deseado y cree un enlace simbólico lib y bin.

cd /var/lib/tomcats/<nombre_de_la_aplicación>
ln -s /usr/share/tomcat/bin/ bin; ln -s /usr/share/tomcat/lib/ lib

Para finalizar, agregue un alias para facilitar el manejo de la aplicación. Para hacerlo, vaya al archivo bashrc raíz y agregue los siguientes alias:

vim /root/.bashrc

# 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@controlpanel.service’ alias cpstop=’systemctl stop tomcat@controlpanel.service’ alias cpstatus=’systemctl status tomcat@controlpanel.service’ alias cphome=’cd /var/lib/tomcats/controlpanel’ alias cpconf=’vim /var/lib/tomcats/controlpanel/conf/config.properties’ alias cpsetup=’/var/lib/tomcats/setup.sh’ alias cplogt=’journalctl -u tomcat@controlpanel -f’ alias cplog=’journalctl -u tomcat@controlpanel | less’

4. Instalación¶

Antes de comenzar el procedimiento de instalación, asegúrese de que los archivos “apache_tomcats.rar” y los archivos “.war” estén disponibles.

Important

Si falta algún archivo, póngase en contacto con el equipo de soporte de Griaule.

Transfiera y descomprima el paquete “apache_tomcats.rar” en el directorio “/var/lib”.

Coloque el archivo de aplicación “.war” en el directorio de inicio de la aplicación y cree un enlace simbólico en el directorio “webapps”.

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

Note

Recuerde sustituir <app_name> por el nombre de la aplicación deseada y <version> por la versión correspondiente.

Tip

El <app_name> puede ser: mir, best, etr, cardscan, intelligence, bcc o controlpanel.

Cambie la propiedad del directorio y los archivos al usuario tomcat.

cd /var/lib/
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:

Important

En todos los procedimientos a continuación, recuerde sustituir <app_name> por el nombre deseado de la aplicación.

Tip

El <app_name> puede ser: mir, best, etr, cardscan, intelligence, bcc o controlpanel.

Detenga la aplicación:

systemctl stop tomcat@<app_name>.service

Elimine los archivos antiguos:

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

Coloque el archivo .war de la aplicación en el directorio de inicio de la aplicación y cree un enlace simbólico en el directorio webapps.

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

Inicie la aplicación:

systemctl start tomcat@<app_name>.service

Y ejecute la configuración:

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

6. Configuraciones¶

Cada componente tiene su propia configuración. Estas se presentan en su respectivo manual. Para configurar la aplicación, edite el archivo config.properties:

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

Tip

El app_name puede ser: mir, best, etr, cardscan, intelligence, bcc, controlpanel o smart-sense.

o con alias:

etrconf csconf bestconf intelconf mirconf bccconf cpconf

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

Note

Asegúrese de que los parámetros de configuración <app_name>.ip y <app_name>.port estén especificados correctamente en el archivo config.properties.

Note

Asegúrese de que el parámetro de configuración Connector port=<port_number> esté especificado correctamente en el archivo server.xml. Consulte los manuales de configuración específicos de las aplicaciones para obtener más detalles.

Después de los procedimientos de configuración, acceda a MySQL como root y ejecute la siguiente consulta:

mysql -u root -p

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

Luego, inicie las aplicaciones.

systemctl start tomcat@<app_name>.service

o con alias:

<app_name> start

Si es la primera vez que ejecuta la aplicación, ejecute la configuración:

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

o con alias:

etrsetup etr cssetup cardscan bestsetup best intelsetup intelligence mirsetup mir bccsetup bcc cpsetup controlpanel

7. Manejo de aplicaciones¶

Esta sección muestra algunos comandos para monitorear y manejar los servicios de Griaule.

Detener aplicación

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@controlpanel.service

o con alias:

etrstop csstop beststop intelstop mirstop bccstop cpstop

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@controlpanel.service

o con alias:

etrstart csstart beststart intelstart mirstart bccstart cpstart

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@controlpanel.service

o con alias:

etrstatus csstatus beststatus intelstatus mirstatus bccstatus cpstatus

Verificar los registros de la aplicación

# registros recientes 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@controlpanel -f

# registros completos 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@controlpanel | less

o con alias:

# registros recientes etrlogt cslogt bestlogt intellogt mirlogt bcclogt cplogt