# Установка Локального агента на 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)`.
- Распечатать тестовый документ и убедиться, что задание появилось в Личном кабинете

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

- [Локальный агент — справка по компоненту](https://wiki.printum.io/books/2-komponenty-sistemy/page/lokalnyi-agent-spravka-po-komponentu)
- [Установка Локального агента на Windows](https://wiki.printum.io/books/3-ustanovka/page/ustanovka-lokalnogo-agenta-na-windows)
- [Обновление Локального агента на Linux](https://wiki.printum.io/books/3-ustanovka/page/obnovlenie-lokalnogo-agenta-na-linux)