Оглавление
1. Дистрибутивы
2. Установка среды исполнения
3. Загрузка тестового проекта в среду исполнения
4. Установка и настройка клиента визуализации
Общий порядок установки клиента визуализации
Настройка автозапуска клиента визуализации
Создание ярлыка запуска клиента визуализации на рабочем столе
Дополнительные опции запуска клиента визуализации
5. Инсталляция криптобиблиотеки
6. Операции с ключами
Использование локального ключа
Использование сетевого ключа

1. Дистрибутивы
1.1. Выбор дистрибутива осуществляется в зависимости от разрядности операционной системы и наличия лицензии на право использования программного продукта.

1.2. Если необходимо установить лицензионную исполнительную систему, то следует использовать каталоги для скачивания с пост - индексом «_key»

1.3. Разрядность операционной системы можно определить, выполнив команду:
[user@localhost ~]$ inxi -S

2. Установка среды исполнения

1.1. Установить ключевой носитель (см. раздел операции с ключами, подключение ключевого носителя).
1.2. Открыть окно терминала.
1.3. Перейти в режим администратора, выполнив команду:

[user@localhost ~]$ sudo su

1.4. Если в операционной системе используется SElinux - система принудительного контроля доступа, реализованная на уровне ядра, то её необходимо временно деинсталлировать, выполнив команду:

[root@localhost]# yum remove selinux*

1.5. Поместить установочные файлы в папку /tmp
1.6. Назначить права администратора скрипту инсталлятора с помощью команды:

[root@localhost]# chmod u+x ./install.sh

1.7. Запустить процесс установки среды исполнения, выполнив команду

при использовании локального ключа:

[root@localhost]# ./install.sh --enable-log --with-reports

при использовании сетевого ключа:

[root@localhost]# ./install.sh --enable-log --with-reports --netkey

1.8. Включить автозапуск среды исполнения при запуске операционной системы, выполнив команду:

[root@localhost]# systemctl enable mplc4

1.9. Проверить корректность установки среды исполнения, проанализировав данные log – файла: /opt/mplc4/log/mplc_YYYY_MM_DD.txt, где YYYY_MM_DD – дата инсталляции в соответствующем формате (см. раздел Логирование).

1.10. Перезагрузить операционную систему, выполнив команду:

[root@localhost]# reboot

1.11. Осуществить проверку наличия процесса среды исполнения, выполнив команду:

[root@localhost]# ps -aux | grep mplc

, результат выполнения должен содержать информацию о запуске связанных со средой исполнения процессов:

root 3503 0.0 0.0 19664 840 ? Ss 16:14 0:00 nginx: master process /opt/mplc4/nginx/sbin/nginx -p /opt/mplc4 -c /opt/mplc4/nginx/conf/nginx-mplc.conf
root 3510 0.1 0.0 20068 208 ? Ss 16:14 0:00 /opt/mplc4/mplc_service 31550 /opt/mplc4/mplc new /netkey /log:log/mplc_2022_06_30.txt
root 3514 0.7 1.3 697184 107016 pts/1 Sl 16:14 0:01 /opt/mplc4/nodejs/node_ms4d /opt/mplc4/nodejs/index.js --mplc http://127.0.0.1:80 --exemplars 0 --log log/node_2022_06_30.log
root 3527 0.0 0.0 20068 208 ? S 16:14 0:00 /opt/mplc4/mplc_service 31550 /opt/mplc4/mplc new /netkey /log:log/mplc_2022_06_30.txt
root 3532 1.4 0.4 2013640 32984 ? Sl 16:14 0:02 /opt/mplc4/mplc 3 6 /netkey /log:log/mplc_2022_06_30.txt

3. Загрузка тестового проекта в среду исполнения.

3.1. Узнать IP адрес компьютера. В терминале ввести команду:
[root@localhost]# inxi -i

3.1. Открыть тестовый проект (извлечь файл: UbuntuT1.zip ) в среде разработки и указать IP – адрес АРМ, определённый в предыдущем пункте.

