.. _ref_snmp:

Протокол SNMP
=============

Протокол SNMP (Simple Network Management Protocol) является стандартом для мониторинга сетевых устройств. Его поддержка обеспечивает централизованное управление параметрами, сбор телеметрии и интеграцию с SCADA-системами. 

В контроллерах реализован протокол версий v.1 и v.2.

Настройка переменных для работы с протоколом осуществляется в диалоге редактирования сетевых переменных (:ref:`ref_SNMPVars`). 

В этом диалоге производится добавление переменных и групп в SNMP протокол, производится настройка их параметров - **OID**, **Имя объекта** и другие параметры.

Порядок формирования OID переменных
-----------------------------------

Формирование OID для переменных SNMP производится в следующем порядке:

* первые шесть идентификаторов указывают на стандартный путь до ветви для зарегистрированных производителей  - 1.3.6.1.4.1 (iso.org.dod.internet.private.enterprises)
* следующий узел указывает на идентификатор производителя. По умолчанию устанавливается идентификатор, зарегистрированный для компании Zentec:62317.
* следующий узел указывает на тип переменных - системные или пользовательские. Системные переменные имеют идентификатор system:1, пользовательские - uservars:2. Ветка системных переменных не доступна для редактирования.
* следующий узел после uservars  обозначает версию адресного пространства, например version:2
* после версии следуют пользовательские группы и переменные

В ветке системных переменных (system) расположены следующие параметры:

* model:1 - тип контроллера, его идентификатор
* version:2 - номер версии ядра контроллера
* build:3 - номер сборки ядра контроллера
* userd:4 - код пользователя
* projectid:5 - код проекта, задается в настройках шаблона контроллера другие системные данные.
* projectver:6 - номер версии проекта 
* projectbuild:7 - номер сборки проекта

Например, переменная **model** имеет следующий полный OID: 1.3.6.1.4.1.62317.1.1

Идентификатор производителя можно поменять в общих настройках программы :ref:`ref_manufacturer_info`.

MIB файлы
---------

Настройка дополнительных параметров и формирования MIB файлов производится в свойствах шаблона контроллера.

.. figure:: image/snmp/snmp2.png
   :align: center

Для редактирования доступны следующие параметры:

* **Версия адресного пространства** - участвует в формировании OID пользовательских переменных
* **Системное имя устройства** - системный OID - 1.3.6.1.2.1.1.5  (iso.org.dod.internet.mgmt.mib-2.system.sysName)
* **Описание устройства** - системный OID - 1.3.6.1.2.1.1.1  (iso.org.dod.internet.mgmt.mib-2.system.sysDescr)
* **Расположение устройства** - системный OID - 1.3.6.1.2.1.1.6  (iso.org.dod.internet.mgmt.mib-2.system.sysLocation)
* **Контакты разработчика** - системный OID - 1.3.6.1.2.1.1.4  (iso.org.dod.internet.mgmt.mib-2.system.sysContact)

Для формирования MIB-файлов необходимо нажать кнопку **Обзор...** и выбрать каталог.  После этого будет сформирован набор файлов, в которых будет содержаться информация о производителе, системных параметрах, пользовательских переменных и других типах данных.

Пример файлов:

* **ZENTEC-MIB.mib** - файл описания производителя
* **ZENTEC-VAR-1-MIB.mib** - пользовательские переменные
* **ZENTEC-SYSVAR-MIB.mib** - системные переменные
* **FLOAT-TC-MIB.mib** - тип данных FLOAT

Обратите внимание, что в формировании имени файлов участвует наименование производителя, устанавливаемое в общих настройках программы :ref:`ref_manufacturer_info`.