Integrazione di agenti ibridi

L'integrazione ibrida si applica alla situazione in cui un'azienda che utilizza Altium 365 desidera integrare il proprio Workspace con un sistema PLM ospitato on-premises, all'interno della rete aziendale, che non dispone di un indirizzo IP pubblico, quindi non è esposto a internet.

Per ottenere questo risultato, all'interno della rete aziendale viene eseguito un piccolo programma chiamato Hybrid Agent. Questo programma comunica con Altium 365, inoltrando le informazioni tra il Workspace Altium 365 e il sistema PLM all'interno della rete chiusa. La comunicazione con l'Hybrid Agent avviene tramite HTTPS e non è necessario aprire alcuna porta di rete per il traffico in ingresso da internet. Per il solo traffico in uscita è richiesta la porta HTTPS standard 443.

Configurare l'integrazione ibrida

Scarica l'archivio dell'Agent () ed estrai il suo contenuto in una posizione nota. Contiene un'applicazione Java (hybrid-agent.jar) che deve essere eseguita su una macchina all'interno della rete aziendale, dalla quale siano raggiungibili il sistema PLM on-premises e Altium 365.

Quella macchina non not deve essere accessibile pubblicamente da internet, ma deve essere in grado di connettersi all'ambiente Altium 365 utilizzato dalla tua azienda.

Una volta che l'applicazione Hybrid Agent è pronta:

1. Genera la chiave API nella pagina Hybrid Agent del Workspace Altium 365 ().
2. Crea una variabile di ambiente HYBRID_AGENT_API_KEY con la chiave API come valore.

3. Esegui agent.bat utilizzando il seguente contesto di comando, dove l'argomento del parametro URL deve essere quello del tuo Workspace Altium 365:
   agent.bat https://acme.365.altium.com

Quando è attivo, l'Hybrid Agent genererà un file di log nella cartella hybrid-agent\logs dell'applicazione.

Si consiglia vivamente di eseguire l'Hybrid Agent come servizio Windows nell'ambiente di produzione anziché direttamente nel terminale, anche se quest'ultima modalità può essere usata per i test.

Un esempio di approccio per eseguire l'Hybrid Agent come servizio Windows utilizzando il gestore di servizi NSSM:

1. Esegui il comando: nssm install HybridAgent.
2. Nella finestra di dialogo NSSM (nella scheda Application), inserisci il percorso del file agent.bat nel campo Path e l'URL del tuo Workspace nel campo Arguments, quindi fai clic su Install service.
   1. Puoi impostare il comportamento di avvio del servizio con l'opzione Startup type nella scheda Details della finestra di dialogo NSSM. Se necessario, esegui nssm edit HybridAgent per apportare tali modifiche.
   2. In alternativa alla creazione delle variabili di ambiente standard PATH e JAVA_HOME per Java, è possibile aggiungerle nella scheda Environment di NSSM. Con questo approccio, le variabili saranno attive solo quando il servizio HybridAgent è in esecuzione.

   3. Analogamente a quanto sopra, anche la variabile HYBRID_AGENT_API_KEY può essere spostata nella configurazione dell'ambiente NSSM in modo che sia attiva quando il servizio è in esecuzione.

3. Avvia il servizio HybridAgent con lo strumento di gestione Services di Windows oppure con il comando NSSM: nssm start HybridAgent. Questo non è necessario (dopo il riavvio del PC) se il servizio è impostato per l'avvio automatico.
4. Assicurati che il servizio HybridAgent sia in esecuzione nello strumento di gestione Services di Windows oppure con il comando NSSM: nssm status HybridAgent.

Una volta che l'Hybrid Agent si è connesso al tuo Workspace Altium 365 (aggiorna la finestra del browser per verificarne lo stato), puoi procedere con la configurazione dell'integrazione PLM nel Workspace Altium 365. Nella pagina Add Configuration, abilita l'opzione di connessione Hybrid Agent e inserisci nel campo URL l'URL del tuo PLM on-premises, così come viene visto all'interno della tua rete chiusa.