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

Для управления пространствами имен с помощью утилиты samba-tool используется группа подкоманд dfsn root.

См. описание последовательности настройки пространства имен в разделе «Настройка DFSN».

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

Пространство имен — логическое представление ресурсов общего доступа, расположенных на разных файловых серверах. Клиенты обращаются к ресурсам не напрямую по именам файловых серверов и папок на них, а через логические пути, которые указывают на объекты внутри пространства имен. При обращении к ресурсу по такому пути выполняется разрешение имени: логический путь преобразуется в фактический путь к общей папке на конкретном файловом сервере.

По типу пространства имен делятся на автономные и доменные: автономное пространство хранит метаданные, описывающие его структуру, локально на одном сервере; доменное — в службе каталогов.

Пространство имен формируется как иерархия объектов:

  1. Корень пространства имен — точка входа для клиентов, доступная по UNC-имени вида \\<FQDN ресурсного домена или сервера>\<пространство имен>.

  2. Папки — логические папки внутри пространства имен, которые связывают корень с фактическими общими папками. Каждая папка указывает на одну или несколько целевых папок.

  3. Целевые папки — фактические общие папки на файловых серверах. При обращении к папке обслуживающий пространство имен сервер возвращает список доступных целевых папок, из которого выбирается оптимальная с учетом топологии сети, приоритетов и других факторов (в соответствии с заданными настройками).

По умолчанию работа ведется с доменными пространствами имен в режиме Windows Server 2008.

Ограничения

Корневой общий ресурс (root target share) используется исключительно для хранения служебных метаданных.

Корневой каталог пространства имен (например, \\elles.inno.tech\dfsroot) является системным контейнером и не предназначен для хранения пользовательских данных.

Текущая реализация не обеспечивает сохранность файлов, размещенных непосредственно в корне пространства имен. При изменении конфигурации DFSN (добавление/удаление папок, изменение структуры) или при перезапуске сервиса inno-samba содержимое корневого каталога может быть полностью перезаписано или очищено.

Пример недопустимой структуры:

\\elles.inno.tech\dfsroot\
  ├── file1.txt (запрещено!)
  └── file2.txt (запрещено!)

Размещение пользовательских файлов в корне пространства имен приводит к их безвозвратной потере и рассматривается как нарушение модели эксплуатации DFSN в реализации Эллес.

Создание пространства имен

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

samba-tool dfsn root create <dfs_path> <target_path> [options]

В качестве обязательных аргументов ожидаются:

  • путь к корню создаваемого пространства имен в формате UNC-имени (например, \\elles.inno.tech\namespace1);

  • путь к целевому каталогу на сервере, который будет обслуживать пространство имен, в формате UNC-имени (например, \\dc01.elles.inno.tech\dfsroot).

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

  • необходимость учета сайта клиента при выдаче ему списков перенаправления на ресурсы общего доступа;

  • необходимость учета стоимости межсайтовых связей при выдаче клиенту списков перенаправления на ресурсы общего доступа в других сайтах;

  • видимость пользователям ресурсов общего доступа, доступ к которым им не разрешен;

  • возможность обращения к ближайшему контроллеру домена вместо контроллера домена с FSMO-ролью PDC Emulator при получении серверами пространства имен метаданных (управление режимом масштабируемости);

  • необходимость возвращения клиента к предпочтительному перенаправлению после периода временной недоступности;

  • состояние пространства имен и сервера пространства имен, на котором оно создается при вызове подкоманды;

  • период хранения в кэше клиентов списков перенаправления на ресурсы общего доступа;

  • класс и ранг приоритет сервера, на котором создается пространство имен, при формировании списка перенаправления;

  • список учетных записей и групп, которым выдаются разрешения на администрирование пространства имен.

Подкоманда создает доменное пространство имен в режиме Windows Server 2008 с переданными дополнительными настройками.

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

