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.
Note:
-
Für die Nutzung von Hybrid Integration ist eine spezielle Altium Workspace-Lizenz erforderlich.
-
Wenn Sie eine Integration mit einem Siemens Teamcenter® PLM einrichten (wofür der Hybrid Agent erforderlich ist), lesen Sie bitte zuerst die Seite Additional Installation and Setup for Siemens Teamcenter page.
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.
-
Beachten Sie, dass der Hybrid Agent not nicht auf dem Rechner ausgeführt werden muss, auf dem das PLM-System gehostet wird, obwohl eine solche Konfiguration keine Probleme verursachen sollte.
-
Die Hybrid Agent-Anwendung enthält entsprechende Shell-Skriptdateien (wie z. B.
agent.sh) für Linux-basierte Systeme – verwenden Sie diese anstelle der Windows-*.bat-Dateien in den unten stehenden Anweisungen zur Einrichtung des Agenten.
Der Hybrid Agent erfordert das Java Development Kit (JDK) in Version 11 oder höher.
Installing JDK
Es kann entweder Oracle JDK oder OpenJDK verwendet werden. Stellen Sie sicher, dass Sie bei der Verwendung von Oracle JDK über eine gültige Lizenz verfügen.
Wenn das JDK aus einem einfachen Archiv (anstatt über eine Installer-Executable) installiert wird, müssen dessen Pfad-Umgebungsvariablen hinzugefügt werden. Auf einem Windows-Rechner bzw. in einer Windows-VM sind dies typischerweise:
-
PATH – verweist auf den bin-Ordner der Installation.
-
JAVA_HOME – verweist auf den Installationsordner selbst.
Testen Sie den Zugriff auf die Java-Executable, indem Sie einen Java -version-Befehl ausführen.
Sobald die Hybrid Agent-Anwendung eingerichtet ist:
-
Generieren Sie den API-Schlüssel auf der Seite Hybrid Agent des Altium 365 Workspace (
).
-
Erstellen Sie eine Umgebungsvariable
HYBRID_AGENT_API_KEY und setzen Sie den API-Schlüssel als deren Wert.
-
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.
Beachten Sie, dass der Workspace zu jedem Zeitpunkt nur einen gültigen API-Schlüssel hat und nur eine einzelne Instanz des Hybrid Agent ausgeführt werden kann. Der Agent unterstützt mehr als eine PLM-Konfigurationsinstanz, wenn beide PLM-Systeme innerhalb desselben geschlossenen Netzwerks gehostet werden.
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:
-
Führen Sie den Befehl aus:
nssm install HybridAgent.
-
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.
-
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.
-
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.
-
Ä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.
-
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.
-
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.
Der aktuelle API-Schlüssel kann mit dem zugehörigen Befehl Revoke widerrufen werden. In diesem Fall muss ein neuer API-Schlüssel generiert und die Umgebungsvariable HYBRID_AGENT_API_KEY mit dem neuen Schlüsselwert aktualisiert werden.
Starten Sie den Hybrid Agent neu, um den neuen Schlüssel zu verwenden – mit NSSM verwenden Sie den Befehl nssm restart HybridAgent, oder stoppen/starten Sie den Dienst HybridAgent in Windows Services.
AI-localized