Управление связями сайтов

Для управления связями сайтов (site link) с помощью утилиты samba-tool используется группа подкоманд sites inter-site-transport ip link.

Общие сведения

В службе каталогов сайты связываются между собой логическими путями, которые отражают сетевую связность между ними и задают разрешенные направления репликации. Каждый такой логический путь соответствует набору сайтов, взаимодействия между которыми характеризуются одинаковым набором параметров и происходят по однотипным сетевым соединениям. Данные пути представлены объектами связей сайтов.

Связи сайтов конфигурируют способы репликации между включенными в них сайтами. Фактически репликация происходит через соединения, которые создаются и изменяются динамически или вручную.

Для каждой связи могут быть настроены следующие параметры, влияющие на топологию репликации и процесс репликации:

относительная стоимость связи — чем она ниже, тем выше вероятность того, что данная связь будет использована для создания репликационного соединения;
интервал репликации — интервал опроса серверов с ролью bridgehead в других сайтах о наличии изменений;
расписание репликации — определяет временные промежутки, когда репликация может иметь место;

Данный параметр учитывается и обрабатывается Эллес, но не может быть отредактирован с помощью samba-tool.
опции, влияющие на определение момента репликации (по уведомлению, по интервалу, инициирование обратной репликации).

Получение списка связей сайтов

Формат вызова:

samba-tool sites inter-site-transport ip link list [options]

Подкоманда поддерживает два формата представления информации о связях сайтов:

без дополнительных параметров — простой список общих имен (CN) связей сайтов;
с параметром --json — вывод набора атрибутов для каждого объекта связи сайтов в формате JSON.

Параметры

Параметры вызова:

-H URL|--URL=URL — URL сервера LDAP; может содержать указание на протокол, имя хоста и номер порта;
--json — выводить набор атрибутов для каждого объекта связи сайтов в формате JSON.

Примеры

Пример получения списка связей сайтов в домене:

samba-tool sites inter-site-transport ip link list
DEFAULTIPSITELINK
SiteLink1
SiteLink2
SiteLink3

Получения информации о связи сайтов

Формат вызова:

samba-tool sites inter-site-transport ip link view <link> [options]

В качестве аргумента (link) ожидается общее имя (CN) связи сайтов.

Подкоманда выводит тот же набор атрибутов объекта связи сайтов, что и подкоманда samba-tool sites inter-site-transport ip link list --json.

Значение атрибута options соответствует набору опций, которые включены для данной связи:

Значение Набор опций

Значение	Набор опций
`0x1`	`USE_NOTIFY`
`0x2`	`TWOWAY_SYNC`
`0x3`	`USE_NOTIFY \| TWOWAY_SYNC`
`0x4`	`DISABLE_COMPRESSION`
`0x5`	`USE_NOTIFY \| DISABLE_COMPRESSION`
`0x6`	`TWOWAY_SYNC \| DISABLE_COMPRESSION`
`0x7`	`USE_NOTIFY \| TWOWAY_SYNC \| DISABLE_COMPRESSION`

0x1

USE_NOTIFY

0x2

TWOWAY_SYNC

0x3

USE_NOTIFY | TWOWAY_SYNC

0x4

DISABLE_COMPRESSION

0x5

USE_NOTIFY | DISABLE_COMPRESSION

0x6

TWOWAY_SYNC | DISABLE_COMPRESSION

0x7

USE_NOTIFY | TWOWAY_SYNC | DISABLE_COMPRESSION

В текущей версии Эллес обработка флагов TWOWAY_SYNC и DISABLE_COMPRESSION не реализована.

Параметры

Параметры вызова:

-H URL|--URL=URL — URL сервера LDAP; может содержать указание на протокол, имя хоста и номер порта.

Примеры

Пример получения набора атрибутов объекта связи сайтов:

samba-tool sites inter-site-transport ip link view SiteLink1
{
  "cn": "SiteLink1",
  "cost": 200,
  "distinguishedName": "CN=SiteLink1,CN=IP,CN=Inter-Site Transports,CN=Sites,CN=Configuration,DC=elles,DC=inno,DC=tech",
  "dn": "CN=SiteLink1,CN=IP,CN=Inter-Site Transports,CN=Sites,CN=Configuration,DC=elles,DC=inno,DC=tech",
  "instanceType": 4,
  "name": "SiteLink1",
  "objectCategory": "CN=Site-Link,CN=Schema,CN=Configuration,DC=elles,DC=inno,DC=tech",
  "objectClass": [
    "top",
    "siteLink"
  ],
  "objectGUID": "c62d112b-0d2a-46ed-8384-c2b72fb73f1c",
  "options": 7,
  "replInterval": 90,
  "siteList": [
    "CN=Default-First-Site-Name,CN=Sites,CN=Configuration,DC=elles,DC=inno,DC=tech",
    "CN=Site1,CN=Sites,CN=Configuration,DC=elles,DC=inno,DC=tech"
  ],
  "systemFlags": 1073741824
}

Создание связи сайтов

Формат вызова:

samba-tool sites inter-site-transport ip link create <link> <site-of-link> <site-of-link> [...] [options]

Подкоманда принимает следующие аргументы:

общее имя (CN) для новой связи между сайтами (link);
общие имена (CN) не менее чем двух сайтов для включения в связь (site-of-link).

Параметры

Параметры вызова:

