Управление пользовательскими разделами каталога (custom application directory partitions)

Группа подкоманд samba-tool dns позволяет создавать и удалять пользовательские разделы каталога, просматривать список таких разделов на контроллере домена, получать подробную информацию об отдельном разделе, а также управлять областью репликации пользовательского раздела.

При выполнении операций с пользовательскими разделами каталога должны использоваться учетные данные пользователя, включенного в группу Enterprise Admins.

См. краткое описание функциональности и пример настройки пользовательского раздела для зоны DNS в «Настройка пользовательских разделов каталога».

Предварительные требования

Для корректного создания пользовательских разделов каталога с аутентификацией через Kerberos (по умолчанию команды samba-tool выполняются с опцией --use-kerberos=required) требуется билет с разрешением на перенаправление, то есть с установленным флагом forwardable.

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

  • добавить в локальную конфигурацию клиента Kerberos (файл /etc/krb5.conf) параметр:

    [libdefaults]
        ...
        forwardable = true
        ...

  • указать ключ -f при вызове kinit:

    kinit -f

Для проверки наличия у билета флага forwardable выполните:

klist -vf

Строка Ticket flags в выводе должна содержать forwardable:

...
Ticket flags: enc-pa-rep, pre-authent, initial, forwardable
...

Создание пользовательского раздела каталога

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

samba-tool dns createdirectorypartition <nc_fqdn> [server] [options]

Подкоманда создает пользовательский раздел каталога с именем, переданным в качестве первого аргумента, на локальном контроллере домена или указанном контроллере домена, если его имя или IP-адрес переданы в качестве второго аргумента.

По умолчанию созданный раздел существует только на том контроллере домена, для которого выполнялась операция, и не реплицируется на другие контроллеры домена в лесу. Чтобы репликация выполнялась на другой контроллер домена, он должен быть включен в область репликации раздела с помощью подкоманды samba-tool dns enlistdirectorypartition.

При создании нового пользовательского раздела на контроллере домена «Эллес», использующего в качестве DNS-сервера BIND 9, дополнительно выполняются: остановка сервиса bind9, обновление данных DNS и запуск сервиса bind9.

Параметры

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

  • <nc_fqdn> — имя для создаваемого пользовательского раздела каталога;

    В качестве имени может использоваться произвольное имя в формате FQDN, которое может не являться логическим поддеревом домена.

  • [server] — IP-адрес, имя хоста или доменное имя сервера контроллера домена.

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

Примеры

Пример создания пользовательского раздела каталога на локальном контроллере домена:

samba-tool dns createdirectorypartition custompartition1.elles.inno.tech
Partition has been created successfully

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

samba-tool dns createdirectorypartition custompartition2.elles.inno.tech dc1.elles.inno.tech
Partition has been created successfully

Получение списка пользовательских разделов каталога

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

samba-tool dns enumdirectorypartitions [server] [options]

Подкоманда возвращает список пользовательских разделов на локальном контроллере домена или указанном контроллере домена, если его имя или IP-адрес переданы в качестве первого аргумента.

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

  • Enlisted — данные раздела реплицируются на контроллер домена;

  • Not-Enlisted — данные раздела не реплицируются на контроллер домена.

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

  • Auto — раздел создан автоматически системой (например, DomainDnsZones);

  • Forest — раздел реплицируется по лесу;

  • Domain — раздел реплицируется по домену;

  • Legacy — раздел создан в старом формате.

Параметры

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

  • [server] — IP-адрес, имя хоста или доменное имя сервера контроллера домена.

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

Примеры

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

samba-tool dns enumdirectorypartitions
Enumerated directory partition list:

	    Directory partition count = 5
 custompartition1.elles.inno.tech       Enlisted
 custompartition2.elles.inno.tech       Enlisted
 DomainDnsZones.elles.inno.tech         Enlisted Auto Domain
 ForestDnsZones.elles.inno.tech         Enlisted Auto Forest
 elles.inno.tech                        Enlisted Legacy

Получение информации о пользовательском разделе каталога

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

samba-tool dns directorypartitioninfo <nc_fqdn> [server] [options]

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

