snmpset

Обмен данными с сетевым объектом с использованием запросов SNMP SET

Синтаксис:

snmpset [-d] [-p порт] [-r повторные_попытки] [-t таймаут] -v 1 хост сообщество имя_переменной тип значение [имя_переменной тип значение] 

snmpset [-d] [-p порт] [-r повторные_попытки] [-t таймаут] [-v 2] хост noAuth имя_переменной тип значение [имя_переменной тип значение] 

snmpset [-d] [-p порт] [-r повторные_попытки] [-t таймаут] [-v 2] хост сторона-источник сторона-адресат контекст имя_переменной тип значение [имя_переменной тип значение]

Опции:

-d

Выгрузить входные и выходные пакеты.

-p порт

Задает номер порта назначения.

-r повторные_попытки

Задает число повторных попыток.

-t таймаут

Задает таймаут (в секундах).

-v 1|2

Версия SNMP (значение по умолчанию – 2).

сообщество

Имя сообщества для транзакции с удаленной системой.

контекст

Набор ресурсов объектов, устанавливаемая стороной-адресатом.

сторона-адресат

Имя стороны, выполняющей действие.

хост

IP-адрес или имя хоста.

сторона-источник

Имя стороны, запрашивающей действие.

тип

Тип данных; переменная тип может принимать одно из следующих значений:

a

IPADDRESS

d

DECIMAL STRING (десятичная строка)

i

INTEGER (целое число)

n

NULLOBJ (нулевой объект)

o

OBJID (идентификатор объекта)

s

STRING (строка)

t

TIMETICKS (отсчет времени)

x

HEX STRING (шестнадцатеричная строка)

значение

Значение данных.

имя_переменной

Имя переменной в формате, указанном в файле mib.txt.

Платформы:

ЗОСРВ «Нейтрино»

Целевые архитектуры:

aarch64, arm, armv7, e2k, mips, ppc, x86

Описание:

Утилита snmpset устанавливает информацию о сетевом объекте с помощью запроса SET. Можно указать один или более полностью определенных идентификаторов объекта в формате, указанном в файле mib.txt.

Если применяется SNMP версии 2, должны быть сконфигурированы следующие файлы:

• /etc/acl.conf
• /etc/context.conf
• /etc/party.conf
• /etc/snmpd.conf (требуется, только если изменено местоположение по умолчанию для конфигурационных файлов)

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

Примеры:

Установка для переменной sysContact.0 значения "John Doe":

• Использование SNMPv1

  snmpset -v 1 netdev-kbox.cc.cmu.edu public system.sysContact.0 s "John Doe"

• Использование SNMPv2

  snmpset netdev-kbox.cc.cmu.edu manager_party agent_party agent_context system.sysContact.0 s "John Doe"

Пример вывода:

system.sysContact.0 = "John Doe"

Переменные окружения:

MIBFILE

Задает местоположение файла mib.txt. Например, MIBFILE=путь/mib.txt (путь по умолчанию – /etc).

SUFFIX

Если в рабочей среде существует переменная SUFFIX, то по всем идентификаторам объектов, имеющим символическое имя, выводится только последний элемент. Примеры:

идентификатор
system.syscontact.0

выводится в виде
syscontact.0

идентификатор
udp.udpTable.udpEntry.udpLocalAddress.0.0.0.161

выводится в виде
udpLocalAddress.0.0.0.161

Ошибки:

Если при обработке пакета запроса сетевым объектом возникает ошибка, то возвращается ошибочный пакет, и утилита snmpset выводит сообщение для диагностики причины некорректности запроса.

Классификация:

Базовые подсистемы ЗОСРВ «Нейтрино»

Тематические ссылки:

snmpd, snmpget, snmpgetnext, snmpnetstat, snmpstatus, snmptest, snmptranslate, snmptrap, snmptrapd, snmpwalk

/etc/acl.conf, /etc/context.conf, /etc/mib.txt, /etc/party.conf, /etc/snmpd.conf, /etc/view.conf

Основано на: ISO 8824 (ASN.1), RFC 1065, RFC 1066, RFC 1067, RFC 1441, RFC 1445, RFC 1446, RFC 1448, RFC 1449

Предыдущий раздел: Утилиты