Kaspersky SD-WAN
2.2
Русский
Развертывание Kaspersky SD-WAN  >  Настройка конфигурационного файла

Настройка конфигурационного файла

Вам нужно указать параметры развертывания Kaspersky SD-WAN в конфигурационном файле в формате YAML на устройстве администратора. Путь к конфигурационному файлу необходимо указать при развертывании решения. Вы можете использовать примеры конфигурационных файлов для типовых схем развертывания, которые содержатся в директориях inventory/external/pnf и inventory/external//vnf архива установки.

Конфигурационный файл состоит из двух основных блоков:

  • nodes – виртуальные машины или физические серверы для развертывания компонентов Kaspersky SD-WAN. При развертывании решения на виртуальных машинах или физических серверах автоматически генерируются правила iptables для взаимодействия компонентов решения друг с другом.
  • external – параметры развертывания Kaspersky SD-WAN.

Мы не рекомендуем изменять значения параметров по умолчанию.

Блок nodes имеет следующую структуру:

Блок/параметр

Описание

node_<номер виртуальной машины или физического сервера>

Параметры развертывания виртуальной машины или физического сервера.

 

ip

IP-адрес виртуальной машины или физического сервера. Вам нужно ввести значение в формате XXX.XXX.XXX.XXX, например:

192.168.110.126

vip

Виртуальный IP-адрес виртуальной машины или физического сервера. Вам нужно ввести значение в формате XXX.XXX.XXX.XXX, например:

192.168.110.126

Этот параметр необходимо указать для всех виртуальных машин или физических серверов, на которых вы планируете использовать виртуальные IP-адреса.

knaas_aio_int

Параметры подключения Docker-контейнеров компонентов Kaspersky SD-WAN к локальной виртуальной сети виртуальной машины или физического сервера.

 

base

Первые три октета IP-адреса локальной виртуальной сети. Значение по умолчанию: 10.11.11. Вам нужно ввести значение в формате XXX.XXX.XXX, например:

192.168.110

Вы можете изменить первые три октета IP-адреса по умолчанию, если они пересекаются с вашим адресным пространством.

mode

Режим работы локальной виртуальной сети. Возможные значения:

  • bridge – на виртуальной машине или физическом сервере создается Linux-мост. Docker-контейнеры подключаются к Linux-мосту по L3-сети с помощью NAT и iptables.
  • vlan – Docker-контейнеры подключаются к интерфейсу виртуальной машины или физического сервера по L2-сети с помощью macvlan-драйвера. Мы рекомендуем указывать это значение только при использовании доверенной L2-сети, так как в этом случае на виртуальной машине или физическом сервере не используется межсетевой экран.

iface

Имя интерфейса виртуальной машины или физического сервера для подключения Docker-контейнеров по L2-сети, например:

enp6s0

Этот параметр необходимо указать, если для параметра mode вы указали значение vlan.

vlan

VLAN-тег L2-сети. Вам нужно ввести значение в диапазоне от 1 до 4095. Если вы не хотите использовать VLAN-тег, введите 0.

Этот параметр необходимо указать, если для параметра mode вы указали значение vlan.

knaas_os_man

Параметры подключения Docker-контейнеров компонентов Kaspersky SD-WAN к управляющей виртуальной сети виртуальной машины или физического сервера.

 

base

Первые три октета IP-адреса управляющей виртуальной сети. Значение по умолчанию: 10.11.11. Вам нужно ввести значение в формате XXX.XXX.XXX, например:

192.168.110

Вы можете изменить первые три октета IP-адреса по умолчанию, если они пересекаются с вашим адресным пространством.

mode

Режим работы управляющей виртуальной сети. Возможные значения:

  • bridge – на виртуальной машине или физическом сервере создается Linux-мост. Docker-контейнеры подключаются к Linux-мосту по L3-сети с помощью NAT и iptables.
  • vlan – Docker-контейнеры подключаются к интерфейсу виртуальной машины или физического сервера по L2-сети с помощью macvlan-драйвера. Мы рекомендуем указывать это значение только при использовании доверенной L2-сети, так как в этом случае на виртуальной машине или физическом сервере не используется межсетевой экран.

iface

