L’intégration hybride s’applique au cas où une entreprise utilisant Altium 365 souhaite intégrer son Workspace à un système PLM hébergé sur site, au sein du réseau de l’entreprise, qui ne dispose pas d’une adresse IP publique – il n’est pas exposé à Internet.
Pour y parvenir, un petit programme appelé Hybrid Agent est exécuté à l’intérieur du réseau de l’entreprise. Ce programme communique avec Altium 365 et relaie les informations entre le Workspace Altium 365 et le système PLM situé dans le réseau fermé. La communication avec le Hybrid Agent s’effectue via HTTPS et il n’est pas nécessaire d’ouvrir des ports réseau pour le trafic entrant depuis Internet. Le port HTTPS standard 443 est requis uniquement pour le trafic sortant.
Configurer l’intégration hybride
Téléchargez l’archive de l’Agent (
) et décompressez son contenu dans un emplacement connu. Elle contient une application Java (hybrid-agent.jar) qui doit être exécutée sur une machine située dans le réseau de l’entreprise, depuis laquelle le système PLM sur site et Altium 365 sont accessibles.
Cette machine n’a pas not besoin d’être accessible publiquement depuis Internet, mais elle doit pouvoir se connecter à l’environnement Altium 365 utilisé par votre entreprise.
-
Notez que le Hybrid Agent n’a pas not besoin d’être exécuté sur la machine qui héberge le système PLM, bien qu’une telle configuration ne devrait pas poser de problème.
-
L’application Hybrid Agent inclut des fichiers de script shell équivalents (tels que
agent.sh) pour les systèmes basés sur Linux – utilisez-les à la place des fichiers Windows *.bat dans les instructions de configuration de l’agent ci-dessous.
Le Hybrid Agent nécessite le Java Development Kit (JDK) en version 11 ou supérieure.
Installing JDK
Vous pouvez utiliser soit Oracle JDK, soit OpenJDK. Assurez-vous de disposer d’une licence valide si vous utilisez Oracle JDK.
Si vous installez le JDK à partir d’une archive simple (plutôt que d’un exécutable d’installation), ses variables d’environnement de chemin doivent être ajoutées. Sur une machine/VM Windows, il s’agit généralement de :
-
PATH – qui pointe vers le dossier bin de l’installation.
-
JAVA_HOME – qui pointe vers le dossier d’installation lui-même.
Testez l’accès à l’exécutable Java en exécutant une commande Java -version.
Une fois l’application Hybrid Agent en place :
-
Générez la clé API dans la page Hybrid Agent du Workspace Altium 365 (
).
-
Créez une variable d’environnement
HYBRID_AGENT_API_KEY avec la clé API comme valeur.
-
Exécutez agent.bat à l’aide du contexte de commande suivant, où l’argument du paramètre URL doit être celui de votre Workspace Altium 365 :
agent.bat https://acme.365.altium.com
Lorsqu’il est actif, le Hybrid Agent génère un fichier journal dans le dossier hybrid-agent\logs de l’application.
Notez que le Workspace ne possède qu’une seule clé API valide à un instant donné, et qu’une seule instance du Hybrid Agent peut être exécutée. L’Agent prendra en charge plus d’une instance de configuration PLM si les deux systèmes PLM sont hébergés dans le même réseau fermé.
Il est fortement recommandé d’exécuter le Hybrid Agent en tant que service Windows dans l’environnement de production plutôt que directement dans le terminal, bien que cette dernière méthode puisse être utilisée pour les tests.
Exemple d’approche pour exécuter le Hybrid Agent en tant que service Windows à l’aide du gestionnaire de services NSSM :
-
Exécutez la commande :
nssm install HybridAgent.
-
Dans la boîte de dialogue NSSM (sous l’onglet Application), saisissez le chemin du fichier
agent.bat dans le champ Path et l’URL de votre Workspace dans le champ Arguments, puis cliquez sur Install service.
-
Vous pouvez définir le comportement de démarrage du service avec l’option Startup type sous l’onglet Details de la boîte de dialogue NSSM. Si nécessaire, exécutez
nssm edit HybridAgent pour effectuer ces modifications.
-
Comme alternative à la création des variables d’environnement standard
PATH et JAVA_HOME pour Java, elles peuvent être ajoutées sous l’onglet Environment de NSSM. Avec cette approche, les variables ne seront actives que lorsque le service HybridAgent est en cours d’exécution.
-
De manière similaire, la variable HYBRID_AGENT_API_KEY peut également être déplacée vers la configuration d’environnement NSSM afin qu’elle soit active lorsque le service est en cours d’exécution.
-
Démarrez le service
HybridAgent avec l’outil de gestion Windows Services, ou avec la commande NSSM : nssm start HybridAgent. Cela n’est pas nécessaire (après un redémarrage du PC) si le service est configuré pour démarrer automatiquement.
-
Assurez-vous que le service
HybridAgent est en cours d’exécution dans l’outil de gestion Windows Services, ou avec la commande NSSM : nssm status HybridAgent.
Une fois que le Hybrid Agent s’est connecté à votre Workspace Altium 365 (actualisez la fenêtre du navigateur pour vérifier son état), vous pouvez procéder à la configuration de l’intégration PLM dans le Workspace Altium 365. Dans la page Add Configuration, activez l’option de connexion Hybrid Agent et saisissez l’URL de votre PLM sur site, telle qu’elle est visible dans votre réseau fermé, dans le champ URL.
La clé API actuelle peut être annulée à l’aide de sa commande Revoke associée. Dans ce cas, une nouvelle clé API doit être générée et la variable d’environnement HYBRID_AGENT_API_KEY mise à jour avec la nouvelle valeur de clé.
Redémarrez le Hybrid Agent pour utiliser la nouvelle clé – avec NSSM, utilisez la commande nssm restart HybridAgent, ou arrêtez/redémarrez le service HybridAgent dans Windows Services.
AI-localized