Instalación con Ansible

Introducción

Este manual describe los procedimientos de instalación de GBDS.

Preparativos para la instalación

Esta sección abarca los pasos esenciales necesarios para la instalación de GBDS.

Todos los pasos deben ejecutarse con privilegios de root en todos los nodos, salvo indicación en contrario.

Para instalar GBDS por completo, necesitará:

• Permiso de root en el servidor

• Enlace del paquete de herramientas GBDS

• Enlace del paquete Ambari Ansible

• Enlace del paquete OpenCV

• Archivos .rpm y .sql de GBDS

• Archivos .war y .sql de los software de Griaule Biometric Suite (opcional)

Si no tiene los enlaces del repositorio o los archivos, póngase en contacto con el equipo de soporte de Griaule.

A continuación, debe seguir los pasos presentados abajo. Estos pasos se describirán completamente en sus respectivas secciones.

1. Inicie sesión en el servidor como root

2. Instale GBDS Tools

3. Configure los archivos de configuración de GBDS Tools

4. Ejecute la configuración automática del entorno de GBDS Tools

5. Instale el RDB

6. Instale Ambari mediante Ansible

7. Instale GBDS

8. Instale las aplicaciones GBS (opcional)

Antes de comenzar, asegúrese de que el hostname de la máquina esté correcto. Para verificarlo, ejecute el comando:

hostname

Si no está correcto, ejecute el comando:

hostnamectl set-hostname <hostname-deseado>
                         ^^^^^^^^^^^^^^^^^^^

Si el hostname se modifica, reinicie la máquina antes de continuar.

GBDS Tools

GBDS Tools es una compilación de scripts bash con características específicas y usabilidad dinámica. El objetivo principal de la herramienta es facilitar, mejorar y acelerar la creación, configuración y gestión de aplicaciones del entorno.

Todos los scripts usan un único archivo de configuración llamado properties.ini y un único archivo de lista llamado cluster.list, que debe contener toda la información del grupo de servidores.

Antes de comenzar, asegúrese de que el wget está instalado:

wget --version

Si no lo está, ejecute el comando:

yum install wget -y

Instalando GBDS Tools

Tiene dos métodos para elegir al instalar GBDS Tools, uno si ya tiene el repositorio Griaule configurado en su servidor y otro si no lo tiene. Se explican a continuación.

Elija solo una alternativa. Tras finalizar una, no hay necesidad de realizar la otra.

Repositorio ya configurado

Si ya configuró el repositorio Griaule en su servidor, puede completar todas las instalaciones con un solo comando.

yum install gbds-tools

Si el repositorio Griaule no está configurado, ejecutar el comando anterior resultará en el siguiente error:

No package gbds-tools available
Error: Nothing to do

En este caso, continúe con Repositorio no configurado.

Repositorio no configurado

Si no tiene el repositorio configurado, debe asegurarse del correcto funcionamiento de la herramienta. Para ello, DEBE colocar la herramienta en el directorio /opt/griaule.

Comience creando el directorio:

mkdir -p /opt/griaule

Entre en el directorio creado:

cd /opt/griaule

A continuación, descargue el paquete de herramientas GBDS:

wget <enlace del paquete de herramientas GBDS>
     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Si no tiene el enlace, póngase en contacto con el equipo de soporte de Griaule.

En los comandos siguientes, asegúrese de reemplazar <versión> por la versión del paquete que se descargó.

Entonces, instálelo:

rpm -ivh gbds-tools-<versión>.el7.noarch.rpm
                    ^^^^^^^^

Y cree un enlace simbólico:

ln -s /opt/griaule/gbds-tools-<versión>/ /opt/griaule/tools
                              ^^^^^^^^

Después de una instalación exitosa, continúe con la sección de configuración.

Configurando GBDS Tools

Los archivos de configuración utilizados por GBDS Tools se encuentran en el directorio: /opt/griaule/tools/shared. En este directorio, hay tres archivos que deben editarse:

• properties.ini - archivo de configuración principal

• cluster.list - archivo principal de lista de nombres de host

• ip.list- archivo secundario de nombres de host

Los archivos están preconfigurados con valores predeterminados en la mayoría de los parámetros. Observe si algo necesita cambiarse para satisfacer las necesidades de su entorno.

Cambiar los nombres de host en los archivos para que coincidan con los del entorno es imprescindible.

