Сервер TCP-соединений М2М24Desktop – коммуникационное программное обеспечение для соединения по протоколу TCP узлов системы диспетчеризации, работающих в режиме «Клиент»: программ верхнего уровня (SCADA-программ) и 3G/GPRS терминалов связи TELEOFIS серии WRX, подключённых к приборам учёта на удалённых узлах.
Служба разработана в виде локальной программы для систем Windows и Linux, совместима с любым диспетчерским ПО, работающим по протоколу TCP, и состоит из двух приложений:
- М2М24 Service — серверное ПО для «прозрачной» передачи данных между узлами.
- М2М24 Client — конфигурационное приложение для настройки параметров сервера и подключаемого оборудования (терминалов WRX, модем RX, конвертеров ER108, роутеров серии RTU).
Установка M2M24 Desktop для операционной системы Windows
Скачав zip-архив M2M24Desktop (M2M24 Desktop_1.9.0_win32/win64/linux_2021-08-10 zip) и распаковав его в любую папку на ПК. Вы найдете две директории: М2М24DesktopClient и М2М24DesktopService.
1. Установка и запуск сервисной части M2M24 Service:
Откройте папку М2М24DesktopService и запустите установочный файл admintool-servereng.bat.
Важно! Программа должна быть запущена от имени администратора: для этого кликните правой кнопкой
по файлу и нажмите Запуск от имени администратора.
В открывшейся консоли управления сервером произведите установку службы, для этого необходимо выбрать пункт №1 (Install Service). После этого необходимо подтвердить После установки служба запустится автоматически.
Внимание! По умолчанию, служба M2M24 Service использует TCP порт 10002 для подключения оборудования из внешней сети. Если вы хотите изменить номер порта с 10002 на другой, в папке М2М24DesktopService найдите и
откройте с помощью любого текстового редактора файл configuration.json.
Найдите параметр “wrxPort”, измените его значение и сохраните изменения. Перезагрузите сервер в консоли управления (4.Restart Service), чтобы изменения вступили в силу.
2. Установка и запуск приложения M2M24 Client:
Откройте папку М2М24DesktopClient и запустите файл m2m24client.exe — программу для настройки и управления сервером и терминалами. Данная программа напрямую связана со службой M2M24Service. Если данная служба отключена, то запуск клиентской части будет невозможен.
На это установка сервера M2M24Desktop закончена.
Установка M2M24 Desktop для операционной системы Linux
1. Установка и запуск сервисной службы M2M24 Service
Внимание! Требуемые зависимости: JRE выше или равен версии 1.8, systemd, unzip
Скачав zip-архив M2M24Desktop по ссылке: M2M24_Desktop_1.10.0_all. Или же с помощью команды wget:
$ wget https://teleofis.ru/upload/iblock/31c/swn77uqio6l8p0ifh49cyhk52bsoqsro/M2M24_Desktop_1.10.0_all.zip
Распаковываем его в любую папку на ПК, подав команду unzip:
$ unzip ./M2M24_Desktop_1.10.0_all.zip
Вы найдете две директории: М2М24DesktopClient и М2М24DesktopService. Необходимо создать директорию, где будет находится служба M2M24DesktopService.
Подаём команду mkdir и указываем где будет расположена директория:
$ sudo mkdir /opt/m2m24service (В данном примере, создана директория m2m24service в разделе /opt/)
Копируем необходимые файлы в директорию службы и проверяем
$ sudo cp ./M2M24DesktopService/{service.jar,configuration.json} /opt/m2m24service
Проверим, что все файлы службы были перенесены в нужную директорию:
$ ls /opt/m2m24service при подаче данной команды мы увидим файлы: configuration.json и service.jar
Создаем пользователя и группу под которыми будет запускаться сервис
$ sudo groupadd -r jvmgrp(наименование группы)
$ sudo useradd -r -s /bin/false -g jvmgrp (наименование группы) jvmapps (наименование пользователя)
Проверяем созданного пользователя
$ sudo id jvmapps
uid=999(jvmapps) gid=998(jvmgrp) groups=998(jvmgrp)
Создаем службу systemd service:
$ sudo nano /etc/systemd/system/m2m24.service
Со следующим содержимым:
[Unit]
Description=M2M24 Service
After=network.target
[Service]
WorkingDirectory=/opt/m2m24service (директория где находится служба и файл конфигурации)
ExecStart=/usr/bin/java -Xms256m -Xmx4g -jar service.jar
User=jvmapps
Type=simple
Restart=on-failure
RestartSec=10
[Install]
WantedBy=multi-user.target
Настраиваем права для директории сервиса
$ sudo chown -R jvmapps:jvmgrp /opt/m2m24service/ (выдаем право для созданного пользователя и группы на директорию, где находится служба и файл конфигурации)
Обновляем конфигурацию systemd
$ sudo systemctl daemon-reload
Запускаем службу
$ sudo systemctl start m2m24.service
Проверяем статус службы
$ sudo systemctl status m2m24.service
m2m24.service - M2M24 Service
Loaded: loaded (/etc/systemd/system/m2m24.service; disabled; vendor preset: enabled)
Active: active (running) since Tue 2019-12-17 15:40:59 MSK; 3s ago
Main PID: 12350 (java)
Tasks: 60 (limit: 4915)
Memory: 266.1M
CPU: 10.309s
CGroup: /system.slice/m2m24.service
└─12350 /usr/bin/java -Xms256m -Xmx4g -jar service.jar
Dec 17 15:41:02 teleofis java[12350]: Scheduler class: 'org.quartz.core.QuartzScheduler' - running locally.
Dec 17 15:41:02 teleofis java[12350]: NOT STARTED.
Dec 17 15:41:02 teleofis java[12350]: Currently in standby mode.
Dec 17 15:41:02 teleofis java[12350]: Number of jobs executed: 0
Dec 17 15:41:02 teleofis java[12350]: Using thread pool 'org.quartz.simpl.SimpleThreadPool' - with 2 threads.
Dec 17 15:41:02 teleofis java[12350]: Using job-store 'org.quartz.simpl.RAMJobStore' - which does not support persistence. and is not clustered.
Dec 17 15:41:02 teleofis java[12350]: 2019-12-17 15:41:02,669 INFO [StdSchedulerFactory.java:1339] Quartz scheduler 'M2M24Scheduler' initialized from default resource file in Quartz package: 'quartz.properties'
Dec 17 15:41:02 teleofis java[12350]: 2019-12-17 15:41:02,670 INFO [StdSchedulerFactory.java:1343] Quartz scheduler version: 2.2.1
Dec 17 15:41:02 teleofis java[12350]: 2019-12-17 15:41:02,670 INFO [QuartzScheduler.java:575] Scheduler M2M24Scheduler_$_NON_CLUSTERED started.
Dec 17 15:41:02 teleofis java[12350]: 2019-12-17 15:41:02,683 INFO [Application.java:115] Start OK
На этом установка и запуск службы M2M24DesktopService завершен. В дальнейшем Вам необходимо запустить клиентскую часть M2M24DesktopClient.
2. Запуск клиентской части M2M24 Client
Необходимо создать директорию, где будет находится клиентская часть M2M24DesktopClient.
Подаём команду mkdir и указываем где будет расположена директория:
$ sudo mkdir /opt/m2m24client (В данном примере, создана директория m2m24client в разделе /opt/)
Копируем необходимые файлы в директорию службы и проверяем
$ sudo cp ./M2M24DesktopClient/* /opt/m2m2client
Клиентская часть включает в себя следующие файлы:
Далее необходимо дать права на исполнение файла m2m24client:
$ sudo chmod +x m2m24client
После этого Вы сможете запустить клиентскую часть сервера нажав два раза мышью на файл m2m24client.
На этом установка и запуск сервера M2M24Desktop завершена!
Дополнительная информация:
Описание возможностей M2M24 Desktop
Как подключить терминал WRX к M2M24 Desktop?
Как подключить модем RX со скриптом к M2M24 Desktop?
Ссылки по теме:
Типовые схемы построения прозрачных каналов связи через M2M24 Desktop
Пример удаленной настройки терминалов WRX с помощью M2M24 Desktop