Информация включает атрибуты:

  • DNS Root — самый верхний уровень доменного DNS-имени раздела;

  • Flags — флаги, управляющие поведением раздела; примеры значений:

    • Enlisted — раздел включен в область репликации контроллера домена;

    • Not-Enlisted — раздел не включен в область репликации контроллера домена;

    • Auto — раздел создан автоматически системой;

    • Forest — раздел реплицируется по лесу;

    • Domain — раздел реплицируется по домену;

    • Legacy — раздел создан в старом формате;

  • State — текущее состояние раздела (значение 0 указывает, что раздел активен);

  • Zone count — количество зон DNS, связанных с разделом;

  • DP head — «головной» DN раздела в структуре каталога;

  • Crossref — ссылка на объект crossRef в контейнере CN=Partitions,CN=Configuration с метаданными раздела;

  • Replicas — количество контроллеров домена, на которые реплицируется раздел, и их DN.

Параметры

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

  • <nc_fqdn> — имя пользовательского раздела каталога;

  • [server] — IP-адрес, имя хоста или доменное имя сервера контроллера домена.

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

Примеры

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

samba-tool dns directorypartitioninfo custompartition2.elles.inno.tech
Directory partition info:

  DNS Root:   custompartition2.elles.inno.tech
  Flags:      0x10 Enlisted
  State:      0
  Zone count: 1
  DP head:    DC=custompartition2,DC=elles,DC=inno,DC=tech
  Crossref:   CN=46ed6e00-f9cd-4709-b99f-e695cd1705b8,CN=Partitions,CN=Configuration,DC=elles,DC=inno,DC=tech
  Replicas:   2
    CN=NTDS Settings,CN=DC2,CN=Servers,CN=Default-First-Site-Name,CN=Sites,CN=Configuration,DC=elles,DC=inno,DC=tech
    CN=NTDS Settings,CN=DC1,CN=Servers,CN=Default-First-Site-Name,CN=Sites,CN=Configuration,DC=elles,DC=inno,DC=tech

Command completed successfully.

Включение контроллера домена в область репликации пользовательского раздела каталога

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

samba-tool dns enlistdirectorypartition <nc_fqdn> [server] [options]

Подкоманда добавляет локальный контроллер домена или указанный контроллер домена, если его имя или IP-адрес переданы в качестве второго аргумента, в состав источников данных для репликации данных пользовательского раздела с именем, переданным в качестве первого аргумента.

Параметры

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

  • <nc_fqdn> — имя пользовательского раздела каталога;

  • [server] — IP-адрес, имя хоста или доменное имя сервера контроллера домена.

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

Примеры

Пример включения контроллера домена в область репликации пользовательского раздела каталога:

samba-tool dns enlistdirectorypartition custompartition1.elles.inno.tech dc1.elles.inno.tech
Partition has been enlisted successfully

Исключение контроллера домена из области репликации пользовательского раздела каталога

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

samba-tool dns unenlistdirectorypartition <nc_fqdn> [server] [options]

Подкоманда удаляет локальный контроллер домена или указанный контроллер домена, если его имя или IP-адрес переданы в качестве второго аргумента, из состава источников данных для репликации данных пользовательского раздела с именем, переданным в качестве первого аргумента.

Параметры

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

  • <nc_fqdn> — имя пользовательского раздела каталога;

  • [server] — IP-адрес, имя хоста или доменное имя сервера контроллера домена.

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

Примеры

Пример исключения контроллера домена из области репликации пользовательского раздела каталога:

samba-tool dns unenlistdirectorypartition custompartition1.elles.inno.tech dc1.elles.inno.tech
Partition has been unenlisted successfully

Удаление пользовательского раздела каталога

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

samba-tool dns deletedirectorypartition <nc_fqdn> [server] [options]

Параметры

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

  • <nc_fqdn> — имя пользовательского раздела каталога;

  • [server] — IP-адрес, имя хоста или доменное имя сервера контроллера домена.

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

Примеры

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

samba-tool dns deletedirectorypartition custompartition1.elles.inno.tech dc1.elles.inno.tech
Partition has been deleted successfully

Обновлено: