Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Развертывание веб-сервера

Alpha.HMI.WebViewer не имеет встроенного веб-сервера. Для корректной работы веб-приложения необходимо развернуть веб-сервер (IIS, Apache HTTP Server, NGINX и т.д.) и настроить его для раздачи файлов веб-приложения.

Веб-сервер может быть развернут как на том же компьютере, где установлен Alpha.HMI.WebViewer, так и на отдельной машине. Главное условие — обеспечить доступ к файлам веб-приложения из папки, указанной в атрибуте WwwRoot конфигурации Alpha.HMI.WebViewer.

Развертывание в Windows

Настройка IIS (базовая конфигурация)

Ниже приведен пример развертывания веб-приложения на веб-сервере IIS. Используется ОС Windows 10.

  1. Перейдите к списку компонентов Windows и включите службы IIS.

  2. Откройте Диспетчер служб IIS.
  3. Добавьте веб сайт, кликнув правой кнопкой на пункте меню Сайты.
  4. Пропишите параметры сайта:

    Параметр Значение Описание
    Имя сайта company Название сайта в списке сайтов, добавленных в IIS.
    Физический путь C:\WebViewer-WwwRoot\Project\build Путь к папке с файлом index.html (папка расположена по пути развертывания веб-приложения).
    Тип http

    Протокол передачи данных между браузером и веб-приложением:

    • http - для незащищенных соединений;
    • https - для безопасных соединений.
    Порт 82 Порт подключения к веб-приложению. Укажите номер, отличный от номера в настройках Alpha.HMI.WebViewer.
    Имя узла company.local Произвольное имя сайта. Используя его, вы будете обращаться к сайту в адресной строке браузера.
  5. Запустите сайт в разделе Управление веб-сайтом.
  6. Убедитесь, что служба Alpha.HMI.WebViewer запущена.
  7. Перейдите в браузер и введите в поле адреса http://company.local/. В результате откроется мнемосхема проекта.

Настройка IIS с SSL-сертификатами

Ниже приведен пример настройки Alpha.HMI.WebViewer и IIS для возможности использования безопасных соединений с веб-приложением.

Используются приватный ключ WIN-K4MT0LRI5U5.key, сертификат WIN-K4MT0LRI5U5.crt и сертификат WIN-K4MT0LRI5U5.pfx для добавления в IIS.

  1. В файле настроек alpha.hmi.webviewer.xml добавьте запись:

    <WebSocket Address="WIN-K4MT0LRI5U5.automiq.local" Port="8080" SslPort="4430" PrivateKeyPath="C:\key\WIN-K4MT0LRI5U5.key" CertificatePath="C:\key\WIN-K4MT0LRI5U5.crt"/>
  2. Остановите сайт в разделе Управление веб-сайтом.
  3. Остановите службу Alpha.HMI.WebViewer.
  4. Откройте Диспетчер служб IIS.
  5. Перейдите на начальную страницу WIN-K4MT0LRI5U5 и откройте раздел Сертификаты сервера.
  6. Импортируйте сертификат WIN-K4MT0LRI5U5.pfx, вызвав контекстное меню и выбрав Импортировать.

  7. Откройте окно с привязками веб-приложения.
  8. Добавьте протокол https, указав добавленный ранее сертификат.

  9. Запустите службу Alpha.HMI.WebViewer.
  10. Запустите сайт в разделе Управление веб-сайтом.
  11. Введите в строке поиска CertMgr.msc.
  12. Перейдите к сертификатам текущего пользователя.
  13. Перейдите в доверенные корневые центры сертификации.
  14. Импортируйте сертификат WIN-K4MT0LRI5U5.crt в доверенные корневые центры сертификации.

  15. В браузере в строке адреса введите https://WIN-K4MT0LRI5U5.automiq.local/.
  16. В результате в браузере должна открыться страница с мнемосхемой.

  17. Для просмотра мнемосхемы с другого АРМ импортируйте сертификат WIN-K4MT0LRI5U5.crt в доверенные корневые центры сертификации.

Развертывание в Linux

Настройка Apache HTTP Server

Ниже приведены примеры настройки Apache HTTP Server для развертывания веб-приложения Alpha.HMI.WebViewer для Astra Linux и Red OS.

