6.2.2. Утилита samba-tool

⁠6.2.2.1. Работа с DNS-записями

Таблица 6.3. Команды управления DNS-записями samba-tool

Команда	Описание	Примечание
dns add <сервер> <зона> <имя> <A\|AAAA\|PTR\|CNAME\|NS\|MX\|SRV\|TXT> <данные>	Добавить новую запись	Параметры вызова: сервер — IP-адрес или доменное имя DNS-сервера; зона — зона DNS; имя — имя DNS-записи; тип добавляемой записи с данными.
dns delete <сервер> <зона> <имя> <A\|AAAA\|PTR\|CNAME\|NS\|MX\|SRV\|TXT> <данные>	Удалить DNS-запись
dns edit <сервер> <зона> <имя> <A\|AAAA\|PTR\|CNAME\|NS\|MX\|SOA\|SRV\|TXT> <текущие данные> <новые данные>	Изменить DNS-запись	Дополнительно для изменения доступен тип записи SOA (Start of Authority), являющейся начальной записью зоны, со следующими данными (порядок пунктов в списке ниже соответствует порядку следования параметров в строке): nameserver — доменное имя DNS-сервера, на котором хранятся другие DNS-записи; email — адрес электронной почты администратора зоны (вместо @ указывается точка, например для адреса user@test.alt указывается значение user.test.alt); serial — серийный номер файла зоны, представляющий собой номер версии записи SOA; увеличивается при каждом изменении значения записи и служит сигналом другим DNS-серверам о том, что требуется обновить данные; refresh — интервал для запроса изменений; retry — интервал для повторных попыток запроса данных в случае неудачи; expire — время, в течение которого обновленные данные могут быть применены на других DNS-серверах; minimum-ttl — время хранения в кеше информации о зоне.
dns cleanup <сервер> <имя узла> [опции]	Очистить DNS-записи указанного DNS-узла	Во многих случаях данная подкоманда только устанавливает значение true в атрибуте dNSTombstoned DNS-записей. После этого при запросе таких записей информация о них возвращаться не будет, но в базе данных могут оставаться соответствующие им записи-заполнители.
dns query <сервер> <зона> <имя> <A\|AAAA\|PTR\|CNAME\|NS\|MX\|SOA\|SRV\|TXT\|ALL> [опции]	Вывести информацию о DNS-записях	Можно использовать следующие опции: `--authority` — поиск по записям полномочного DNS-сервера (значение по умолчанию); `--cache` — поиск по записям в кеше; `--glue` — поиск по корневым ссылкам DNS-сервера; `--additional` — вывод списка дополнительных записей; `--no-children` — исключение вывода дочерних записей; `--only-children` — вывод только дочерних записей.

Возможные типы записей и данные:

A <IPv4-адрес> — IPv4-адрес для связи с именем домена;
AAAA <IPv6-адрес> — IPv6-адрес для связи с именем домена;
PTR <FQDN> — полное доменное имя (FQDN) для связи с IP-адресом домена;
CNAME <FQDN> — полное доменное имя (FQDN) для создания псевдонима;
NS <FQDN> — полное доменное имя (FQDN) сервера, выполняющего роль сервера имен;
MX <FQDN> <приоритет> — полное доменное имя (FQDN) и приоритет почтового сервера;
SRV <FQDN> <порт> <приоритет> <вес> — полное доменное имя (FQDN) сервера, на котором доступна определенная служба, порт для доступа к службе, приоритет и относительный вес на случай, если существует несколько записей с одинаковым приоритетом;
TXT "'sting1' 'string2' …" — информация о домене в текстовом формате (string).

Примечание

Полный список параметров каждой команды можно увидеть в справке, например:

$ samba-tool dns add --help

Примечание

При использовании команды samba-tool dns указание аутентифицирующей информации (имени пользователя и пароля) обязательно!

Примеры:

добавить запись типа A:

$ samba-tool dns add 192.168.0.132 test.alt \
DC2 A 192.168.0.133 -Uadministrator

Password for [TEST\administrator]:
Record added successfully

добавить запись типа PTR для обратной зоны 192.168.0.0/24:

$ samba-tool dns add dc1.test.alt 0.168.192.in-addr.arpa \
55 PTR demo.test.alt -U administrator

Password for [TEST\administrator]:
Record added successfully

удалить запись типа A:

$ samba-tool dns delete dc1.test.alt test.alt \
DC2 A 192.168.0.133 -U administrator

Password for [TEST\administrator]:
Record deleted successfully

изменить запись типа A:

$ samba-tool dns update dc1.test.alt test.alt DC2 \
A 192.168.0.133 192.168.0.149 -U administrator

Password for [TEST\administrator]:
Record updated succefully

изменить адрес электронной почты администратора в записи типа SOA:

