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, ovvero 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 di 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 sia il sistema PLM on-premises sia 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.
-
Nota che l'Hybrid Agent non not deve essere eseguito sulla macchina che ospita il sistema PLM, anche se una configurazione di questo tipo non dovrebbe causare problemi.
-
L'applicazione Hybrid Agent include file di script shell equivalenti (come
agent.sh) per sistemi basati su Linux: usali al posto dei file Windows *.bat nelle istruzioni di configurazione dell'agent riportate di seguito.
L'Hybrid Agent richiede il Java Development Kit (JDK) versione 11 o successiva.
Installing JDK
È possibile utilizzare sia Oracle JDK sia OpenJDK. Assicurati di disporre di una licenza valida quando utilizzi Oracle JDK.
Se installi il JDK da un archivio semplice (anziché da un eseguibile di installazione), è necessario aggiungere le relative variabili di ambiente del percorso. Su una macchina/VM Windows queste sono in genere:
-
PATH – che punta alla cartella bin dell'installazione.
-
JAVA_HOME – che punta alla cartella di installazione stessa.
Verifica l'accesso all'eseguibile Java eseguendo un comando Java -version.
Una volta che l'applicazione Hybrid Agent è stata predisposta:
-
Genera la chiave API nella pagina Hybrid Agent del Workspace di Altium 365 (
).
-
Crea una variabile di ambiente
HYBRID_AGENT_API_KEY con la chiave API come valore.
-
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.
Nota che il Workspace dispone di una sola chiave API valida in un dato momento e può essere in esecuzione una sola istanza dell'Hybrid Agent. L'Agent supporterà più di un'istanza di configurazione PLM se entrambi i sistemi PLM sono ospitati all'interno della stessa rete chiusa.
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:
-
Esegui il comando:
nssm install HybridAgent.
-
Nella finestra di dialogo di 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.
-
Puoi impostare il comportamento di avvio del servizio con l'opzione Startup type nella scheda Details della finestra di dialogo di NSSM. Se necessario, esegui
nssm edit HybridAgent per apportare tali modifiche.
-
In alternativa alla creazione delle variabili di ambiente standard
PATH e JAVA_HOME per Java, queste possono essere aggiunte nella scheda Environment di NSSM. Con questo approccio le variabili saranno attive solo quando il servizio HybridAgent è in esecuzione.
-
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.
-
Avvia il servizio
HybridAgent con lo strumento di gestione Services di Windows oppure con il comando NSSM: nssm start HybridAgent. Questo non è necessario (dopo un riavvio del PC) se il servizio è impostato per l'avvio automatico.
-
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 di Altium 365. Nella pagina Add Configuration, abilita l'opzione di connessione Hybrid Agent e inserisci l'URL del tuo PLM on-premises, così come è visibile all'interno della tua rete chiusa, nel campo URL.
La chiave API corrente può essere annullata utilizzando il relativo comando Revoke. In tal caso, è necessario generare una nuova chiave API e aggiornare la variabile di ambiente HYBRID_AGENT_API_KEY con il nuovo valore della chiave.
Riavvia l'Hybrid Agent per utilizzare la nuova chiave: con NSSM usa il comando nssm restart HybridAgent, oppure arresta/avvia il servizio HybridAgent in Services di Windows.
Localizzato tramite A