Имя интерфейса виртуальной машины или физического сервера для подключения Docker-контейнеров по L2-сети, например:

enp6s0

Этот параметр необходимо указать, если для параметра mode вы указали значение vlan.

vlan

VLAN-тег L2-сети. Вам нужно ввести значение в диапазоне от 1 до 4095. Если вы не хотите использовать VLAN-тег, введите 0.

Этот параметр необходимо указать, если для параметра mode вы указали значение vlan.

Блок external имеет следующую структуру:

Блок/параметр

Описание

vault_passwords_dirname

Путь к директории /passwords на устройстве администратора со сгенерированными вручную паролями. Если вы не генерируете пароли вручную, они автоматически генерируются при развертывании решения и помещаются в директорию /passwords распакованного архива установки на устройстве администратора.

ansible_user

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

ssl

Параметры SSL-сертификатов компонентов Kaspersky SD-WAN.

 

san_list

Информация, которая добавляется в SSL-сертификаты.

 

ip

IP-адреса, которые добавляются в SSL-сертификаты. Вам нужно указать список значений в формате XXX.XXX.XXX.XXX, например:

ip:

- 192.168.2.0

- 192.168.2.1

dns

Доменные имена, которые добавляются в SSL-сертификаты. Вам нужно указать список значений, например:

dns:

- sdwan.kaspersky.com

- kaspersky.sdwan.com

path_local

Путь к директории на устройстве администратора со сгенерированными вручную SSL-сертификатами. Если вы не генерируете SSL-сертификаты вручную, они автоматически генерируются при развертывании решения и помещаются в директорию /ssl распакованного архива установки на устройстве администратора.

path_remote

Путь к директории на виртуальных машинах или физических серверах со сгенерированными вручную SSL-сертификатами. Если вы не генерируете SSL-сертификаты вручную, они автоматически генерируются при развертывании решения и помещаются в директорию /ssl на виртуальных машинах или физических серверах.

syslog

Параметры Syslog-сервера.

 

docker_memory_limit

Объем оперативной памяти в мегабайтах для Docker-контейнеров Syslog-сервера.

max_log_size

Объем оперативной памяти в гигабайтах для журналов Syslog-сервера.

state

Развертывание Syslog-сервера на виртуальных машинах или физических серверах. Возможные значения:

  • enabled;
  • disabled.

zabbix

Параметры системы мониторинга Zabbix. Более подробную информацию можно получить из официальной документации решения Zabbix.

 

syslog_server_address

Веб-адрес Syslog-сервера, на который Docker-контейнеры системы мониторинга Zabbix отправляют журналы. Вам нужно ввести значение в формате <протокол>://<IP-адрес>:<номер порта>, например:

udp://192.168.2.15:1514

Параметры Syslog-сервера можно указать в блоке syslog.

db_docker_memory_limit

Объем оперативной памяти в мегабайтах для Docker-контейнеров базы данных системы мониторинга Zabbix.

srv_docker_memory_limit

Объем оперативной памяти в мегабайтах для Docker-контейнеров сервера Zabbix.

www_docker_memory_limit

Объем оперативной памяти в мегабайтах для Docker-контейнеров frontend-части системы мониторинга Zabbix.

proxy_docker_memory_limit

Объем оперативной памяти в мегабайтах для Docker-контейнеров сервера Zabbix-прокси.

cachesize

Объем оперативной памяти в гигабайтах для кеша системы мониторинга Zabbix. Вам нужно ввести значение в формате <количество гигабайт>G, например:

8G

zabbix_<1‑3>

Параметры развертывания узлов системы мониторинга Zabbix. Вы можете развернуть один узел системы мониторинга Zabbix без высокой доступности (англ. high availability) или три узла с высокой доступностью.

 

ansible_host

IP-адрес виртуальной машины или физического сервера из блока nodes для развертывания системы мониторинга Zabbix. Возможные значения:

  • Значение в формате XXX.XXX.XXX.XXX, например:

    192.168.110.126

  • Переменная Ansible, например:

    {{ nodes.node_1.ip }}

db

Параметры развертывания базы данных системы мониторинга Zabbix.

 

inventory_hostname

