Integration hybrider Agenten

Hybrid Integration gilt für den Fall, dass ein Unternehmen, das Altium 365 verwendet, seinen Workspace mit einem lokal gehosteten PLM-System innerhalb des Unternehmensnetzwerks integrieren möchte, das keine öffentliche IP-Adresse hat – es ist nicht dem Internet ausgesetzt.

Um dies zu erreichen, wird ein kleines Programm namens Hybrid Agent innerhalb des Unternehmensnetzwerks ausgeführt. Dieses Programm kommuniziert mit Altium 365 und leitet Informationen zwischen dem Altium 365 Workspace und dem PLM-System innerhalb des geschlossenen Netzwerks weiter. Die Kommunikation mit dem Hybrid Agent erfolgt über HTTPS, und es ist nicht erforderlich, Netzwerkports für eingehenden Datenverkehr aus dem Internet zu öffnen. Der Standard-HTTPS-Port 443 wird nur für ausgehenden Datenverkehr benötigt.

Hybrid Integration einrichten

Laden Sie das Agent-Archiv herunter () und entpacken Sie seinen Inhalt an einen bekannten Speicherort. Es enthält eine Java-Anwendung (hybrid-agent.jar), die auf einem Rechner innerhalb des Unternehmensnetzwerks ausgeführt werden muss, von dem aus sowohl das lokale PLM-System als auch Altium 365 erreichbar sind.

Dieser Rechner muss not nicht öffentlich über das Internet erreichbar sein, muss jedoch in der Lage sein, eine Verbindung mit der von Ihrem Unternehmen verwendeten Altium 365-Umgebung herzustellen.

Sobald die Hybrid Agent-Anwendung eingerichtet ist:

1. Generieren Sie den API-Schlüssel auf der Seite Hybrid Agent des Altium 365 Workspace ().
2. Erstellen Sie eine Umgebungsvariable HYBRID_AGENT_API_KEY und setzen Sie den API-Schlüssel als deren Wert.

3. Führen Sie agent.bat mit dem folgenden Befehlskontext aus, wobei das URL-Parameterargument dem Ihres Altium 365 Workspace entsprechen sollte:
   agent.bat https://acme.365.altium.com

Wenn der Hybrid Agent aktiv ist, erzeugt er eine Protokolldatei im Ordner hybrid-agent\logs der Anwendung.

Es wird dringend empfohlen, den Hybrid Agent in der Produktionsumgebung als Windows-Dienst statt direkt im Terminal auszuführen, obwohl Letzteres zu Testzwecken verwendet werden kann.

Ein Beispiel dafür, wie der Hybrid Agent mithilfe des Dienstmanagers NSSM als Windows-Dienst ausgeführt werden kann:

1. Führen Sie den Befehl aus: nssm install HybridAgent.
2. Geben Sie im NSSM-Dialogfenster (auf der Registerkarte Application) den Dateipfad zu agent.bat im Feld Path und Ihre Workspace-URL im Feld Arguments ein und klicken Sie auf Install service.
   1. Sie können das Startverhalten des Dienstes mit der Option Startup type auf der Registerkarte Details des NSSM-Dialogs festlegen. Falls erforderlich, führen Sie nssm edit HybridAgent aus, um solche Änderungen vorzunehmen.
   2. Als Alternative zum Erstellen der standardmäßigen Umgebungsvariablen PATH und JAVA_HOME für Java können diese auf der Registerkarte Environment von NSSM hinzugefügt werden. Bei diesem Ansatz sind die Variablen nur aktiv, wenn der Dienst HybridAgent ausgeführt wird.

   3. Ähnlich wie oben kann auch die Variable HYBRID_AGENT_API_KEY in die NSSM-Umgebungskonfiguration verschoben werden, sodass sie aktiv ist, wenn der Dienst ausgeführt wird.

3. Starten Sie den Dienst HybridAgent mit dem Windows-Verwaltungstool Services oder mit dem NSSM-Befehl: nssm start HybridAgent. Dies ist nach einem PC-Neustart nicht erforderlich, wenn der Dienst für den automatischen Start konfiguriert ist.
4. Stellen Sie sicher, dass der Dienst HybridAgent im Windows-Verwaltungstool Services ausgeführt wird, oder prüfen Sie dies mit dem NSSM-Befehl: nssm status HybridAgent.

Sobald der Hybrid Agent mit Ihrem Altium 365 Workspace verbunden ist (aktualisieren Sie das Browserfenster, um seinen Status zu prüfen), können Sie mit der Konfiguration der PLM-Integration im Altium 365 Workspace fortfahren. Aktivieren Sie auf der Seite Add Configuration die Verbindungsoption Hybrid Agent und geben Sie im Feld URL die URL Ihres lokalen PLM ein, wie sie innerhalb Ihres geschlossenen Netzwerks sichtbar ist.