Alpha.Community

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

Автоматический перезапуск проекта (ОС Linux)

Для обеспечения бесперебойной работы проекта Alpha.HMI можно настроить автоматический перезапуск в случае аварийного завершения работы визуализатора.

Автоматический перезапуск реализуется через создание пользовательской службы systemd, которая:

  • Автоматически запускается при входе пользователя в систему.
  • Запускает проект в визуализаторе.

  • Отслеживает состояние процесса визуализатора.
  • Автоматически перезапускает визуализатор при его аварийном завершении или сбое.

Инструкция применима для любых операционных систем семейства Linux, в которых используется systemd, включая:

  • Astra Linux
  • РЕД ОС
  • ALT Linux

Пользовательские службы systemd работают только в рамках активной пользовательской сессии. Если настройки системы приводят к автоматическому завершению сессии при закрытии приложения (как в режиме киоска одного приложения в Astra Linux), автоматический перезапуск визуализатора средствами пользовательской службы systemd становится невозможным.

Настройка службы автоматического перезапуска

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

Создание директории для службы

Файлы пользовательских служб systemd должны располагаться в каталоге ~/.config/systemd/user. Если этот каталог отсутствует, создайте его командой:

mkdir -p ~/.config/systemd/user/

Создание файла службы

Создайте файл службы с расширением .service (например, restart_hmi_project.service):

nano ~/.config/systemd/user/restart_hmi_project.service

Настройка содержимого файла службы

Добавьте в созданный файл следующее содержимое:

[Unit]
Description=Alpha.HMI Project Auto-restart Service
StartLimitIntervalSec=100
StartLimitBurst=10

[Service]
Environment="DISPLAY=:0"
ExecStart=alpha.hmi.viewer /home/user/projects/MyProject.hmi
Restart=on-failure
RestartSec=5

[Install]
WantedBy=default.target

Описание параметров файла службы:

Параметр Описание Что нужно указать
Description Описание назначения службы.

Любое понятное описание, например

Alpha.HMI Project Auto-restart Service

Environment Параметр для задания переменных окружения службы. В данном случае задаётся переменная DISPLAY, указывающая графический дисплей для визуализатора. Значение переменной DISPLAY (например, :0). Получается командой echo $DISPLAY — см. раздел Получение значения переменной DISPLAY
ExecStart Команда запуска визуализатора с указанием файла проекта.

Имя исполняемого файла alpha.hmi.viewer и полный путь к проекту в формате .hmi или .ni.binom — см. раздел Указание пути к проекту.

StartLimitIntervalSec Временной интервал (в секундах), в течение которого отслеживается количество попыток перезапуска. Можно оставить 100.
StartLimitBurst Максимальное количество попыток перезапуска в течение StartLimitIntervalSec. При превышении лимита служба будет остановлена. Можно оставить 10.
Restart

Условия автоматического перезапуска.

Для перезапуска при аварийных ситуациях используйте on-failure (рекомендуется). Полный список значений см. в официальной документации systemd.
RestartSec Время ожидания (в секундах) перед попыткой перезапуска службы. Можно оставить 5.

Получение значения переменной DISPLAY

Переменная окружения DISPLAY указывает, на каком графическом дисплее должен отображаться визуализатор. Для получения её значения выполните команду:

echo $DISPLAY

Пример результата:

:0

Полученное значение необходимо указать в параметре Environment="DISPLAY=..." в файле службы.

Если вы используете несколько мониторов или удаленное подключение, значение может отличаться (например, :1, :10.0).

Указание пути к проекту

В параметре ExecStart укажите:

  1. Путь к исполняемому файлу alpha.hmi.viewer.
  2. Полный путь к файлу проекта в формате .hmi или .ni.binom.
    1. Пример с файлом проекта .hmi:

      ExecStart=alpha.hmi.viewer /home/operator/projects/SCADA_System.hmi
    2. Пример с файлом .ni.binom (без компиляции):

      ExecStart=alpha.hmi.viewer /home/operator/projects/output/SCADA_System.ni.binom

Если в пути к файлу проекта присутствуют пробелы, заключите путь в двойные кавычки:

ExecStart=alpha.hmi.viewer "/home/operator/My Projects/SCADA System.hmi"

Сохранение и активация службы

После создания и настройки файла службы выполните следующие действия:

  1. Сохраните файл (в nano: Ctrl+O, затем Enter, затем Ctrl+X).
  2. Обновите конфигурацию systemd:

    systemctl --user daemon-reload
  3. Запустите службу:

    systemctl --user start restart_hmi_project.service
  4. Проверьте статус службы:

    systemctl --user status restart_hmi_project.service

    Служба должна быть в состоянии active (running).

Добавление службы в автозапуск

Чтобы служба автоматически запускалась при входе пользователя в систему, выполните команду:

systemctl --user enable restart_hmi_project.service

После этого служба будет автоматически запускаться при каждой загрузке системы и входе пользователя.

Диагностика службы

Для наблюдения за работой службы в режиме реального времени:

journalctl --user -u restart_hmi_project.service -f

Эта команда выводит логи по мере их появления. Полезно для отслеживания ошибок при запуске или во время работы. Для выхода нажмите Ctrl+C.

Для просмотра недавних событий службы:

journalctl --user -u restart_hmi_project.service -n 50

Команда показывает последние 50 записей из журнала службы. Вы можете изменить число записей, заменив 50 на нужное значение.

Для анализа событий за конкретный период:

journalctl --user -u restart_hmi_project.service --since "2025-11-10 10:00:00"

Или за последний час:

journalctl --user -u restart_hmi_project.service --since "1 hour ago"

Анализ системных логов

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

sudo tail -f /var/log/syslog