Имя хоста базы данных системы мониторинга Zabbix. Значение по умолчанию: zabbix-db-<1‑3>.

state

Развертывание базы данных системы мониторинга Zabbix на виртуальной машине или физическом сервере. Возможные значения:

  • enabled;
  • disabled.

srv

Параметры развертывания сервера Zabbix. При развертывании трех узлов системы мониторинга Zabbix вам нужно указать эти параметры только для двух узлов.

 

inventory_hostname

Имя хоста сервера Zabbix. Значение по умолчанию: zabbix-srv-<1‑3>.

state

Развертывание сервера Zabbix на виртуальной машине или физическом сервере. Возможные значения:

  • enabled;
  • disabled.

www

Параметры развертывания frontend-части системы мониторинга Zabbix. При развертывании трех узлов системы мониторинга Zabbix вам нужно указать эти параметры только для двух узлов.

 

inventory_hostname

Имя хоста frontend-части системы мониторинга Zabbix. Значение по умолчанию: zabbix-www-<1‑3>.

state

Развертывание frontend-части системы мониторинга Zabbix на виртуальной машине или физическом сервере. Возможные значения:

  • enabled;
  • disabled.

proxy

Параметры развертывания сервера Zabbix-прокси. При развертывании трех узлов системы мониторинга Zabbix вам нужно указать эти параметры только для двух узлов.

 

inventory_hostname

Имя хоста сервера Zabbix-прокси. Значение по умолчанию: zabbix-proxy-<1–3>.

state

Развертывание сервера Zabbix-прокси на виртуальной машине или физическом сервере. Возможные значения:

  • enabled;
  • disabled.

mongo

Параметры базы данных MongoDB. Более подробную информацию можно получить из официальной документации базы данных MongoDB.

 

syslog_server_address

Веб-адрес Syslog-сервера, на который Docker-контейнеры базы данных MongoDB отправляют журналы. Вам нужно ввести значение в формате <протокол>://<IP-адрес>:<номер порта>, например:

udp://192.168.2.15:1514

Параметры Syslog-сервера можно указать в блоке syslog.

docker_memory_limit

Объем оперативной памяти в мегабайтах для Docker-контейнеров базы данных MongoDB.

mongo_<1‑3>

Параметры развертывания узлов базы данных MongoDB. Вы можете развернуть один узел базы данных MongoDB без высокой доступности или три узла с высокой доступностью. Если вы развертываете три узла базы данных MongoDB, последний узел становится узлом-арбитром.

 

inventory_hostname

Имя хоста базы данных MongoDB. Значение по умолчанию: mongo-<1‑3>

state

Развертывание базы данных MongoDB на виртуальной машине или физическом сервере. Возможные значения:

  • enabled;
  • disabled.

ansible_host

IP-адрес виртуальной машины или физического сервера из блока nodes для развертывания базы данных MongoDB. Возможные значения:

  • Значение в формате XXX.XXX.XXX.XXX, например:

    192.168.110.126

  • Переменная Ansible, например:

    {{ nodes.node_1.ip }}

redis

Параметры базы данных Redis. Более подробную информацию можно получить из официальной документации базы данных Redis.

 

syslog_server_address

Веб-адрес Syslog-сервера, на который Docker-контейнеры базы данных Redis отправляют журналы. Вам нужно ввести значение в формате <протокол>://<IP-адрес>:<номер порта>, например:

udp://192.168.2.15:1514

Параметры Syslog-сервера можно указать в блоке syslog.

docker_memory_limit

Объем оперативной памяти в мегабайтах для Docker-контейнеров базы данных Redis.

redis_<1–3>m

Параметры развертывания узлов сервера Redis replica. Вы можете развернуть один узел сервера Redis replica без высокой доступности или три узла с высокой доступностью.

 

inventory_hostname

Имя хоста сервера Redis replica. Значение по умолчанию: redis-<1–3>m.

state

Развертывание сервера Redis replica на виртуальной машине или физическом сервере. Возможные значения:

  • enabled;
  • disabled.

ansible_host

