Integrazione dell'agente ibrido
A colpo d'occhio
- Scopri i requisiti di licenza, Java e rete per l'Hybrid Agent.
- Scopri come generare una chiave API, avviare l'agente e configurare la connessione PLM nel tuo Workspace.
- Trova indicazioni su come eseguire l'agente come servizio Windows e aggiornarlo per utilizzare una nuova chiave API.
L'integrazione ibrida si applica quando 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 e non è quindi esposto a Internet.
A tale scopo, all'interno della rete aziendale viene eseguito un piccolo programma chiamato Hybrid Agent. Questo programma comunica con Altium 365, trasferendo 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 porte di rete per il traffico in ingresso da Internet. La porta HTTPS standard 443 è richiesta solo per il traffico in uscita.
Configurare l'integrazione ibrida
Scarica l'archivio dell'agente ed estrai il contenuto in una posizione nota. Contiene un'applicazione Java (hybrid-agent.jar) che deve essere eseguita su un computer all'interno della rete aziendale, dal quale siano raggiungibili il sistema PLM on-premises e Altium 365.
Questo computer not deve essere accessibile pubblicamente da Internet, ma deve essere in grado di connettersi all'ambiente Altium 365 utilizzato dalla tua azienda.
Una volta predisposta l'applicazione Hybrid Agent:
- Genera la chiave API nella pagina Hybrid Agent del Workspace Altium 365
-
Crea una variabile d'ambiente
HYBRID_AGENT_API_KEYe assegnale come valore la chiave API. -
Esegui
agent.batutilizzando la seguente sintassi del comando, dove l'argomento del parametro URL deve corrispondere all'URL del tuo Workspace Altium 365:
agent.bat https://acme.365.altium.com
Quando è attivo, l'Hybrid Agent genera un file di log nella cartella hybrid-agent\logs dell'applicazione.
Nell'ambiente di produzione si consiglia vivamente di eseguire l'Hybrid Agent come servizio Windows anziché direttamente nel terminale, sebbene quest'ultima modalità possa essere utilizzata per i test.
Di seguito è riportato un esempio di procedura 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.batnel campo Path e l'URL del tuo Workspace nel campo Arguments, quindi fai clic su Install service.-
Puoi impostare la modalità di avvio del servizio tramite l'opzione Startup type nella scheda Details della finestra di dialogo di NSSM. Se necessario, esegui
nssm edit HybridAgentper apportare queste modifiche. -
In alternativa alla creazione delle variabili d'ambiente standard
PATHeJAVA_HOMEper Java, puoi aggiungerle nella scheda Environment di NSSM. Con questo approccio, le variabili saranno attive solo quando il servizioHybridAgentè in esecuzione. -
Analogamente a quanto descritto sopra, anche la variabile
HYBRID_AGENT_API_KEYpuò essere spostata nella configurazione dell'ambiente di NSSM, in modo che sia attiva quando il servizio è in esecuzione.
-
Puoi impostare la modalità di avvio del servizio tramite l'opzione Startup type nella scheda Details della finestra di dialogo di NSSM. Se necessario, esegui
-
Avvia il servizio
HybridAgentcon lo strumento di gestione Services di Windows oppure con il comando NSSM:nssm start HybridAgent. Questa operazione non è necessaria (dopo un riavvio del PC) se il servizio è impostato per l'avvio automatico. -
Assicurati che il servizio
HybridAgentsia in esecuzione tramite lo 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 alla 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 visualizzato all'interno della rete chiusa.



