Primeros Pasos¶

Conceptos Clave¶

Antes de comenzar con la configuración, es importante entender algunos conceptos clave que se mencionarán a continuación:

host: Un host es una computadora o máquina virtual (localmente o en la nube) que tendrá su sesión controlada.
protocol: El protocolo que se utilizará para la conexión y comunicación con el host. Consulte la lista de protocolos compatibles.

Protocolos Compatibles¶

Actualmente, se admiten dos protocolos:

RDP
AWS EC2 + RDP

RDP - Escritorio Remoto¶

Para configurar un host con soporte para Escritorio Remoto, necesitará la siguiente información:

Nombre del Host o Dirección IP para comunicarse con el host
Nombre de usuario para iniciar la sesión
Contraseña para iniciar la sesión del usuario

AWS EC2 + RDP¶

Este protocolo permite no solo establecer la conexión RDP con el host, sino también manipular el estado de la instancia EC2 de AWS, iniciándola y deteniéndola según la demanda de la cola de tareas del BotCity Orchestrator.

Para configurar un host con soporte de AWS EC2, necesitará la siguiente información:

ID de Instancia
Región de AWS (Opcional) la región de AWS donde se encuentra esta instancia
ID de Clave de Acceso AWS (Opcional) la clave de acceso de la API de AWS
ID de Clave Secreta de Acceso AWS (Opcional) la clave secreta de acceso de AWS
Nombre del Host o Dirección IP para comunicarse con el host
Nombre de usuario para iniciar la sesión
Contraseña para iniciar la sesión del usuario

Tip

El uso de un archivo de credenciales de AWS también es compatible. Asegúrese de responder Sí durante el comando host add cuando se le pregunte.

Si utiliza el archivo de credenciales, no se solicitarán la Región, la Clave de Acceso ni la Clave Secreta.

Requisitos¶

Para poder ejecutar el Session Manager correctamente, es obligatorio que:

Su servidor de Session Manager pueda comunicarse con el BotCity Orchestrator a través de HTTPS (Puerto 443)
Su servidor de Session Manager pueda alcanzar los hosts a través de la red para gestionar las sesiones
El usuario que utiliza para ejecutar el Session Manager tenga permiso para establecer conexión RDP u otra conexión necesaria con los hosts

Instalación¶

El Session Manager es parte del BotCity Studio SDK.

Para obtener el Session Manager, continúe con la instalación descrita en la guía de introducción.

Instalando como Servicio de Windows

Puede instalar el BotCity Session Manager como un Servicio de Windows siguiendo las instrucciones a continuación:

Tip

Necesitará un sistema operativo Windows con privilegios administrativos.

Paso 1: Crear el Servicio

Abra el Símbolo del sistema como Administrador:
Presione Win + X y seleccione Símbolo del sistema (Admin) o Windows PowerShell (Admin).

Ejecute el siguiente comando para crear un nuevo servicio:

sc create SessionManagerService binPath="C:\ruta\su\ejecutable.exe"

Reemplace C:\ruta\su\SessionManager.exe con la ruta completa a su archivo .exe.
Nota: Asegúrese de que no haya espacio entre binPath= y la ruta.

Paso 2: Configurar el Servicio para Iniciar Automáticamente

Ejecute el siguiente comando para configurar el servicio para que se inicie automáticamente al iniciar el sistema:
```
sc config SessionManagerService start=auto
```
Para iniciar el servicio de inmediato, use:
```
sc start SessionManagerService
```

Paso 3: Verificar el Servicio

Abra Servicios (presione Win + R, escriba services.msc y presione Enter).
Localice SessionManagerService en la lista de servicios para confirmar que aparece.
Verifique que el Tipo de inicio del servicio esté configurado en Automático.
Reinicie el sistema para verificar que el servicio se inicie automáticamente al arrancar.

Paso 4: Pruebas y Solución de Problemas

