Наразі даний функціонал працює лише для OS Windows!
¶ Як це працює
Device Manager(далі ДМ) має можливість працювати на одному пристрої як кілька додатків(служб) на різних портах.
Додатковий інстанс чи кілька інстансів використовують всі ті ж самі дані з каталогу де встановлено device manager, проте є відмінності.
Різниця в:
- Кожен інстанс має свій порт. За замовчуванням ДМ працює на 3939 порту перший створений інстанс, після основного, буде мати порт 3940, кожен наступний буде мати:
номер порту попереднього + 1 - Кожен інстанс має свій конфігураційний файл з назвою
EDMSrv{InstanceID}.iniдеInstanceIDномер інстансу. - Кожен інстанс має свою папку для логів з назвою Logs{InstanceID}.
- Кожен інстанс пише дані в свій файл БД.
- Кожен інстанс це окремий сервіс(служба) з назвою EDMSrv{InstanceID}.
На один фізичний сервер рекомендовано встановлювати не більше 20 інстансів.
¶ Створення нового інстансу
- Створюємо bat файл(створювати потрібно в папці з додатком) можна довільної назви, рекомендуємо
EDMSrv_instance.bat - Відкриваємо файл EDMSrv_instance.bat за допомогою будь-якого text-редактора.
Додаємо такий вміст до цього файлу:
SET InstanceID=1
SET mypath=%~dp0
echo %mypath:~0,-1%
sc create EDMSrv%InstanceID% binPath= "%mypath:~0,-1%\EDMSrv.exe -s -%InstanceID%" DisplayName= EDMSrv%InstanceID% type= own start= auto
net start EDMSrv%InstanceID%
-
В першому рядку
SET InstanceIDвказується ID нового ДМ, якщо 1 то буде створений додатковий сервіс EDMSrv1, якщо 2 то EDMSrv2 і т.д. -
Зберігаємо зміни в файлі, після чого запускаємо bat файл з правами адміністратора.
-
Після запуску якщо прав було достатньо буде створено новий сервіс ДМ.
-
Перевірка роботи нового экземпляра ДМ, приклад:
Переходимо за посиланням:http://localhost:3939/dm/vchasno-kasa/ якщо все працює буде відображена наступна інформація
curl --location --request GET 'http://{{dm_ip}}:3939/dm/echo'
Де {{dm_ip}} IP адреса пристрою де встановлено ДМ, або localhost якщо запити відправляються на локально встановлений додаток.
Якщо додаток запущено та вебсервер працює:
<HTML>
<BODY><B>200 Echo</B></BODY>
</HTML>
Якщо є проблеми:
HTTP статус не буде 200
¶ Що відбувається після запуску додаткового екземпляра ДМ
В даному прикладі дані якщо
InstanceID=1
- Створюється файл EDMSrv1.ini в якому знаходяться налаштування для відповідного екземпляра(інстансу) ДМ, при цьому порт буде автоматично збільшено на номер екземпляра ДМ в даному випадку це буде: 3940, при необхідності порт можна замінити на будь-який інший доступний в системі.
- Для нового экземпляра ДМ створюється новий файл БД шлях до якого має вигляд:
C:\ProgramData\VCHASNO\DeviceManager1\ - Створюється додаткова папка Logs1, в яку пишуться логи відповідного екземпляра.
¶ Видалення інстансу з системи
Файл EDMSrv_unreg.bat, який створюється автоматично при встановленні додатку, використовується для вилучення сервіса ДМ з будь яким id із системи, ось його вміст:
SET InstanceID=1
net stop EDMSrv%InstanceID%
sc delete EDMSrv%InstanceID%
reg delete "HKEY_LOCAL_MACHINE\SOFTWARE\EVO\EVO DeviceManager x64\Instances\%InstanceID%" /f /reg:32
Принцип ідентичний попередньому, якщо InstanceID=1 то буде вилучено сервіс EDMSrv1.
Для вилучення запускати bat файл потрібно з правами адміністратора.
¶ Додаткова інформація
- Автооновлення додатку виконує основний інстанс ДМ-а з
InstanceID=0який за замовчуванням на порту 3939 з назвою служби EDMSrv. Відповідно встановлювати час автооновлення потрібно саме на цьому ДМ.
При встановленні часу автооновлення на іншому інстансі автооновлення не відбудеться!
Служби всі інших інстансів автоматично будуть зупинені та оновлені, після чого запущені.