Установка Локального агента на Linux

Цель

Установить Локальный агент мониторинга на рабочую станцию Linux с подключённым локальным МФУ для учёта заданий печати.

Предусловия

• Сервер Мониторинга установлен и доступен по сети.
• Получен клиентский ключ из панели администратора Мониторинга.
• Доступ к терминалу рабочей станции.

Что потребуется

• Дистрибутив Локального агента: printum-jtm-linux-x.x.tar.
• IP-адрес сервера Мониторинга.
• Клиентский ключ CLIENT_KEY из раздела "Клиентские ключи" в панели администратора Мониторинга.
• Серийный номер принтера (при наличии).

Подготовка: получить клиентский ключ

1. Войдите в панель администратора Мониторинга.
2. Перейдите в раздел "Локальные принтеры" → "Клиентские ключи", нажмите кнопку «Добавить».
3. Заполните поля:
   • Название — имя ключа (любое значение).
   • Ключ — произвольная строка формата UUID ( ********-****-****-****-************ ), например 5f17bc69-e37e-47ce-b025-60a57dcd20b1. Заполнять не требуется — генерируется автоматически.
   • Описание — подробная информация (необязательное поле).
   • Включен — должен быть активирован (установлена галочка).
   • Компания — выбрать компанию, к которой будет привязан ключ.
4. Нажмите кнопку "Сохранить".
5. Ключ отобразится в таблице "Клиентские ключи".

Шаги установки

Шаг 1. Скачать дистрибутив

Скачайте дистрибутив Локального агента printum-jtm-linux-x.x.tar.

Шаг 2. Запустить установку

После скачивания дистрибутива выполните команды:

tar xf printum-jtm-linux-x.x.tar
cd printum-jtm-linux-x.x
SERVER_IP=x.x.x.x CLIENT_KEY=<key> MODULE_IDENT= SN=<123> ./install.sh 

где:

• printum-jtm-linux-x.x.tar — дистрибутив Локального агента версии x.x.
• printum-jtm-linux-x.x — директория с распакованным Локальным агентом версии x.x.
• MODULE_IDENT — переменная используется для создания идентификатора локального агента. Оставьте её незаполненной.
• SERVER_IP — IP используемого сервера Мониторинга в формате https://<SERVER_IP>:8001.
• CLIENT_KEY — значение, которое было получено на этапе "Подготовка: получить клиентский ключ".
• SN — серийный номер принтера; укажите реальный серийный номер. Если серийный номер неизвестен, оставьте поле пустым — он будет генерироваться автоматически.

Шаг 3. Проверить статус службы

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

systemctl status printum-jtm

МФУ, подключённый по USB, должен появиться в Личном кабинете с отметкой в столбце "Дата": "USB".

Шаг 4. (Опционально) Настроить периодичность опроса

Можно настроить, как часто локальный агент будет отправлять данные. Для этого перейдите в директорию установленного Локального агента:

cd /opt/printum-jtm

После этого отредактируйте файл settings.yml. Поменяйте параметр upload_interval — значение указывается в секундах. По умолчанию оно равно 300 . После правки перезапустите службу агента:

sudo systemctl restart printum-jtm 

Ожидаемый результат

• Служба printum-jtm запущена.
• Локальный МФУ отображается в Личном кабинете Мониторинга с отметкой USB.
• Задания печати учитываются.

Как проверить установку

• Выполнить systemctl status printum-jtm — служба должна быть active (running).
• Распечатать тестовый документ и убедиться, что задание появилось в Личном кабинете

Связанные страницы

• Локальный агент — справка по компоненту
• Установка Локального агента на Windows
• Обновление Локального агента на Linux