# Установка агента Linux ### хорошо Создание и публикация сервиса агента 1\. Зайдите в веб-интерфейс KUMA и перейдите на вкладку **Ресурсы** – **Агенты**. 2\. Нажмите на кнопку **Добавить агент**. 3\. Задайте необходимые параметры для агента в соответствии с ограничениями Linux-агентов: [https://support.kaspersky.ru/help/KUMA/3.2/ru-RU/217776.htm](https://support.kaspersky.ru/help/KUMA/2.1/ru-RU/217776.htm) 4\. Сохраните созданный ресурс агента. 5\. Перейдите на вкладку **Ресурсы** – **Активные сервисы**. 6\. Нажмите на кнопку **Добавить сервис**, выберите созданный ресурс агента и нажмите на кнопку **Создать сервис**. 7\. Выберите галочкой созданный сервис агента и нажмите в верхней части экрана на кнопку **Копировать идентификатор**.

Идентификатор будет скопирован в буфер обмена. Сохраните полученный таким образом идентификатор, он потребуется для дальнейшей установки сервиса агента.

--- ### Установка агента в качестве службы

В данном разделе под **<ID>** понимается значение идентификатора агента, который был скопирован в предыдущем разделе в п. 7. Под **<KUMA-FQDN>** понимается FQDN ядра KUMA.

1\. Если установка агента осуществляется на сервер, на котором уже установлены какие-либо компоненты KUMA, то шаги 2, 3, 5, 7 нужно пропустить. 2\. Скопируйте из дистрибутива KUMA файл `kuma-ansible-installer/roles/kuma/files/kuma` и переместите его на сервер для установки агента в любую директорию. 3\. Создайте пользователя для запуска агента следующей командой ```bash useradd -Mrs /usr/bin/false kuma ``` 4\. Создайте рабочую директорию для агента ```bash mkdir -p /opt/kaspersky/kuma/agent/ ```
Для KUMA < 4.0 5\. Скопируйте файл `kuma` по пути `/opt/kaspersky/kuma/` на любом из установленных компонентов системы или из архива пакета установки (путь: `kuma-ansible-installer/roles/kuma/files/kuma`) в директорию `/opt/kaspersky/kuma/` ```bash cp kuma /opt/kaspersky/kuma/ ``` 6\. Назначьте пользователя kuma владельцем директории ```bash chown -R kuma:kuma /opt/kaspersky/kuma/ ``` 7\. Задайте права на выполнение файлу kuma ```bash chmod +x /opt/kaspersky/kuma/kuma ``` 8\. Примите лицензионное соглашение ```bash /opt/kaspersky/kuma/kuma license ``` На данном этапе можно выполнить ручной запуск агента для проверки его работоспособности. Для этого необходимо выполните команду ```bash /opt/kaspersky/kuma/kuma agent --core https://:7210 --id --wd /opt/kaspersky/kuma/agent/ ``` Для остановки выполнения воспользуйтесь комбинацией клавиш `Ctrl + C`
Для KUMA >= 4.0 5\. Скопируйте файл `agent` из архива пакета установки (путь: `kuma-ansible-installer/roles/kuma/files/agent`) в директорию `/opt/kaspersky/kuma/`, затем переименуйте его на `kuma_agent` ```bash cp agent /opt/kaspersky/kuma/ ; mv /opt/kaspersky/kuma/agent /opt/kaspersky/kuma/kuma_agent ``` 6\. Назначьте пользователя kuma владельцем директории ```bash chown -R kuma:kuma /opt/kaspersky/kuma/ ``` 7\. Задайте права на выполнение файлу kuma\_agent ```bash chmod +x /opt/kaspersky/kuma/kuma_agent ``` 8\. Примите лицензионное соглашение ```bash /opt/kaspersky/kuma/kuma_agent license ``` На данном этапе можно выполнить ручной запуск агента для проверки его работоспособности. Для этого необходимо выполните команду ```bash /opt/kaspersky/kuma/kuma_agent agent --core https://:7210 --id --wd /opt/kaspersky/kuma/agent/ ``` Для остановки выполнения воспользуйтесь комбинацией клавиш `Ctrl + C`
9\. Создайте файл с описанием сервиса агента ```bash touch /usr/lib/systemd/system/kuma-agent-.service ``` 10\. Любым удобным способом откройте созданный файл на редактирование и укажите в нем следующую конфигурацию ```bash [Unit] Description=KUMA Agent Syslog StartLimitIntervalSec=1 After=network.target [Service] Type=notify Restart=always RestartPreventExitStatus=99 TimeoutSec=300 RestartSec=5 WatchdogSec=60 User=kuma Group=kuma ExecStartPre=+-chown kuma:kuma /opt/kaspersky/kuma/agent ExecStartPre=+-chown -R kuma:kuma /opt/kaspersky/kuma/agent/ ExecStart=/opt/kaspersky/kuma/kuma agent --core https://:7210 --id --wd /opt/kaspersky/kuma/agent// LimitFSIZE=infinity LimitCPU=infinity LimitAS=infinity LimitNOFILE=64000 LimitNPROC=64000 LimitMEMLOCK=infinity TasksMax=infinity TasksAccounting=false [Install] WantedBy=multi-user.target ``` 11\. Сохраните полученный файл 12\. Выполните обновление конфигурации ```bash systemctl daemon-reload ``` 13\. Запустите сервис агента ```bash systemctl start kuma-agent-.service ``` 14\. Настройте сервису автозапуск ```bash systemctl enable kuma-agent-.service ``` После установки сервиса агента индикация состояния в веб-интерфейсе KUMA на вкладке **Ресурсы** – **Активные сервисы** изменится на Зеленый. Также будет отображен FQDN и IP-адрес агента. --- ### Диагностика неполадок В случае возникновения сбоев в работе агента или ошибок установки службы диагностическую информацию можно получить следующими способами: 1\. Просмотр состояния службы ```bash systemctl status kuma-agent-.service ``` 2\. Просмотр журнала службы ```bash journalctl -f -u kuma-agent-.service ``` 3\. Просмотр журнала агента ```bash tail -f /opt/kaspersky/kuma/agent//log/agent ``` Для получения дополнительной информации в журнале агента необходимо в веб-интерфейсе KUMA в параметрах агента установить галочку рядом с параметром Отладка после чего выполнить обновление параметров сервиса агента. --- ### Удаление агента Для удаления агента необходимо выполнять ряд команд: 1. Остановка сервиса агента ``` sudo systemctl stop kuma-agent- ``` 2. Отключение сервиса агента ``` sudo systemctl disable kuma-agent- ``` 3. Удаление unit-файла агента ``` sudo rm /usr/lib/systemd/system/kuma-agent-.service ``` 4. Перезапуск конфигурации systemd ``` sudo systemctl daemon-reload ``` 5. (Опциональный шаг) ``` sudo systemctl reset-failed ```