IP-адрес виртуальной машины или физического сервера из блока nodes для развертывания сервера Redis replica. Возможные значения:

  • Значение в формате XXX.XXX.XXX.XXX, например:

    192.168.110.126

  • Переменная Ansible, например:

    {{ nodes.node_1.ip }}

redis_<1–3>s

Параметры развертывания узлов системы Redis Sentinel. Если вы разворачиваете три узла сервера Redis replica с высокой доступностью, вам также нужно развернуть три узла системы Redis Sentinel.

 

inventory_hostname

Имя хоста системы Redis Sentinel. Значение по умолчанию: redis-<1–3>s.

state

Развертывание системы Redis Sentinel на виртуальной машине или физическом сервере. Возможные значения:

  • enabled;
  • disabled.

ansible_host

IP-адрес виртуальной машины или физического сервера из блока nodes для развертывания системы Redis Sentinel. Возможные значения:

  • Значение в формате XXX.XXX.XXX.XXX, например:

    192.168.110.126

  • Переменная Ansible, например:

    {{ nodes.node_1.ip }}

ctl

Параметры развертывания контроллера. Вам нужно развернуть контроллер в виде физической сетевой функции, чтобы развернуть экземпляр SD-WAN для тенанта.

 

tenants

Параметры тенантов, для которых вы разворачиваете экземпляры SD-WAN.

- name

Имя тенанта.

 

state

Создание тенанта и развертывание контроллера на виртуальной машине или физическом сервере. Возможные значения:

  • enabled;
  • disabled.

ctl_base

Первые три октета IP-адреса виртуальной сети контроллера. Вам нужно ввести значение в формате XXX.XXX.XXX, например:

192.168.110

При развертывании демонстрационного стенда Kaspersky SD-WAN в соответствии со схемой развертывания все-в-одном значение этого параметра может совпадать со значением параметра base в блоке nodes.

mock_base

Первые три октета IP-адреса управляющей виртуальной сети контроллера. Вам нужно ввести значение в формате XXX.XXX.XXX, например:

192.168.110

hosts

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

- inventory_hostname

Имя хоста узла контроллера. Значение по умолчанию: ctl-<1–5>.

 

ansible_host

IP-адрес виртуальной машины или физического сервера из блока nodes для развертывания узла контроллера. Возможные значения:

  • Значение в формате XXX.XXX.XXX.XXX, например:

    192.168.110.126

  • Переменная Ansible, например:

    {{ nodes.node_1.ip }}

docker_memory_limit

Объем оперативной памяти в мегабайтах для Docker-контейнеров контроллера.

JAVA_OPTS

Параметры оперативной памяти виртуальной машины Java.

 

Xms

Минимальный объем heap-памяти, который виртуальная машина Java может назначить контроллеру. Вам нужно ввести значение в одном из следующих форматов:

  • <объем памяти>m – объем памяти в мегабайтах, например:

    512m

  • <объем памяти>g – объем памяти в гигабайтах, например:

    2g

Мы рекомендуем указать для этого параметра значение, которое вдвое меньше значения параметра Xmx.

Xmx

Максимальный объем heap-памяти, который виртуальная машина Java может назначить контроллеру. Вам нужно ввести значение в одном из следующих форматов:

  • <объем памяти>m – объем памяти в мегабайтах, например:

    512m

  • <объем памяти>g – объем памяти в гигабайтах, например:

    4g

Мы рекомендуем указать для этого параметра значение, которое вдвое меньше значения параметра docker_memory_limit.

MaxDirectMemorySize

Максимальный объем прямой памяти (англ. direct memory), который виртуальная машина Java может назначить контроллеру. Вам нужно ввести значение в одном из следующих форматов:

  • <объем памяти>m – объем памяти в мегабайтах, например:

    512m

  • <объем памяти>g – объем памяти в гигабайтах, например:

    4g

Мы рекомендуем указать для этого параметра значение, которое вдвое меньше значения параметра docker_memory_limit.

syslog_server_address

Веб-адрес Syslog-сервера, на который Docker-контейнеры контроллера отправляют журналы. Вам нужно ввести значение в формате <протокол>://<IP-адрес>:<номер порта>, например:

udp://192.168.2.15:1514

Параметры Syslog-сервера можно указать в блоке syslog.

www

Параметры frontend-части решения.

 

