Hybrid Agent Integration

Parent page: PLM Integration

Hybrid Integration applies to the situation where a company using Altium 365 wishes to integrate their Workspace with a PLM system that is hosted on-premises, inside the company's network, which does not have a public IP address – it is not exposed to the internet.

To achieve this, a small program called Hybrid Agent is run inside the company's network. This program communicates with Altium 365, relaying information between the Altium 365 Workspace and the PLM system inside the closed network. Communication with the Hybrid Agent is through HTTPS and there is no need to open any network ports for incoming traffic from the internet. Standard HTTPS port 443 is required for outbound traffic only.

Note:

Set up Hybrid Integration

The Hybrid Agent installation package can be obtained from the Altium 365 Workspace Hybrid Agent page, opened from the Hybrid Agent tab option at the top of the (new) PLM Management page (Admin – PLM Integration).

Download the Agent archive () and unpack its contents to a known location. It contains a Java application (hybrid-agent.jar) that needs to be run on a machine inside the company's network, from where the on-premises PLM system and Altium 365 are reachable.

That machine does not need to be publicly accessible from the internet, but does need to be capable of connecting with the Altium 365 environment that your company uses.

  • Note that the Hybrid Agent does not need to be run on the machine that is hosting the PLM system, although such a setup should not cause problems.
  • The Hybrid Agent application includes equivalent shell script files (such as agent.sh) for Linux-based systems – use in place of the Windows *.bat files in the agent setup instructions below.

The Hybrid Agent requires the Java Development Kit (JDK) in version 11 or higher.

Once the Hybrid Agent application is in place:

  1. Generate the API key in the Altium 365 Workspace Hybrid Agent page ().
  2. Create a HYBRID_AGENT_API_KEY environment variable with the API key as its value.
  3. Run agent.bat using the following command context, where the URL parameter argument should be that of your Altium 365 Workspace:
    agent.bat https://acme.365.altium.com

When active, the Hybrid Agent will generate a log file in the application's hybrid-agent\logs folder.

Note that the Workspace has only one valid API Key at any one time, and only a single instance of the Hybrid Agent can be running. The Agent will support more than one PLM configuration instance if both PLM systems are hosted within the same closed network.

It is highly recommended to run the Hybrid Agent as a Windows service in the production environment rather than directly in the terminal, although the latter can be used for testing.

An example approach to running the Hybrid Agent as a Windows service using the NSSM service manager:

  1. Run the command: nssm install HybridAgent.
  2. In the NSSM dialog window (under the Application tab), enter the agent.bat file path in the Path field and your Workspace URL in the Arguments field, and click Install service.
    1. You can set the service startup behavior with the Startup type option under the NSSM dialog's Details tab. If needed, run nssm edit HybridAgent to make such changes.
    2. As an alternative to creating standard PATH and JAVA_HOME environment variables for Java, they can be added under the NSSM Environment tab. With this approach the variables will be active only when the HybridAgent service is running.
    3. Similar to above, the HYBRID_AGENT_API_KEY variable also can be moved to the NSSM environment setup so it is active when the service is running.

  3. Start the HybridAgent service with the Windows Services management tool, or with the NSSM command: nssm start HybridAgent. This is not required (after a PC restart) if the service is set for automatic startup.
  4. Ensure the HybridAgent service is running in the Windows Services management tool, or with the NSSM command: nssm status HybridAgent.

Once the Hybrid Agent has connected to your Altium 365 Workspace (refresh the browser window to check its status), you can proceed to configure PLM Integration in the Altium 365 Workspace. In the Add Configuration page, enable the Hybrid Agent connection option and enter the URL of your on-premises PLM, as seen within your closed network, in the URL field.

The current API Key can be canceled using its associated Revoke command. In that event, a new API Key needs to be generated and the HYBRID_AGENT_API_KEY environment variable updated with the new Key value.

Restart the Hybrid Agent to use the new Key – with NSSM use the nssm restart HybridAgent command, or stop/start the HybridAgent service in Windows Services.

If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.

Source URL: https://www.altium365.com/documentation/hybrid-agent-plm-integration