Servizo de pasarela KMC para o software Niagara

Requisitos previos

Obter software e licenzas

Antes de instalar un servizo KMC Commander Gateway en Niagara, debes ter:

• Un Niagara 4 Workbench de licenza aberta (KMC N4 Workbench ou terceiros).
  Nota: Para obter detalles sobre a instalación de KMC Workbench, consulte o Manual do software de KMC Workbench que se atopa na páxina Páxina do produto KMC Converge. (Debes iniciar sesión para atopar o manual baixo o Documentos ficha.)
• Os seguintes módulos e files para o servizo KMC Commander Gateway (parte de Niagara DR kmc Commander Gateway / KMC Commander parte CMDR-NIAGARA
  • kmcControls.licenza
  • kmcControls.certificado
  • kmcCommanderGateway-rt.jar
  • kmcCommanderGateway-wb.jar
• Licenzas do proxecto KMC Commander.
• Licenza de puntos KMC Commander.

Consultar co departamento de TI

Se o departamento de TI ten regras de saída, debe engadirse unha regra para permitir o tráfico de saída no porto TCP/IP 443.
Alternativamente, para obter seguridade adicional, o tráfico de saída no porto TCP/IP 443 debería estar aberto (só) aos seguintes FQDN (nomes de dominio totalmente cualificados):

• app.kmccommander.com (app.kmccommander.com.herokudns.com)
• kmc-endeavor-stg.herokuapp.com (necesario só para IFR)

Nota: Se o firewall realiza a inspección HTTPS, tamén faga exclusións para os FQDN indicados.
Nota: Os FQDN listados non responden aos pings ICMP.
Nota: Os servizos distribúense de forma dinámica e as regras (se é necesario) deben usar nomes de dominio en lugar de enderezos IP estáticos.

Ademais, obtén enderezos DNS primarios e secundarios do departamento de TI, que se utilizarán para configurar enderezos DNS en Niagara. Teña en conta se son DNSv4 ou DNSv6.

Configura enderezos DNS en Niagara

Para conseguir a comunicación desde a estación Niagara coa nube de comandantes de KMC, aproveitarase un DNS para resolver a localización do punto final de app.kmccommander.com.

Despois de consultar co departamento de TI, configure o DNS en Niagara facendo o seguinte:

1. Usando Workbench, conéctese á plataforma do JACE.
2. Na árbore de navegación, expanda Plataforma.
3. Seleccione Configuración TCP/IP.
4. Fai clic no (+) xunto a Servidores DNSv4 ou Servidores DNSv6, dependendo da configuración do teu sistema.
5. Introduza o enderezo DNS principal na caixa de texto.
6. Repita os pasos 4 e 5 para os enderezos DNS secundarios. (Recoméndase un enderezo principal e polo menos un secundario).
7. Fai clic en Gardar, o que fai aparecer unha confirmación de reinicio.
8. Fai clic en Si.

Licenza do Servizo

No momento en que se adquire a parte de Niagara DR-kmcCommanderGateway ou a parte de KMC Commander CMDR-NIAGARA(-3P) a KMC Controls, o ID de host de Niagara da estación prevista entrégase ao servizo de atención ao cliente de KMC Controls.
O servizo de atención ao cliente vincula a licenza a ese ID de host. Unha vez feito isto, ao conectar o ID de host ao servidor de licenzas de Niagara (mediante unha importación de licenza en Workbench) engádese ou actualiza a seguinte licenza e certificado files:

• kmcControls.licenza
• kmcControls.certificado

Nota: O servizo de atención ao cliente de KMC Controls tamén envía un correo electrónico cun cartafol .zip que contén a licenza e o certificado files. Importa esas files ao JACE desde o seu ordenador se non é posible a conexión co servidor de licenzas Niagara.
Nota: Para obter máis información sobre os procesos de importación de licenzas, consulte a documentación de Tridium (docPlatform.pdf, Xestor de licenzas).

Saber antes de instalar

Antes de instalar o servizo KMC Commander Gateway, lea as seguintes seccións para comprender o impacto potencial do servizo na estación.

Impacto do servizo no funcionamento da estación

O servizo KMC Commander Niagara Gateway está deseñado para fornecer datos desde a estación Niagara ata a KMC Commander Cloud. Achegar estes datos suporá que o servizo terá que sondear os puntos da estación. A votación destes puntos pode afectar o rendemento da estación.

Uso da CPU

Antes de instalar o servizo, review recursos do JACE por viewxestor de recursos na estación. Teña en conta a CPU% e o uso da memoria durante o funcionamento normal.
Despois de instalar o servizo e configurar todos os puntos que aproveitará o servizo, volve visitar o xestor de recursos de JACE para confirmar o funcionamento normal. Para obter máis información sobre o funcionamento normal, consulte a documentación de Tridium (docIT.pdf, Rendemento do sistema).

Votación por puntos

O servizo KMC Commander Niagara Gateway enquisará os puntos en función do tempo de actualización do punto de nivel de proxecto en KMC Commander Cloud (predeterminado: 5 minutos). A medida que se engaden puntos á nube, o servizo creará unha lista destes puntos no servizo dentro da estación.
Tras un ciclo de actualización de puntos, o servizo obterá un valor actualizado do obxecto subscribindose a ese punto en Niagara. A subscrición de puntos predeterminada en Niagara é de 1 minuto. Durante este tempo, o punto que se está a sondear será sondeado en función da súa configuración da política de axuste de Niagara.

Políticas de afinación

A configuración das políticas de axuste do obxecto Niagara pode afectar gravemente o rendemento do JACE ao intercambiar datos co KMC Commander Cloud. Deben implementarse políticas de axuste adecuadas en todos os puntos de interese que se intercambiarán co servizo de pasarela de comandante de KMC.
Por example, a política de axuste predeterminada de Niagara está definida en 5 segundos. Se esa política se utiliza para os puntos de interese, en cada solicitude de actualización de KMC Commander Cloud (intervalo predeterminado de 5 minutos) eses puntos serán consultados cada 5 segundos durante 1 minuto.

Nota: Para obter máis información sobre a configuración da política de axuste, consulte a documentación de Tridium (docDrivers.pdf, Tuning).

Engadindo o servizo

Engadindo o módulo (.jar) File s a Workbench

1. Copie o .jar do servizo de pasarela de comando de KMC files (kmcCommanderGateway-rt.jar e kmcCommanderGateway-wb.jar) ao cartafol de módulos de Niagara 4 na seguinte localización: C:\\\modules
2. Reinicie Workbench.

Continúa co tema Transferencia do módulo (.jar) Files a un JACE na páxina 7.

Transferencia do módulo (.jar) Files a un JACE

Realice estes pasos despois de engadir a mula (.jar) files a Workbench:

1. En Workbench, localice o controlador JACE na árbore de navegación.
2. Conéctate á plataforma JACE.
3. Na plataforma JACE, faga dobre clic en Xestor de software.
4. No File lista, manteña premida a tecla CTRL mentres fai clic en cada unha das seguintes opcións files:
   • kmcCommanderGateway-rt.jar
   • kmcCommanderGateway-wb.jar
5. Fai clic en Instalar.
   Nota: Se estás a actualizar, fai clic en Actualizar.
6. Fai clic en Commit.
7. Reinicie Workbench.

Continúa co tema Verificando a presenza do módulo na páxina 7.

Verificando a presenza do módulo

Realice os seguintes pasos despois de que os módulos sexan transferidos ao JACE para verificar a validez do certificado do módulo.

Nota: Consulte o documento de Tridium docModuleSign.pdf para obter máis información.

1. Conéctate á plataforma JACE.
2. Amplíe a plataforma e localice o Xestor de software.
3. Fai dobre clic en Xestor de software.
4. 4. Na lista de módulos, localice os seguintes módulos:
   • kmcCommanderGateway-rt.jar
   • kmcCommanderGateway-wb.jar
5. Teña en conta cales das seguintes iconas están presentes nos ficheiros Instalado e Dispoñible. columnas:
   • Un escudo verde    indica que existe un certificado válido.
   • Un signo de interrogación indica que é necesario reiniciar JACE. Para reiniciar o JACE, faga clic en Reiniciar no Director de aplicacións view da plataforma do JACE.
     Nota: Un reinicio de JACE é diferente que un reinicio de JACE.

Continúa co tema Engadir o servizo a unha estación na páxina 8.

Engadir o servizo a unha estación

Para engadir o servizo KMC Commander Gateway a unha estación JACE, faga o seguinte:

1. Na árbore de navegación do Workbench, localice e conéctese á plataforma e estación JACE.
2. Abre unha barra lateral de paleta.
   Nota: Fai clic en Barras laterais , seleccione Paleta no menú despregable.
3. Na barra lateral da paleta, fai clic en Abrir paleta .
4. Na xanela Abrir paleta, na columna Módulo, localice e seleccione kmcCommanderGateway.
   Nota: Para restrinxir a lista, escriba kmc no filtro.
   
5. Fai clic en Aceptar. KMC Commander Gateway Service aparece na paleta do módulo.
6. Arrastra o  KMC Commander Gateway Service desde a Paleta do módulo e colócao no nodo Servizos da base de datos da estación JACE.
7. Na xanela Nome que aparece, deixe o nome tal cal ou edite o nome segundo corresponda.
8. Fai clic en Aceptar. O servizo aparece en Servizos.

Conectando o servizo

Para conectar o servizo KMC Commander Gateway en Niagara ao KMC Commander Project Cloud, faga o seguinte:

1. Fai dobre clic KMC Commander Gateway Service, que abre a súa configuración view nunha pestana á dereita.
   Nota: Localice na barra lateral Workbench Nav KMC Commander Gateway Service baixo o nodo Servizos da estación.
2. Fai clic en Configurar a conexión de Commander Cloud, que abre unha xanela de inicio de sesión de Commander.
3. Introduza a súa conta de KMC Commander Project Cloud Nome de usuario (correo electrónico) e contrasinal.
4. Cambia o nome de rede de Commander que se enche automaticamente segundo sexa necesario ou déixao tal e como está.
   Nota: Este é o nome da estación tal e como se mostrará no KMC Commander web aplicación. Tamén se pode modificar posteriormente dentro desa aplicación.
5. Fai clic en Conectar.
   Nota: Se a conexión se realiza correctamente, o estado mostrará "Conectado" e a licenza cambiará de "Iniciar sesión para seleccionar" á licenza e ao proxecto de KMC Commander, ou a unha lista despregable de licenzas e proxectos se hai máis dunha asignada a esta conta.
6. Seleccione a licenza e o proxecto correctos na lista despregable Licenza (se ten máis dun asignado a esta conta).
   Nota: O formato que se mostra é "Nome da licenza — Nome do proxecto". Os nomes están definidos na Administración do sistema KMC Commander (Cloud). Vexa o Acceso á Administración do Sistema en Axuda de KMC Commander ou no PDF da Guía de aplicacións de software KMC Commander.
7. Fai clic en Aceptar, que garda a selección e pecha a xanela.
   Nota: na configuración do servizo KMC Commander Gateway view, debaixo dos Detalles da conexión de Commander, o estado cambia a "Rexistrado" e a información de Latencia en directo e Última transmisión (hora da última transmisión [por servizo á nube]).
   Nota: para actualizar a información da licenza e o nome do proxecto (abaixo dos Detalles da licenza de Commander Project Cloud), faga clic no Workbench Actualizar botón.

Eliminación do Servizo

Se as políticas de axuste están configuradas correctamente (consulte Políticas de axuste na páxina 6), o servizo KMC Commander Gateway non debería ser necesario eliminar. Se por algún motivo é necesario eliminar o servizo, siga estes pasos.

Eliminación do Servizo

1. Usando Workbench, conéctese á estación no JACE remoto.
2. Expanda a estación na árbore de navegación.
3. Dentro da estación, expanda Config.
4. Dentro de Config, expande Servizos.
5. Fai clic co botón dereito KMC Commander Gateway Service.
6. No menú despregable, faga clic en Eliminar.
7. Fai clic co botón dereito na estación.
8. Fai clic en Gardar estación.

Eliminación de módulos

1. Usando Workbench, conéctese á Plataforma do JACE remoto.
2. Na árbore de navegación, expanda Plataforma.
3. Fai dobre clic en Xestor de software.
4. No principal view panel, seleccione os dous módulos:
   • kmcCommanderGateway-rt
   • kmcCommanderGateway-wb
5. Fai clic en Desinstalar.
6. Fai clic en Commit.

Nota: Se a estación está funcionando, deter as aplicacións? aparecerá. Fai clic OK.

Avisos importantes

Marcas comerciais

KMC Commander®, KMC Conquest™, KMC Controls® e o logotipo de KMC son marcas rexistradas de KMC Controls, Inc. Todos os demais produtos ou marcas de nome mencionados son marcas comerciais das súas respectivas empresas ou organizacións. Todos os dereitos reservados.

Patentes

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

Condicións de uso https://www.kmccontrols.com/terms/

EULA (contrato de licenza de usuario final) https://www.kmccontrols.com/eula/

Dereitos de autor

Ningunha parte desta publicación pode ser reproducida, transmitida, transcrita, almacenada nun sistema de recuperación ou traducida a ningún idioma de ningún xeito por ningún medio sen o permiso por escrito de KMC Controls, Inc.

Exencións de responsabilidade

O material deste documento é só para fins informativos. O contido e o produto que describe están suxeitos a cambios sen previo aviso. KMC Controls, Inc. non fai ningunha representación ou garantía con respecto a este documento. En ningún caso KMC Controls, Inc. será responsable de ningún dano, directo ou incidental, derivado ou relacionado co uso deste documento.

ATENCIÓN AO CLIENTE

©2024 KMC Controls, Inc.
Especificacións e deseño suxeitos a cambios sen previo aviso
862-019-15A
KMC Controls, 19476 Industrial Drive, New Paris, IN 46553 / 877-444-5622 / Fax: 574-831-5252 /
www.kmccontrols.com

Documentos/Recursos

Servizo de pasarela KMC para o software Niagara [pdfGuía do usuario 862-019-15A, Servizo de pasarela para Niagara Software, Servizo para Niagara Software, Niagara Software, Software

Referencias

• Manual de usuario