WM SYSTEMS Device Manager Server User Manual

Servilo pri Aparato Administranto
Uzanto Manlibro

Enhavo kaŝi

1 Servilo pri Aparato Administranto

2 Dokumentaj specifoj

3 Ĉapitro 1. Enkonduko

4 Ĉapitro 2. Instalado kaj Agordo

Servilo pri Aparato Administranto

Aparato Administranto ® Servilo por M2M Router kaj WM-Ex-modemo, WM-I3-aparatoj

Dokumentaj specifoj

Ĉi tiu dokumento estis farita por la programaro Device Manager kaj ĝi enhavas la detalan priskribon de agordo kaj uzado por la ĝusta funkciado de la programaro.

Dokumentkategorio:	Uzanto Manlibro
Dokumenta temo:	Aparato Administranto
Aŭtoro:	WM Systems LLC
Dokumenta versio n-ro:	REV 1.50
Nombro da paĝoj:	11
Versio por administranto de aparatoj:	v7.1
Programara versio:	DM_Pack_20210804_2
Dokumenta stato:	FINALA
Laste modifita:	13 aŭgusto 2021
Dato de aprobo:	13 aŭgusto 2021

Ĉapitro 1. Enkonduko

La Aparato-Manaĝero povas esti uzata por fora monitorado kaj centra administrado de niaj industriaj enkursigiloj, datumkoncentriloj (M2M Router, M2M Industria Router, M2M ekstera PRO4) kaj por inteligentaj mezuraj modemoj (WM-Ex-familio, WM-I3-aparato).
Fora aparato-administra platformo kiu disponigas kontinuan monitoradon de aparatoj, analizajn kapablojn, amasajn firmware-ĝisdatigojn, reagordon.
La programaro permesas kontroli la servajn KPI-ojn de la aparatoj (QoS, vivsignaloj), interveni kaj kontroli la funkciadon, plenumante bontenajn taskojn sur viaj aparatoj.
Ĝi estas kostefika maniero de kontinua interreta monitorado de viaj konektitaj M2M-aparatoj en foraj lokoj.
Ricevante informojn pri la havebleco de la aparato, la monitorado de vivsignaloj, funkciaj karakterizaĵoj de surlokaj aparatoj.
Pro la analizaj datumoj derivitaj de ili.
ĝi kontinue kontrolas la operaciajn valorojn (signala forto de la ĉela reto, komunikado-sano, aparata rendimento).
Ricevante informojn pri la havebleco de la aparato, la monitorado de vivsignaloj, funkciaj karakterizaĵoj de surlokaj aparatoj - pro la analizaj datumoj derivitaj de ili.
ĝi kontinue kontrolas la operaciajn valorojn (signala forto de la ĉela reto, komunikado sano, aparata agado).

Ĉapitro 2. Instalado kaj Agordo

2.1. Antaŭkondiĉoj

Maks. 10.000 mezuraj aparatoj povas esti administritaj de ununura Device Manager-instanco.
La uzado de servila aplikaĵo de Device Manager postulas la jenajn kondiĉojn:
Aparataro medio:

Fizika instalado kaj virtuala mediouzo ankaŭ estas subtenataj
4 Kerna Procesoro (minimuma) - 8 Kerna (preferata)

8 GB RAM (minimume) - 16 GB RAM (preferata), dependas de la kvanto de la aparatoj
1Gbit LAN retkonekto

Maks. 500 GB-stoka kapablo (dependas de la kvanto de la aparatoj)

Programaro-medio:
• Windows Server 2016 aŭ pli nova - Linukso aŭ Mac OS ne subtenataj
• MS SQL Express Edition (minimuma) – MS SQL Standard (preferata) – Aliaj specoj de datumbazo
ne estas subtenataj (Oracle, MongoDB, MySql)
• MS SQL Server Management Studio - por krei kontojn kaj datumbazon kaj administri la
datumbazo (ekz.: sekurkopio aŭ restarigo)

2.2. Sistemkomponentoj
La Aparato-Manaĝero konsistas el tri ĉefaj softvarelementoj:

DeviceManagerDataBroker.exe - komunika platformo inter la datumbazo kaj la datumkolektilo-servo

DeviceManagerService.exe - kolektante la datumojn de la konektitaj enkursigiloj kaj mezuraj modemoj
DeviceManagerSupervisorSvc.exe - por prizorgado

Datuma Broker
La ĉefa tasko de la datummakleristo de la aparato-manaĝero estas konservi la datumbazan konekton kun la SQL-servilo kaj provizi REST-API-interfacon al la Aparato-Manaĝera Servo. Krome ĝi havas funkcion de sinkronigado de datumoj, por konservi ĉiujn kurantajn UI-ojn sinkronigitaj kun la datumbazo.
Aparato-Manaĝera Servo
Ĉi tio estas la aparato-administra servo, kaj komerca logiko. Ĝi komunikas kun la Datuma Makleristo per REST API, kaj kun la M2M-aparatoj per la protokolo pri administrado de la propra aparato de WM Systems. La komunikado fluas en TCP-ingo, kiu povas laŭvole esti sekurigita per industrinormo TLS v1.2 transporttavola sekurec-olucio, bazita sur mbedTLS (ĉe aparatflanko) kaj OpenSSL (ĉe servilflanko).