Para verificar el estado de su servicio, puede usar:
```
sc query SessionManagerService
```
Si el servicio no se inicia, verifique el log_sm.txt en la carpeta logs del BotCity Studio SDK.
Alternativamente, consulte el Visor de eventos en Registros de Windows > Aplicación.

Desinstalar el Servicio

Para eliminar el servicio, ejecute:

sc delete SessionManagerService

Este comando elimina el servicio por completo.

Configuración¶

Tip

Puede personalizar la ubicación de la base de datos de configuración de Session Manager estableciendo la ruta completa al archivo smdb en su conf/conf.bcf bajo el parámetro sessionManagerDBPath.

sessionManagerDBPath=/ruta/ejemplo/BotCity/config_file.smdb

Toda la configuración de Session Manager se realiza a través de la interfaz de línea de comandos (CLI) de Session Manager.

Para ejecutar el Session Manager, necesitará al menos:

Agregar un host
Adjuntar un Runner a un host registrado

Agregar un Host¶

Tip

Antes de proceder, asegúrese de tener a mano:

La IP o nombre del host para la conexión con el host.
El nombre de usuario y la contraseña que se utilizarán para abrir la sesión.
Cualquier otra información pertinente requerida por el protocolo que se utilizará para la conexión de sesión.

Abra el terminal de comando de su elección y navegue hasta la carpeta del BotCity Studio SDK donde se encuentra el SessionManager.
Ejecute el comando para agregar un nuevo host SessionManager host add.
Siga las instrucciones en el indicador.

Adjuntar un Runner a un Host¶

Tip

Antes de proceder, asegúrese de tener a mano:

La ruta completa en el host donde está instalado el BotCity SDK para el Runner deseado.

Abra el terminal de comando de su elección y navegue hasta la carpeta del BotCity Studio SDK donde se encuentra el SessionManager.
Ejecute el comando para adjuntar un nuevo runner SessionManager runner attach.
Siga las instrucciones en el indicador.

Liberar un Runner de un Host¶

Abra el terminal de comando de su elección y navegue hasta la carpeta del BotCity Studio SDK donde se encuentra el SessionManager.
Ejecute el comando para liberar un runner SessionManager runner release.
Siga las instrucciones en el indicador.

Listar todos los Hosts y Runners Asociados¶

Abra el terminal de comando de su elección y navegue hasta la carpeta del BotCity Studio SDK donde se encuentra el SessionManager.
Ejecute el comando para listar todos los hosts SessionManager list all.

Eliminar un Host¶

Abra el terminal de comando de su elección y navegue hasta la carpeta del BotCity Studio SDK donde se encuentra el SessionManager.
Ejecute el comando para eliminar un host SessionManager host remove.
Siga las instrucciones en el indicador.

Ejecutar el Session Manager¶

Puede ejecutar el Session Manager haciendo doble clic en la aplicación SessionManager o ejecutando el siguiente comando para la ejecución local:

SessionManager run local

Detalles Técnicos¶

Cómo Funciona¶

El Session Manager monitorea la cola de tareas en tiempo real, activando recursos a medida que la cola crece y desactivándolos cuando disminuye la demanda. Está optimizado para proporcionar una asignación de recursos oportuna, reduciendo el tiempo de inactividad y asegurando la disponibilidad de recursos cuando sea necesario.

Flujo de Procesos:

Monitoreo de la Cola: El Session Manager monitorea continuamente la cola de tareas.
Activación de Recursos: Cuando existe demanda de tareas, los recursos se activan para manejar la carga.
Desactivación de Recursos: A medida que cesa la demanda, los recursos se liberan para optimizar la eficiencia y reducir costos.

Resolución de Problemas¶

Falla al Iniciar el Servicio: Verifique el archivo sm_out.log en la carpeta logs del BotCity Studio SDK. Alternativamente, consulte el Visor de Eventos en Registros de Windows > Aplicación.
Problemas de Configuración: Asegúrese de que todos los ajustes de configuración estén correctamente definidos y coincidan con las especificaciones del sistema.

Para más ayuda, contacte a nuestro equipo de soporte.