Параметры

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

  • --server=DFSSERVERHOST — имя хоста (NetBIOS-имя) или полное доменное имя (FQDN) сервера пространства имен, используя соединение с которым будет выполнено изменение или запрошена информация;

    Этот параметр предназначен для использования только в исключительных случаях, когда необходимо явно указать сервер пространства имен (например, при нештатных ситуациях или тестировании). Задавать его при штатной эксплуатации не требуется.
  • --comment=DESCRIPTION — произвольное текстовое описание пространства имен;

  • --enable-access-based-enumeration=Yes|No — управление механизмом отображения папок пространства имен на основе разрешений (Access-Based Enumeration);

    Возможные значения:

    • No (по умолчанию) — все пользователи видят все папки пространства имен;

    • Yes — пользователи видят папки на основании сконфигурированных прав (после выдачи соответствующих разрешений).

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

    В выводе подкоманд для обозначения флага может использоваться сокращение ABDE.
  • --enable-insite-referrals=True|False — управление доступом клиентов к целевым ресурсам в других сайтах;

    Возможные значения:

    • False (по умолчанию) — клиентам сначала возвращаются целевые ресурсы в том сайте, в котором они находятся, а затем — в других сайтах;

    • True — клиентам возвращаются целевые ресурсы только в том же сайте, в котором они сами находятся.

  • --enable-root-scalability=True|False — управление режимом масштабируемости корня пространства имен;

    Параметр определяет, как серверы пространства имен получают обновления конфигурации корня: через ближайшие контроллеры домена или через контроллер домена с FSMO-ролью PDC Emulator.

    Возможные значения:

    • False (по умолчанию) — режим масштабируемости выключен:

      • изменение в конфигурации корня пространства имен отправляется на контроллер домена с FSMO-ролью PDC Emulator;

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

      • серверы пространства имен запрашивают изменения у контроллера домена с FSMO-ролью PDC Emulator и сохраняют их в кэш метаданных; если сервер не может получить уведомление об изменении, то он получает изменение при очередном опросе контроллера домена с FSMO-ролью PDC Emulator (опрос выполняется периодически с интервалом, установленным конфигурационным параметром smbd:mc_refresh_interval_s; по умолчанию интервал составляет 1 час);

    • True — режим масштабируемости включен:

      • изменение в конфигурации корня пространства имен отправляется на контроллер домена с FSMO-ролью PDC Emulator;

      • сервер пространства имен получает изменение от ближайшего контроллера домена по репликации; при этом:

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

        • сервер пространства имен не опрашивает контроллер домена с FSMO-ролью PDC Emulator на периодической основе.

  • --enable-site-costing=True|False — управление учетом топологии и стоимости межсайтовых связей при формировании списка перенаправления, возвращаемого в ответе клиенту;

    Возможные значения:

    • False (по умолчанию) — стоимость межсайтовых связей не учитывается, выбор осуществляется только на основе принадлежности к сайту и стандартной логики;

      Целевые ресурсы возвращаются в следующем порядке:

      1. Целевые ресурсы в том же сайте, в котором находится клиент, в случайном порядке.

      2. Прочие целевые ресурсы в случайном порядке.

    • True — сервер пространства имен сортирует целевые пути с учетом стоимости маршрута между сайтом, в котором находится клиент, и сайтом, в котором находится целевой ресурс.

      Целевые ресурсы возвращаются в следующем порядке:

      1. Целевые ресурсы в том же сайте, в котором находится клиент, в случайном порядке.

      2. Целевые ресурсы, информация о сайтах которых доступна серверу: сначала идут целевые ресурсы в сайте с наименьшей стоимостью соединения в случайном порядке; затем — целевые ресурсы в следующем по стоимости сайте в случайном порядке и т. д.

      3. Целевые ресурсы, для которых у сервера отсутствует информация о принадлежности к тому или иному сайту, в случайном порядке.

  • --enable-target-failback=True|False — управление автоматическим восстановлением подключения к приоритетному целевому ресурсу;

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

    Возможные значения:

    • False (по умолчанию) — клиент продолжает использовать текущий целевой ресурс до обновления локального кэша или до повторного разрешения пространства имен, даже если более предпочтительный ресурс уже доступен;

    • True — после переключения на менее предпочтительный целевой ресурс (например, из-за недоступности основного) клиент автоматически возвращается к более приоритетному ресурсу, когда тот снова становится доступен.

  • --grant-admin-accounts=User1,UserN — список учетных записей пользователей и групп (через запятую без пробелов), которым будет разрешено создавать, изменять и удалять папки и целевые папки в рамках пространства имен;

  • --referral-priority-class=CLASS — класс приоритета для целевого ресурса;

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

    Возможные значения:

    • GlobalHigh — наивысший приоритет среди всех целевых ресурсов вне зависимости от принадлежности к сайту;

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

    • SiteCostNormal (по умолчанию) — стандартный приоритет среди целевых ресурсов с одной стоимостью связи между сайтом клиента и сайтом целевого ресурса;

    • SiteCostLow — пониженный приоритет среди целевых ресурсов с одной стоимостью связи между сайтом клиента и сайтом целевого ресурса;

    • GlobalLow — наименьший приоритет среди всех целевых ресурсов вне зависимости от принадлежности к сайту.

  • --referral-priority-rank=RANK — числовой ранг в рамках класса приоритета;

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

    Допустимый диапазон значений — от 0 (по умолчанию) до 31. Чем меньше число, тем выше ранг приоритета; нулевое значение соответствует наивысшему рангу приоритета.

  • --target-state=STATE — состояние целевого ресурса;

    Параметр определяет состояние целевого ресурса и управляет его видимостью для клиентов. Состояние может использоваться для временного исключения целевого ресурса из списка перенаправления без фактического его удаления.

    Возможные значения:

    • Online (по умолчанию) — целевой ресурс доступен и участвует в формировании списка перенаправления;

    • Offline — целевой ресурс исключается из списка перенаправления, но остается в конфигурации DFSN.

  • --ttl=TIMETOLIVE — время хранения в кэше на клиенте списка перенаправления в секундах (значение по умолчанию — 300).

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

    1. Сохраняет его в локальном кэше.

    2. Использует этот список для доступа к ресурсам, не запрашивая обновления.

    3. По истечении значения параметра --ttl выполняет новое разрешение пути к ресурсу и получает актуальный список перенаправления.