Развертывание в Astra Linux

  1. Проверьте установку Python.

    which python3

    Результат команды (например, /usr/bin/python3) понадобится для конфигурации Alpha.HMI.WebViewer.

  2. Установите Apache HTTP Server.

    sudo apt-get update
    sudo apt-get install apache2
  3. Создайте директорию для веб-приложения.

    sudo mkdir -p /var/www/webviewer.local/html
    sudo chown -R $USER:$USER /var/www/webviewer.local/html
  4. Настройте виртуальный хост Apache.

    sudo nano /etc/apache2/sites-available/webviewer.local.conf

    Содержимое конфигурационного файла:

    <VirtualHost *:80>
    ㅤㅤServerName webviewer.local
    ㅤㅤServerAlias www.webviewer.local
    ㅤㅤDocumentRoot /var/www/webviewer.local/html/build
    ㅤㅤ<Directory /var/www/webviewer.local/html/build>
    ㅤㅤㅤㅤOptions Indexes FollowSymLinks
    ㅤㅤㅤㅤAllowOverride None
    ㅤㅤㅤㅤRequire all granted
    ㅤㅤ</Directory>
    ㅤㅤErrorLog ${APACHE_LOG_DIR}/webviewer_error.log
    ㅤㅤCustomLog ${APACHE_LOG_DIR}/webviewer_access.log combined
    </VirtualHost>
  5. Активируйте виртуальный хост.

    sudo a2ensite webviewer.local.conf
    sudo a2dissite 000-default.conf
  6. Настройте Apache для работы с Astra Linux.

    sudo nano /etc/apache2/apache2.conf

    Добавьте в файл строку:

    AstraMode off

  7. Проверьте конфигурацию и перезапустите Apache.

    sudo apache2ctl configtest
    sudo systemctl restart apache2
    sudo systemctl enable apache2
  8. Добавьте запись в файл hosts для локального доступа.

    echo "127.0.0.1 webviewer.local" | sudo tee -a /etc/hosts
  9. Настройте Alpha.HMI.WebViewer.

    sudo nano /opt/Automiq/alpha.hmi.webviewer/alpha.hmi.webviewer.xml

    Пример конфигурации:

    <?xml version="1.0" encoding="utf-8"?>
    <Alpha.HMI.WebViewer PythonPath="/usr/bin/python3">
    ㅤㅤ<WebSocket Address="192.168.0.1" Port="8080"/>
    ㅤㅤ<Application ProjectPath="/home/astraadmin/Desktop/TestProject/Test.hmi"
    ㅤㅤㅤㅤWwwRoot="/var/www/webviewer.local/html"/>
    </Alpha.HMI.WebViewer>
  10. Перезапустите службу Alpha.HMI.WebViewer.

    sudo systemctl restart alpha.hmi.webviewer
  11. Проверьте процесс компиляции.

    sudo journalctl -u alpha.hmi.webviewer -f

После завершения компиляции веб-приложение будет доступно по адресу http://webviewer.local или напрямую по IP-адресу машины с Apache: http://IP-адрес_машины.

