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

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

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

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

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

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

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

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

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

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

Операция доступна при работе с доменными пространствами имен.

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

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

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

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

Параметры

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

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

  • --referral-priority-class=CLASS — приоритет сервера внутри сайта; возможные значения:

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

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

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

    • SiteCostLow — наименьший приоритет среди северов с одинаковой стоимостью соединения для конкретного клиента.

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

    В текущей версии Эллес учет стоимости соединения не реализован.

  • --referral-priority-rank=RANK — приоритет сервера в виде целого числового значения;

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

  • --state=STATE — доступность сервера; возможные значения:

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

    • Offline — сервер недоступен для запросов клиентов;

    • --target-path=TARGETPATH — путь к целевому каталогу на добавляемом сервере.

Примеры

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

samba-tool dfsn root target create "\\\\elles.inno.tech\\namespace1" \
    --target-path="\\\\dfsnserver02.elles.inno.tech\\dfsroot" \
    --referral-priority-class=GlobalHigh \
    --referral-priority-rank=1
...
Path                       TargetPath                             State  RefferalPriorityClass RefferalPriorityRank
-------------------------- -------------------------------------- ------ --------------------- --------------------
elles.inno.tech\namespace1 \\dfsnserver02.elles.inno.tech\dfsroot Online GlobalHigh            1

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

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

samba-tool dfsn root target get <dfs_path> [--target-path=<target_path>] [options]

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

Подкоманда возвращает список обслуживающих пространство серверов или следующую информацию о сервере пространства имен:

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

  • доступность;

  • настройки приоритета.

Параметры

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

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

  • --target-path=TARGETPATH — путь к целевому каталогу на добавляемом сервере.

Примеры

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

samba-tool dfsn root target get "\\\\elles.inno.tech\\namespace1"
...
Path                       TargetPath                             State  RefferalPriorityClass RefferalPriorityRank
-------------------------- -------------------------------------- ------ --------------------- --------------------
elles.inno.tech\namespace1 \\dfsnserver01.elles.inno.tech\dfsroot Online SiteCostNormal        0
elles.inno.tech\namespace1 \\dfsnserver02.elles.inno.tech\dfsroot Online GlobalHigh            1

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

samba-tool dfsn root target get "\\\\elles.inno.tech\\namespace1" \
    --target-path="\\\\dfsnserver02.elles.inno.tech\\dfsroot"
...
Path                       TargetPath                             State  RefferalPriorityClass RefferalPriorityRank
-------------------------- -------------------------------------- ------ --------------------- --------------------
elles.inno.tech\namespace1 \\dfsnserver02.elles.inno.tech\dfsroot Online GlobalHigh            1

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

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

samba-tool dfsn root target set <dfs_path> --target-path=<target_path> [options]

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

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

Параметры

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

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

  • --referral-priority-class=CLASS — приоритет сервера внутри сайта; возможные значения:

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

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

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

    • SiteCostLow — наименьший приоритет среди северов с одинаковой стоимостью соединения для конкретного клиента.

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

    В текущей версии Эллес учет стоимости соединения не реализован.

  • --referral-priority-rank=RANK — приоритет в виде целого числового значения;

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

  • --state=STATE — доступность сервера; возможные значения:

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

    • Offline — сервер недоступен для запросов клиентов;

  • --target-path=TARGETPATH — путь к целевому каталогу на добавляемом сервере.

Примеры

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

samba-tool dfsn root target set "\\\\elles.inno.tech\\namespace1" \
    --target-path="\\\\dfsnserver03.elles.inno.tech\\dfsroot" \
    --referral-priority-class=SiteCostLow \
    --referral-priority-rank=2
...
Path                       TargetPath                             State  RefferalPriorityClass RefferalPriorityRank
-------------------------- -------------------------------------- ------ --------------------- --------------------
elles.inno.tech\namespace1 \\dfsnserver02.elles.inno.tech\dfsroot Online SiteCostLow           2

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

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

samba-tool dfsn root target remove <dfs_path> --target-path=<target_path> [options]

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

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

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

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

Параметры

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

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

  • --force — принудительная очистка данных о сервере в службе каталогов;

  • --skip-confirm — не запрашивать подтверждение операции;

  • --target-path=TARGETPATH — путь к целевому каталогу на добавляемом сервере.

Примеры

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

samba-tool dfsn root target remove "\\\\elles.inno.tech\\namespace1" \
    --target-path="\\\\dfsnserver02.elles.inno.tech\\dfsroot" \
    --skip-confirm
...
Deleted DFS Namespace root target: \\dfsnserver02.elles.inno.tech\dfsroot