Конектори

Конекторът на Edge е малка Windows услуга (EdgeConnector) на компютър в мрежата на обекта. Той достига до контролерите за достъп там и се свързва навън към Edge по HTTPS и WebSocket, така че на обекта не са нужни входящи портове, нито VPN.

Конекторът:

прилага конфигурацията на всеки контролер, която Edge изпраща, и отчита какво пази контролерът;
чете събитията на всеки контролер приблизително веднъж в секунда в надеждна опашка на диска си и ги качва по ред, така че събитията оцеляват при рестартиране и прекъсване на интернет и пристигат точно веднъж;
отваря врати при заявка, търси контролери и проверява връзките;
отчита състоянието на всеки контролер (онлайн, отворена или затворена врата, заключена или отключена) поне веднъж в минута. Контролерите TrackBase002 още не отчитат дали вратата е отворена или заключена;
обновява се сам, когато Edge предложи по-нова версия (Обновления).

Инсталирането и премахването на конектори изисква ролята Администратор на тенанта.

Изисквания

Windows 10/11 или Windows Server, 64-битов, постоянно включен (малък сървър или мини компютър). Не е нужно компютърът да е присъединен към домейн.
Изходящ HTTPS (TCP 443) към hub.entrosity.com. Нищо входящо.
Към контролерите по TCP/IP: техният TCP порт. За шина RS-485: серийният порт или Modbus TCP шлюз.
Обикновено има един конектор на мрежа на обект; той управлява всеки контролер, до който достига. Компютър, който се регистрира отново (със същото име и домейн, в същия тенант), заменя предишната си регистрация: старият ключ спира да работи.

Инсталиране на конектор

Създаване на токен за регистриране

Отворете Конектори и изберете Инсталиране на конектор.

Попълнете:

Поле	Значение
Етикет	Ваше име за токена, напр. Сървър в централата (до 200 знака).
Обект	Обектът, към който принадлежат контролерите на конектора, или Без обект.
Максимален брой използвания	Колко инсталации могат да се регистрират с него: 1–100000, празно за Неограничено. По подразбиране 1.
Изтича след (дни)	1–3650 или празно, ако не изтича. По подразбиране 7.

Изберете Създаване на токен. Диалогът показва Токен и две готови команди. Копирайте токена сега: показва се само веднъж.

Когато сървърът има настроен адрес за изтегляне, диалогът води и към инсталатора на конектора (Изтегляне на инсталатора на конектора); иначе вземете edge-connector.msi от изданията на хранилището entrosity-edge-connector: издание с етикет (vX.Y.Z) или развойната версия dev, която се създава наново при всяка промяна (версия 0.0.<build>-dev.<commit>; всяка се инсталира върху предишната, а първото издание с етикет се инсталира върху всички тях). След като е инсталиран, конекторът сам се поддържа актуален (Обновления).

Инсталиране на Windows

Изпълнете командата под Windows: инсталиране на MSI (команден ред като администратор) в команден ред с администраторски права, в папката, в която е MSI файлът:

msiexec /i edge-connector.msi /qn ENROLLMENT_TOKEN=<token> SERVER_URL=https://hub.entrosity.com/edge

MSI пакетът:

инсталира edge-connector.exe в %ProgramFiles%\Entrosity Edge Connector\;
регистрира компютъра с токена (като SYSTEM). Неуспешно регистриране връща инсталацията назад;
инсталира и стартира Windows услугата EdgeConnector (показвано име Entrosity Edge Connector, LocalSystem, автоматично стартиране), настроена да се рестартира 30 секунди след всеки неуспех.

До минута конекторът се появява в Конектори като Онлайн.

/qn скрива грешките на инсталатора. За да откриете проблем, добавете /l*v C:\edge-connector-install.log и потърсете Return value 3. Подробният журнал съдържа токена за регистриране: изтрийте го след това.

Регистриране от командния ред