Развертывание в Red OS

  1. Проверьте установку Python.

    which python3

    Результат команды (например, /usr/bin/python3) понадобится для конфигурации Alpha.HMI.WebViewer.

  2. Установите Apache HTTP Server.

    sudo dnf update
    sudo dnf install httpd
  3. Создайте директорию для веб-приложения.

    sudo mkdir -p /var/www/webviewer.local/html
    sudo chown -R $USER:$USER /var/www/webviewer.local/html
  4. Настройте виртуальный хост Apache.

    sudo nano /etc/httpd/conf.d/webviewer.local.conf

    Содержимое конфигурационного файла:

    <VirtualHost *:80>
    ㅤㅤServerName webviewer.local
    ㅤㅤServerAlias www.webviewer.local
    ㅤㅤDocumentRoot /var/www/webviewer.local/html/build
    ㅤㅤ<Directory /var/www/webviewer.local/html/build>
    ㅤㅤㅤㅤOptions Indexes FollowSymLinks
    ㅤㅤㅤㅤAllowOverride None
    ㅤㅤㅤㅤRequire all granted
    ㅤㅤ</Directory>
    ㅤㅤErrorLog /var/log/httpd/webviewer_error.log
    ㅤㅤCustomLog /var/log/httpd/webviewer_access.log combined
    </VirtualHost>
  5. Перезапустите Apache.

    sudo httpd -t
    sudo systemctl restart httpd
    sudo systemctl enable httpd
  6. Настройте firewall (если активен).

    sudo firewall-cmd --state

    Если firewall активен, откройте HTTP порт.

    sudo firewall-cmd --permanent --add-service=http
    sudo firewall-cmd --reload
  7. Настройте SELinux (если включен).

    sudo dnf install policycoreutils-python-utils
    sudo semanage fcontext -a -t httpd_sys_content_t "/var/www/webviewer.local/html/build(/.*)?"
    sudo restorecon -Rv /var/www/webviewer.local/html/build
  8. Добавьте запись в файл hosts для локального доступа.

    echo "127.0.0.1 webviewer.local" | sudo tee -a /etc/hosts
  9. Настройте Alpha.HMI.WebViewer.

    sudo nano /opt/Automiq/alpha.hmi.webviewer/alpha.hmi.webviewer.xml

    Пример конфигурации:

    <?xml version="1.0" encoding="utf-8"?>
    <Alpha.HMI.WebViewer PythonPath="/usr/bin/python3">
    ㅤㅤ<WebSocket Address="192.168.0.1" Port="8080"/>
    ㅤㅤ<Application ProjectPath="/home/admin/Desktop/TestProject/Test.hmi"
    ㅤㅤㅤㅤWwwRoot="/var/www/webviewer.local/html"/>
    </Alpha.HMI.WebViewer>
  10. Перезапустите службу Alpha.HMI.WebViewer.

    sudo systemctl restart alpha.hmi.webviewer
  11. Проверьте процесс компиляции.

    sudo journalctl -u alpha.hmi.webviewer -f

После завершения компиляции веб-приложение будет доступно по адресу http://webviewer.local или напрямую по IP-адресу машины с Apache: http://IP-адрес_машины.

Настройка NGINX

Ниже приведён пример настройки NGINX для развертывания веб-приложения Alpha.HMI.WebViewer для Astra Linux и Red OS.

Развертывание в Astra Linux

  1. Проверьте установку Python.

    which python3

    Результат команды (например, /usr/bin/python3) понадобится для конфигурации Alpha.HMI.WebViewer.

  2. Установите NGINX.

    sudo apt-get update
    sudo apt-get install nginx
  3. Создайте директорию для веб-приложения.

    sudo mkdir -p /var/www/webviewer.local/html
    sudo chown -R $USER:$USER /var/www/webviewer.local/html
  4. Создайте конфигурацию виртуального хоста.

    sudo cp /etc/nginx/sites-available/default /etc/nginx/sites-available/webviewer.local
    sudo nano /etc/nginx/sites-available/webviewer.local

    Содержимое конфигурационного файла:

    server {
        listen 80;
        listen [::]:80;
    
        server_name webviewer.local www.webviewer.local;
        root /var/www/webviewer.local/html/build;
        index index.html index.htm index.nginx-debian.html;
    
        # Основная директива для обработки запросов
        location / {
            try_files $uri $uri/ =404;
        }
    
        # Логирование
        access_log /var/log/nginx/webviewer_access.log;
        error_log /var/log/nginx/webviewer_error.log;
    
        # Настройки для статических файлов
        location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
            expires 1y;
            add_header Cache-Control "public, immutable";
        }
    }
  5. Активируйте виртуальный хост.

    sudo ln -s /etc/nginx/sites-available/webviewer.local /etc/nginx/sites-enabled/
    sudo rm /etc/nginx/sites-enabled/default
  6. Настройте основной конфигурационный файл NGINX.

    sudo nano /etc/nginx/nginx.conf

    Найдите и раскомментируйте строку:

    server_names_hash_bucket_size 64;
  7. Удалите конфигурацию по умолчанию.

    sudo rm /etc/nginx/sites-available/default
  8. Проверьте конфигурацию и перезапустите NGINX.

    sudo nginx -t
    sudo systemctl restart nginx
    sudo systemctl enable nginx
  9. Добавьте запись в файл hosts для локального доступа.

    echo "127.0.0.1 webviewer.local" | sudo tee -a /etc/hosts
  10. Настройте Alpha.HMI.WebViewer.

    sudo nano /opt/Automiq/alpha.hmi.webviewer/alpha.hmi.webviewer.xml

    Пример конфигурации:

    <?xml version="1.0" encoding="utf-8"?>
    <Alpha.HMI.WebViewer PythonPath="/usr/bin/python3">
    ㅤㅤ<WebSocket Address="192.168.0.1" Port="8080"/>
    ㅤㅤ<Application ProjectPath="/home/astraadmin/Desktop/TestProject/Test.hmi"
    ㅤㅤㅤㅤㅤWwwRoot="/var/www/webviewer.local/html"/>
    </Alpha.HMI.WebViewer>
  11. Перезапустите службу Alpha.HMI.WebViewer.

    sudo systemctl restart alpha.hmi.webviewer
  12. Проверьте процесс компиляции.

    sudo journalctl -u alpha.hmi.webviewer -f

