1. Introducción

Este manual describe la configuración de los componentes del lado del servidor de la aplicación GBS SmartSense. GBS SmartSense es una aplicación diseñada para monitorear los clústeres de GBDS, permitiendo al usuario ver informes en vivo sobre la salud y el rendimiento del entorno.

El procedimiento de configuración debe realizarse solo después del paso de instalación. Para obtener más información, consulte el Manual de configuración de aplicaciones GBS.

2. Configuración

Los pasos de configuración son:

  1. Configurar Tomcat;
  2. Configurar Certificados;
  3. Generar contraseña encriptada;
  4. Instalar el Elastic Stack (ELK);
  5. Configurar el archivo config.properties;

Todos los pasos se describen a continuación. Un ejemplo de archivo config.properties se encuentra en la sección Ejemplo de archivo de configuración.

Danger

Todas las líneas deben estar presentes en el archivo de configuración. Comentar o eliminar líneas puede causar un comportamiento inesperado. Para obtener más información, comuníquese con el equipo de soporte de Griaule.

2.1. Configuración de Tomcat

Edite el archivo de configuración de Tomcat para configurar los certificados y el puerto que la aplicación utilizará.

vi /var/lib/tomcats/smartsense/conf/server.xml

Para cambiar el puerto, busque Connector port=. Este es el puerto para las operaciones de backend.

2.2. Configuración de Certificados

Para habilitar la autenticación SSL, busque connector port= en el archivo /conf/server.xml.

Existen dos entradas. La comentada es la configuración para SSL. Elimine los delimitadores de comentarios <!-- y -->, luego ajuste los siguientes parámetros:

port="58194"
keystoreFile="/home/griaule/keystore"
keystorePass="password"
keyAlias="1"
clientAuth="true"
truststoreFile="/home/griaule/keystore"
truststorePass="password"

El parámetro port debe ser el puerto de red deseado para la aplicación.

Cambie la ruta del keystoreFile y el truststoreFile a los valores apropiados. Haga lo mismo para el keystorePass y el truststorePass.

El parámetro clientAuth="true" requerirá autenticación del servidor para el cliente y del cliente para el servidor. Esto significa que el cliente necesitará importar el certificado en el navegador para poder acceder a la aplicación.

Warning

Cuando clientAuth está configurado como true, el administrador del sistema debe proporcionar el archivo certificate.pfx a los usuarios finales.

2.3. Encriptación de contraseña de base de datos

El parámetro jdbc.password es una contraseña encriptada. Para generar la contraseña encriptada, realice los siguientes pasos:

  1. Vaya a <carpeta de tomcat>/webapps/gbs-smartsense-server/WEB-INF/lib

    cd /var/lib/tomcats/smart-sense/webapps/gbs-smart-sense-server/WEB-INF/lib

  2. Vaya al siguiente directorio:

    java -cp gbs-common-db-<version>.jar com.griaule.commons.util.EncryptUtil <desiredPassword>

  3. La contraseña encriptada se mostrará después del mensaje: “Encrypted password is:”

Note

Guarde esta contraseña encriptada. Se utilizará en el siguiente paso.

2.4. Archivo de propiedades de la aplicación

Para configurar el archivo de propiedades de la aplicación, abra con:

vi /var/lib/tomcats/smartsense/conf/config.properties

Los cambios más importantes en este archivo de configuración son las propiedades jdbc.url, jdbc.username, jdbc.password y gbds.url. Configure los parámetros según el entorno.

El archivo de configuración completo se muestra en la sección Ejemplo de archivo de configuración.

Note

Recuerde sustituir la contraseña encriptada correcta generada en la sección Encriptación de contraseña de base de datos en el archivo.

2.4.1. Configuración de SmartSense

El último paso es configurar la dirección IP y el puerto de la aplicación a la que accederá el usuario final. Debe ser la misma dirección IP y el mismo puerto configurados en la sección Configuración de Tomcat.

smart-sense.ip=<ip>
smart-sense.port=<port>
smart-sense.protocol=<protocol>

Important