3.2. Указать IP адрес в соответствующем свойстве элемента АРМ или Сервер.

3.3. Загрузить проект в среду исполнения и проверить корректность работы среды исполнения, запустив браузер и указав URL АРМ/Сервера, на котором разворачивается среда исполнения. 1.1. Открыть тестовый проект (извлечь файл:) в среде разработки и указать IP – адрес АРМ, определённый в предыдущем пункте.

4. Установка и настройка клиента визуализации

4.1. MasterSCADA 4D Client работает на ОС Linux и устанавливается в случае, если необходимо подключаться к исполнительной системе, работающей на другом компьютере. На устройстве, где находится клиент установлена ОС Linux.

Внимание! Приложение MasterSCADA 4D Client Linux рассчитано на операционные системы с разрядностью x64.

4.2. Скачать файлы для установки графического клиента можно с FTP-сервера: ftp://ftpGuestDemo:8AA55D8A@support.insat.ru/MasterSCADA4D/HMI/MasterSCADA4DClient-linux-x64.zip

Общий порядок установки клиента визуализации

4.3. Поместить папку из архива в директорию /tmp.

4.4. Открыть окно терминала.

4.5. Перейти в режим администратора, последовательно выполнить команды:

[user@localhost ~]$ sudo su
[root@localhost]# cd /tmp
[root@localhost]# cp -rp /tmp/MasterSCADA4DClient-linux-x64/ /opt

4.6. Перейти в директорию /opt/MasterSCADA4DClient-linux-x64

[root@localhost]# cd /opt/MasterSCADA4DClient-linux-x64

4.7. Последовательно выполнить команды:

[root@localhost]# chown root:root chrome-sandbox
[root@localhost]# chmod 4755 chrome-sandbox
[root@localhost]# chmod u+x ./MasterSCADA4DClient
[root@localhost]# exit

4.8. Протестировать работу клиента визуализации, выполнить команду из под учётной записи рядового пользователя:

[user@localhost ~]$ cd /opt/MasterSCADA4DClient-linux-x64
[user@localhost ~]$ ./MasterSCADA4DClient -u http://IP

, где IP – адрес, определённый в пункте 12.1 раздела «Установка среды исполнения» настоящей инструкции.

Если загрузится пустое окно, то нужно дополнительно указать номер порта, например,

[user@localhost ~]$ ./MasterSCADA4DClient -u http://192.168.247.132:8043

Настройка автозапуска клиента визуализации

4.9. Запустить GUI-инструмент «Центр управления»

4.10. В Категории «Персонализация» запустить GUI-инструмент «Запуск приложений»

4.11. Добавить приложение, задав соответствующие свойства:

Имя = MasterScada 4D Client;

Команда = /opt/MasterSCADA4DClient-linux-x64/MasterSCADA4DClient -u http:// IP, где IP – адрес, определённый в пункте 13.1 раздела «Установка среды исполнения» настоящей инструкции;

Примечание = Клиент визуализации MasterScada 4D.

4.12. После заполнения свойств нажать кнопку «+Добавить».

4.13. Выйти из сеанса пользователя.

4.14. Запустить сеанс пользователя с целью убедиться, что клиент визуализации запускается.

Создание ярлыка запуска клиента визуализации на рабочем столе

4.15. На рабочем столе вызвать контекстное меню, нажатием правой клавиши мыши.

4.16. Выбрать пункт контекстного меню «Создать кнопку запуска».

Указать свойства:

Тип = Приложение;

Имя = MasterScada 4D Client;

Команда = /opt/MasterSCADA4DClient-linux-x64/MasterSCADA4DClient -u http:// IP , где IP – адрес, определённый в пункте 13.1 раздела «Установка среды исполнения» настоящей инструкции;

Примечание = Клиент визуализации MasterScada 4D.

Дополнительные опции запуска клиента визуализации

4.17. Для запуска клиента визуализации в полноэкранном режиме к команде запуска необходимо добавить опцию «--noframe». Команда запуска будет иметь, следующий вид:

