IQM Manager - руководство пользователя (стр. 6 )

Configuration --> IQM Agents --> Agents

Рисунок 27 Подключение агента

Заполнить следующие поля:

Agent IP * - IP адрес подключаемого агента, Agent password * - пароль для авторизации управляющего соединения с агентом, Agent type = IQM, необходимо указать, тип агента - IQM, Network layer - сетевой архитектурный уровень, SNMP profile - имя профиля SNMP, для получения списка интерфейсов.

Нажать на кнопку Get. Система подключится к агенту с указанным адресом, после успешной handshake-авторизации система  считает текущую конфигурацию агента и тестов.  В случае, если указан SNMP-профиль, система дополнительно попытается считать информацию об интерфейсах для подключаемого агента по SNMP. Полученную конфигурацию система попытается занести в базу (таблицы agents, tests, ifcfg). В случае успеха, в интерфейсе будет выведен отчет о добавленных объектах.

1 row added to agents (iqmm)

1 row(s) added to ifcfg

При возникновении ошибок о них будет выдано соответствующее тревожное сообщение.

Error: Couldn't connect to 192.168.0.2:1189: IO::Socket::INET: connect: No route to host
2277: error getting config from agent 192.168.0.2:1189

После подключения агента к СУ IQMM необходимо проверить его текущую конфигурацию, внести изменения при необходимости. Для изменения конфигурации агента удобно выбрать его Agent ID или Agent name *, нажать на Fill form, форма будет заполнена текущей конфигурацией выбранного агента. После изменения значений требуемых параметров в форме следует нажать на Change. Все поля, с заданными значениями будут изменены.

Изменения в конфигурации агентов могут быть проведены массово, методом мультиконфигурации (см. Режим массовой конфигурации).

Подключение группы агентов по списку

Система позволяет проводить массовое включение агентов в автоматическом режиме с использованием метода мультиконфигурации. Подробно о режиме см. в разделе Режим массовой конфигурации. При заведении агентов по списку следует помнить о некоторых ограничениях:

Подключение списка агентов методом get со считыванием конфигурации с агента допускается только для агентов типа IQM, для всех агентов из подключаемого списка должны быть проведены работы по первичной конфигурации, в процессе первичной конфигурации всем агентам из списка должны быть выданы уникальные имена. Заведение агентов методом add все обязательные конфигурационные поля, не имеющие dafault-значений, должны быть определены либо в файле мультиконфигурации индивидуально для каждого агента, либо в форме для всей группы в качестве agent_name должны использоваться уникальные имена

Ниже приведен пример файла мультиконфигурации для подключения двух IQM агентов к системе. Наличие заключающего поля с комментариями - обязательно, его заполнение - не обязательно. Так как все параметры в конфигурации повторяются, в приведенном примере можно было бы оставить только поле agent_ip и поле my_comments, остальные поля заполнить в форме.

agent_ip	agent_pwd	agent_type	net_layer	snmp_profile_id	one_way_delays	status	oper_status	customer_id	my_comments
192.168.0.188	xyz	IQM	ACCESS	public	1	UP	UP	shared
192.168.0.178	xyz	IQM	ACCESS	public	1	UP	UP	shared

Файл мультиконфигурации сохраняется в формате CSV. Пример содержимого:

agent_ip;agent_pwd;agent_type;net_layer;snmp_profile_id;one_way_delays;status;oper_status;customer_id;my_comments

192.168.0.188;xyz;IQM;ACCESS;public;1;UP;UP;shared;

192.168.0.178;xyz;IQM;ACCESS;public;1;UP;UP;shared;

Символ-разделитель и символ цитирования, используемые по-умолчанию определены в файле конфигурации /home/iqm/iqmm/iqmm-cfg. pl:

$gCSVSepChar = ';';

$gCSVQuoteChar = '';

Символ-разделитель и символ цитирования не должны пересекаться со значениями в полях. В случае пересечения, следует воспользоваться нестандартными символами, их выбор - на усмотрение оператора. После создания файла мультиконфигурации его следует передать в СУ IQMM через форму управления агентами, поле Multiconf, после чего нажатием кнопки Get инициировать процесс  автоматического подключения агентов.

Рисунок 28 Подключение списка агентов через Multiconf

По окончании работы система выдаст отчет по каждому добавленному объекту.

IQMM - [logged as admin] - AGENTS CONFIGURATION:

AGENTS CONFIGURATION

GetAgent: : fld_agent_pwd=xyz|fld_snmp_profile_id=1|fld_oper_status=UP|fld_customer_id=1|fld_agent_ip=192.168.0.188|fld_agent_type=IQM|fld_net_layer=ACCESS|fld_one_way_delays=1|fld_status=UP|
GetAgent: : fld_agent_ip=192.168.0.178|fld_customer_id=1|fld_agent_type=IQM|fld_snmp_profile_id=1|fld_net_layer=ACCESS|fld_oper_status=UP|fld_one_way_delays=1|fld_status=UP|fld_agent_pwd=xyz|

