Služba KMC Gateway pro software Niagara

Předpoklady

Získejte software a licence

Před instalací služby KMC Commander Gateway Service v Niagara musíte mít:

• Otevřená licence Niagara 4 Workbench (KMC N4 Workbench nebo třetí strana).
  Poznámka: Podrobnosti o instalaci KMC Workbench naleznete v příručce KMC Workbench Software Manual na stránce Produktová stránka KMC Converge. (Musíte být přihlášeni, abyste našli příručku pod Dokumenty tab.)
• Následující moduly a files pro KMC Commander Gateway Service (Niagara část DR kmc Commander Gateway / KMC Commander část CMDR-NIAGARA
  • kmcControls.licence
  • certifikát kmcControls
  • kmcCommanderGateway-rt.jar
  • kmcCommanderGateway-wb.jar
• Licencování projektu KMC Commander.
• Bodové licencování KMC Commander.

Poraďte se s IT oddělením

Pokud má IT oddělení odchozí pravidla, mělo by být přidáno pravidlo povolující odchozí provoz na portu TCP/IP 443.
Alternativně by pro další zabezpečení měl být odchozí provoz na portu TCP/IP 443 otevřen (pouze) pro následující FQDN (plně kvalifikované názvy domén):

• app.kmccommander.com (app.kmccommander.com.herokudns.com)
• kmc-endeavour-stg.herokuapp.com (potřebné pouze pro IFR)

Poznámka: Pokud brána firewall provádí kontrolu HTTPS, proveďte také výjimky pro uvedené FQDN.
Poznámka: Uvedené FQDN nereagují na ping ICMP.
Poznámka: Služby jsou dynamicky distribuovány a pravidla (v případě potřeby) by měla používat názvy domén, nikoli statické adresy IP.

Od IT oddělení také získejte primární a sekundární DNS adresy, které budou použity k nastavení DNS adres v Niagaře. Všimněte si, zda se jedná o DNSv4 nebo DNSv6.

Nastavte adresy DNS v Niagara

K dosažení komunikace ze stanice Niagara s cloudem KMC Commander Cloud bude k vyřešení umístění koncového bodu využit DNS. app.kmccommander.com.

Po konzultaci s IT oddělením nastavte DNS v Niagaře takto:

1. Pomocí Workbench se připojte k platformě JACE.
2. V navigačním stromu rozbalte položku Platforma.
3. Vyberte Konfigurace TCP/IP.
4. Klepněte na (+) vedle buď Servery DNSv4 nebo Servery DNSv6, v závislosti na konfiguraci vašeho systému.
5. Do textového pole zadejte primární adresu DNS.
6. Opakujte kroky 4 a 5 pro sekundární adresy DNS. (Doporučuje se primární a alespoň jedna sekundární adresa).
7. Klikněte na Uložit, čímž se zobrazí potvrzení restartu.
8. Klepněte na tlačítko Ano.

Licencování služby

V době, kdy je od společnosti KMC Controls zakoupena část Niagara DR-kmcCommanderGateway nebo část KMC Commander CMDR-NIAGARA(-3P), bude zákaznickému servisu společnosti KMC Controls poskytnuto ID hostitele Niagara zamýšlené stanice.
Zákaznický servis váže licenci k tomuto ID hostitele. Jakmile to uděláte, připojení ID hostitele k licenčnímu serveru Niagara (pomocí importu licence ve Workbench) přidá nebo aktualizuje následující licenci a certifikát files:

• kmcControls.licence
• certifikát kmcControls

Poznámka: Zákaznický servis KMC Controls také odešle e-mail se složkou .zip obsahující licenci a certifikát files. Importujte je files na JACE z vašeho počítače, pokud připojení k licenčnímu serveru Niagara není možné.
Poznámka: Podrobnosti o procesech importu licencí najdete v dokumentaci Tridium (docPlatform.pdf, Správce licencí).

Vědět před instalací

Před instalací služby KMC Commander Gateway Service si přečtěte následující části, abyste pochopili potenciální dopad této služby na stanici.

Vliv služby na provoz stanice

Služba KMC Commander Niagara Gateway Service je navržena tak, aby poskytovala data ze stanice Niagara do cloudu KMC Commander Cloud. Poskytnutí těchto údajů bude znamenat, že služba bude muset volit body ve stanici. Dotazování těchto bodů může ovlivnit výkon stanice.

Využití CPU

Před instalací služby znovuview zdroje JACE tím viewsprávce zdrojů na stanici. Všimněte si procenta CPU a využití paměti během normálního provozu.
Po instalaci služby a nastavení všech bodů, které bude služba využívat, znovu navštivte správce zdrojů JACE a potvrďte normální provoz. Podrobnosti o běžném provozu naleznete v dokumentaci Tridium (docIT.pdf, System Performance).

Bodové hlasování

Služba KMC Commander Niagara Gateway Service provede průzkum bodů na základě času aktualizace bodů na úrovni projektu v cloudu KMC Commander Cloud (výchozí: 5 minut). Při přidávání bodů do cloudu služba vytvoří výpis těchto bodů ve službě v rámci stanice.
Po cyklu aktualizace bodu získá služba aktualizovanou hodnotu z objektu tím, že se přihlásí k tomuto bodu v Niagara. Výchozí bodové předplatné v Niagaře je 1 minuta. Během této doby bude dotazovaný bod dotazován na základě nastavení zásad ladění Niagara.

Zásady ladění

Konfigurace zásad ladění objektu Niagara může vážně ovlivnit výkon JACE při výměně dat s cloudem KMC Commander. Správné zásady ladění by měly být implementovány ve všech bodech zájmu, které budou vyměňovány se službou KMC Commander Gateway Service.
Napřample, výchozí zásada ladění Niagara je nastavena na 5 sekund. Pokud je tato zásada použita pro body zájmu, pak při každém požadavku na aktualizaci KMC Commander Cloud (výchozí interval 5 minut) budou tyto body dotazovány každých 5 sekund po dobu 1 minuty.

Poznámka: Podrobnosti o nastavení zásad ladění naleznete v dokumentaci Tridium (docDrivers.pdf, Tuning).

Přidání služby

Přidání modulu (.jar) File s na Workbench

1. Zkopírujte soubor jar KMC Commander Gateway Service files (kmcCommanderGateway-rt.jar a kmcCommanderGateway-wb.jar) do složky modulů Niagara 4 v následujícím umístění: C:\\\modules
2. Restartujte Workbench.

Pokračujte v tématu Přenos modulu (.jar) Files na JACE na straně 7.

Přenos modulu (.jar) Files JACE

Po přidání muly (.jar) proveďte tyto kroky files to Workbench:

1. Ve Workbench vyhledejte ve stromu Nav ovladač JACE.
2. Připojte se k platformě JACE.
3. Na platformě JACE poklepejte na Software Manager.
4. V File seznamu, stiskněte a podržte klávesu CTRL a klepněte na každou z následujících položek files:
   • kmcCommanderGateway-rt.jar
   • kmcCommanderGateway-wb.jar
5. Klepněte na tlačítko Instalovat.
   Poznámka: Pokud provádíte upgrade, klikněte na Upgrade.
6. Klikněte na Potvrdit.
7. Restartujte Workbench.

Pokračujte v tématu Ověření přítomnosti modulu na straně 7.

Ověření přítomnosti modulu

Po přenesení modulů do JACE proveďte následující kroky, abyste ověřili platnost certifikátu modulu.

Poznámka: Podrobnosti naleznete v dokumentu Tridium docModuleSign.pdf.

1. Připojte se k platformě JACE.
2. Rozbalte platformu a vyhledejte Správce softwaru.
3. Poklepejte na Software Manager.
4. 4. V seznamu modulů vyhledejte následující moduly:
   • kmcCommanderGateway-rt.jar
   • kmcCommanderGateway-wb.jar
5. Všimněte si, které z následujících ikon jsou přítomny v Instalováno a Dostupné. sloupce:
   • Zelený štít    znamená, že je přítomen platný certifikát.
   • Otazník označuje, že je vyžadován restart JACE. Chcete-li restartovat JACE, klikněte na Reboot v aplikaci Application Director view platformy JACE.
     Poznámka: Restart JACE je jiný než restart JACE.

Pokračujte v tématu Přidání služby ke stanici na straně 8.

Přidání služby ke stanici

Chcete-li přidat službu KMC Commander Gateway Service ke stanici JACE, postupujte takto:

1. Ve stromu Workbench Nav vyhledejte a připojte se k platformě a stanici JACE.
2. Otevřete postranní panel palety.
   Poznámka: Klikněte na Postranní pruhy a poté z rozbalovací nabídky vyberte Paleta.
3. Na postranním panelu Paleta klikněte na Otevřít paletu .
4. V okně Otevřít paletu ve sloupci Modul vyhledejte a vyberte kmcCommanderGateway.
   Poznámka: Chcete-li seznam zúžit, zadejte kmc ve filtru.
   
5. Klepněte na tlačítko OK. Služba KMC Commander Gateway Service se objeví na paletě modulu.
6. Přetáhněte  KMC Commander Gateway Service z palety modulu a umístěte ji na uzel Services databáze stanice JACE.
7. V okně Název, které se zobrazí, ponechte název tak, jak je, nebo jej podle potřeby upravte.
8. Klepněte na tlačítko OK. Služba se zobrazí v části Služby.

Připojení služby

Chcete-li připojit službu KMC Commander Gateway Service v Niagara ke cloudu projektu KMC Commander, postupujte takto:

1. Poklepejte Služba KMC Commander Gateway Service, která otevře její nastavení view na kartě vpravo.
   Poznámka: Na bočním panelu Workbench Nav vyhledejte Služba KMC Commander Gateway pod uzlem služby stanice.
2. Klikněte na Nastavit připojení Commander Cloud Connection, čímž se otevře okno Commander Login.
3. Zadejte uživatelské jméno (e-mail) a heslo svého účtu KMC Commander Project Cloud.
4. Změňte automaticky vyplněný název sítě Commander podle potřeby nebo jej ponechte tak, jak je.
   Poznámka: Toto je název stanice, jak se zobrazí v KMC Commanderu web aplikace. Lze jej také později v rámci této aplikace upravit.
5. Klikněte na Připojit.
   Poznámka: Pokud se připojení podaří, zobrazí se Stav „Připojeno“ a Licence se změní z „Přihlásit se k výběru“ na licenci a projekt KMC Commander nebo rozevírací seznam licencí a projektů, pokud je k tomuto účtu přiřazeno více než jeden.
6. Vyberte správnou licenci a projekt z rozevíracího seznamu Licence (pokud je k tomuto účtu přiřazeno více než jeden).
   Poznámka: Zobrazený formát je „License Name — Project Name“. Názvy se nastavují v Správě systému KMC Commander (Cloud). Viz Přístup ke správě systému téma v nápovědě aplikace KMC Commander nebo v příručce KMC Commander Software Application Guide PDF.
7. Klikněte na OK, čímž se výběr uloží a okno se zavře.
   Poznámka: V nastavení služby KMC Commander Gateway view, pod položkou Podrobnosti připojení velitele, se stav změní na „Registrováno“ a zobrazí se aktuální informace o latenci a posledním vysílání (čas posledního přenosu [službou do cloudu]).
   Poznámka: Chcete-li aktualizovat informace o licenci a názvu projektu (pod podrobnostmi licence Commander Project Cloud), klepněte na Workbench Obnovit tlačítko.

Odebrání služby

Pokud jsou zásady ladění nastaveny správně (viz Zásady ladění na straně 6), službu KMC Commander Gateway Service by nemělo být nutné odstraňovat. Pokud je nutné službu z nějakého důvodu odebrat, proveďte tyto kroky.

Odebrání služby

1. Pomocí Workbench se připojte ke stanici na vzdáleném JACE.
2. Rozbalte Stanici v navigačním stromu.
3. V rámci stanice rozbalte položku Config.
4. V rámci Config rozbalte položku Služby.
5. Klikněte pravým tlačítkem Služba brány velitele KMC.
6. V rozevírací nabídce klikněte na Odstranit.
7. Klepněte pravým tlačítkem myši na stanici.
8. Klikněte na Uložit stanici.

Odstranění modulů

1. Pomocí Workbench se připojte k platformě vzdáleného JACE.
2. V navigačním stromu rozbalte položku Platforma.
3. Poklepejte na Software Manager.
4. V hlavním view panelu, vyberte oba tyto moduly:
   • kmcCommanderGateway-rt
   • kmcCommanderGateway-wb
5. Klepněte na Odinstalovat.
6. Klikněte na Potvrdit.

Poznámka: Pokud stanice běží, Zastavit aplikace? se objeví. Klikněte OK.

Důležitá upozornění

ochranné známky

KMC Commander®, KMC Conquest™, KMC Controls® a logo KMC jsou registrované ochranné známky společnosti KMC Controls, Inc. Všechny ostatní uvedené produkty nebo názvy značek jsou ochrannými známkami příslušných společností nebo organizací. Všechna práva vyhrazena.

Patenty

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

Podmínky použití https://www.kmccontrols.com/terms/

EULA (Licenční smlouva s koncovým uživatelem) https://www.kmccontrols.com/eula/

Copyright

Žádná část této publikace nesmí být reprodukována, přenášena, přepisována, ukládána do vyhledávacího systému nebo překládána do jakéhokoli jazyka v jakékoli formě jakýmkoli způsobem bez písemného souhlasu společnosti KMC Controls, Inc.

Vyloučení odpovědnosti

Materiál v tomto dokumentu slouží pouze pro informační účely. Obsah a produkt, který popisuje, se mohou bez upozornění změnit. Společnost KMC Controls, Inc. neposkytuje žádná prohlášení ani záruky s ohledem na tento dokument. Společnost KMC Controls, Inc. v žádném případě nenese odpovědnost za žádné přímé nebo náhodné škody, které vzniknou nebo souvisejí s používáním tohoto dokumentu.

ZÁKAZNICKÁ PODPORA

©2024 KMC Controls, Inc.
Specifikace a design se mohou změnit bez upozornění
862-019-15A
KMC Controls, 19476 Industrial Drive, New Paris, IN 46553 / 877-444-5622 / Fax: 574-831-5252 /
www.kmccontrols.com

Dokumenty / zdroje

Služba KMC Gateway pro software Niagara [pdfUživatelská příručka 862-019-15A, Služba brány pro software Niagara, služba pro software Niagara, software Niagara, software

Reference

• Uživatelská příručka