syslog_server_address

Веб-адрес Syslog-сервера, на который Docker-контейнеры frontend-части решения отправляют журналы. Вам нужно ввести значение в формате <протокол>://<IP-адрес>:<номер порта>, например:

udp://192.168.2.15:1514

Параметры Syslog-сервера можно указать в блоке syslog.

docker_memory_limit

Объем оперативной памяти в мегабайтах для Docker-контейнеров frontend-части решения.

oem

Параметры отображения графических элементов веб-интерфейса оркестратора. С помощью этого блока вы можете изменить графические элементы веб-интерфейса оркестратора.

 

state

Изменение графических элементов по умолчанию веб-интерфейса оркестратора. Возможные значения:

  • enabled;
  • disabled.

path_local

Путь к директории на устройстве администратора с графическими элементами веб-интерфейса оркестратора. Графические элементы по умолчанию веб-интерфейса оркестратора содержатся в директории /oem распакованного архива установки на устройстве администратора.

path_remote

Путь к директории на виртуальных машинах или физических серверах с графическими элементами веб-интерфейса оркестратора.

title

Название, которое которое отображается на фоне при входе в веб-интерфейс оркестратора. Значение по умолчанию: Kaspersky SD-WAN. Рекомендуемая длина: не более 128 символов.

support

Веб-адрес, который отображается в нижней части веб-интерфейса оркестратора. Значение по умолчанию: support.kaspersky.com. Рекомендуемая длина: не более 128 символов.

assets

Замена графических элементов по умолчанию веб-интерфейса оркестратора на графические элементы, которые вы поместили в директорию на устройстве администратора. Возможные значения:

  • enabled;
  • disabled.

Вам нужно указать директорию на устройстве администратора с графическими элементами веб-интерфейса оркестратора с помощью параметра path_local.

www_<1‑2>

Параметры развертывания узлов frontend-части решения. Вы можете развернуть один узел frontend-части решения без высокой доступности или два узла с высокой доступностью.

 

inventory_hostname

Имя хоста frontend-части решения. Значение по умолчанию: www-<1‑2>.

state

Развертывание frontend-части решения на виртуальной машине или физическом сервере. Возможные значения:

  • enabled;
  • disabled.

ansible_host

IP-адрес виртуальной машины или физического сервера из блока nodes для развертывания frontend-части решения. Возможные значения:

  • Значение в формате XXX.XXX.XXX.XXX, например:

    192.168.110.126

  • Переменная Ansible, например:

    {{ nodes.node_1.ip }}

orc

Параметры оркестратора.

 

syslog_server_address

Веб-адрес Syslog-сервера, на который Docker-контейнеры оркестратора отправляют журналы. Вам нужно ввести значение в формате <протокол>://<IP-адрес>:<номер порта>, например:

udp://192.168.2.15:1514

Параметры Syslog-сервера можно указать в блоке syslog.

docker_memory_limit

Объем оперативной памяти в мегабайтах для Docker-контейнеров оркестратора.

JAVA_OPTS

Параметры оперативной памяти виртуальной машины Java.

 

Xms

Минимальный объем heap-памяти, который виртуальная машина Java может назначить оркестратору. Вам нужно ввести значение в одном из следующих форматов:

  • <объем памяти>m – объем памяти в мегабайтах, например:

    512m

  • <объем памяти>g – объем памяти в гигабайтах, например:

    4g

Мы рекомендуем указать для этого параметра значение, которое вдвое меньше значения параметра Xmx.

Xmx

Максимальный объем heap-памяти, который виртуальная машина Java может назначить оркестратору. Вам нужно ввести значение в одном из следующих форматов:

  • <объем памяти>m – объем памяти в мегабайтах, например:

    512m

  • <объем памяти>g – объем памяти в гигабайтах, например:

    4g

Мы рекомендуем указать для этого параметра значение, которое вдвое меньше значения параметра docker_memory_limit.

orc_<1–2>

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

 

inventory_hostname

Имя хоста оркестратора. Значение по умолчанию: orc-<1–2>.

state

Развертывание оркестратора на виртуальной машине или физическом сервере. Возможные значения:

  • enabled;
  • disabled.