................

Processed 2 records:

1 row added to agents (iqmm)

1 row(s) added to ifcfg

1 row added to agents (saratov1)

2 row(s) added to ifcfg

После подключения агентов к СУ IQMM необходимо проверить их текущую конфигурацию, внести изменения при необходимости. Изменения в конфигурации агентов так же могут быть проведены массово, методом мультиконфигурации.

Размещение IQM-агента за NAT

Часто возникает необходимость организовать мониторинг сервисов или качества участка сети для сетевого сегмента, размещенного за межсетевым устройством с трансляцией адресов (NAT) по отношению к СУ IQMM. Прямым решением поставленной задачи является настройка листов доступа (см. раздел Требования к листам доступа (ACL) для работы системы IQM) и статической трансляции (либо port-forwarding), для обеспечения прохождения трафика, необходимого для мониторинга. Однако, в ряде случаев, проведение дополнительной настройки межсетевого устройства может оказаться затруднительным с организационной или с технологической точки зрения. В таких случаях целесообразно воспользоваться REMOTE_IQM режимом работы агента.

Тип REMOTE_IQM говорит СУ IQMM, что агент находится за NAT и не доступен для конфигурации. В этом случае СУ IQMM должна сохранить полный конфигурационный файл для агента в своей локальной директории, для того, чтобы агент его самостоятельно забрал с использованием механизма, который должен быть указан в параметре Config source. В качестве механизма допускается использовать:

ftp, агент будет забирать конфиг по адресу: ftp://${FtpUser}:${FtpPassword}@$CoreIP/cfg/${SID}_iqm_agent. conf http, агент будет забирать конфиг по адресу: http://$CoreIP/cfg/${SID}_iqm_agent. conf URL, понятной для программы wget форме

На агенте для обновления файла конфигурации используется shell-программа /usr/local/iqm_agent/update_cfg. sh.

Локальная директория, в которой СУ IQMM будет сохранять подготовленные для REMOTE_IQM конфигурационные файлы указывается в переменной gRemoteIqmCfgDir файла  /home/iqm/iqmm/iqmm-cfg. pl

$gSLAHome = "/home/iqm";

$gSLARoot = "/home/iqm/iqmm";

$gHTML2PDF  = "$gSLARoot/scripts/wkhtmltopdf-i386";

$gCDRDir  = "$gSLAHome/stat";

$gRemoteIqmCfgDir= "$gSLAHome/cfg";

$gOldCDRDir  = "$gCDRDir/old";

$gErrorCDRDir  = "$gCDRDir/err";

$gCDRFileMask = "\\d{10}\\.results\$";

По умолчанию, используется размещение /home/iqm/cfg/

[*****@***iqmm]$ ls - ld /home/iqm/cfg/

drwxrwxr-x. 2 iqm iqm 4096 Ноя  8 18:04 /home/iqm/cfg/

Файл конфигурации для REMOTE_IQM сохраняется под именем <agent name>_iqm_agent. conf

Пример подготовки cfg - директории на СУ IQMM:

sudo chown iqm. iqm cfg/

sudo chmod 775 cfg/

sudo ln - s /home/iqm/cfg /var/ftp/stat/cfg

sudo chcon - t httpd_sys_content_rw_t /home/iqm/cfg/

Для включения режима самостоятельного обновления конфигурации агентом необходимо через интерфейс управления агентами:

Configuration --> IQM Agents --> Agents

выбрать нужный агент в списке Agent ID, выбранному агенту назначить тип REMOTE_IQM в параметре Agent type, указать URL файла-конфигурации в параметре Config Source, для приведенного примера достаточно указать ftp, Change

В директории /home/iqm/cfg/ будет создан файл <agent name>_iqm_agent. conf

1 row updated (saratov1)

on_agent=false for agent_type=REMOTE_IQM (!=IQM)
Updating config for agent_name=saratov1 (10) agent_type=REMOTE_IQM
Putting new config in /home/iqm/cfg/saratov1_iqm_agent. conf

первый раз перенести файл конфигурации на агента в ручную, включить на агенте регулярное обновление конфигурации через cron при помощи скрипта /usr/local/iqm_agent/update_cfg. sh или другого средства

root@wtplug:~# /usr/local/iqm_agent/update_cfg. sh

Usage: /usr/local/iqm_agent/update_cfg. sh <path-to-iqm-config-file>

root@wtplug:/usr/local/iqm_agent# crontab - l

# Edit this file to introduce tasks to be run by cron.

#

# Each task to run has to be defined through a single line

# indicating with different fields when the task will be run

# and what command to run for the task

#

# To define the time you can provide concrete values for

# minute (m), hour (h), day of month (dom), month (mon),

# and day of week (dow) or use '*' in these fields (for 'any').#

# Notice that tasks will be started based on the cron's system