# Установка KUMA

<p class="callout info"><span style="color: rgb(35, 111, 161);">Информация, приведенная на данной странице, является разработкой команды pre-sales и/или community KUMA и **НЕ** является официальной рекомендацией вендора.</span></p>

### <span style="color: rgb(0, 0, 0);">Описание процесса установки</span>

<p class="callout success">Ниже рассматривается вариант установки KUMA All-in-One.</p>

<span style="color: rgb(0, 0, 0);">Для выполнения установки KUMA Вам понадобится дистрибутив **kuma-ansible-installer-&lt;номер сборки&gt;.tar.gz** и файл лицензии/лицензионный код.</span>

<p class="callout success">Дистрибутив и файл лицензии/лицензионный код запрашивается у сотрудника Лаборатории Касперского или представителя партнера Лаборатории Касперского.</p>

<span style="color: rgb(22, 145, 121);"><span style="color: rgb(0, 0, 0);">Установка, а также обновление и удаление компонентов KUMA производится из папки **kuma-ansible-installer** с распакованным установщиком с помощью инструмента Ansible и созданного пользователем файла инвентаря. В создаваемом файле инвентаря указываются значения параметров конфигурации KUMA, а установщик использует эти значения при развертывании, обновлении и удалении KUMA. Файл инвентаря имеет формат YAML.</span></span>

<span style="color: rgb(22, 145, 121);"><span style="color: rgb(0, 0, 0);">Для создания файла инвентаря можно воспользоваться шаблоном, включенным в поставку. Доступны следующие шаблоны:</span></span>

- <span style="color: rgb(22, 145, 121);"><span style="color: rgb(0, 0, 0);">**single.inventory.yml.template** – используется для установки KUMA на одном сервере. Содержит минимальный набор параметров, оптимизированный для установки на одном сервере. **Этот шаблон будет использоваться при дальнейшей установке.**</span></span>
- <span style="color: rgb(22, 145, 121);"><span style="color: rgb(0, 0, 0);">**distributed.inventory.yml.template** – используется для первоначальной распределенной установки KUMA без использования кластера Kubernetes, расширения установки "все в одном" до распределенной и для обновления KUMA, а также для установки KUMA c несколькими сервисами Ядра в кластере Raft.</span></span>
- <span style="color: rgb(22, 145, 121);"><span style="color: rgb(0, 0, 0);">**expand.inventory.yml.template** – используется в ряде сценариев изменения конфигурации: </span></span>
    - <span style="color: rgb(22, 145, 121);"><span style="color: rgb(0, 0, 0);">для добавления серверов Коллекторов и серверов Корреляторов;</span></span>
    - <span style="color: rgb(22, 145, 121);"><span style="color: rgb(0, 0, 0);">для расширения существующего кластера хранения;</span></span>
    - <span style="color: rgb(22, 145, 121);"><span style="color: rgb(0, 0, 0);">добавления нового кластера хранения;</span></span>
    - <span style="color: rgb(22, 145, 121);"><span style="color: rgb(0, 0, 0);">расширения кластера и добавления необходимого количества сервисов Ядра KUMA в кластер Raft.</span></span>
- <span style="color: rgb(22, 145, 121);"><span style="color: rgb(0, 0, 0);">**k0s.inventory.yml.template** – используется для установки или переноса KUMA в кластер Kubernetes.</span>  
    </span>

