Управление целевыми папками

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

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

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

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

Один объект папки может содержать несколько целевых папок.

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

Добавление целевой папки

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

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

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

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

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

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

Параметры

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

--server=DFSSERVERHOST — имя хоста или полное доменное имя (FQDN) сервера пространства имен, используя соединение с которым будет осуществлено изменение; применяется только при необходимости явно указать сервер в нештатных ситуациях;
--referral-priority-class=CLASS — приоритет целевой папки внутри сайта; возможные значения:
- GlobalHigh — максимальный приоритет независимо от стоимости соединения для конкретного клиента;
- SiteCostHigh — максимальный приоритет среди целевых папок с одинаковой стоимостью соединения для конкретного клиента;
- SiteCostNormal (по умолчанию) — обычный приоритет среди целевых папок с одинаковой стоимостью соединения для конкретного клиента;
- SiteCostLow — наименьший приоритет среди целевых папок с одинаковой стоимостью соединения для конкретного клиента;
- GlobalLow — максимальный приоритет независимо от стоимости соединения для конкретного клиента;
В текущей версии Эллес учет стоимости соединения не реализован.
--referral-priority-rank=RANK — приоритет целевой папки в виде целого числового значения (значение по умолчанию — 0);

Допустимый диапазон значений — от 0 до 31. Чем меньше число, тем выше приоритет; нулевое значение соответствует наивысшему приоритету.
--state=STATE — доступность целевой папки; возможные значения:
- Online (по умолчанию) — целевая папка доступна для запросов клиентов;
- Offline — целевая папка недоступна для запросов клиентов.

Примеры

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

samba-tool dfsn folder target create "\\\\elles.inno.tech\\namespace1\\documents" "\\\\fileserver01.elles.inno.tech\\namespace1\\documents" \
    --referral-priority-class=SiteCostHigh \
    --referral-priority-rank=1
...
Create folder target:
DFS path:                \\elles.inno.tech\namespace1\documents
Target path:             \\fileserver01.elles.inno.tech\namespace1\documents
State:                   2 (Online)
Referral priority class: 2 (SiteCostHigh)
Referral priority rank:  1
Result: SUCCESS

Получение информации о целевой папке

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

samba-tool dfsn folder target get <dfs_path> [<target_path>] [options]

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

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

путь к целевой папке;
доступность;
настройки приоритета.

Параметры

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

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

Примеры

Пример получения списка целевых папок, включенных в папку:

samba-tool dfsn folder target get "\\\\elles.inno.tech\\namespace1\\documents"
...
Get folder target info:
DFS path:    \\elles.inno.tech\namespace1\documents
Target path:
Result:
Stores:
             \\fileserver01.elles.inno.tech\namespace1\documents    Online    SiteCostNormal    0
             \\fileserver02.elles.inno.tech\namespace1\documents    Online   SiteCostNormal     0

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

samba-tool dfsn folder target get "\\\\elles.inno.tech\\namespace1\\documents" "\\\\fileserver01.elles.inno.tech\\namespace1\\documents"
...
Get folder target info:
DFS path:    \\elles.inno.tech\namespace1\documents
Target path: \\fileserver01.elles.inno.tech\namespace1\documents
Result:
Stores:
             \\fileserver01.elles.inno.tech\namespace1\documents    Online    SiteCostNormal    0

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

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

samba-tool dfsn folder target set <dfs_path> <target_path> [options]

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

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

Параметры

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

--server=DFSSERVERHOST — имя хоста или полное доменное имя (FQDN) сервера пространства имен, используя соединение с которым будет осуществлено изменение; применяется только при необходимости явно указать сервер в нештатных ситуациях;
--referral-priority-class=CLASS — приоритет целевой папки внутри сайта; возможные значения:
- GlobalHigh — максимальный приоритет независимо от стоимости соединения для конкретного клиента;
- SiteCostHigh — максимальный приоритет среди целевых папок с одинаковой стоимостью соединения для конкретного клиента;
- SiteCostNormal — обычный приоритет среди целевых папок с одинаковой стоимостью соединения для конкретного клиента;
- SiteCostLow — наименьший приоритет среди целевых папок с одинаковой стоимостью соединения для конкретного клиента;
- GlobalLow — максимальный приоритет независимо от стоимости соединения для конкретного клиента;
В текущей версии Эллес учет стоимости соединения не реализован.
--referral-priority-rank=RANK — приоритет целевой папки в виде целого числового значения;

Допустимый диапазон значений — от 0 до 31. Чем меньше число, тем выше приоритет; нулевое значение соответствует наивысшему приоритету.
--state=STATE — доступность целевой папки; возможные значения:
- Online — целевая папка доступна для запросов клиентов;
- Offline — целевая папка недоступна для запросов клиентов.

Примеры

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

samba-tool dfsn folder target set "\\\\elles.inno.tech\\namespace1\\documents" "\\\\fileserver01.elles.inno.tech\\namespace1\\documents" \
    --referral-priority-rank=1
...
Set folder target settings:
DFS path:               \\elles.inno.tech\namespace1\documents
Target path:            \\fileserver01.elles.inno.tech\namespace1\documents
Referral priority rank: 1
Result: SUCCESS

Удаление целевой папки

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

samba-tool dfsn folder target remove <dfs_path> <target_path> [options]

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

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

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

Параметры

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

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

Примеры

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

samba-tool dfsn folder target remove "\\\\elles.inno.tech\\namespace1\\documents" "\\\\fileserver02.elles.inno.tech\\namespace1\\documents"
...
Remove folder target:
DFS path:    \\elles.inno.tech\namespace1\documents
Target path: \\fileserver02.elles.inno.tech\namespace1\documents
Result: SUCCESS