Intégration de l’agent hybride
En un coup d'œil
- Découvrez les prérequis de l’agent hybride en matière de licence, de Java et de réseau.
- Apprenez à générer une clé API, à démarrer l’agent et à configurer la connexion PLM dans votre espace de travail.
- Consultez les instructions pour exécuter l’agent en tant que service Windows et le mettre à jour afin qu’il utilise une nouvelle clé API.
L’intégration hybride s’applique lorsqu’une entreprise utilisant Altium 365 souhaite intégrer son espace de travail à un système PLM hébergé sur site, au sein de son réseau, qui ne dispose pas d’adresse IP publique et n’est donc pas exposé à Internet.
Pour ce faire, un petit programme appelé Hybrid Agent est exécuté au sein du réseau de l’entreprise. Ce programme communique avec Altium 365 et relaie les informations entre l’espace de travail Altium 365 et le système PLM au sein du réseau fermé. La communication avec l’agent hybride s’effectue via HTTPS et ne nécessite l’ouverture d’aucun port réseau pour le trafic entrant depuis Internet. Le port HTTPS standard 443 n’est requis que 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 du réseau de l’entreprise depuis laquelle le système PLM sur site et Altium 365 sont accessibles.
Cette machine n’a not besoin d’être accessible publiquement depuis Internet, mais elle doit pouvoir se connecter à l’environnement Altium 365 utilisé par votre entreprise.
Une fois l’application de l’agent hybride en place :
- Générez la clé API sur la page Hybrid Agent de l’espace de travail Altium 365
-
Créez une variable d’environnement
HYBRID_AGENT_API_KEYayant pour valeur la clé API. -
Exécutez
agent.batà l’aide de la syntaxe de commande suivante, en indiquant comme argument du paramètre URL l’adresse de votre espace de travail Altium 365 :
agent.bat https://acme.365.altium.com
Lorsqu’il est actif, l’agent hybride génère un fichier journal dans le dossier hybrid-agent\logs de l’application.
Il est vivement recommandé d’exécuter l’agent hybride 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 de procédure pour exécuter l’agent hybride 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.batdans le champ Path et l’URL de votre espace de travail dans le champ Arguments, puis cliquez sur Install service.-
Vous pouvez définir le comportement de démarrage du service à l’aide de l’option Startup type sous l’onglet Details de la boîte de dialogue NSSM. Si nécessaire, exécutez
nssm edit HybridAgentpour effectuer ces modifications. -
Au lieu de créer les variables d’environnement standard
PATHetJAVA_HOMEpour Java, vous pouvez les ajouter sous l’onglet Environment de NSSM. Avec cette méthode, les variables ne sont actives que lorsque le serviceHybridAgentest en cours d’exécution. -
De même, la variable
HYBRID_AGENT_API_KEYpeut également être déplacée vers la configuration de l’environnement NSSM afin qu’elle soit active lorsque le service est en cours d’exécution.
-
Vous pouvez définir le comportement de démarrage du service à l’aide de l’option Startup type sous l’onglet Details de la boîte de dialogue NSSM. Si nécessaire, exécutez
-
Démarrez le service
HybridAgentà l’aide de l’outil de gestion Services de Windows ou de la commande NSSM :nssm start HybridAgent. Cette opération n’est pas nécessaire (après un redémarrage du PC) si le service est configuré pour démarrer automatiquement. -
Vérifiez que le service
HybridAgentest en cours d’exécution dans l’outil de gestion Services de Windows ou à l’aide de la commande NSSM :nssm status HybridAgent.
Une fois l’agent hybride connecté à votre espace de travail Altium 365 (actualisez la fenêtre du navigateur pour vérifier son état), vous pouvez configurer l’intégration PLM dans l’espace de travail Altium 365. Sur la page Add Configuration, activez l’option de connexion Hybrid Agent et saisissez dans le champ URL l’URL de votre PLM sur site, telle qu’elle est accessible depuis votre réseau fermé.



