Управление папками
Для управления папками в пространстве имен с помощью утилиты samba-tool используется группа подкоманд dfsn folder.
| См. описание последовательности настройки пространства имен в разделе «Настройка DFSN». |
Общие сведения
Папка представляет собой виртуальную папку, которая видна клиентам в иерархии пространства имен и может содержать одно или несколько целевых местоположений, указывающих на общие папки на файловых серверах.
Папка сопоставляется с виртуальным именем, которое клиент использует при построении пути в пространстве имен. При обращении клиента к папке сервер пространства имен возвращает список целевых файловых ресурсов. Этот список может содержать один или несколько адресов, упорядоченных по принадлежности к сайту, доступности и приоритету (если заданы соответствующие настройки).
Создание папки
Формат вызова:
samba-tool dfsn folder create <dfs_path> <target_path> [options]
В качестве обязательного аргумента ожидается путь к создаваемой папке в пространстве имен в формате UNC-имени (например, \\elles.inno.tech\namespace1\documents). Путь должен быть уникальным в рамках пространства имен.
Если папка используется для создания промежуточного уровня в иерархии каталогов в пространстве имен, путь к целевой папке не указывается. Если папка должна быть связана с целевой папкой, в качестве второго аргумента ожидается путь к ней в формате UNC-имени (например, \\fileserver01.elles.inno.tech\namespace1\documents).
Дополнительно могут быть указаны параметры, определяющие:
-
необходимость учета сайта клиента при выдаче ему перенаправлений;
-
необходимость обращения клиента к оптимальному серверу;
-
доступность папки;
-
доступность целевых папок в папке;
-
период хранения в кэше клиентов перенаправлений;
-
приоритет при обработке клиентских запросов к папке.
Подкоманда создает папку в пространстве имен в соответствии с переданными значениями параметров.
После создания в папку могут быть добавлены целевые папки.
Параметры
Параметры вызова:
-
--server=DFSSERVERHOST— имя хоста или полное доменное имя (FQDN) сервера пространства имен, используя соединение с которым будет осуществлено изменение; применяется только при необходимости явно указать сервер в нештатных ситуациях; -
--comment=DESCRIPTION— произвольное текстовое описание папки; -
--enable-insite-referrals=True|False— возвращать клиенту перенаправления только в том же сайте, в котором он находится (значение по умолчанию —False);Если при вызове подкоманды параметр передается со значением
True, сервер пространства имен будет возвращать клиентам перенаправления в том же сайте, в котором они находятся.Если параметр имеет значение
False(по умолчанию), возвращаются перенаправления на ресурсы как внутри собственного сайта клиента, так и в других сайтах. -
--enable-target-failback=True|False— требовать использования клиентом предпочитаемого сервера при восстановлении его доступности (значение по умолчанию —False);Если попытка доступа к целевой папке на предпочитаемом сервере завершается неуспешно, клиент переходит к следующему серверу в списке. В случае использования этого параметра сервер пространства имен требует, чтобы клиент обращался к предпочитаемому серверу, если он снова доступен.
-
--referral-priority-class=CLASS— приоритет папки внутри сайта; возможные значения:-
GlobalHigh— максимальный приоритет независимо от стоимости соединения для конкретного клиента; -
SiteCostHigh— максимальный приоритет среди ссылок с одинаковой стоимостью соединения для конкретного клиента; -
SiteCostNormal(по умолчанию) — обычный приоритет среди ссылок с одинаковой стоимостью соединения для конкретного клиента; -
SiteCostLow— наименьший приоритет среди ссылок с одинаковой стоимостью соединения для конкретного клиента. -
GlobalLow— максимальный приоритет независимо от стоимости соединения для конкретного клиента;
В текущей версии Эллес учет стоимости соединения не реализован. -
-
--referral-priority-rank=RANK— приоритет папки в виде целого числового значения (значение по умолчанию —0);Допустимый диапазон значений — от
0до31. Чем меньше число, тем выше приоритет; нулевое значение соответствует наивысшему приоритету. -
--state=STATE— доступность папки для клиентов; возможные значения:-
Online(по умолчанию) — папка доступна для запросов клиентов; -
Offline— папка недоступна для запросов клиентов;
-
-
--target-state=STATE— доступность целевой папки, на которую указывает папка, для клиентов; возможные значения:-
Online(по умолчанию) — целевая папка доступна для запросов клиентов; -
Offline— целевая папка недоступна для запросов клиентов;
-
-
--ttl=TIMETOLIVE— период хранения в кэше клиентов перенаправлений на целевые папки в секундах (значение по умолчанию —1800).
Примеры
Пример создания папки на указанном сервере пространства имен:
samba-tool dfsn folder create "\\\\elles.inno.tech\\namespace1\\documents" "\\\\fileserver01.elles.inno.tech\\namespace1\\documents" \
--comment="DFS folder"
...
Create folder:
DFS path: \\elles.inno.tech\namespace1\documents
Target path: \\fileserver01.elles.inno.tech\namespace1\documents
Insite referrals: False
Target failback: False
State: 2 (Online)
Time-to-live (sec): 1800
Comment: DFS folder
Target state: 2 (Online)
Referral priority class: 3 (SiteCostNormal)
Referral priority rank: 0
Result: Success
Получение информации о папке
Формат вызова:
samba-tool dfsn folder get <dfs_path> [options]
В качестве обязательного аргумента ожидается путь к папке в пространстве имен в формате UNC-имени.
Подкоманда возвращает следующую информацию о папке:
-
путь к папке в пространстве имен;
-
доступность;
-
период кэширования перенаправлений клиентами;
-
описание;
-
GUID;
-
целевые папки.
Параметры
Параметры вызова:
-
--server=DFSSERVERHOST— имя хоста или полное доменное имя (FQDN) сервера пространства имен, используя соединение с которым будет осуществлено изменение; применяется только при необходимости явно указать сервер в нештатных ситуациях.
Примеры
Пример получения информации о папке:
samba-tool dfsn folder get \\elles.inno.tech\namespace1\documents
...
Get folder info:
DFS path: \\elles.inno.tech\namespace1\documents
Result:
DFS path: \\elles.inno.tech\namespace1\documents
State: 2 (Online)
Properties: Insite referrals, Target failback
Time-to-live (sec): 1800
Comment: Example DFS Folder
Stores:
\\fileserver01.elles.inno.tech\namespace1\documents Online
\\fileserver02.elles.inno.tech\namespace1\documents Online
Изменение настроек папки
Формат вызова:
samba-tool dfsn folder set <dfs_path> [options]
В качестве обязательных аргументов ожидаются путь к папке в пространстве имен в формате UNC-имени и новые значения для настроек, которые требуется изменить.
Подкоманда изменяет настройки указанной папки в соответствии с переданными значениями параметров.
Параметры
Параметры вызова:
-
--server=DFSSERVERHOST— имя хоста или полное доменное имя (FQDN) сервера пространства имен, используя соединение с которым будет осуществлено изменение; применяется только при необходимости явно указать сервер в нештатных ситуациях; -
--comment=DESCRIPTION— произвольное текстовое описание папки; -
--enable-insite-referrals=True|False— возвращать клиенту перенаправления только в том же сайте, в котором он находится;Если при вызове подкоманды параметр передается со значением
True, сервер пространства имен будет возвращать клиентам перенаправления в том же сайте, в котором они находятся.Если параметр имеет значение
False, возвращаются перенаправления на ресурсы как внутри собственного сайта клиента, так и в других сайтах. -
--state=STATE— доступность папки для клиентов; возможные значения:-
Online— папка доступна для запросов клиентов; -
Offline— папка недоступна для запросов клиентов;
-
-
--enable-target-failback=True|False— требовать использования клиентом предпочитаемого сервера при восстановлении его доступности;Если попытка доступа к целевой папке на предпочитаемом сервере завершается неуспешно, клиент переходит к следующему серверу в списке. В случае использования этого параметра сервер пространства имен требует, чтобы клиент обращался к предпочитаемому серверу, если он снова доступен.
-
--ttl=TIMETOLIVE— период хранения в кэше клиентов перенаправлений на целевые папки в секундах.
Перемещение или переименование папки
Формат вызова:
samba-tool dfsn folder move <dfs_path> <new_dfs_path> [options]
В качестве обязательных аргументов ожидаются:
-
текущий путь к папке в пространстве имен в формате UNC-имени (например, \\elles.inno.tech\namespace1\documents);
-
новый путь к папке в пространстве имен в формате UNC-имени (например, \\elles.inno.tech\namespace1\documents-old).
Подкоманда изменяет путь к папке в соответствии с переданным новым значением.
Параметры
Параметры вызова:
-
--server=DFSSERVERHOST— имя хоста или полное доменное имя (FQDN) сервера пространства имен, используя соединение с которым будет осуществлено изменение; применяется только при необходимости явно указать сервер в нештатных ситуациях.
Примеры
Пример переименования папки на текущем сервере:
samba-tool dfsn folder move "\\\\elles.inno.tech\\namespace1\\documents" "\\\\elles.inno.tech\\namespace1\\documents-archived" ... Move folder: DFS path: \\elles.inno.tech\namespace1\documents New DFS path: \\elles.inno.tech\namespace1\documents-archived Result: SUCCESS
Удаление папки
Формат вызова:
samba-tool dfsn folder remove <dfs_path> [options]
В качестве обязательного аргумента ожидается путь к папке в пространстве имен в формате UNC-имени.
Подкоманда удаляет папку со всеми ее метаданными, включая информацию о целевых папках. Общие папки и файлы на файловых серверах не удаляются.
Если папка является последней в родительском каталоге, не являющемся корневым каталогом пространства имен, родительский каталог также удаляется.
Для удаления корневого каталога пространства имен используйте подкоманду sama-tool dfsn root remove (см. раздел
«Управление пространствами имен»).
|