En el archivo properties.ini, busque las configuraciones SPECIFIC TO y realice los cambios necesarios para que coincidan con su entorno.

En la sección SPECIFIC TO AUTO_ENVSETUP, asegúrese de que el nombre de usuario y contraseña estén configurados correctamente en usernm, userpw y rootpw.

En la sección SPECIFIC TO INSTALL_MYSQL, anote la contraseña del RDB, configurada en dbuspw, ya que se usará posteriormente.

En el archivo cluster.list, asegúrese de cambiar los nombres de host y de adaptar el número de hosts en cada componente para que coincida con el entorno.

Por defecto, el archivo está configurado para un clúster de tres nodos. Si el entorno tiene, por ejemplo, solo un nodo, elimine las menciones a los nodos 2 y 3 y sustituya todos los nombres por el hostname de su servidor.

En el archivo ip.list, asegúrese de cambiar los nombres de host y las direcciones IP para que coincidan con el entorno, siguiendo el formato <nombre de host>|<dirección IP> en cada línea.

Ejecutando la configuración automática del entorno

La configuración automática del entorno, denominada auto_envsetup.sh, es la automatización para configurar el entorno. Debe ejecutar este script al construir un servidor nuevo desde cero.

Para ejecutar el script, ejecute el siguiente comando:

/opt/griaule/tools/auto_envsetup/auto_envsetup.sh --all

A continuación, se recomienda actualizar todos los paquetes, si es posible:

yum update -y

Instalando el RDB

Para usar GBDS, necesitará una base de datos relacional instalada y configurada. Puede elegir entre MySQL Server o NDB Cluster.

Solo necesita ejecutar una instalación del RDB.

MySQL Server

Se recomienda instalar MySQL en el nodo maestro.

Para instalar MySQL Server, ejecute:

/opt/griaule/tools/install_mysql/install_mysql.sh --single

Entonces, continúe con Configurando la contraseña del RDB.

NDB Cluster

La instalación de NDB DEBE ser en el nodo MAESTRO.

O, si elige instalar NDB Cluster, ejecute:

/opt/griaule/tools/install_mysql/install_mysql.sh --cluster

Entonces, continúe con Configurando la contraseña del RDB.

Configurando la contraseña del RDB

Después de la instalación, intente iniciar sesión en MySQL ejecutando el comando:

mysql -u root -p

E ingresando la contraseña configurada en el archivo properties.ini en dbuspw, como se mencionó en el paso anterior.

Si puede iniciar sesión, la instalación y la configuración de la contraseña se realizaron correctamente y puede continuar con Configurando MySQL.

---

Si no puede iniciar sesión y ve el siguiente error:

Error: Access denied for user '<username>'@'<host>' (using password: YES)

Será necesario modificar la contraseña manualmente. Para hacerlo, use el siguiente comando para obtener la contraseña temporal creada durante la instalación:

grep "temporary password" /var/log/mysqld.log

Copie la contraseña temporal mostrada.

Entonces, cambie la contraseña usando el siguiente comando:

Asegúrese de reemplazar <senha_desejada> por la contraseña deseada. Mantenga las comillas.

mysqladmin -u root -p password "<senha_desejada>"
                                ^^^^^^^^^^^^^^^^

Cuando se le solicite, ingrese la contraseña temporal.

Entonces, intente iniciar sesión en MySQL nuevamente usando la nueva contraseña.

Si puede iniciar sesión, la instalación y la configuración de la contraseña se realizaron correctamente y puede continuar con Configurando MySQL.

Configurando MySQL

Finalmente, configure la base de datos para su entorno.

El archivo de configuración se encuentra en: /etc/my.cnf.

Las configuraciones predeterminadas de la instalación del RDB pueden no ser las configuraciones deseadas. Revíselas en el archivo de configuración my.cnf y adáptelas para satisfacer las necesidades del entorno.

Después de realizar los cambios necesarios, aplíquelos reiniciando el servicio:

systemctl restart mysqld

Instalando Ambari

Para instalar Ambari mediante Ansible, es necesario acceder al repositorio Griaule.

Si su GBDS RDB no está en el nodo MAESTRO, se recomienda iniciar otra instancia RDB para Ambari.

La instalación requiere una conexión a internet y puede tardar 45 minutos en completarse sin errores. Antes de instalar, verifique que su conexión sea estable.

Para iniciar la instalación de Ambari, entre en el directorio de Ansible:

cd /etc/ansible

Entonces, descargue el paquete:

