Kimaldi

Aplicación Node.js/Express.js que se comunica a través de web sockets con la API de Kimaldi. Es una aplicación que se ejecuta como un servicio windows. Además contiene un endpoint para poder abrir las puertas manualmente.

Instalación

Antes que nada descarga node.js (https://nodejs.org/es/) descargar la version lts. Y clonar el repositorio (https://gitlab.com/mtpconsulting/sintesysglobal) en cualquier carpeta.

1. Instalar las dependencias y ejecutar en una terminal cmd (dentro de la carpeta /kimaldi del repositorio de gitlab):

   npm install

2. Copiar y renombrar el archivo .env.example a .env (en la misma carpeta) y configurar las variables de entorno.

Importante en este punto es la variable SERVER_WINDOWS_SCRIPT que es el path en donde se encuentra el archivo server.js, además asegurarse usar \ doble barra invertida para el path.

Configuración de múltiples controles de acceso:

El sistema ahora soporta múltiples controles de acceso. Para configurar cada control, puedes usar variables de entorno con el siguiente formato:

• ACCESS_<sEUI64>_ACCESS_ID: Define el access_id del backend para un nodo específico
• KIMALDI_API_<sEUI64>: Define el endpoint de la API de Kimaldi para un nodo específico

Ejemplo:

ACCESS_001824FFFF030409_ACCESS_ID=1
KIMALDI_API_001824FFFF030409=http://localhost:8080

ACCESS_001824FFFF030410_ACCESS_ID=2
KIMALDI_API_001824FFFF030410=http://localhost:8081

Si no se configuran variables específicas para un nodo, el sistema usará los valores por defecto:

• EMANAGYM_ACCESS_ID: Access ID por defecto
• KIMALDI_API_ENDPOINT: Endpoint de Kimaldi por defecto

3. Crear el servicio windows. Para eso ejecutar en una terminal cmd (dentro de la carpeta /kimaldi del repositorio de gitlab como modo administrador):

   node service.windows

4. Para probar si funciona correctamente, ir al navegador y tipear:

   localhost:45679

NOTA: A veces ocurre que el servicio no se inicializa al momento. Ir a los servicios e inicializarlo. NOTA2: Al instalar el servicio node service.windows crea una carpeta daemon, si por algún motivo se tiene que desinstalar el servicio asegurarse se que esa carpeta también se haya eliminado. Por que puede pasar que se elimina el servicio windows pero la carpeta daemon sigue estando, y el sistema operativo va a detectar que el servicio sigue instalado, cuando no es así.

Desarrollo

Para levantar el entorno en desarrollo, seguir los mismo pasos, a excepción del paso 3. Para levantar el servidor ejecutar:

npm run dev

NOTAS

Para que funcione correctamente, asegurarse de que la API de kimaldi este ejecutandose y configurada correctamente, para que envíe los eventos web sockets a 127.0.0.1:45679 al canal 'event'. En la carpeta /docs hay un documento que explica como configurar la API de Kimaldi (SOP - Registro de KProduct_dll en Windows 10.docx).

Para matar el servio, primero hay que detenerlo y ejecutar como administrador: sc delete kimaldiemanagymapplication.exe