Втората команда, под Вече инсталиран или пробно пускане: регистриране от командния ред, регистрира вече инсталиран конектор (например инсталиран без свойствата) или пускане за разработка:

"C:\Program Files\Entrosity Edge Connector\edge-connector.exe" enroll --server https://hub.entrosity.com/edge --token <token>

Услуга, която стартира без регистрация, чака и проверява на всеки десет секунди, така че сама открива регистрацията. За да регистрирате компютъра отново с нов токен, добавете --force и след това рестартирайте услугата (sc stop EdgeConnector и sc start EdgeConnector).

edge-connector status показва регистрацията и колко събития чакат да бъдат качени на сървъра. Всички команди: Конектор на Edge.

ПИН кодове на контролерите

Контролерите TrackBase002 отговарят само със своя ПИН. ПИН кодът се задава в Edge, за всеки контролер поотделно: в полето ПИН на контролера при добавяне на контролера или по-късно на страницата на контролера (ПИН на контролера). Edge го изпраща на конектора с всяка задача за този контролер; конекторът го пази заедно с конфигурацията на контролера и никога не го връща обратно.

Без ПИН контролерът се показва като Офлайн с грешката the controller's PIN is not set: set it in Edge (the controller's page, Controller PIN), а конфигурацията му е неуспешна с config_rejected. При грешен ПИН контролерът не отговаря: недостижим (check the controller's PIN).

Бележка

trackbase.json вече не се чете

По-старите версии на конектора четяха ПИН кодовете от trackbase.json в директорията си с данни. Сега конекторът не обръща внимание на този файл: задайте ПИН кода на всеки контролер в Edge. Останал на диска, файлът не вреди, а деинсталирането все така го премахва.

Симулираните контролери нямат нужда от ПИН.

Списъкът с конектори

Конектори показва всеки конектор с неговото Име, Компютър, на който работи, Състояние (Онлайн или Офлайн), броя Контролери, които управлява, Версия, канала му за Обновления и кога е Последно видян. Докато обновяване е на път, версията показва Обновява се до X (предложено …).

Конекторът е Онлайн от момента, в който се свърже, докато връзката му не прекъсне (показва се веднага) или докато не мълчи три минути. Той изпраща сигнал за активност (heartbeat) всяка минута.

Токени за регистриране

Токени за регистриране показва токените с техния Етикет, Състояние (Активен, Изчерпан, Изтекъл или Отменен), Използвания, кога Изтича и кой ги е създал (Създаден от).

Отмяна спира регистрирането на още конектори с токена. Вече регистрираните с него конектори продължават да работят.
Отменените и изтеклите токени се изтриват автоматично след 30 дни. Глобалните администратори могат да изтрият токен веднага чрез API (то иска паролата им отново).

Токените са тайни: всеки с валиден токен може да добави конектор към тенанта ви. Дръжте Максимален брой използвания на 1 и кратък срок на валидност.

Обновления

Конекторите се обновяват сами: Edge предлага по-нова версия, а конекторът я инсталира, без да е нужен човек пред компютъра.

Канал: всеки конектор следва канал за обновления, който администраторите на тенанта задават в колоната Обновления на Конектори:

Канал	Получава
Стабилни (по подразбиране)	Само издания с етикет (`vX.Y.Z`).
Бета (версии в разработка)	Най-новото от бета и стабилните издания: предварителни издания (`vX.Y.Z-suffix`) и версии в разработка веднага щом бъдат публикувани.

Кога: Edge предлага най-новата версия на канала, когато конекторът се свърже, и после на всеки 5 минути, ако тя е по-нова от версията на конектора. Предложението не се повтаря в рамките на час, нито докато предишно обновяване още чака. Междувременно Версия показва Обновява се до X (предложено …).
Как: конекторът проверява, че изданието е подписано от Edge, изтегля инсталатора и го инсталира минута по-късно. Услугата се рестартира с новата версия; междувременно контролерите продължават да работят, а събитията чакат в опашката. Ако новата версия не стартира, конекторът инсталира отново версията, с която е работил преди.
Резултатът се записва в журнала на конектора (%ProgramData%\Entrosity Edge Connector\logs\connector.log), когато услугата стартира отново; новата Версия се вижда в Конектори.

Конектори, инсталирани преди самообновяването

Конекторите отпреди самообновяването (те не се обновяват, колкото и да чакате) трябва да бъдат обновени ръчно веднъж: изпълнете на компютъра MSI файла от изданието dev или от издание с етикет на entrosity-edge-connector, както е описано по-долу. Оттам нататък те се обновяват сами.

Обновленията изискват сървърът да е настроен за тях (EDGE_MASTER_KEY, EDGE_RELEASE_SIGNING_KEY: Работа с Entrosity Edge). Подробности: Конектор на Edge → Самообновяване.

Ръчно обновяване и деинсталиране

Ръчно обновяване: изпълнете MSI файла (без свойства). Данните остават в %ProgramData%\Entrosity Edge Connector, така че конекторът остава регистриран и запазва контролерите си. По-стар MSI също се инсталира върху по-нов.
Деинсталиране: от Apps & features или с msiexec /x edge-connector.msi /qn. Това премахва услугата, идентификационните данни, списъка с контролери (с техните ПИН кодове), останал от по-стари версии trackbase.json и опашката със събития; журналите се запазват. След това изберете Премахване за конектора в Edge (по-долу).

Премахване на конектор

Изберете Премахване на реда на конектора и потвърдете. Ключът му спира да работи веднага и той се изключва; отворените му задачи се отменят. След това го деинсталирайте от компютъра.

Конектор, който още управлява контролери, не може да бъде премахнат (connector_has_controllers): първо премахнете или преместете контролерите му.

Когато конекторът е офлайн

Контролерите продължават да работят: те решават всяко четене на карта с конфигурацията, която пазят.
Състоянието им в Edge се показва като Неизвестно, а дистанционното отваряне и търсенето на контролери се отказват (connector_offline).
Промените, които правите, изчакват: всеки засегнат контролер показва Изчаква, а конфигурацията се изпраща, когато конекторът се свърже отново.
Събитията остават в паметта на контролера (32 000 събития) и, след като бъдат прочетени, в опашката на конектора на диска; те се качват по ред, когато връзката се възстанови.

Вижте Синхронизация на конфигурацията и отстраняване на проблеми.

Отстраняване на проблеми при инсталиране

Симптом	Причина и решение
Инсталацията се връща назад	Регистрирането е неуспешно. Инсталирайте отново с `/l*v <журнал>` и прочетете стъпката на регистриране: невалиден токен (`enrollment_token_invalid`: сгрешен или не е токен за конектор на Edge), без оставащи използвания (`enrollment_token_exhausted`), изтекъл или отменен (`enrollment_token_expired`) или няма връзка до `SERVER_URL`. Създайте нов токен.
Регистриран, но конекторът остава Офлайн	Проверете изходящия HTTPS към `hub.entrosity.com` (прокси, защитна стена) и журнала `%ProgramData%\Entrosity Edge Connector\logs\connector.log`.
Премахнат е в Edge	Ключът му вече не работи (`connector_unauthorized`). Регистрирайте го отново с нов токен и `--force` и рестартирайте услугата.
`enroll` казва `already enrolled`	Компютърът има идентификационни данни. Използвайте `--force`, за да го регистрирате отново.

Изисквания​

Инсталиране на конектор​

Създаване на токен за регистриране​

Инсталиране на Windows​

Регистриране от командния ред​

ПИН кодове на контролерите​

Списъкът с конектори​

Токени за регистриране​

Обновления​

Ръчно обновяване и деинсталиране​

Премахване на конектор​

Когато конекторът е офлайн​

Отстраняване на проблеми при инсталиране​