/opt/MasterSCADA4DClient-linux-x64/MasterSCADA4DClient -u http:// IP --noframe , где IP – адрес, определённый в пункте 12.1 раздела «Установка среды исполнения» настоящей инструкции.

Для отключения панели задач к команде запуска необходимо добавить опцию «-f». Команда запуска будет иметь, следующий вид

/opt/MasterSCADA4DClient-linux-x64/MasterSCADA4DClient -u http:// IP --noframe -f

Внимание! Перед включением опции «-f», отключающей панель задач, в проекте необходимо предусмотреть процедуру закрытия клиента визуализации. В прилагаемом, к настоящей инструкции проекте, подобная возможность реализована, нажатием кнопки «Закрыть».

5. Инсталляция криптобиблиотеки

5.1. В некоторых случаях в операционной системе Linux может отсутствовать криптобиблиотека, необходимая для работы среды исполнения

5.2. В этом случае необходимо установить пакет с библиотекой, обеспечивающей процедуры кодирования и декодирования (библиотека шифрования / дешифрования).

5.3. Определить имя пакета, содержащего библиотеку, можно, выполнив команду:
[root@localhost]# yum provides "libxcrypt.so.1"

5.4. Инсталлировать пакет можно из командной строки, командой

[root@localhost]# yum -y install libxcrypt-compat

5.5. Или воспользоваться специальным GUI-инструментом

6. Операции с ключами

Использование локального ключа

1.1. Если устанавливаемая среда исполнения, лицензируется локальным ключом и устанавливается на операционную систему Linux, развёрнутую на виртуальной машине, то процедура монтирования ключа выглядит примерно так:

1.2. Вставить USB ключ в разъём.

1.3. Подключить USB ключ к виртуальной машине (см. рисунок).

6.4. При запуске среды исполнения на Linux в лог файле /opt/mplc4/log/mplc_YYYY_MM_DD.txt, где YYYY_MM_DD - дата в соответствующем формате будет отражена информация о ключе (текст выделен), например:

Log to : log/mplc_2022_07_14.txt

MasterSCADA 4D RT started (1.2.16.27212) Date: Jun 29 2022 15:58:27 ID: Guardant Platform: linux-x64 (11)
(PID=25637) (Dir=/opt/mplc4)
ProgramPath=/opt/mplc4/ DataPath=/opt/mplc4/
39981213: Change state from 00 to 03 (1)
Date=14.07.2022 Time=11:06:21:213
No File: NET = FALSE
Key found : 3EED798F

6.5. Если ключ не будет опознан средой исполнения, то информация об этом будет отражена в лог фале в виде строки:

Key error 1 : Dongle Not Found

Использование сетевого ключа

6.6. В целях использования сетевого ключа необходимо развернуть Сервер Guardant Net (см. Сервер Guardant Net / Центр загрузки / Поддержка / Guardant).

6.7. Подключить USB ключ, который должен быть определён Сервером Guardant Net.

6.8. Сформировать конфигурационный файл, разместив его в /opt/mplc4/

6.9. Если необходимо, внести изменения в файл, например, указав IP - адрес Сервера Guardant Net

6.10. Запустить среду исполнения на Linux

6.12. При запуске среды исполнения на Linux в лог файле /opt/mplc4/log/mplc_YYYY_MM_DD.txt, где YYYY_MM_DD - дата в соответствующем формате будет отражена информация о ключе (текст выделен), например:

Log to : log/mplc_2022_07_28.txt
MasterSCADA 4D RT started (1.2.16.27525) Date: Jul 18 2022 19:48:01 ID: Guardant Platform: linux-x64 (11)
(PID=24119) (Dir=/opt/mplc4)
ProgramPath=/opt/mplc4/ DataPath=/opt/mplc4/
54926986: Change state from 00 to 03 (1)
Date=28.07.2022 Time=15:15:26:986
No File: NET = TRUE
Key found: 38B5657D