Puertos habilitados en kafka:

1.  Crear Base de datos

 Seleccione una instancia en el proveedor de infraestructura en la nube de su preferencia.

 Asegúrese de asignar un almacenamiento y recursos adecuados para soportar la carga de trabajo de la base de datos.

2.   Instalación de MySQL

Una vez lanzada la instancia, asegúrese de que MySQL esté ejecutándose dentro de un contenedor Docker siguiendo los comandos específicos para su distribución de Linux (p. ej., Amazon Linux o Ubuntu).

3.  Configuración del Grupo de Seguridad

Configure las reglas del grupo de seguridad asociado a la instancia para permitir el acceso al puerto estándar de MySQL/Aurora (3306).

1. Nota Importante sobre la Compatibilidad de Bases de Datos. El estándar JPA con Hibernate permite usar bases de datos como PostgreSQL o SQL Server. Sin embargo, Onibex OneConnect no está oficialmente certificado para estas opciones. Aunque deberían funcionar técnicamente, no se garantiza que todas las funcionalidades se comporten como se espera. Se recomienda realizar pruebas exhaustivas si se decide usar una base de datos distinta a MariaDB o MySQL para asegurar una experiencia estable.

2.1  Descarga de los Scripts 

Descargue el archivo scripts.zip ,  adjunto al final del documento.

2.2   Contenido de los archivos

1. .env
2. run-sql.sh
3. scripts

2.3  Configuración del archivo .env

Localiza el archivo .env dentro de la carpeta. Antes de ejecutar el script, es necesario configurar las siguientes variables en el archivo para establecer la conexión con la base de datos.

1. DP: Dirección IP del servidor de base de datos.
   
2. SPRING_DATASOURCE_USERNAME: Nombre del usuario de la base de datos.
   
3. SPRING_DATASOURCE_PASSWORD: Contraseña del usuario de la base de datos.
   
4. MYSQL_CONTAINER: Nombre del contenedor MySQL.
   

2.4  Ejecución al archivo run-sql.sh

Asigna permisos de ejecución al archivo run-sql.sh. Ejecuta el siguiente comando en el directorio donde se encuentra el archivo: chmod +x run-sql.sh.

Una vez otorgados los permisos, el script está listo para ejecutarse con el siguiente comando: ./run-sql.sh.

Con esto, la base de datos estará lista para ser utilizada.

Las credenciales de la cuenta de administrador en su estado inicial son:

Usuario: administrator@oneconnect.com

Password: mzve$JQ@bg#zWmiDC3G$Jt

Las credenciales de la cuenta de usuario por default en su estado inicial son:

Usuario: poc@onibex.com

Password: mzve$JQ@bg#zWmiDC3G$Jt

---

3. Despliegue de Confluent Platform 

3.1  Preparación

3.1.1 Descargue la carpeta kafka-compose adjunto al final del documento, que contiene los archivos necesarios para el despliegue de Kafka y sus componentes. Dentro encontrará:

1. Archivo docker-compose.yml
2. Un script setup_kafka_dirs.sh
3. Archivo .env
   
4. Carpeta control-center-conf
   

Si deseas conocer las credenciales configuradas, puedes revisar el archivo password.properties ubicado en la carpeta control-center-conf . Editarlas es opcional y solo sirve para verificar o documentar las credenciales existentes.

3.1.2  Configure el archivo .env ingresando la dirección IP del servidor donde se desplegará Kafka.

Requerimientos:

4.1. Configuración del despliegue 

4.1 Descargue el archivo one-connect-compose.zip adjunto al final del documento que incluirá tres carpetas internas:

1. Frontend
   
2. Platform
3. Workspace

 Y los siguientes archivos:

1. .env
   
2.  run_compose.sh 
   

Antes de cargar la carpeta en el servidor, es necesario realizar la configuración del archivo  .env  que contendrá las variables de entorno requeridas para el funcionamiento del sistema. Se recomienda utilizar un editor de código para llevar a cabo esta tarea.

4.2 Al abrir nuestro archivo .env veremos la información que se detalla a continuación y en ella deberá cambiar el valor de estas variables sabiendo lo siguiente:

1. KAFKA_MACHINE_IP: IP de la máquina con Kafka.
   
2. KAFKA_BROKER_PORT, SCHEMA_REGISTRY_PORT, CONNECT_PORT: Puertos asignados para broker, schema registry y Kafka Connect.
   
3. HOST_MACHINE_IP: IP de la máquina donde se desplegará One Connect.
   
4. DB_IP, SPRING_DATASOURCE_USERNAME, SPRING_DATASOURCE_PASSWORD: IP de la base de datos, usuario y contraseña respectivamente.
   
5. DOCKER_PASSWORD: password/accesstoken proporcionado por Onibex.
   

Configuración del servicio de emails:

ENABLE_LOG_EMAIL_NOTIFICATION:
Habilita la opción de enviar alertas por vía email.

​

4.3 Para habilitar la funcionalidad de recibir correos, es necesario configurar las siguientes variables con los detalles de su propio servidor SMTP:

1. EMAIL_PASSWORD EMAIL_SMTP
   
2. AUTH EMAIL_SMTP_FROM
   
3. EMAIL_SMTPHOST
   
4. EMAIL_SMTPPORT
   
5. EMAIL_SMTPSSLPROTOCOLS
   
6. EMAIL_SMTPSTARTTLS
   
7. ENABLE EMAIL_SOURCEADDRESS EMAIL_USER
   

Si decide no utilizar estas características, puede dejar estas configuraciones tal como están, sin cambios.

4.2. Despliegue de One Connect Platform

1. Suba la carpeta one-connect-compose con los archivos configurados al servidor de destino.
   
2. Una vez que la carpeta esté en el servidor, navegue a su interior.
   
3. Ejecute el siguiente comando para otorgar permisos de ejecución al script: chmod +x run_compose.sh.
   
4. Inicie el despliegue de los contenedores ejecutando: ./run_compose.sh
   
5. Una vez finalizado el despliegue, verifique el estado de los contenedores con el comando: docker ps y vera algo similar a la siguiente imagen:

4.3 Acceso a la Interfaz

Espere aproximadamente un minuto para el inicio completo de todos los contenedores. Luego, abra un navegador y diríjase a la dirección IP del servidor donde hicimos el despliegue de One Connect y al puerto 5050 utilizando el siguiente formato:

<IP del servidor con One Connect desplegado>:5050

Allí podrá visualizar la interfaz de One Connect.

Las credenciales de la cuenta de administrador en su estado inicial son:

Usuario: administrator@oneconnect.com

Password: mzve$JQ@bg#zWmiDC3G$Jt

Las credenciales de la cuenta de usuario por default en su estado inicial son:

Usuario: poc@onibex.com

Password: mzve$JQ@bg#zWmiDC3G$Jt

NOTA:

En caso de presentar problemas al ejecutar el script utilizando el comando ./run_compose.sh, es posible que el archivo haya cambiado su formato original debido a modificaciones realizadas en un dispositivo con sistema operativo Windows.

Para corregir este inconveniente, ejecute los siguientes comandos para instalar y aplicar la herramienta de conversión:

1. sudo yum install -y dos2unix
2. dos2unix run_compose.sh

Esto convertirá el archivo al formato compatible con sistemas Linux, permitiendo su correcta ejecución.