Примеры

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

samba-tool dfsn root create "\\\\elles.inno.tech\\namespace1" "\\\\dc01.elles.inno.tech\\dfsroot" \
    --comment="Domain-based DFS namespace" \
    --enable-site-costing=true
Create DFS namespace:
DFS path:                 \\elles.inno.tech\namespace1
Target path:              \\dc01.elles.inno.tech\dfsroot
Site costing:             true
Insite referrals:         false
Access based enumeration: false
Root scalability:         false
Target failback:          false
Time-to-live (sec):       300
Comment:                  Domain-based DFS namespace
Target state:             2 (Online)
Referral priority class:  2 (SITE_COST_HIGH)
Referral priority rank:   0
...
Result: SUCCESS

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

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

samba-tool dfsn root get <dfs_path> [options]

В качестве аргумента ожидается путь к корню пространства имен в формате UNC-имени.

Если подкоманда вызывается только с указанием имени домена (без конкретного пространства имен), она возвращает список всех доступных пространств имен.

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

  • путь к корню пространства имен;

  • режим работы пространства имен:

    • Domain v2 — пространство имен работает в режиме Windows Server 2008;

    • Domain v1 — пространство имен работает в режиме Windows Server 2000;

  • список флагов, установленных в конфигурации пространства имен:

    • ABDE — установлен флаг, включающий механизм отображения папок пространства имен на основе разрешений (Access-Based Enumeration);

    • Cluster enabled (только для автономных пространств имен) — установлен флаг, указывающий на то, что пространство имен развернуто в кластере серверов;

    • Insite referrals — установлен флаг, указывающий на необходимость возвращать клиенту целевые ресурсы только в том же сайте, в котором он находится;

    • Root scalability — установлен флаг, указывающий на то, что включен режим масштабируемости и сервер получает изменения в метаданных пространства имен от ближайших контроллеров домена;

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

    • Target failback — установлен флаг, включающий автоматическое восстановление подключения к приоритетному целевому ресурсу;

  • время хранения в кэше на клиенте списка перенаправления в секундах;

  • состояние:

    • Online — целевой ресурс доступен и участвует в формировании списка перенаправления;

    • Offline — целевой ресурс исключается из списка перенаправления, но остается в конфигурации DFSN;

  • описание.