wget <enlace del paquete Ambari Ansible>
     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Si no tiene el enlace, póngase en contacto con el equipo de soporte de Griaule.

A continuación, extraiga los archivos en el directorio principal de Ansible, /etc/ansible, con el siguiente comando:

En el comando siguiente, asegúrese de reemplazar <versión> por la versión del paquete que se descargó.

tar -xvf ansible_hdp-<versión>.tar
                     ^^^^^^^^

Entre en el directorio extraído:

cd /etc/ansible/ansible-hadoop

Como el proceso tarda algún tiempo en completarse, se recomienda ejecutar el script de instalación usando screen para evitar interrupciones.

Para ello, instale screen:

yum install screen -y

Inicie una nueva sesión en screen:

screen -S ambari-install

Entonces, continúe con la ejecución del script de instalación como se describe a continuación.

—

Si se pierde la conexión con el servidor, el script no se interrumpirá y podrá reanudar la sesión reconectándose al servidor y ejecutando:

screen -r ambari-install

Entonces, ejecute el script de instalación:

./full-hadoop.sh

Responda a las preguntas de instalación y continúe hasta terminar.

Una vez iniciado, NO interrumpa ninguno de los scripts. Si ocurre algún problema, póngase en contacto con el equipo de soporte de Griaule.

Instalando GBDS

Para instalar GBDS, necesitará:

• .rpm de GBDS Cluster

• .rpm de GBDS Distribution

• .sql del script de volcado del RDB de GBDS

• Enlace del paquete OpenCV

Comience moviendo los dos archivos .rpm al directorio /opt/griaule/tools/deploy_application/files.

El archivo .sql del script de volcado del RDB debe guardarse en otro directorio.

Después de ejecutar el siguiente script, todo el contenido del directorio /opt/griaule/tools/deploy_application/files será eliminado.

Entonces, ejecute el siguiente comando para instalar GBDS:

/opt/griaule/tools/deploy_application/deploy_application.sh --gbds

Después de intentar ejecutar el script anterior, si recibe el error:

[ERROR] No OPENCV RPM found to be deployed. Make sure to stage the desired RPM

Entre en el directorio files:

cd /opt/griaule/tools/deploy_application/files

Y descargue el paquete OpenCV:

wget <enlace del paquete OpenCV>
     ^^^^^^^^^^^^^^^^^^^^^

Entonces, intente ejecutar el script deploy_application.sh nuevamente.

A continuación, ejecute el script de volcado del RDB en el servidor SQL.

mysql -u root -p < /PATH/DO/ARQUIVO/clear-rdb-<versão>.sql
                   ^^^^^^^^^^^^^^^^^          ^^^^^^^^

La contraseña del RDB fue configurada aquí.

Después de terminar la instalación de GBDS, configúrelo ejecutando:

/opt/griaule/tools/auto_appconfig/auto_appconfig.sh --gbds

Para revisar o cambiar manualmente las configuraciones, edite el archivo de configuración ubicado en: /etc/griaule/conf/gbds/application.conf. Para más información sobre las configuraciones, consulte el Manual de Configuración de GBDS.

Asegúrese de que el hostname en el archivo de configuración (application.conf) corresponda al hostname del servidor.

Entonces, inicie la API de GBDS:

service gbsapid start

Pruebe si la API está en ejecución:

curl http://<host-ip>:8085/gbds/v2/operations/ping
            ^^^^^^^^^

La respuesta esperada es:

{
	"data": "pong!"
}

Finalmente, inicie GBDS:

gbdsstart

Y siga el log de ejecución:

gbdslogt

Instalando las aplicaciones GBS

Para instalar las Aplicaciones GBS, necesitará:

• Archivo .war para cada aplicación

• Script de volcado .sql para cada aplicación

Primero, instale y configure Tomcat para las aplicaciones web. Esto debe hacerse solo en el servidor que alojará las aplicaciones web. Use el siguiente comando:

/opt/griaule/tools/install_services/install_services.sh

A continuación, mueva los archivos .war al directorio /opt/griaule/tools/deploy_application/files y ejecute el comando:

/opt/griaule/tools/deploy_application/deploy_application.sh --services

Después de eso, configure las aplicaciones con el siguiente comando:

/opt/griaule/tools/auto_appconfig/auto_appconfig.sh --services

Para explorar las configuraciones individuales de cada aplicación, consulte los manuales de configuración correspondientes listados aquí.