Обновление агентов

При обновлении версий KUMA требуется обновить и установленные на удаленных машинах агенты WMI, WEC и ETW.

Чтобы обновить агент, используйте учетную запись с правами администратора и выполните следующие шаги:

1. В ОС Windows в разделе Службы откройте агент и нажмите Стоп.
2. В командном интерпретаторе перейдите в папку, где был установлен агент и выполните команду по удалению агента с сервера.

   kuma.exe agent --id <agent_ID> --uninstall

   где:

   <agent_ID> — идентификатор сервиса агента, созданного в KUMA.

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

   kuma agent --core <FQDN>:<port> --pair.fingerprint <CA_cert_ID> --id <agent_ID> --user <user> --install

   где:

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

     Параметр --pair.fingerprint является необязательным. При создании сервиса KUMA автоматически добавляет этот параметр в команду установки и указывает идентификатор отпечатка.
     Вы можете выполнить установку сервиса без указания параметра --pair.fingerprint. В этом случае KUMA использует значение insecure по умолчанию, что не обеспечивает проверку подлинности CA-сертификата Ядра KUMA при установлении соединения. Если используется значение insecure, обновление отпечатка после перевыпуска CA-сертификата не требуется.
     
     Для обеспечения проверки подлинности CA-сертификата Ядра KUMA рекомендуется не удалять параметр --pair.fingerprint с идентификатором отпечатка при установке сервиса. При перевыпуске CA-сертификата необходимо скопировать новый отпечаток сертификата в веб-интерфейсе и перезапустить сервис с обновленным значением параметра.

   • <agent_ID> — идентификатор сервиса агента, созданного в KUMA.
   • <user> — имя пользователя, под которым будет работать агент, включая домен.
5. При первой установке обновленного агента на устройстве требуется подтверждение лицензии. В процессе установки вам будет предложено ознакомиться с текстом лицензии и у вас будет возможность принять соглашение или отказаться. Если этого не произошло автоматически, вы можете воспользоваться следующей командой, чтобы ознакомиться с текстом лицензии:

   kuma.exe license --show

   Если вы хотите принять лицензионное соглашение, выполните команду и нажмите y:

   kuma.exe license

Агент обновлен.