Параметры

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

  • --server=DFSSERVERHOST — имя хоста (NetBIOS-имя) или полное доменное имя (FQDN) сервера пространства имен, используя соединение с которым будет выполнено изменение или запрошена информация.

    Этот параметр предназначен для использования только в исключительных случаях, когда необходимо явно указать сервер пространства имен (например, при нештатных ситуациях или тестировании). Задавать его при штатной эксплуатации не требуется.

Примеры

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

samba-tool dfsn root get "\\\\elles.inno.tech"
Gets settings for DFS namespaces:
DFS path: \\\\elles.inno.tech
...
Result:
\\elles.inno.tech\namespace1:
   Type:               Domain v2
   Properties:         Site costing
   Time-to-live (sec): 300
   State:              2 (Online)
   Description:        DFS Namespace

\\elles.inno.tech\namespace2:
   Type:               Domain v2
   Properties:         Site costing
   Time-to-live (sec): 600
   State:              2 (Online)
   Description:        Another DFS Namespace

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

samba-tool dfsn root get "\\\\elles.inno.tech\\namespace1"
Gets settings for DFS namespaces:
DFS path: \\elles.inno.tech\namespace1
...
Result:
   Type:               Domain v2
   Properties:         Site costing
   Time-to-live (sec): 300
   State:              2 (Online)
   Description:        DFS Namespace

Изменение настроек пространства имен

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

samba-tool dfsn root set <dfs_path> [options]

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

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

Параметры

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

  • --server=DFSSERVERHOST — имя хоста (NetBIOS-имя) или полное доменное имя (FQDN) сервера пространства имен, используя соединение с которым будет выполнено изменение или запрошена информация;

    Этот параметр предназначен для использования только в исключительных случаях, когда необходимо явно указать сервер пространства имен (например, при нештатных ситуациях или тестировании). Задавать его при штатной эксплуатации не требуется.
  • --comment=DESCRIPTION — произвольное текстовое описание пространства имен;

  • --enable-access-based-enumeration=Yes|No — управление механизмом отображения папок пространства имен на основе разрешений (Access-Based Enumeration);

    Возможные значения:

    • No (по умолчанию) — все пользователи видят все папки пространства имен;

    • Yes — пользователи видят папки на основании сконфигурированных прав (после выдачи соответствующих разрешений).

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

    В выводе подкоманд для обозначения флага может использоваться сокращение ABDE.
  • --enable-insite-referrals=True|False — управление доступом клиентов к целевым ресурсам в других сайтах;

    Возможные значения:

    • False (по умолчанию) — клиентам сначала возвращаются целевые ресурсы в том сайте, в котором они находятся, а затем — в других сайтах;

    • True — клиентам возвращаются целевые ресурсы только в том же сайте, в котором они сами находятся.

  • --enable-root-scalability=True|False — управление режимом масштабируемости корня пространства имен;

    Параметр определяет, как серверы пространства имен получают обновления конфигурации корня: через ближайшие контроллеры домена или через контроллер домена с FSMO-ролью PDC Emulator.

    Возможные значения:

    • False (по умолчанию) — режим масштабируемости выключен:

      • изменение в конфигурации корня пространства имен отправляется на контроллер домена с FSMO-ролью PDC Emulator;

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

      • серверы пространства имен запрашивают изменения у контроллера домена с FSMO-ролью PDC Emulator и сохраняют их в кэш метаданных; если сервер не может получить уведомление об изменении, то он получает изменение при очередном опросе контроллера домена с FSMO-ролью PDC Emulator (опрос выполняется периодически с интервалом, установленным конфигурационным параметром smbd:mc_refresh_interval_s; по умолчанию интервал составляет 1 час);

    • True — режим масштабируемости включен:

      • изменение в конфигурации корня пространства имен отправляется на контроллер домена с FSMO-ролью PDC Emulator;

      • сервер пространства имен получает изменение от ближайшего контроллера домена по репликации; при этом:

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

        • сервер пространства имен не опрашивает контроллер домена с FSMO-ролью PDC Emulator на периодической основе.

  • --enable-site-costing=True|False — управление учетом топологии и стоимости межсайтовых связей при формировании списка перенаправления, возвращаемого в ответе клиенту;

    Возможные значения:

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

      Целевые ресурсы возвращаются в следующем порядке:

      1. Целевые ресурсы в том же сайте, в котором находится клиент, в случайном порядке.

      2. Прочие целевые ресурсы в случайном порядке.

    • True — сервер пространства имен сортирует целевые пути с учетом стоимости маршрута между сайтом, в котором находится клиент, и сайтом, в котором находится целевой ресурс.

      Целевые ресурсы возвращаются в следующем порядке:

      1. Целевые ресурсы в том же сайте, в котором находится клиент, в случайном порядке.

      2. Целевые ресурсы, информация о сайтах которых доступна серверу: сначала идут целевые ресурсы в сайте с наименьшей стоимостью соединения в случайном порядке; затем — целевые ресурсы в следующем по стоимости сайте в случайном порядке и т. д.

      3. Целевые ресурсы, для которых у сервера отсутствует информация о принадлежности к тому или иному сайту, в случайном порядке.

  • --enable-target-failback=True|False — управление автоматическим восстановлением подключения к приоритетному целевому ресурсу;

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

    Возможные значения:

    • False (по умолчанию) — клиент продолжает использовать текущий целевой ресурс до обновления локального кэша или до повторного разрешения пространства имен, даже если более предпочтительный ресурс уже доступен;

    • True — после переключения на менее предпочтительный целевой ресурс (например, из-за недоступности основного) клиент автоматически возвращается к более приоритетному ресурсу, когда тот снова становится доступен.

  • --grant-admin-accounts=User1,UserN — список учетных записей пользователей и групп (через запятую без пробелов), которым разрешено создавать, изменять и удалять папки и целевые папки в рамках пространства имен;

  • --revoke-admin-accounts=User1,UserN — список учетных записей пользователей и групп (через запятую без пробелов), у которых необходимо отозвать разрешения на создание, изменение и удаление папок и целевых папок в рамках пространства имен;

  • --ttl=TIMETOLIVE — время хранения в кэше на клиенте списка перенаправления в секундах (значение по умолчанию — 300).

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

    1. Сохраняет его в локальном кэше.

    2. Использует этот список для доступа к ресурсам, не запрашивая обновления.

    3. По истечении значения параметра --ttl выполняет новое разрешение пути к ресурсу и получает актуальный список перенаправления.

