Integrazione dell'agente ibrido

A colpo d'occhio

Collega il tuo Workspace Altium 365 a un sistema PLM on-premises senza esporlo a Internet né aprire porte per il traffico in ingresso. Questo articolo spiega come l'Hybrid Agent trasmette le informazioni tramite connessioni HTTPS in uscita e illustra i requisiti, l'installazione e la configurazione, inclusa l'esecuzione dell'agente come servizio Windows. Continua a leggere per compiere il prossimo passo verso la configurazione della tua integrazione PLM ibrida.

- 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.
Approfondisci con l'IA:

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.

Note:

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.

  • Tieni presente che l'Hybrid Agent not deve essere eseguito sul computer che ospita il sistema PLM, sebbene una configurazione di questo tipo non dovrebbe causare problemi.
  • L'applicazione Hybrid Agent include file di script shell equivalenti (come agent.sh) per i sistemi basati su Linux: utilizzali al posto dei file Windows *.bat nelle istruzioni di configurazione dell'agente riportate di seguito.

Le versioni 5 e precedenti dell'Hybrid Agent richiedono Java Development Kit (JDK) versione 11 o successiva. A partire dalla versione 6 (rilasciata il 6 luglio 2026), l'Hybrid Agent richiede JDK versione 17 o successiva.

I Workspace Altium 365 supportano sia la versione 5 sia la versione 6 dell'Hybrid Agent. Pertanto, se hai già installato la versione 5 dell'Hybrid Agent, non è necessario eseguire l'aggiornamento alla versione 6.

Una volta predisposta l'applicazione Hybrid Agent:

  1. Genera la chiave API nella pagina Hybrid Agent del Workspace Altium 365 ().
  2. Crea una variabile d'ambiente HYBRID_AGENT_API_KEY e assegnale come valore la chiave API.
  3. Esegui agent.bat utilizzando 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.

Tieni presente che il Workspace può avere una sola chiave API valida alla volta e che può essere in esecuzione una sola istanza dell'Hybrid Agent. L'agente supporta più istanze di configurazione PLM se entrambi i sistemi PLM sono ospitati all'interno della stessa rete chiusa.

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:

  1. Esegui il comando: nssm install HybridAgent.
  2. 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.
    1. 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 HybridAgent per apportare queste modifiche.
    2. In alternativa alla creazione delle variabili d'ambiente standard PATH e JAVA_HOME per Java, puoi aggiungerle nella scheda Environment di NSSM. Con questo approccio, le variabili saranno attive solo quando il servizio HybridAgent è in esecuzione.
    3. Analogamente a quanto descritto sopra, anche la variabile HYBRID_AGENT_API_KEY può essere spostata nella configurazione dell'ambiente di 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. Questa operazione non è necessaria (dopo un riavvio del PC) se il servizio è impostato per l'avvio automatico.
  4. Assicurati che il servizio HybridAgent sia 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.

 

La chiave API corrente può essere revocata utilizzando il comando Revoke associato. In tal caso, è necessario generare una nuova chiave API e aggiornare la variabile d'ambiente HYBRID_AGENT_API_KEY con il valore della nuova chiave.

Riavvia l'Hybrid Agent per utilizzare la nuova chiave: con NSSM utilizza il comando nssm restart HybridAgent, oppure arresta e riavvia il servizio HybridAgent in Services di Windows.

AI-LocalizedLocalizzato tramite A
Se trovi un problema, seleziona il testo/l’immagine e premi Ctrl + Enter per inviarci il tuo feedback.
Contents
Disponibilità delle funzionalità

Le funzionalità a tua disposizione dipendono dalla soluzione Altium di cui disponi: Altium Develop, Altium Agile Teams, Altium Agile Enterprise oppure Altium Designer (con abbonamento attivo).

Se non vedi una funzionalità documentata nel software che stai effettivamente utilizzando, contatta il reparto vendite di Altium per saperne di più.