После завершения компиляции веб-приложение будет доступно по адресу http://webviewer.local или напрямую по IP-адресу машины с NGINX: http://IP-адрес_машины

Развертывание в Red OS

  1. Проверьте установку Python.

    which python3

    Результат команды (например, /usr/bin/python3) понадобится для конфигурации Alpha.HMI.WebViewer.

  2. Установите NGINX.

    sudo dnf update
    sudo dnf install nginx
  3. Создайте директорию для веб-приложения.

    sudo mkdir -p /var/www/webviewer.local/html
    sudo chown -R $USER:$USER /var/www/webviewer.local/html
  4. Создайте конфигурацию виртуального хоста.

    sudo nano /etc/nginx/conf.d/webviewer.local.conf

    Содержимое конфигурационного файла:

    server {
        listen 80;
        listen [::]:80;
    
        server_name webviewer.local www.webviewer.local;
        root /var/www/webviewer.local/html/build;
        index index.html index.htm index.nginx-debian.html;
    
        # Основная директива для обработки запросов
        location / {
            try_files $uri $uri/ =404;
        }
    
        # Логирование
        access_log /var/log/nginx/webviewer_access.log;
        error_log /var/log/nginx/webviewer_error.log;
    
        # Настройки для статических файлов
        location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
            expires 1y;
            add_header Cache-Control "public, immutable";
        }
    }
  5. Настройте SELinux (если включен).

    sudo dnf install policycoreutils-python-utils
    sudo semanage fcontext -a -t httpd_sys_content_t "/var/www/webviewer.local/html/build(/.*)?"
    sudo restorecon -Rv /var/www/webviewer.local/html/build
  6. Проверьте конфигурацию и перезапустите NGINX.

    sudo nginx -t
    sudo systemctl restart nginx
    sudo systemctl enable nginx
  7. Настройте firewall (если активен).

    sudo firewall-cmd --state

    Если firewall активен, откройте HTTP порт.

    sudo firewall-cmd --permanent --add-service=http
    sudo firewall-cmd --reload
  8. Добавьте запись в файл hosts для локального доступа.

    echo "127.0.0.1 webviewer.local" | sudo tee -a /etc/hosts
  9. Настройте Alpha.HMI.WebViewer.

    sudo nano /opt/Automiq/alpha.hmi.webviewer/alpha.hmi.webviewer.xml

    Пример конфигурации:

    <?xml version="1.0" encoding="utf-8"?>
    <Alpha.HMI.WebViewer PythonPath="/usr/bin/python3">
    ㅤㅤ<WebSocket Address="192.168.0.1" Port="8080"/>
    ㅤㅤ<Application ProjectPath="/home/admin/Desktop/TestProject/Test.hmi"
    ㅤㅤㅤㅤㅤWwwRoot="/var/www/webviewer.local/html"/>
    </Alpha.HMI.WebViewer>
  10. Перезапустите службу Alpha.HMI.WebViewer.

    sudo systemctl restart alpha.hmi.webviewer
  11. Проверьте процесс компиляции.

    sudo journalctl -u alpha.hmi.webviewer -f

После завершения компиляции веб-приложение будет доступно по адресу http://webviewer.local или напрямую по IP-адресу машины с NGINX: http://IP-адрес_машины