ansible_host

IP-адрес виртуальной машины или физического сервера из блока nodes для развертывания оркестратора. Возможные значения:

  • Значение в формате XXX.XXX.XXX.XXX, например:

    192.168.110.126

  • Переменная Ansible, например:

    {{ nodes.node_1.ip }}

vnfm

Параметры менеджера виртуальных сетевых функций.

 

syslog_server_address

Веб-адрес Syslog-сервера, на который Docker-контейнеры менеджера виртуальных сетевых функций отправляют журналы. Вам нужно ввести значение в формате <протокол>://<IP-адрес>:<номер порта>, например:

udp://192.168.2.15:1514

Параметры Syslog-сервера можно указать в блоке syslog.

docker_memory_limit

Объем оперативной памяти в мегабайтах для Docker-контейнеров оркестратора.

JAVA_OPTS

Параметры оперативной памяти виртуальной машины Java.

 

Xms

Минимальный объем heap-памяти, который виртуальная машина Java может назначить менеджеру виртуальных сетевых функций. Вам нужно ввести значение в одном из следующих форматов:

  • <объем памяти>m – объем памяти в мегабайтах, например:

    512m

  • <объем памяти>g – объем памяти в гигабайтах, например:

    4g

Мы рекомендуем указать для этого параметра значение, которое вдвое меньше значения параметра Xmx.

Xmx

Максимальный объем heap-памяти, который виртуальная машина Java может назначить менеджеру виртуальных сетевых функций. Вам нужно ввести значение в одном из следующих форматов:

  • <объем памяти>m – объем памяти в мегабайтах, например:

    512m

  • <объем памяти>g – объем памяти в гигабайтах, например:

    4g

Мы рекомендуем указать для этого параметра значение, которое вдвое меньше значения параметра docker_memory_limit.

vnfm_<1–2>

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

 

inventory_hostname

Имя хоста менеджера виртуальных сетевых функций. Значение по умолчанию: vnfm-<1–2>.

state

Развертывание менеджера виртуальных сетевых функций на виртуальной машине или физическом сервере. Возможные значения:

  • enabled;
  • disabled.

ansible_host

IP-адрес виртуальной машины или физического сервера из блока nodes для развертывания менеджера виртуальных сетевых функций. Возможные значения:

  • Значение в формате XXX.XXX.XXX.XXX, например:

    192.168.110.126

  • Переменная Ansible, например:

    {{ nodes.node_1.ip }}

vnfm_proxy

Параметры прокси-менеджера виртуальных сетевых функций.

 

syslog_server_address

Веб-адрес Syslog-сервера, на который Docker-контейнеры прокси-менеджера виртуальных сетевых функций отправляют журналы. Вам нужно ввести значение в формате <протокол>://<IP-адрес>:<номер порта>, например:

udp://192.168.2.15:1514

Параметры Syslog-сервера можно указать в блоке syslog.

docker_memory_limit

Объем оперативной памяти в мегабайтах для Docker-контейнеров прокси-менеджера виртуальных сетевых функций.

vnfm_proxy_<1‑2>

Параметры развертывания узлов прокси-менеджера виртуальных сетевых функций. Вы можете развернуть один узел прокси-менеджера виртуальных сетевых функций без высокой доступности или два узла с высокой доступностью.

 

inventory_hostname

Имя хоста прокси-менеджера виртуальных сетевых функций. Значение по умолчанию: vnfm-proxy-<1–2>.

state

Развертывание прокси-менеджера виртуальных сетевых функций на виртуальной машине или физическом сервере. Возможные значения:

  • enabled;
  • disabled.

ansible_host

IP-адрес виртуальной машины или физического сервера из блока nodes для развертывания прокси-менеджера виртуальных сетевых функций. Возможные значения:

  • Значение в формате XXX.XXX.XXX.XXX, например:

    192.168.110.126

  • Переменная Ansible, например:

    {{ nodes.node_1.ip }}

Пример конфигурационного файла

См. также

Подготовка устройства администратора

Сценарий: развертывание экземпляра SD-WAN для тенанта
Идентификатор статьи: 273509, Последнее изменение: 22 окт. 2024 г.
В начало