$ samba-tool dns update dc1.test.alt test.alt @ SOA \
"dc1.test.alt admin.test.alt 63 900 600 86400 3600" \
"dc1.test.alt new.test.alt 64 900 600 86400 3600" \
-U administrator

Password for [TEST\administrator]:
Record updated succefully

вывести все DNS-записи для указанной зоны:

$ samba-tool dns query dc1.test.alt 0.168.192.in-addr.arpa \
@ ALL -U administrator

⁠6.2.2.2. Работа с DNS-зонами

⁠

Таблица 6.4. Команды samba-tool для управления зонами DNS

Команда	Описание	Примечание
dns zonecreate <сервер> <зона> [опции]	Создать зону DNS	Дополнительно с помощью параметра `--client-version` можно указать версию DNS-клиента. Возможные значения: w2k, dotnet, longhorn (по умолчанию).
dns zonedelete <сервер> <зона> [опции]	Удалить зону DNS
dns zoneinfo <сервер> <зона> [опции]	Вывести информацию о зоне DNS
dns zonelist <сервер> [опции]	Вывести список зон DNS	Можно использовать следующие опции: `--client-version` — версия DNS-клиента. Возможные значения: w2k, dotnet, longhorn (по умолчанию); `--primary` — получение списка первичных зон DNS (по умолчанию); `--secondary` — получение списка вторичных зон DNS; `--cache` — получение списка зон DNS из кеша; `--auto` — получение списка автоматически созданных зон DNS; `--reverse` — получение списка обратных зон DNS; `--ds` — получение списка зон DNS, интегрированных с доменом; `--non-ds` — получение списка зон DNS без интеграции с доменом.
dns zoneoptions <сервер> <зона> [опции]	Изменить настройки очистки от устаревших записей для зоны DNS	Можно использовать следующие опции: `--client-version` — версия DNS-клиента. Возможные значения: w2k, dotnet, longhorn (по умолчанию); `--mark-old-records-static=YYYY-MM-DD` — записи старше указанной даты становятся статическими (их временные метки становятся нулевыми); `--mark-records-static-regex=REGEXP` — записи, соответствующие заданному регулярному выражению, становятся статическими; `-n\|--dry-run` — запуск в тестовом режиме для проверки корректности заданных параметров; фактически изменения не вносятся; `--aging` — признак необходимости очистки от устаревших записей: 0 — очистка отключена (по умолчанию), 1 — очистка включена; `--norefreshinterval=[0-87600]` — интервал блокировки для зоны с включенной очисткой в часах; если параметр равен нулю, используется значение по умолчанию (168 часов, одна неделя); `--refreshinterval=[0-87600]` — интервал обновления для зоны с включенной очисткой в часах; если параметр равен нулю, используется значение по умолчанию (168 часов, одна неделя).

Примечание

Полный список параметров каждой команды можно увидеть в справке, например:

$ samba-tool dns zoneoptions --help

Примечание

При использовании команды samba-tool dns указание аутентифицирующей информации (имени пользователя и пароля) обязательно!

Примеры:

создать обратную зону /24:

$ samba-tool dns zonecreate 192.168.0.132 \
0.168.192.in-addr.arpa -U administrator

вывести информацию об обратной зоне DNS:

$ samba-tool dns zoneinfo dc1.test.alt \
0.168.192.in-addr.arpa -U administrator

включить очистку с большим интервалом обновления:
```
$ samba-tool dns zoneoptions dc1.test.alt \
test.alt --aging=1 --refreshinterval=306600
```

Примечание

Чтобы очистка работала, в файле smb.conf хотя бы на одном контроллере домена должен быть задан параметр dns zone scavenging = yes.

⁠6.2.2.3. Получение информации о DNS-серверах

⁠

Таблица 6.5. Команды samba-tool для получения информации о DNS-серверах

Команда	Описание	Примечание
dns serverinfo <сервер> [опции]	Вывести информацию о DNS-сервере	Дополнительно с помощью параметра `--client-version` можно указать версию DNS-клиента. Возможные значения: w2k, dotnet, longhorn (по умолчанию)
dns roothints <сервер> [<имя>] [опции]	Вывести информацию о корневых серверах DNS

Примечание

Полный список параметров каждой команды можно увидеть в справке, например:

$ samba-tool dns roothints --help

Примеры:

вывести информацию о DNS-сервере:

$ samba-tool dns serverinfo dc1.test.alt -U administrator

вывести информацию об обратной зоне DNS:
```
$ samba-tool dns zoneinfo dc1.test.alt \
0.168.192.in-addr.arpa -U administrator
```
Данная команда возвращает структуру DNS_RPC_SERVER_INFO, содержащую информацию о состоянии и конфигурации DNS-сервера, в формате, соответствующем версии DNS-клиента.
вывести информацию о корневых серверах DNS:
```
$ samba-tool dns roothints dc1.test.alt -U administrator
```