<p class="callout success"><span style="color: rgb(22, 145, 121);"><span style="color: rgb(0, 0, 0);">Статья онлайн-справки «Установка и удаление KUMA»:  
[https://support.kaspersky.ru/kuma/4.0/217904](https://support.kaspersky.ru/kuma/4.0/217904)  
  
Статья онлайн-справки «Параметры конфигурации KUMA в файле инвентаря»:  
[https://support.kaspersky.ru/kuma/4.0/244406](https://support.kaspersky.ru/kuma/4.0/244406)  
</span></span></p>

### <span style="color: rgb(0, 0, 0);">Пошаговая установка KUMA</span>

<p class="callout warning">В примере ниже установка выполняется от пользователя root</p>

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

- Подготовьте файл инвентаря **single.inventory.yml**:
- Скопируйте архив с установщиком **kuma-ansible-installer-&lt;номер версии&gt;.tar.gz** на сервер и распакуйте его с помощью следующей команды (потребуется около 2 ГБ дискового пространства):

```shell
tar -xpf kuma-ansible-installer-<номер версии>.tar.gz
```

- - Перейдите в директорию распакованного архива с установщиком KUMA, выполнив следующую команду

```shell
cd kuma-ansible-installer
```

- - Скопируйте шаблон **single.inventory.yml.template** и создайте файл инвентаря с именем **single.inventory.yml**:

```shell
cp single.inventory.yml.template single.inventory.yml
```

- - Замените в файле инвентаря все строки **kuma.example.com** на имя сервера, на котором выполняется установка компонентов KUMA:

```shell
sed -i "s/kuma.example.com/$(hostname -f)/g" single.inventory.yml
```

- - По умолчанию установщик создает предустановленные сервисы KUMA (Коррелятор, Хранилище, Коллекторы). В случае если демонстрационные сервисы НЕ нужно разворачивать укажите в файле **single.inventory.yml** для параметра **deploy\_example\_services** значение **false.**

Файл инвентаря создан. С его помощью можно установить KUMA на одном сервере.

<p class="callout success">Рекомендуется сохранить файл инвентаря, который использовался для установки KUMA. С его помощью в дальнейшем можно дополнить систему компонентами или удалить KUMA.</p>

- В зависимости от типа активации лицензии, который вы планируете использовать, выберите один из вариантов: 
    - При использовании **файла лицензии** поместите полученный файл лицензии в папку **kuma-ansible-installer/roles/kuma/files** и переименуйте его в **license.key**:

```shell
cp <файл ключа>.key <папка установщика>/roles/kuma/files/license.key
```

- - При использовании лицензионного кода перейдите к следующему шагу.

<p class="callout warning">Активация с помощью лицензионного кода доступна только для KUMA версии 3.4+. Для более ранних версий KUMA используется активация лицензии файлом.</p>

- Запустите установку компонентов KUMA с использованием подготовленного файла инвентаря **single.inventory.yml** с помощью следующей команды:

```shell
./install.sh single.inventory.yml
```

- Примите условия **Лицензионного соглашения**. Если вы не примете условия Лицензионного соглашения, KUMA не будет установлена.
- В зависимости от выбранного типа активации лицензии результатом запуска установщика будет один из следующих вариантов: 
    - Если Вы использовали активацию **лицензии файлом** и поместили файл с лицензионным ключом в папку **&lt;папка установщика&gt;/roles/kuma/files/**, в результате запуска установщика с инвентарем **single.inventory.yml** будут установлены: 
        - Ядро KUMA.
        - Все заданные в файле инвентаря сервисы Коррелятора, Хранилища и Коллекторов (если в инвентаре был задан параметр **deploy\_example\_services** = **true**) и OOTB-ресурсы.
    - Если Вы планируете использовать активацию с помощью **лицензионного кода** или планируете предоставить лицензионный файл позднее, в результате запуска установщика с инвентарем **single.inventory.yml** будет установлено только Ядро KUMA. Чтобы установить остальные сервисы KUMA: 
        - Перейдите по адресу **https://&lt;IP-адрес/FQDN сервера**, на котором установлены компоненты KUMA&gt;:7220.
        - Войдите в веб-интерфейс KUMA. Учетные данные для входа по умолчанию: 
            - Логин – admin
            - Пароль – [mustB3Ch@ng3d](mailto:mustB3Ch@ng3d)!
        - Перейдите в раздел **Параметры** → **Лицензия**, в поле **Тип активации** выберите **Активировать ключом** и введите код активации.
        - Опционально укажите параметры прокси-сервера для доступа к серверу активации "Лаборатории Касперского".

<p class="callout success">При активации с помощью лицензионного кода серверу KUMA (в распределенном варианте установки серверу Ядра) требуется постоянный доступ в интернет к серверу активации "Лаборатории Касперского":   
https://activation-v2.kaspersky.com:443</p>

- - - Нажмите **Активировать**.  
              
            [![image8.png](https://kb.kuma-community.ru/uploads/images/gallery/2026-06/scaled-1680-/image8.png)](https://kb.kuma-community.ru/uploads/images/gallery/2026-06/image8.png)

<p class="callout success">Вы также можете выбрать **Активировать файлом** и добавить файл лицензии.</p>

- - - После активации лицензии перейдите в консоль сервера и из папки **kuma-ansible-installer** запустите установщик **postinstall.sh** с файлом инвентаря **single.inventory.yml**:

```shell
./postinstall.sh single.inventory.yml
```

- - - В результате будут установлены все заданные в файле инвентаря сервисы Коррелятора, Хранилища и Коллекторов (если в инвентаре был задан параметр **deploy\_example\_services = true**) и OOTB-ресурсы.
- По окончании установки войдите в веб-интерфейс KUMA, перейдя по адресу: **https://&lt;IP-адрес/FQDN сервера**, на котором установлены компоненты KUMA&gt;:7220.
- Учетные данные для входа по умолчанию: 
    - **Логин** – admin
    - **Пароль** – mustB3Ch@ng3d!

![image9.png](https://kb.kuma-community.ru/uploads/images/gallery/2026-06/scaled-1680-/image9.png)Установка KUMA завершена. В дальнейшем при необходимости установку можно расширить до распределенной.

<p class="callout success">Статья онлайн-справки «Установка на одном сервере»:  
[https://support.kaspersky.ru/kuma/4.0/217908](https://support.kaspersky.ru/kuma/4.0/217908)  
  
Видео «Установка на одном сервере»:  
[https://rutube.ru/video/7f45a6902afb8296f84d58b057cc8492/?playlist=891489](https://rutube.ru/video/7f45a6902afb8296f84d58b057cc8492/?playlist=891489)  
  
Статья онлайн-справки «Распределенная установка»:  
[https://support.kaspersky.ru/kuma/4.0/217917](https://support.kaspersky.ru/kuma/4.0/217917)  
  
Статья онлайн-справки «Распределенная установка в отказоустойчивой конфигурации»:  
[https://support.kaspersky.ru/kuma/4.0/244396](https://support.kaspersky.ru/kuma/4.0/244396)  
  
Видео «Распределенная установка KUMA»:  
[https://rutube.ru/video/a0a310d160e408015b7009e8a756ffaa/?playlist=891489](https://rutube.ru/video/a0a310d160e408015b7009e8a756ffaa/?playlist=891489)  
  
Статья онлайн-справки «Распределенная установка с Ядром KUMA в кластере Raft»:  
[https://support.kaspersky.ru/kuma/4.0/303366](https://support.kaspersky.ru/kuma/4.0/303366)  
  
Статья онлайн-справки «Удаление KUMA»:  
[https://support.kaspersky.ru/kuma/4.0/217962](https://support.kaspersky.ru/kuma/4.0/217962)</p>