Общие инструкции по работе с сервисами

В этом разделе приведены общие инструкции по работе с сервисами.

Изменение названия сервиса

При необходимости вы можете изменить имя и параметры созданных сервисов.

Чтобы изменить имя сервиса:

1. В веб-интерфейсе откройте раздел Ресурсы → Активные сервисы.
2. Нажмите на ссылку с названием сервиса в столбце Сервис.
3. В открывшемся окне укажите новое название сервиса и при необходимости измените параметры. Имя должно быть уникальным в рамках одного тенанта и содержать от 1 до 128 символов в кодировке Unicode.

   Для сервисов Ядро KUMA и сервиса Метрики доступно только изменение имени.

4. Нажмите на кнопку Сохранить.

Получение идентификатора сервиса

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

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

1. В веб-интерфейсе откройте раздел Ресурсы → Активные сервисы.
2. В контекстном меню сервиса, идентификатор которого вы хотите получить, выберите Копировать идентификатор.

Идентификатор сервиса будет скопирован в буфер.

Остановка, запуск, проверка статуса сервиса

Чтобы остановить, запустить или проверить статус Ядра KUMA:

1. В веб-интерфейсе откройте раздел Ресурсы → Активные сервисы и в контекстном меню сервиса выберите Копировать идентификатор.

   Идентификатор будет скопирован в буфер обмена.

2. В командной строке выполните одну из следующих команд:

   Остановка сервиса

   sudo systemctl stop kuma-core/collector/correlator/storage/metrics-<service_ID>.service

   Запуск сервиса

   sudo systemctl start kuma-<collector/correlator/storage/eventRouter/metrics>-<service_ID>.service

   Проверка статуса сервиса

   sudo systemctl status kuma-<collector/correlator/storage/eventRouter/metrics>-<service_ID>.service

   Где:

   <service_ID> – идентификатор сервиса, скопированный в буфер обмена.

Остановка, запуск, проверка статусов агентов под управлением Windows

Чтобы остановить или запустить агент под управлением Windows:

1. В веб-интерфейсе откройте раздел Ресурсы → Активные сервисы.
2. В контекстном меню агента, идентификатор которого вы хотите получить, выберите Копировать идентификатор.

   Идентификатор будет скопирован в буфер обмена.

3. Подключитесь к хосту, на котором требуется запустить или остановить агент KUMA.
4. Запустите интерпретатор команд PowerShell от имени учетной записи с правами администратора.
5. В PowerShell выполните одну из следующих команд:

   Остановка агента

   Stop-Service -Name "WindowsAgent-<идентификатор агента>"

   Запуск агента

   Start-Service -Name "WindowsAgent-<идентификатор агента>"

Чтобы просмотреть статус агента:

1. В Windows откройте приложение Службы (Services).
2. В списке служб двойным щелчком мыши откройте агент KUMA, статус которого вы хотите просмотреть.
3. В открывшемся окне на вкладке Общие (General) просмотрите статус в поле Состояние (Service status).

Обновление и перезапуск сервиса

Чтобы обновить или перезапустить сервис:

1. В веб-интерфейсе откройте раздел Ресурсы → Активные сервисы.
2. Установите флажок рядом с сервисом и выберите один из следующих вариантов:
   • Если нужно обновить параметры работающего сервиса без его остановки, например для изменения параметров сопоставления полей или параметров точки назначения, выберите Обновить параметры.
   • Если нужно остановить сервис и запустить заново, например для изменения порта или типа коннектора, выберите Перезапустить.

     Особенности перезапуска агентов KUMA:

     • Агент KUMA для Windows можно перезапустить, только если он запущен на удаленном компьютере. Если сервис на удаленном компьютере неактивен, при попытке перезагрузить его из KUMA отобразится сообщение об ошибке. В этом случае следует перезапустить сервис Агент KUMA для Windows на удаленном компьютере с Windows. Чтобы узнать, как перезапустить сервисы Windows, обратитесь к документации, относящейся к версии операционной системы вашего удаленного компьютера с Windows.
     • Агент KUMA для Linux при использовании этой опции останавливается. Для запуска агента необходимо выполнить команду, с помощью которой он был запущен.

Удаление сервиса

Чтобы удалить сервис:

1. В веб-интерфейсе откройте раздел Ресурсы → Активные сервисы.
2. Получите идентификатор удаляемого сервиса. Для этого контекстном меню сервиса нажмите Копировать идентификатор.
3. В контекстном меню сервиса нажмите Удалить.
4. Подтвердите удаление.
5. Удалить сервис на сервере, выполнив следующую команду:

   sudo /opt/kaspersky/kuma/kuma <collector/correlator/storage/eventRouter/metrics> --core https://<FQDN>:<port> --id <service_ID> --uninstall

   Где:

   • <FQDN> — полное доменное имя сервера Ядра KUMA.
   • <port> — порт, используемый ядром KUMA для внутренних коммуникаций (по умолчанию 7210).
   • <service_ID> — идентификатор сервиса, скопированный в веб-интерфейсе KUMA.

   Например:

   sudo /opt/kaspersky/kuma/kuma collector --core https://kuma.example.com:7210 --id 29fd6760-a870-42d2-8ebe-eb911ac90305 --uninstall

Сервис будет удален.