Asegúrese de que los parámetros de configuración smart-sense.ip, smart-sense.port y smart-sense.protocol estén correctamente especificados en el archivo config.properties. En muchos casos, la IP será la misma para varias aplicaciones. Sin embargo, cada aplicación tendrá un puerto diferente y único.

2.4.2. Nodos (opcional)

Opcionalmente, en lugar de usar la GUI de SmartSense, puede configurar los nodos que se monitorearán insertándolos directamente en la tabla smartsense.hosts en la base de datos. Para hacerlo, ejecute el siguiente comando en la base de datos, reemplazando los marcadores de posición con los valores correctos:

INSERT INTO smartsense.hosts (hostname,ip,port,active) VALUES ('<server_hostname>','<ip>','<smartsense agent port>',1);
COMMIT;

3. Instalación del Elastic Stack (ELK)

Consulte el Manual de Instalación de ELK para obtener instrucciones detalladas sobre cómo instalar y configurar el Elastic Stack.

4. Finalizar la configuración

Después de completar todos los pasos de configuración, regrese a la sección de configuración del Manual de configuración de aplicaciones GBS.

5. Ejemplo de archivo de configuración

Esta sección muestra un ejemplo del archivo config.properties.

# *********************************************************************
#
#         /$$$$$$  /$$      /$$  /$$$$$$  /$$$$$$$  /$$$$$$$$
#        /$$__  $$| $$$    /$$$ /$$__  $$| $$__  $$|__  $$__/
#       | $$  \__/| $$$$  /$$$$| $$  \ $$| $$  \ $$   | $$
#       |  $$$$$$ | $$ $$/$$ $$| $$$$$$$$| $$$$$$$/   | $$
#        \____  $$| $$  $$$| $$| $$__  $$| $$__  $$   | $$
#        /$$  \ $$| $$\  $ | $$| $$  | $$| $$  \ $$   | $$
#       |  $$$$$$/| $$ \/  | $$| $$  | $$| $$  | $$   | $$
#        \______/ |__/     |__/|__/  |__/|__/  |__/   |__/
#
#
#
#         /$$$$$$  /$$$$$$$$ /$$   /$$  /$$$$$$  /$$$$$$$$
#        /$$__  $$| $$_____/| $$$ | $$ /$$__  $$| $$_____/
#       | $$  \__/| $$      | $$$$| $$| $$  \__/| $$
#       |  $$$$$$ | $$$$$   | $$ $$ $$|  $$$$$$ | $$$$$
#        \____  $$| $$__/   | $$  $$$$ \____  $$| $$__/
#        /$$  \ $$| $$      | $$\  $$$ /$$  \ $$| $$
#       |  $$$$$$/| $$$$$$$$| $$ \  $$|  $$$$$$/| $$$$$$$$
#        \______/ |________/|__/  \__/ \______/ |________/
#
# *********************************************************************

# DATABASE (RDB)
jdbc.driverClassName=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://<host-ip>:3306/smartsense?useSSL=false
jdbc.username=griaule
jdbc.password=CDrt8vbewA2YAubPNOLZkw==
jdbc.dialect=org.hibernate.dialect.MySQLDialect
jdbc.showSql=false

# GBDS CONNECTION
gbds.url=http://<host-ip>:8085
gbds.user=gbds.authenticate
gbds.key=Griaule.123
gbds.logLevel=INFO
gbds.timeout=300

# SMARTSENSE - GUI
smart-sense.ip=<host-ip>
smart-sense.port=8126
smart-sense.protocol=http
locale=en_us

# SMARTSENSE - CONFIGURATION

fingerprint.useSDK=true
useLatentExtrator.fingerprint=true
useLatentExtrator.palmprint=false
image.convert.useJnbis=true
server.standalone.port=8085

gbds.smartSenseUser=smart_sense_server
sync.logLevel=INFO
same.user.simultaneous.login=false
notification.delay=5

poolingLoadBalancing.time=60
poolingLoadBalancing.active=true
poolingLoadBalancing.last=

# SMARTSENSE - ELK CONFIGURATION

linkEnroll=
linkIdentify=
linkIdentifyLatent=
linkUpdate=
linkVerify=

consumerQueue.active=true