Servo de Kontrolisto de Aparato Administranto
Ĉi tiu servo disponigas la prizorgajn funkciojn inter la GUI kaj la Aparato-Manaĝera Servo. Kun ĉi tiu funkcio la administranto de la sistemo povas ĉesi, komenci kaj rekomenci la servilan servon de la GUI.
2.3. Ekfunkciigo
2.3.1 Instali kaj agordi la SQL-Servilon
Se vi bezonas instali SQL-servilon, bonvolu viziti la jenajn webretejo kaj elektu la preferatan SQL-produkton: https://www.microsoft.com/en-us/sql-server/sql-server-downloads
Se vi jam havas instaladon de SQL-servilo, kreu novan datumbazon ekz. DM7.1 kaj faru datumbazan uzantkonton kun posedantorajtoj sur tiu datumbazo DM7.1. Kiam vi komencos la datummakleriston unuafoje, ĝi kreos ĉiujn necesajn tabelojn kaj kampojn en la datumbazon. Vi ne bezonas krei ilin permane.
Antaŭ ĉio kreu la radikan dosierujon sur la celsistemo. ekz.: C:\DMv7.1. Malfermu la kunpremitan programaron de Aparato-Administranto en la dosierujon.
2.3.2 Datuma Broker

Modifi la agordon file: DeviceManagerDataBroker.config (Ĉi tio estas agordo bazita en JSON file kiu devas esti modifita por ke la Datuma Makleristo aliru la SQL-Servilon.)
Vi devas plenigi la sekvajn parametrojn:
– SQLServerAddress → IP-adreso de la SQL-servilo
– SQLServerUser → uzantnomo de la datumbazo de Device Manager
– SQLServerPass → pasvorto de la datumbazo de Device Manager
– SQLServerDB → nomo de la datumbazo
– DataBrokerPort → aŭskulta haveno de la datumperanto. La klientoj uzos ĉi tiun havenon por komunikado kun la datuma makleristo.
Post la modifoj, bonvolu ruli la datummakleriston programaron kun administranto privilegioj (DeviceManagerDataBroker.exe)

Nun ĉi tio konektos al la datumbaza servilo kun la donitaj akreditaĵoj kaj kreos / modifos aŭtomate la datumbazan strukturon.

GRAVA!
Se vi volas ŝanĝi la agordojn de Device Manager Data Broker, unue ĉesu la aplikaĵon.
Se vi finis la modifon rulu la aplikaĵon kiel administranto.
Aliokaze la aplikaĵo anstataŭigos la modifitajn agordojn al la lastaj funkciaj agordoj!
2.3.3 Servo de Kontrolisto de Aparato Administranto

Modifi la agordon file: Elman.ini
Agordu la ĝustan pordan numeron por la prizorgaj operacioj. DMSupervisorPort

Se vi volas fari servon por ruli la DM aŭtomate ĉe ĉiu servilo-komenco, tiam malfermu la komandlinion kaj plenumu la sekvan komandon kiel administranto:
DeviceManagerSupervisorSvc.exe /install Tiam la komando instalos la DeviceManagerSupervisorSvc kiel servon.
Komencu la servon el la listo de servoj (fenestroj+R → services.msc)

2.3.4 Servo pri Aparato Administranto

Modifi la agordon file: DeviceManagerService.config (Ĉi tio estas JSON-bazita agordo file tio devas esti modifita por ke Device Manager ricevu datumojn de la konektaj modemoj, enkursigiloj.)

Vi devas agordi la sekvajn rekomenditajn parametrojn:
– DataBrokerAddress → IP-adreso de la datumperanto
– DataBrokerPort → komunika haveno de la datumperanto
– SupervisorPort → komunika haveno de la kontrolisto
– ServerAddress → ekstera IP-adreso por la modema komunikado
– ServerPort → ekstera haveno por la modema komunikado
- CyclicReadInterval → 0 - malŝalti, aŭ valoro pli granda ol 0 (en sek)
- ReadTimeout → parametro aŭ ŝtatlegtempo (en sek)
- ConnectionTimeout → ligprovotempo al la aparato (en sek)
– ForcePolling → valoro devas esti agordita al 0
– MaxExecutingThreads → maksimumaj paralelaj fadenoj en la sama tempo (rekomendita:
dediĉita CPU-kerno x 16, ekz.: se vi dediĉis 4-kernan CPU por la Aparato-Administranto, tiam
la valoro devas esti agordita al 64)
Se vi volas fari servon por ruli la Aparato-Administranton aŭtomate ĉe ĉiu servilo-komenco, tiam malfermu la komandlinion kaj plenumu la sekvan komandon kiel administranto: DeviceManagerService.exe /install Tiam la komando instalos la Aparato-Administranton kiel servon.

