Hybrid-Agent-Integration

Auf einen Blick

Verbinden Sie Ihren Altium 365 Workspace mit einem lokal betriebenen PLM-System, ohne dieses über das Internet zugänglich zu machen oder Ports für eingehenden Datenverkehr zu öffnen. Dieser Artikel erläutert, wie der Hybrid Agent Informationen über ausgehende HTTPS-Verbindungen überträgt, und führt Sie durch die Voraussetzungen, die Installation und die Konfiguration – einschließlich des Betriebs als Windows-Dienst. Lesen Sie weiter und machen Sie den nächsten Schritt zur Einrichtung Ihrer hybriden PLM-Integration.

- Informieren Sie sich über die Lizenz-, Java- und Netzwerkanforderungen für den Hybrid Agent.
- Erfahren Sie, wie Sie einen API-Schlüssel generieren, den Agenten starten und die PLM-Verbindung in Ihrem Workspace konfigurieren.
- Erhalten Sie Anleitungen zum Betrieb des Agenten als Windows-Dienst und zur Umstellung auf einen neuen API-Schlüssel.
Mit KI tiefer einsteigen:

Die hybride Integration kommt zum Einsatz, wenn ein Unternehmen, das Altium 365 verwendet, seinen Workspace mit einem PLM-System integrieren möchte, das lokal im Unternehmensnetzwerk gehostet wird und keine öffentliche IP-Adresse hat – also nicht über das Internet erreichbar ist.

Hierzu wird ein kleines Programm namens Hybrid Agent im Unternehmensnetzwerk ausgeführt. Dieses Programm kommuniziert mit Altium 365 und überträgt Informationen zwischen dem Altium 365 Workspace und dem PLM-System innerhalb des geschlossenen Netzwerks. Die Kommunikation mit dem Hybrid Agent erfolgt über HTTPS. Es müssen keine Netzwerkports für eingehenden Datenverkehr aus dem Internet geöffnet werden. Der standardmäßige HTTPS-Port 443 wird nur für ausgehenden Datenverkehr benötigt.

Note:

Hybride Integration einrichten

Laden Sie das Agent-Archiv () herunter und entpacken Sie dessen Inhalt in ein bekanntes Verzeichnis. Es enthält eine Java-Anwendung (hybrid-agent.jar), die auf einem Rechner innerhalb des Unternehmensnetzwerks ausgeführt werden muss, von dem aus das lokal gehostete PLM-System und Altium 365 erreichbar sind.

Dieser Rechner muss not öffentlich über das Internet erreichbar sein, muss jedoch eine Verbindung mit der von Ihrem Unternehmen genutzten Altium 365-Umgebung herstellen können.

  • Beachten Sie, dass der Hybrid Agent not auf dem Rechner ausgeführt werden muss, auf dem das PLM-System gehostet wird, auch wenn eine solche Konfiguration keine Probleme verursachen sollte.
  • Die Hybrid Agent-Anwendung enthält entsprechende Shell-Skriptdateien (z. B. agent.sh) für Linux-basierte Systeme. Verwenden Sie diese anstelle der Windows-Dateien *.bat in den nachfolgenden Anweisungen zur Einrichtung des Agents.

Hybrid Agent-Versionen bis einschließlich Version 5 erfordern Java Development Kit (JDK) Version 11 oder höher. Ab Version 6 (veröffentlicht am 6. Juli 2026) benötigt der Hybrid Agent JDK Version 17 oder höher.

Altium 365 Workspaces unterstützen sowohl Hybrid Agent-Version 5 als auch Version 6. Wenn Sie also bereits Hybrid Agent-Version 5 installiert haben, ist ein Upgrade auf Version 6 nicht erforderlich.

Sobald die Hybrid Agent-Anwendung eingerichtet ist:

  1. Generieren Sie den API-Schlüssel auf der Seite Hybrid Agent im Altium 365 Workspace ().
  2. Erstellen Sie eine Umgebungsvariable HYBRID_AGENT_API_KEY mit dem API-Schlüssel als Wert.
  3. Führen Sie agent.bat mit dem folgenden Befehlsaufruf aus. Als Argument für den URL-Parameter geben Sie die URL Ihres Altium 365 Workspace an:
    agent.bat https://acme.365.altium.com

Wenn der Hybrid Agent aktiv ist, erstellt 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 besitzt und nur eine einzige Instanz des Hybrid Agent ausgeführt werden kann. Der Agent unterstützt mehrere PLM-Konfigurationsinstanzen, sofern beide PLM-Systeme innerhalb desselben geschlossenen Netzwerks gehostet werden.

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

Ein Beispiel für die Ausführung des Hybrid Agent als Windows-Dienst mithilfe des Dienstmanagers NSSM:

  1. Führen Sie den folgenden Befehl aus: nssm install HybridAgent.
  2. Geben Sie im NSSM-Dialogfenster (auf der Registerkarte Application) den Dateipfad von agent.bat in das Feld Path und Ihre Workspace-URL in das 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. Führen Sie bei Bedarf nssm edit HybridAgent aus, um diese Änderungen vorzunehmen.
    2. Als Alternative zum Erstellen der standardmäßigen Umgebungsvariablen PATH und JAVA_HOME für Java können diese auf der NSSM-Registerkarte Environment hinzugefügt werden. Bei diesem Vorgehen sind die Variablen nur aktiv, wenn der Dienst HybridAgent ausgeführt wird.
    3. Ebenso kann 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 über das Windows-Verwaltungstool Services oder mit dem NSSM-Befehl: nssm start HybridAgent. Dies ist nach einem Neustart des PCs nicht erforderlich, wenn der Dienst für den automatischen Start konfiguriert ist.
  4. Stellen Sie über das Windows-Verwaltungstool Services oder mit dem NSSM-Befehl nssm status HybridAgent sicher, dass der Dienst HybridAgent ausgeführt wird.

Sobald der Hybrid Agent eine Verbindung zu Ihrem Altium 365 Workspace hergestellt hat (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 lokal gehosteten PLM-Systems so ein, wie es innerhalb Ihres geschlossenen Netzwerks erreichbar 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. Verwenden Sie mit NSSM den Befehl nssm restart HybridAgent oder beenden und starten Sie den Dienst HybridAgent in Windows unter Services.

AI-LocalizedKI-lokalisiert
Wenn Sie ein Problem feststellen, wählen Sie den Text/das Bild aus und drücken SieCtrl + Enter, um uns Ihr Feedback zu senden.
Contents
Funktionsverfügbarkeit

Die Ihnen zur Verfügung stehenden Funktionen hängen davon ab, über welche Altium-Lösung Sie verfügen – Altium Develop, Altium Agile Teams, Altium Agile Enterprise oder Altium Designer (mit aktivem Laufzeitvertrag).

Wenn Sie eine dokumentierte Funktion in Ihrer tatsächlich verwendeten Software nicht sehen, wenden Sie sich an den Altium-Vertrieb, um mehr zu erfahren.