-H URL|--URL=URL — URL сервера LDAP; может содержать указание на протокол, имя хоста и номер порта;
--cost — относительная стоимость связи между сайтами (значение по умолчанию — 100);

Чем ниже стоимость, тем выше приоритет связи при использовании в процессе репликации.
--repl-interval — интервал репликации в минутах (значение по умолчанию — 180);

Указанный интервал определяет периодичность, с которой сервер с ролью bridgehead в сайте опрашивает серверы с той же ролью в других сайтах, включенных в связь, о наличии реплицируемых изменений.
--use-notify — включение репликации по уведомлению (значение по умолчанию — False);

Значение флага USE_NOTIFY в атрибуте options объекта siteLink.
--twoway-sync — включение репликации в обратном направлении (значение по умолчанию — False);

Значение флага TWOWAY_SYNC в атрибуте options объекта siteLink.

В текущей версии Эллес обработка флага не реализована.
--disable-compression — выключение сжатия данных при репликации между сайтами (значение по умолчанию — False).

Значение флага DISABLE_COMPRESSION в атрибуте options объекта siteLink.

В текущей версии Эллес обработка флага не реализована.

Примеры

Пример создания связи между сайтами:

samba-tool sites inter-site-transport ip link create SiteLink1 Site1 Site2 \
   --cost=50 \
   --repl-interval=90 \
   --use-notify
Link SiteLink1 created!

Изменение связи сайтов

Формат вызова:

samba-tool sites inter-site-transport ip link modify <link> [options]

В качестве аргумента (link) ожидается общее имя (CN) существующей связи между сайтами.

Параметры

Параметры вызова:

-H URL|--URL=URL — URL сервера LDAP; может содержать указание на протокол, имя хоста и номер порта;
--cost — относительная стоимость связи между сайтами;

Чем ниже стоимость, тем выше приоритет связи при использовании в процессе репликации.
--repl-interval — интервал репликации в минутах;

Указанный интервал определяет периодичность, с которой сервер с ролью bridgehead в сайте опрашивает серверы с той же ролью в других сайтах, включенных в связь, о наличии реплицируемых изменений.
управление флагом USE_NOTIFY в атрибуте options объекта siteLink:
- --use-notify — включение репликации по уведомлению;
- --no-use-notify — выключение репликации по уведомлению;
управление флагом TWOWAY_SYNC в атрибуте options объекта siteLink:
- --twoway-sync — включение репликации в обратном направлении;
- --no-twoway-sync — выключение репликации в обратном направлении;
управление флагом DISABLE_COMPRESSION в атрибуте options объекта siteLink:
- --disable-compression — выключение сжатия данных при репликации между сайтами;
- --no-disable-compression — включение сжатия данных при репликации между сайтами.

Примеры

Пример изменения атрибутов связи между сайтами:

samba-tool sites inter-site-transport ip link modify SiteLink1 \
   --cost=150
Link SiteLink1 modified!

Изменение имени связи сайтов

Формат вызова:

samba-tool sites inter-site-transport ip link rename <link> <new-link> [options]

Подкоманда принимает следующие аргументы:

изменяемое общее имя (CN) связи между сайтами (link);
новое общее имя (CN) для связи (new-link).

Параметры

Параметры вызова:

-H URL|--URL=URL — URL сервера LDAP; может содержать указание на протокол, имя хоста и номер порта.

Примеры

Пример изменения имени связи между сайтами:

samba-tool sites inter-site-transport ip link rename SiteLink1 NewSiteLink1
Link SiteLink1 renamed!

Добавление сайтов в связь

Формат вызова:

samba-tool sites inter-site-transport ip link add-site <link> <site-of-link> [...] [options]

Подкоманда принимает следующие аргументы:

общее имя (CN) связи между сайтами, в которую требуется добавить новые сайты (link);
одно или несколько общих имен (CN) сайтов для добавления в связь (site-of-link).

Параметры

Параметры вызова:

-H URL|--URL=URL — URL сервера LDAP; может содержать указание на протокол, имя хоста и номер порта.

Примеры

Пример добавления сайта в связь:

samba-tool sites inter-site-transport ip link add-site SiteLink1 Site3
Sites to link SiteLink1 added!

Удаление сайтов из связи

Формат вызова:

samba-tool sites inter-site-transport ip link remove-site <link> <site-of-link> [...] [options]

Подкоманда принимает следующие аргументы:

общее имя (CN) связи между сайтами, из которой требуется удалить сайты (link);
одно или несколько общих имен (CN) сайтов для удаления из связи (site-of-link).

Параметры

Параметры вызова:

-H URL|--URL=URL — URL сервера LDAP; может содержать указание на протокол, имя хоста и номер порта.

Примеры

Пример удаления сайтов из связи:

samba-tool sites inter-site-transport ip link site-remove SiteLink1 Site3
Sites from link SiteLink1 deleted!

Удаление связи сайтов

Формат вызова:

samba-tool sites inter-site-transport ip link remove <link> [options]

В качестве аргумента (link) ожидается общее имя (CN) существующей связи между сайтами.

Параметры

Параметры вызова:

-H URL|--URL=URL — URL сервера LDAP; может содержать указание на протокол, имя хоста и номер порта.

Примеры

Пример удаления связи между сайтами:

samba-tool sites inter-site-transport ip link remove SiteLink1
Link SiteLink1 removed!