Servizio gateway KMC per il software Niagara

Prerequisiti

Ottieni software e licenze

Prima di installare un servizio KMC Commander Gateway in Niagara, è necessario disporre di:

• Un Niagara 4 Workbench con licenza aperta (KMC N4 Workbench o terze parti).
  Nota: Per i dettagli sull'installazione di KMC Workbench, consultare il manuale del software KMC Workbench disponibile sul Pagina del prodotto KMC Converge. (Devi essere loggato per trovare il manuale sotto il Documenti scheda.)
• I seguenti moduli e files per il servizio KMC Commander Gateway (parte Niagara DR kmc Commander Gateway / parte KMC Commander CMDR-NIAGARA
  • kmcControls.licenza
  • kmcControls.certificato
  • kmcCommanderGateway-rt.jar
  • kmcCommanderGateway-wb.jar
• Licenza del progetto KMC Commander.
• Licenza punti KMC Commander.

Consultare il dipartimento IT

Se il reparto IT dispone di regole in uscita, è necessario aggiungere una regola per consentire il traffico in uscita sulla porta TCP/IP 443.
In alternativa, per maggiore sicurezza, il traffico in uscita sulla porta TCP/IP 443 dovrebbe essere aperto (solo) ai seguenti FQDN (Fully Qualified Domain Names):

• app.kmccommander.com (app.kmccommander.com.herokudns.com)
• kmc-endeavour-stg.herokuapp.com (necessario solo per IFR)

Nota: Se il firewall esegue l'ispezione HTTPS, effettuare anche le esclusioni per gli FQDN elencati.
Nota: Gli FQDN elencati non rispondono ai ping ICMP.
Nota: I servizi sono distribuiti dinamicamente e le regole (se necessario) dovrebbero utilizzare nomi di dominio anziché indirizzi IP statici.

Inoltre, ottieni gli indirizzi DNS primari e secondari dal reparto IT, che verranno utilizzati per configurare gli indirizzi DNS a Niagara. Nota se sono DNSv4 o DNSv6.

Configura gli indirizzi DNS a Niagara

Per ottenere la comunicazione dalla stazione Niagara al KMC Commander Cloud, verrà sfruttato un DNS per risolvere la posizione del punto finale di app.kmccommander.com.

Dopo aver consultato il reparto IT, configura il DNS in Niagara procedendo come segue:

1. Utilizzando Workbench, connettersi alla piattaforma JACE.
2. Nell'albero di navigazione, espandere Piattaforma.
3. Selezionare Configurazione TCP/IP.
4. Fare clic sul (+) accanto a Server DNSv4 o Server DNSv6, a seconda della configurazione del sistema.
5. Inserisci l'indirizzo DNS primario nella casella di testo.
6. Ripetere i passaggi 4 e 5 per gli indirizzi DNS secondari. (Si consiglia un indirizzo primario e almeno un indirizzo secondario).
7. Fare clic su Salva, per visualizzare la conferma del riavvio.
8. Fare clic su Sì.

Licenza del servizio

Nel momento in cui la parte Niagara DR-kmcCommanderGateway o la parte KMC Commander CMDR-NIAGARA(-3P) viene acquistata da KMC Controls, l'ID host Niagara della stazione prevista viene fornito al servizio clienti di KMC Controls.
Il Servizio Clienti vincola la licenza a quell'ID host. Fatto ciò, collegando l'Host ID al server di licenze Niagara (tramite un'importazione di licenze in Workbench) si aggiunge o si aggiorna la seguente licenza e certificato files:

• kmcControls.licenza
• kmcControls.certificato

Nota: Il servizio clienti di KMC Controls invia inoltre un'e-mail con una cartella .zip contenente la licenza e il certificato fileS. Importali files a JACE dal tuo computer se la connessione al server delle licenze Niagara non è possibile.
Nota: Per dettagli sui processi di importazione delle licenze, fare riferimento alla documentazione di Tridium (docPlatform.pdf, License Manager).

Da sapere prima dell'installazione

Prima di installare il servizio KMC Commander Gateway, leggere le seguenti sezioni per comprendere il potenziale impatto del servizio sulla stazione.

Impatto del servizio sul funzionamento della stazione

Il servizio KMC Commander Niagara Gateway è progettato per fornire dati dalla stazione Niagara al KMC Commander Cloud. Fornire questi dati significherà che il servizio dovrà interrogare i punti della stazione. Il polling di questi punti può influire sulle prestazioni della stazione.

Utilizzo della CPU

Prima di installare il servizio, riview le risorse della JACE da viewing il gestore delle risorse sulla stazione. Prendere nota della percentuale di CPU e dell'utilizzo della memoria durante il normale funzionamento.
Dopo aver installato il servizio e configurato tutti i punti che verranno sfruttati dal servizio, visitare nuovamente il gestore delle risorse JACE per confermare il normale funzionamento. Per i dettagli sul normale funzionamento, consultare la documentazione di Tridium (docIT.pdf, Prestazioni del sistema).

Sondaggio per punti

Il servizio KMC Commander Niagara Gateway eseguirà il polling dei punti in base al tempo di aggiornamento dei punti a livello di progetto in KMC Commander Cloud (impostazione predefinita: 5 minuti). Man mano che i punti vengono aggiunti al cloud, il servizio creerà un elenco di questi punti nel servizio all'interno della stazione.
Durante un ciclo di aggiornamento del punto, il servizio otterrà un valore aggiornato dall'oggetto iscrivendosi a quel punto in Niagara. L'abbonamento punti predefinito a Niagara è di 1 minuto. Durante questo periodo, il punto sottoposto a polling verrà sottoposto a polling in base alle impostazioni della politica di ottimizzazione Niagara.

Politiche di ottimizzazione

La configurazione delle policy di ottimizzazione dell'oggetto Niagara può avere un impatto significativo sulle prestazioni di JACE durante lo scambio di dati con KMC Commander Cloud. Dovrebbero essere implementate politiche di ottimizzazione adeguate per tutti i punti di interesse da scambiare con il servizio KMC Commander Gateway.
Per esempioample, la policy di ottimizzazione Niagara predefinita è impostata su 5 secondi. Se tale policy viene utilizzata per i punti di interesse, ad ogni richiesta di aggiornamento di KMC Commander Cloud (intervallo predefinito di 5 minuti) tali punti verranno interrogati ogni 5 secondi per 1 minuto.

Nota: Per dettagli sull'impostazione dei criteri di ottimizzazione, fare riferimento alla documentazione di Tridium (docDrivers.pdf, Tuning).

Aggiunta del servizio

Aggiunta del modulo (.jar) File s al banco di lavoro

1. Copiare il file .jar del servizio KMC Commander Gateway files (kmcCommanderGateway-rt.jar e kmcCommanderGateway-wb.jar) nella cartella dei moduli Niagara 4 nella seguente posizione: C:\\\modules
2. Riavviare l'ambiente di lavoro.

Continua con l'argomento Trasferimento del modulo (.jar) Files a JACE a pagina 7.

Trasferimento del modulo (.jar) Files a un JACE

Esegui questi passaggi dopo aver aggiunto il mulo (.jar) files al banco di lavoro:

1. In Workbench, individuare il controller JACE nell'albero Nav.
2. Connettiti alla piattaforma JACE.
3. Nella piattaforma JACE, fare doppio clic su Gestione software.
4. Nel File elenco, tenere premuto CTRL mentre si fa clic su ciascuno dei seguenti elementi files:
   • kmcCommanderGateway-rt.jar
   • kmcCommanderGateway-wb.jar
5. Fare clic su Installa.
   Nota: Se stai effettuando l'aggiornamento, fai clic su Aggiorna.
6. Fare clic su Impegna.
7. Riavviare l'ambiente di lavoro.

Continua con l'argomento Verifica della presenza del modulo a pagina 7.

Verifica della presenza del modulo

Eseguire i passaggi seguenti dopo che i moduli sono stati trasferiti a JACE per verificare la validità del certificato del modulo.

Nota: Fare riferimento al documento Tridium docModuleSign.pdf per i dettagli.

1. Connettiti alla piattaforma JACE.
2. Espandi la piattaforma e individua il Software Manager.
3. Fare doppio clic su Gestione software.
4. 4. Nell'elenco dei moduli, individuare i seguenti moduli:
   • kmcCommanderGateway-rt.jar
   • kmcCommanderGateway-wb.jar
5. Nota quali delle seguenti icone sono presenti in Installato e Disponibile. colonne:
   • Uno scudo verde    indica che è presente un certificato valido.
   • Un punto interrogativo indica che è necessario un riavvio JACE. Per riavviare JACE, fare clic su Riavvia in Application Director view della piattaforma JACE.
     Nota: Un riavvio JACE è diverso da un riavvio JACE.

Continua con l'argomento Aggiunta del servizio a una stazione a pagina 8.

Aggiunta del servizio a una stazione

Per aggiungere il servizio KMC Commander Gateway a una stazione JACE, procedere come segue:

1. Nell'albero di navigazione del Workbench, individuare e connettersi alla piattaforma e alla stazione JACE.
2. Apri una barra laterale della tavolozza.
   Nota: Fare clic su Barre laterali , quindi seleziona Tavolozza dal menu a discesa.
3. Nella barra laterale della tavolozza, fare clic su Apri tavolozza .
4. Dalla finestra Apri tavolozza, nella colonna Modulo, individuare quindi selezionare kmcCommanderGateway.
   Nota: Per restringere l'elenco, digitare kmc nel filtro.
   
5. Fare clic su OK. Il servizio KMC Commander Gateway viene visualizzato nella tavolozza del modulo.
6. Trascina il  KMC Commander Gateway Service dalla tavolozza del modulo e rilasciarlo nel nodo Servizi del database della stazione JACE.
7. Nella finestra Nome visualizzata, lascia il nome così com'è o modifica il nome come appropriato.
8. Fare clic su OK. Il servizio viene visualizzato in Servizi.

Collegamento del servizio

Per connettere il servizio KMC Commander Gateway in Niagara a KMC Commander Project Cloud, procedere come segue:

1. Fare doppio clic KMC Commander Gateway Service, che apre il programma di installazione view in una scheda a destra.
   Nota: Dalla barra laterale Workbench Nav, individuare KMC Commander Gateway Service nel nodo Servizi della stazione.
2. Fare clic su Configura connessione Commander Cloud, che apre una finestra di accesso a Commander.
3. Inserisci il nome utente (e-mail) e la password del tuo account KMC Commander Project Cloud.
4. Modificare il nome della rete Commander popolato automaticamente secondo necessità oppure lasciarlo così com'è.
   Nota: Questo è il nome della stazione così come verrà visualizzato nel KMC Commander web applicazione. Può anche essere modificato successivamente all'interno dell'applicazione.
5. Fare clic su Connetti.
   Nota: Se la connessione ha esito positivo, lo stato mostrerà "Connesso" e la licenza cambierà da "Accedi per selezionare" alla licenza e al progetto KMC Commander o a un elenco a discesa di licenze e progetti se più di uno è assegnato a questo account.
6. Seleziona la licenza e il progetto corretti dall'elenco a discesa Licenza (se più di uno è assegnato a questo account).
   Nota: Il formato visualizzato è "Nome licenza - Nome progetto". I nomi vengono impostati nell'amministrazione di sistema KMC Commander (Cloud). Vedi il Accesso all'amministrazione del sistema argomento nella Guida di KMC Commander o nel PDF della Guida dell'applicazione software KMC Commander.
7. Fare clic su OK, che salva la selezione e chiude la finestra.
   Nota: nella configurazione del servizio KMC Commander Gateway view, sotto Dettagli connessione Commander, lo stato cambia in "Registrato" e vengono visualizzate le informazioni in tempo reale sulla latenza e sull'ultima trasmissione (ora dell'ultima trasmissione [tramite servizio al cloud]).
   Nota: per aggiornare le informazioni sulla licenza e sul nome del progetto (sotto Dettagli sulla licenza di Commander Project Cloud), fare clic su Workbench Aggiornare pulsante.

Rimozione del servizio

Se i criteri di ottimizzazione sono impostati correttamente (vedere Criteri di ottimizzazione a pagina 6), non dovrebbe essere necessario rimuovere il servizio KMC Commander Gateway. Se per qualsiasi motivo fosse necessario rimuovere il servizio, eseguire questi passaggi.

Rimozione del servizio

1. Utilizzando Workbench, connettersi alla Stazione sul JACE remoto.
2. Espandere la Stazione nell'albero di navigazione.
3. All'interno della Stazione, espandere Config.
4. All'interno di Configurazione, espandi Servizi.
5. Fare clic con il tasto destro del mouse Servizio gateway del comandante KMC.
6. Nel menu a discesa, fare clic su Elimina.
7. Fare clic con il pulsante destro del mouse sulla stazione.
8. Fare clic su Salva stazione.

Rimozione dei moduli

1. Utilizzando Workbench, connettersi alla piattaforma del JACE remoto.
2. Nell'albero di navigazione, espandere Piattaforma.
3. Fare doppio clic su Gestione software.
4. Nel principale view pannello, seleziona entrambi questi moduli:
   • kmcCommanderGateway-rt
   • kmcCommanderGateway-wb
5. Fare clic su Disinstalla.
6. Fare clic su Impegna.

Nota: Se la stazione è in esecuzione, Stop Applications? apparirà. Clic OK.

Avvisi importanti

Marchi

KMC Commander®, KMC Conquest™, KMC Controls® e il logo KMC sono marchi registrati di KMC Controls, Inc. Tutti gli altri prodotti o marchi menzionati sono marchi delle rispettive società o organizzazioni. Tutti i diritti riservati.

Brevetti

Pat. https://www.kmccontrols.com/patents/

Termini di utilizzo https://www.kmccontrols.com/terms/

EULA (Contratto di licenza con l'utente finale) https://www.kmccontrols.com/eula/

Copyright

Nessuna parte di questa pubblicazione può essere riprodotta, trasmessa, trascritta, memorizzata in un sistema di recupero o tradotta in qualsiasi lingua in qualsiasi forma con qualsiasi mezzo senza il permesso scritto di KMC Controls, Inc.

Dichiarazioni di non responsabilità

Il materiale in questo documento è solo a scopo informativo. I contenuti e il prodotto che descrive sono soggetti a modifiche senza preavviso. KMC Controls, Inc. non rilascia dichiarazioni o garanzie in relazione a questo documento. In nessun caso KMC Controls, Inc. potrà essere ritenuta responsabile per eventuali danni, diretti o incidentali, derivanti o correlati all'uso di questo documento.

ASSISTENZA CLIENTI

©2024 Controlli KMC, Inc.
Specifiche e design soggetti a modifiche senza preavviso
862-019-15A
KMC Controls, 19476 Industrial Drive, Nuova Parigi, IN 46553 / Numero di telefono: 877-444-5622 / Fax: Numero di telefono: 574-831-5252 /
www.kmccontrols.com

Documenti / Risorse

Servizio gateway KMC per il software Niagara [pdf] Guida utente 862-019-15A, Servizio gateway per il software Niagara, Servizio per il software Niagara, Software Niagara, Software

Riferimenti

• Manuale d'uso