omshell
Подключение, запрос и
изменение статуса сервера ISC DHCP
Синтаксис:
omshell
Поддерживаемые платформы:
Neutrino
Опции:
См. описание подкоманд
далее.
Описание:
Утилита omshell представляет собой
командный интерпретатор, осуществляющий подключение к
серверу, запрос и (возможно) изменение статуса сервера ISC
DHCP через OMAPI (Object Management API – интерфейс API для
управления объектами) в интерактивном режиме. Если для
внесения изменений используются интерфейс OMAPI и утилита omshell, то останавливать и затем
перезапускать сервер DHCP не требуется. Вносить изменения
можно на работающем сервере. Утилита omshell обеспечивает доступ к
интерфейсу OMAPI.
OMAPI представляет собой
всего лишь механизм связи, позволяющий управлять объектами.
Для практического применения утилиты omshell необходимо ознакомиться с
доступными объектами и способами их использования.
Документацию по объектам
OMAPI см. в описании серверов, предоставляющих эти объекты
(например, см. dhcpd).
Открытие
соединения
Утилита omshell запускается из командной
строки с использованием нескольких допустимых команд.
server адрес
IP-адрес сервера DHCP для
установления соединения. Сервер по умолчанию – 127.0.0.1 (localhost).
port номер
Порт, прослушиваемый через
OMAPI. Значение по умолчанию – 7911.
key имя секрет
Эта команда
задает ключ TSIG, используемый для аутентификации транзакций
OMAPI. Аргумент имя является именем ключа,
определенным в файле dhcpd.conf.
new тип_объекта
Возможные
значения аргумента тип_объекта: group, host или
lease.
На этом шаге создание нового
объекта выполнено, и теперь можно задать свойства объекта.
Например, если по команде new lease был создан новый объект
аренды, можно задать следующие атрибуты аренды:
set имя_атрибута = значение
Имена атрибутов определены в
команде dhcpd. Строковые значения следует
заключать в кавычки. Пример. Установка IP-адреса объекта
аренды:
set ip-address = 192.168.4.50
Связывание
локальных и удаленных объектов
По команде open на сервере запрашивается
информация о данном объекте аренды.
open
Теперь
созданный локальный объект аренды, которому назначен
IP-адрес, связан с соответствующим объектом аренды на
сервере DHCP. Все атрибуты объекта аренды, полученные от
сервера DHCP, также являются атрибутами локального объекта и
отображаются в omshell.
Просмотр
удаленного объекта
После подключения к серверу
для запроса объекта аренды с адресом 192.168.4.50 и получения атрибутов
объекта используются следующие команды:
new lease
В результате создан новый
локальный объект аренды.
set ip-address =
192.168.4.50
В результате установлен
IP-адрес локального объекта 192.168.4.50
open
Теперь, если
объект аренды с указанным IP-адресом существует,
отображается полная информация сервера DHCP об этом объекте.
Все данные, не являющиеся печатаемым текстом, отображаются в
виде шестнадцатеричных значений, разделенных двоеточиями. В
этом примере выводимая сервером информация для всей
транзакции может выглядеть следующим образом:
> new "lease"
obj: lease
> set ip-address =
192.168.4.50
obj: lease
ip-address = c0:a8:04:32
> open
obj: lease
Здесь IP-адрес
представлен в виде шестнадцатеричных значений (в таком же
виде выводится время начала и окончания аренды).
Изменение
удаленного объекта
Для обновления атрибутов
удаленных объектов можно воспользоваться командой set (см. выше) и командой update. Команда set устанавливает атрибуты для
текущего локального объекта, а команда update передает эти изменения на
сервер.
В продолжение предыдущего
примера, если введена команда set
client-hostname = something-else и вслед за ней введена
команда update, то вывод выглядит
следующим образом:
> set client-hostname =
"something-else"
obj: lease
ip-address = c0:a8:04:32
state = 00:00:00:02
dhcp-client-identifier =
01:00:10:a4:b2:36:2c
client-hostname =
"something-else"
subnet = 00:00:00:06
pool = 00:00:00:07
hardware-address =
00:10:a4:b2:36:2c
hardware-type = 00:00:00:01
ends = dc:d9:0d:3b
starts = 5c:9f:04:3b
tstp = 00:00:00:00
tsfp = 00:00:00:00
cltt = 00:00:00:00
<
> update
obj: lease
ip-address = c0:a8:04:32
state = 00:00:00:02
dhcp-client-identifier =
01:00:10:a4:b2:36:2c
client-hostname =
"something-else"
subnet = 00:00:00:06
pool = 00:00:00:07
hardware-address =
00:10:a4:b2:36:2c
hardware-type = 00:00:00:01
ends = dc:d9:0d:3b
starts = 5c:9f:04:3b
tstp = 00:00:00:00
tsfp = 00:00:00:00
cltt = 00:00:00:00
Новые удаленные объекты
Создание новых объектов
выполняется примерно так же, как изменение существующих
объектов сервера. Создание локального объекта с помощью
команды new; установка требуемых
атрибутов и затем создание удаленного объекта с такими же
свойствами:
create
name = "some-host"
hardware-address =
00:80:c7:84:b1:94
> set hardware-type = 1
obj: host
name = "some-host"
hardware-address =
00:80:c7:84:b1:94
hardware-type = 1
> set ip-address =
192.168.4.40
obj: host
name = "some-host"
hardware-address =
00:80:c7:84:b1:94
hardware-type = 1
ip-address = c0:a8:04:28
> create
obj: host
name = "some-host"
hardware-address =
00:80:c7:84:b1:94
hardware-type = 00:00:00:01
ip-address = c0:a8:04:28
>
В файле dhcpd.leases при этом
появится следующая запись:
host some-host {
dynamic;
hardware ethernet
00:80:c7:84:b1:94;
fixed-address 192.168.4.40;
}
Строка dynamic; означает, что эта запись
хоста создана динамически через OMAPI и не извлекалась из
файла dhcpd.conf.
Сброс
атрибутов
Для удаления атрибута
объекта используется команда unset. После удаления атрибута
обязательно следует ввести команду update для обновления удаленного
объекта. Например, если для хоста somehost из предыдущего примера
необходимо удалить статический IP-адрес, используются
следующие команды в утилите omshell:
obj: host
name = "some-host"
hardware-address =
00:80:c7:84:b1:94
hardware-type = 00:00:00:01
ip-address = c0:a8:04:28
> unset ip-address
obj: host
name = "some-host"
hardware-address =
00:80:c7:84:b1:94
hardware-type = 00:00:00:01
ip-address =
>
name = "some-host"
hardware-address =
00:80:c7:84:b1:94
hardware-type = 00:00:00:01
ip-address = c0:a8:04:28
> remove
obj:
>
Примечание.
Обязательное предварительное условие для использования
интерфейса OMAPI: в файле dhcpd.conf
должна существовать следующая строка, определяющая порт:
omapi-port 7911;
Здесь 7911 является значением
по умолчанию, используемым библиотекой dhcpctl().