Примеры

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

samba-tool dfsn root set "\\\\elles.inno.tech\\namespace1" \
    --comment="Updated DFS namespace"
    --enable-site-costing=False \
    --ttl=900
Set DFS namespace settings:
DFS path: \\elles.inno.tech\namespace1
Site costing:             false
Time-to-live (sec):       900
Comment:                  Updated DFS Namespace
...
Result: SUCCESS

Удаление пространства имен

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

samba-tool dfsn root remove <dfs_path> [options]

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

Подкоманда удаляет пространство имен со всеми его метаданными. Общие папки и файлы на файловых серверах не удаляются.

Если при вызове передается дополнительный параметр --force, операция выполняется без подтверждения.

Параметры

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

  • --server=DFSSERVERHOST — имя хоста (NetBIOS-имя) или полное доменное имя (FQDN) сервера пространства имен, используя соединение с которым будет выполнено изменение или запрошена информация;

    Этот параметр предназначен для использования только в исключительных случаях, когда необходимо явно указать сервер пространства имен (например, при нештатных ситуациях или тестировании). Задавать его при штатной эксплуатации не требуется.
  • --force — не запрашивать подтверждение операции.

Примеры

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

samba-tool dfsn root remove "\\\\elles.inno.tech\\namespace1"
Are you sure you want to perform this action?
Performing operation "Delete DFS Namespace root" [Y/n]: y
Remove DFS namespace:
DFS path: \\elles.inno.tech\namespace1
...
Result: SUCCESS

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

samba-tool dfsn root remove "\\\\elles.inno.tech\\namespace1" \
    --force