Komencu la servon el la listo de servoj (fenestroj+R → services.msc)

GRAVA!
Se vi volas ŝanĝi la agordojn de la Servo de Device Manager, unue ĉesigu la servon. Se vi finis la modifon, komencu la servon. En alia kazo, la servo anstataŭigos li modifitajn agordojn al la lastaj funkciaj agordoj!
2.3.5 Retaj preparoj
Bonvolu malfermi la taŭgajn havenojn sur la Aparato-Administra Servilo por la ĝusta komunikado.
– Servila haveno por la envenanta modema komunikado
- Data Broker-haveno por la klienta komunikado
- Kontrolisto-haveno por la bontenaj operacioj de la klientoj

2.3.6 Ekfunkciigo de la sistemo

Komencu la Kontroliston por la Servo DeviceManager
Rulu la DeviceManagerDataBroker.exe
DeviceManagerService

2.4 TLS-protokola komunikado
La TLS v1.2-protokolo-komunika funkcio povas esti aktivigita inter la enkursigilo/modema aparato kaj la Aparato-Manaĝero ® de ĝia programara flanko (elektante TLS-reĝimon aŭ heredan komunikadon).
Ĝi uzis mbedTLS-bibliotekon ĉe la klientflanko (ĉe modemo/enkursigilo), kaj OpenSSL-bibliotekon ĉe la Device Manager flanko.
La ĉifrita komunikado estas pakita en TLS-ingo (duoble ĉifrita, tre sekura metodo).
La uzita TLS-solvo uzas reciprokan aŭtentikigmetodon por identigi la du partiojn implikitajn en komunikado. Ĉi tio signifas, ke ambaŭ flankoj havas privatan-publikan ŝlosilparon. La privata ŝlosilo estas videbla nur por ĉiuj (inkluzive de la Device Manager ® kaj enkursigilo/modemo), kaj la publika ŝlosilo vojaĝas en formo de atestilo.
La firmware de modemo/enkursigilo inkluzivas fabrikan defaŭltan ŝlosilon kaj atestilon. Ĝis vi havos vian propran atestilon de la Device Manager ® , la enkursigilo aŭtentikigos sin per ĉi tiu enigita.
Defaŭlte, ĝi estas efektivigita sur la enkursigilo, do la enkursigilo ne kontrolas ĉu la atestilo prezentita de la konektita partio estas subskribita de fidinda partio, do ajna TLS-konekto al la modemo/enkursigilo povas esti establita per iu ajn atestilo, eĉ mem. -subskribita. (Vi devas scii la alian ĉifradon kiu estas ene de la TLS, alie, la komunikado ne funkcios. Ĝi ankaŭ havas uzantan aŭtentigon, do la konektita partio ne sufiĉe scias pri la komunikado, sed vi ankaŭ devas havi la radikan pasvorton, kaj sukcese memaŭtentigi).

Ĉapitro 3. Subteno

3.1 Teknika Subteno
Se vi havas demandojn pri la uzado de la aparato, kontaktu nin per via persona kaj dediĉita vendisto.
Interreta produktsubteno povas esti postulata ĉi tie ĉe nia webretejo: https://www.m2mserver.com/en/support/
La dokumentaro kaj programara eldono por ĉi tiu produkto estas alireblaj per la sekva ligo: https://www.m2mserver.com/en/product/device-manager/
3.2 GPL-licenco
La programaro Device Manager ne estas senpaga produkto. WM Systems LLc posedas la kopirajtojn de la aplikaĵo. La programaro estas regata de la licencaj kondiĉoj de GPL. La produkto uzas la fontkodon de la komponanto Synopse mORMot Framework, kiu ankaŭ estas licencita laŭ GPL 3.0-licencaj kondiĉoj.

Leĝa avizo

©2021. WM Systems LLC.
La enhavo de ĉi tiu dokumentaro (ĉiuj informoj, bildoj, testoj, priskriboj, gvidiloj, emblemoj) estas sub kopirajtoprotekto. Kopiado, uzado, dissendo kaj publikigado estas permesita nur kun la konsento de WM Systems LLC., kun klara indiko de la fonto.
La bildoj en la uzantgvidilo estas nur por ilustraj celoj. WM Systems LLC. ne agnoskas aŭ akceptas respondecon pri iuj eraroj en la informoj enhavitaj en la uzantgvidilo.
La publikigitaj informoj en ĉi tiu dokumento povas ŝanĝiĝi sen avizo.
Ĉiuj datumoj enhavitaj en la uzantgvidilo estas nur por informaj celoj. Por pliaj informoj, bonvolu kontakti niajn kolegojn.
Averto! Ajnaj eraroj okazantaj dum la procezo de ĝisdatigo de la programo povas rezultigi malsukceson de la aparato.

WM Systems LLC
8 Villa str., Budapeŝto H-1222 HUNGARJO
Telefono: +36 1 310 7075
Retpoŝto: sales@wmsystems.hu
Web: www.wmsysterns.hu