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.
-
Tenga en cuenta que el Hybrid Agent no not necesita ejecutarse en la máquina que aloja el sistema PLM, aunque una configuración de ese tipo no debería causar problemas.
-
La aplicación Hybrid Agent incluye archivos de script de shell equivalentes (como
agent.sh) para sistemas basados en Linux; utilícelos en lugar de los archivos de Windows *.bat en las instrucciones de configuración del agent que aparecen a continuación.
El Hybrid Agent requiere el Java Development Kit (JDK) en la versión 11 o superior.
Installing JDK
Se puede usar tanto Oracle JDK como OpenJDK. Asegúrese de contar con una licencia válida al usar Oracle JDK.
Si instala el JDK desde un archivo comprimido simple (en lugar de un ejecutable instalador), será necesario agregar sus variables de entorno de ruta. En una máquina/VM con Windows, normalmente son:
-
PATH – que apunta a la carpeta bin de la instalación.
-
JAVA_HOME – que apunta a la propia carpeta de instalación.
Pruebe el acceso al ejecutable de Java ejecutando un comando Java -version.
Una vez que la aplicación Hybrid Agent esté en su lugar:
-
Genere la clave API en la página Hybrid Agent del Workspace de Altium 365 (
).
-
Cree una variable de entorno
HYBRID_AGENT_API_KEY con la clave API como valor.
-
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.
Tenga en cuenta que el Workspace solo tiene una clave API válida en un momento dado, y que solo puede estar ejecutándose una única instancia del Hybrid Agent. El Agent admitirá más de una instancia de configuración de PLM si ambos sistemas PLM están alojados dentro de la misma red cerrada.
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:
-
Ejecute el comando:
nssm install HybridAgent.
-
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.
-
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.
-
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.
-
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.
-
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.
-
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.
La clave API actual puede cancelarse usando su comando Revoke asociado. En ese caso, deberá generarse una nueva clave API y actualizar la variable de entorno HYBRID_AGENT_API_KEY con el nuevo valor de la clave.
Reinicie el Hybrid Agent para usar la nueva clave; con NSSM use el comando nssm restart HybridAgent, o detenga/inicie el servicio HybridAgent en Services de Windows.
AI-localized