Remove DFS namespace:
DFS path: \\elles.inno.tech\namespace1
...
Result: SUCCESS

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

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

samba-tool dfsn root list [options]

По умолчанию при вызове без аргументов подкоманда возвращает список всех пространств имен в текущем домене (определяется по конфигурации сервера, на котором выполняется подкоманда).

Также подкоманда позволяет получить список пространств имен, размещающихся:

  • в указанном домене (при использовании параметра --domain);

  • на указанном сервере (при использовании параметра --computer).

По умолчанию подкоманда возвращает только список пространств имен. Также доступно получение расширенного набора информации (при использовании параметра --extended), включая:

  • режим работы пространства имен:

    • Domain v2 — пространство имен работает в режиме Windows Server 2008;

    • Domain v1 — пространство имен работает в режиме Windows Server 2000;

  • список флагов, установленных в конфигурации пространства имен:

    • ABDE — установлен флаг, включающий механизм отображения папок пространства имен на основе разрешений (Access-Based Enumeration);

    • Cluster enabled (только для автономных пространств имен) — установлен флаг, указывающий на то, что пространство имен развернуто в кластере серверов;

    • Insite referrals — установлен флаг, указывающий на необходимость возвращать клиенту целевые ресурсы только в том же сайте, в котором он находится;

    • Root scalability — установлен флаг, указывающий на то, что включен режим масштабируемости и сервер получает изменения в метаданных пространства имен от ближайших контроллеров домена;

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

    • Target failback — установлен флаг, включающий автоматическое восстановление подключения к приоритетному целевому ресурсу;

  • время хранения в кэше на клиенте списка перенаправления в секундах;

  • состояние:

    • Online — целевой ресурс доступен и участвует в формировании списка перенаправления;

    • Offline — целевой ресурс исключается из списка перенаправления, но остается в конфигурации DFSN;

  • описание.

Параметры

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

  • --server=DFSSERVERHOST — имя хоста (NetBIOS-имя) или полное доменное имя (FQDN) сервера пространства имен, используя соединение с которым будет выполнено изменение или запрошена информация;

    Этот параметр предназначен для использования только в исключительных случаях, когда необходимо явно указать сервер пространства имен (например, при нештатных ситуациях или тестировании). Задавать его при штатной эксплуатации не требуется.
  • --domain=DOMAIN — DNS-имя домена, информацию о пространствах имен в котором необходимо получить;

    Параметр не может указываться одновременно с --computer.
  • --computer=COMPUTER — DNS-имя сервера, информацию о пространствах имен на котором необходимо получить;

    Параметр не может указываться одновременно с --domain.
  • --extended — включить в вывод информацию о конфигурации пространства имен (режим работы, список установленных в конфигурации флагов, период кэширования данных на клиенте, состояние, описание).

Примеры

Пример получения списка пространств имен в текущем домене (определяется по конфигурации на сервере, на котором выполняется подкоманда):

samba-tool dfsn root list
...
List DFS namespaces:
Result:
\\ELLES.INNO.TECH\namespace1
\\ELLES.INNO.TECH\namespace2

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

samba-tool dfsn root list --domain=elles.inno.tech
...
List DFS namespaces:
Result:
\\ELLES.INNO.TECH\namespace1
\\ELLES.INNO.TECH\namespace2

Пример получения списка пространств имен, обслуживаемых указанным сервером:

samba-tool dfsn root list --computer=dc01.elles.inno.tech
...
List DFS namespaces:
Result:
\\ELLES.INNO.TECH\namespace1
\\ELLES.INNO.TECH\namespace2

Пример получения расширенной информации о пространствах имен в текущем домене (определяется по конфигурации сервера, на котором выполняется подкоманда):

samba-tool dfsn root list --extended
List DFS namespaces:
...
Result:
...
\\ELLES.INNO.TECH\namespace1:
        Type:               Domain v2
        Properties:         Site costing
        Time-to-live (sec): 300
        State:              2 (Online)
        Description:        DFS Namespace

\\ELLES.INNO.TECH\namespace2:
        Type:               Domain v2
        Properties:         Site costing
        Time-to-live (sec): 600
        State:              2 (Online)
        Description:        Another DFS Namespace