Integración de agentes híbridos

La integración híbrida se aplica a la situación en la que una empresa que utiliza Altium 365 desea integrar su Workspace con un sistema PLM alojado localmente, dentro de la red de la empresa, que no tiene una dirección IP pública; es decir, no está expuesto a internet.

Para lograrlo, se ejecuta dentro de la red de la empresa un pequeño programa llamado Hybrid Agent. Este programa se comunica con Altium 365, retransmitiendo información entre el Workspace de Altium 365 y el sistema PLM dentro de la red cerrada. La comunicación con el Hybrid Agent se realiza mediante HTTPS y no es necesario abrir puertos de red para tráfico entrante desde internet. Solo se requiere el puerto HTTPS estándar 443 para tráfico saliente.

Configurar la integración híbrida

Descargue el archivo del Agent () y descomprima su contenido en una ubicación conocida. Contiene una aplicación Java (hybrid-agent.jar) que debe ejecutarse en una máquina dentro de la red de la empresa, desde la cual se pueda acceder tanto al sistema PLM local como a Altium 365.

Esa máquina no not necesita ser accesible públicamente desde internet, pero sí debe ser capaz de conectarse con el entorno de Altium 365 que utiliza su empresa.

Una vez que la aplicación Hybrid Agent esté en su lugar:

1. Genere la clave API en la página Hybrid Agent del Workspace de Altium 365 ().
2. Cree una variable de entorno HYBRID_AGENT_API_KEY con la clave API como valor.

3. Ejecute agent.bat usando el siguiente contexto de comando, donde el argumento del parámetro URL debe ser el de su Workspace de Altium 365:
   agent.bat https://acme.365.altium.com

Cuando esté activo, el Hybrid Agent generará un archivo de registro en la carpeta hybrid-agent\logs de la aplicación.

Se recomienda encarecidamente ejecutar el Hybrid Agent como un servicio de Windows en el entorno de producción, en lugar de hacerlo directamente en la terminal, aunque esto último puede usarse para pruebas.

Un ejemplo de enfoque para ejecutar el Hybrid Agent como servicio de Windows usando el administrador de servicios NSSM:

1. Ejecute el comando: nssm install HybridAgent.
2. En la ventana de diálogo de NSSM (en la pestaña Application), introduzca la ruta del archivo agent.bat en el campo Path y la URL de su Workspace en el campo Arguments, y haga clic en Install service.
   1. Puede configurar el comportamiento de inicio del servicio con la opción Startup type en la pestaña Details del cuadro de diálogo de NSSM. Si es necesario, ejecute nssm edit HybridAgent para realizar esos cambios.
   2. Como alternativa a crear las variables de entorno estándar PATH y JAVA_HOME para Java, estas pueden agregarse en la pestaña Environment de NSSM. Con este enfoque, las variables solo estarán activas cuando el servicio HybridAgent esté en ejecución.

   3. De forma similar a lo anterior, la variable HYBRID_AGENT_API_KEY también puede trasladarse a la configuración de entorno de NSSM para que esté activa cuando el servicio esté en ejecución.

3. Inicie el servicio HybridAgent con la herramienta de administración de Services de Windows, o con el comando de NSSM: nssm start HybridAgent. Esto no es necesario (después de reiniciar el PC) si el servicio está configurado para iniciarse automáticamente.
4. Asegúrese de que el servicio HybridAgent esté en ejecución en la herramienta de administración de Services de Windows, o con el comando de NSSM: nssm status HybridAgent.

Una vez que el Hybrid Agent se haya conectado a su Workspace de Altium 365 (actualice la ventana del navegador para comprobar su estado), puede proceder a configurar la integración PLM en el Workspace de Altium 365. En la página Add Configuration, habilite la opción de conexión Hybrid Agent e introduzca la URL de su PLM local, tal como se ve dentro de su red cerrada, en el campo URL.