cfgmaker - Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

cfgmaker - створює файли mrtg.cfg (для mrtg-2.17.4)

СИНТАКСИС

cfgmaker [параметри] [community@]router [[параметри] [community@]router ...]

ВАРІАНТИ

--ifref=name посилання на інтерфейс за назвою інтерфейсу (за замовчуванням)
--ifref=ip ... за IP-адресою
--ifref=eth ... за номером Ethernet
--ifref=descr ... за описом інтерфейсу
--ifref=nr ... за номером інтерфейсу
--ifref=type ... за типом інтерфейсу
Ви також можете використовувати кілька варіантів, розділених комами,
у цьому випадку використовується перший доступний:
наприклад --ifref=ip,name,nr

--ifdesc=nr опис інтерфейсу використовує номер інтерфейсу (за замовчуванням)
--ifdesc=ip ... використовує IP-адресу
--ifdesc=eth ... використовує номер Ethernet
--ifdesc=descr ... використовує опис інтерфейсу
--ifdesc=name ... використовує назву інтерфейсу
--ifdesc=catname ... використовує назву інтерфейсу CatOS
--ifdesc=ppname ... використовує назву паспортного порту
--ifdesc=alias ... використовує псевдонім інтерфейсу
--ifdesc=type ... використовує тип інтерфейсу
Ви також можете використовувати кілька варіантів, розділених комами,
у цьому випадку використовується перший доступний:
наприклад, --ifdesc=catname,ppname,descr,alias,ip,name,nr

--if-filter=f Перевірте кожен інтерфейс із фільтром f, щоб визначити погоду
або не включати цей інтерфейс до колекції.
Наразі f обчислюється як вираз Perl
і його значення істини використовується для відхилення або прийняття
Інтерфейс
(Експериментальний, у розробці, може змінитися)

--if-template=файл шаблону
Замініть звичайні цільові записи для інтерфейсів
із записом, визначеним вмістом у файлі
файл шаблону. Файл має містити Perl
код, який буде виконано для створення рядків для
target у файлі конфігурації.
(Експериментальний, у розробці, може змінитися)

--host-template=файл шаблону
На додаток до створення цілей для інтерфейсів хоста
також створіть цілі для самого хоста, як зазначено
за вмістом файлу templatefile. Файл є
має містити код Perl, який потрібно виконати для генерації
рядки для цілей, пов’язаних з хостом (таких як ЦП,
вимірювання часу відгуку ping тощо) у конфігурації
uration файл.
(Експериментальний, у розробці, може змінитися)

--global "x: a" додати глобальні записи конфігурації

--no-down не переглядати статус адміністратора або opr інтерфейсів

--show-op-down показує інтерфейси, які не працюють

--zero-speed=spd використовувати цю швидкість у бітах за секунду як інтерфейс
швидкість для всіх інтерфейсів, які повертають швидкість 0
через ifSpeed/ifHighSpeed. 100 Мбіт/с = 100000000

--subdirs=format надає кожному маршрутизатору власний підкаталог, називаючи кожен per
"формат", у якому будуть HOSTNAME і SNMPNAME
замінено значеннями цих елементів, наприклад,
--subdirs=ІМ'Я ХОСТУ або --subdirs="ІМ'Я ХОСТУ (SNMPNAME)"

--noreversedns не повертати IP-номера пошуку

--community=cmty Встановити стандартний рядок спільноти на "cmty".
"публічний".

--enable-ipv6 Увімкнути підтримку IPv6, якщо необхідні бібліотеки є
присутній. Числові адреси IPv6 мають бути включені
у квадратних дужках, наприклад public@[2001:760:4::1]:161

--use-16bit Використовувати 16-бітні ідентифікатори запиту SNMP для запиту до всіх маршрутизаторів.

--snmp-options=:[ ][:[ ][:[ ][:[ ][: ]]]]

Укажіть параметри SNMP за замовчуванням, які будуть додані до всіх
наступні маршрутизатори. Окремі поля можуть бути порожніми.
Наступні маршрутизатори можуть замінити деякі або всі
параметри, надані для --snmp-options.

--dns-domain=домен
Визначає домен, який потрібно додати до імені всіх
наступні маршрутизатори.

--nointerfaces Не створювати жодних рядків конфігурації для інтерфейсів,
пропустіть крок збору інформації про інтерфейс і
не запускайте код шаблону інтерфейсу.

--interfaces Створити рядки конфігурації для інтерфейсів (це
за замовчуванням). Основна мета цієї опції - заперечення
an --nointerfaces, що з’являється раніше в командному рядку.

--help коротке довідкове повідомлення
--man повна документація
--version вивести версію cfgmaker

--output=вихідний файл ім'я файлу за замовчуванням STDOUT

ОПИС

Cfgmaker створює конфігураційні файли MRTG на основі інформації, отриманої з маршрутизатора або
іншого пристрою, керованого SNMP.

[співтовариство@]маршрутизатор

Спільнота це назва спільноти пристрою, для якого ви хочете створити конфігурацію. Якщо
не вказано, за замовчуванням 'громадськість'; Ви можете спробувати це спочатку, якщо ви цього не зробите
знати назву спільноти пристрою. Якщо ви використовуєте неправильну назву спільноти, ви це зробите
не отримати відповідь від пристрою.

маршрутизатор це DNS-ім’я або IP-номер пристрою, керованого SNMP. Після назви
Ви можете вказати ще 6 параметрів, розділених двокрапками. Повний синтаксис виглядає так:

маршрутизатор[:[готовий][:[tmout][:[ретр][:[відступаємо][:для]]]]]

Особливий інтерес може представляти останній параметр, для. Якщо ви встановите значення «2», то ваш
пристрій запитуватиметься за допомогою запитів SNMP версії 2. Це дозволяє опитувати 64 біти
лічильники трафіку в пристрої і, таким чином, працюватимуть набагато краще зі швидкими інтерфейсами (ні
більше перевищення лічильника). Зверніть увагу, що порядок, у якому маршрутизатори вказані на
командний рядок має значення, оскільки той самий порядок використовується під час створення файлу конфігурації.
Першим зазначеним маршрутизатором створюються рядки конфігурації, а потім
лінії, що належать наступному маршрутизатору тощо.

Зауважте, що перший рядок згенерованого файлу cfg міститиме весь командний рядок
параметри, які ви використовували для його створення. Це робиться для легкої «регенерації» у випадку
ви хочете додати нові хости або внести інші глобальні зміни.

конфігурація
За винятком - вихід та --глобальний параметри, усі параметри впливають лише на маршрутизатори
слідуючи за ними в командному рядку. Якщо параметр, вказаний раніше в командному рядку
пізніше знову з’являється в командному рядку з іншим значенням, нове значення перекриває старе
значення, що стосується інших маршрутизаторів. Таким чином можна адаптувати параметри
групи маршрутизаторів або для окремих маршрутизаторів.

Читати - вихід та --глобальний як на їхню поведінку впливає де або скільки разів
вони з'являються в командному рядку.

Див прикладів нижче описано, як налаштувати параметри по-різному для кількох маршрутизаторів.

--допомога
Надрукуйте коротке повідомлення довідки та вийдіть.

-- чоловік
Друк сторінки посібника та вихід.

-- версія
Роздрукуйте версію cfgmaker. Це має відповідати версії MRTG, для якої конфігурації
створюються файли.

--ifref nr|ip|eth|Descr|ім'я
Виберіть спосіб ідентифікації інтерфейсу. За замовчуванням nr який ідентифікує маршрутизатор
інтерфейсів за їх кількістю. На жаль, схема нумерації інтерфейсу в SNMP
дерево може змінюватися. Деякі маршрутизатори змінюють свою нумерацію, коли додаються нові інтерфейси,
інші змінюють свою нумерацію кожного повного місяця просто заради розваги.

Щоб вирішити цю сумну проблему, MRTG може ідентифікувати інтерфейси за 4 іншими властивостями.
Жоден із них не працює для всіх інтерфейсів, але ви зможете знайти той, який працює
добре для вас. Зауважте, що адреси Ethernet можуть бути проблемними
маршрутизатори мають однакову адресу Ethernet на більшості своїх інтерфейсних карт.

Select ip для ідентифікації інтерфейсу за його IP-номером. використання eth використовувати мережу Ethernet
адреса для ідентифікації. використання Descr використовувати опис інтерфейсу. Або використовувати ім'я до
використовувати назву інтерфейсу.

За бажанням можна вказати декілька властивостей, розділених комами. В цьому випадку,
cfgmaker використовуватиме перший елемент у списку, який може надати унікальну ідентифікацію.
Це дозволяє вказати, наприклад, використовувати IP-адресу та використовувати ifName, якщо це
не визначено:
--ifref ip, ім'я

Якщо вибраний вами метод не дозволяє ідентифікувати унікальний інтерфейс на вашому пристрої
запитують, cfgmaker розповість вам про це.

--ifdesc nr|ip|eth|Descr|ім'я|тип|псевдонім
Виберіть, що використовувати як опис інтерфейсу. Опис з’являється в
властивість "Title[]" для цілі, а також текстовий заголовок у коді HTML
визначено в цільовому "PageTop[]". За замовчуванням використовується nr який є просто інтерфейсом
число, яке не завжди корисне для перегляду графіків.

Є ще 6 властивостей, які можна використати. використання ip якщо ви хочете використовувати
IP-адреса інтерфейсу. використання eth якщо ви хочете використовувати адресу ethernet інтерфейсу.
Якщо вам потрібен кращий опис, ви можете використовувати будь-яке з них Descr, ім'я or псевдонім. Саме так
те, що робить кожен із них, залежить від різного обладнання, тому вам може знадобитися
експеримент. Наприклад, для послідовного інтерфейсу на маршрутизаторі Cisco під керуванням IOS з використанням
ім'я може призвести до того, що "S0" буде описом інтерфейсу, Descr може призвести до
«Serial0» і псевдонім може призвести до "Посилання на HQ" (за умови, що це те, що використовується як
«опис» інтерфейсу в конфігурації маршрутизатора).

Нарешті, якщо ви хочете описати інтерфейс за його Btype (тобто "ethernetCSMA",
"propPointtoPoint" тощо), ви можете використовувати тип.

За бажанням можна вказати декілька властивостей, розділених комами. В цьому випадку,
cfgmaker використовуватиме перший елемент у списку, доступний для цього інтерфейсу.
Це дозволяє вказати, наприклад, використання будь-якого з різних псевдонімів по порядку
переваги.

--if-фільтр 'фільтр-вираз'
По-перше, це на стадії розробки та є експериментальним.

Використовуйте це, якщо ви хочете краще контролювати, які інтерфейси включені
конфігурація. The фільтр-вираз оцінюється як частина коду Perl і є
очікується повернення істинного значення. Якщо істина, включити інтерфейс, а якщо невірно,
виключити інтерфейс.

Докладніше про те, як працюють ці фільтри, див. у розділі «Докладніше про
Фільтри» нижче.

--if-шаблон шаблон-файл
По-перше, це на стадії розробки та є експериментальним.

Використовуйте це, якщо ви хочете контролювати, як має виглядати лінія для кожної цілі в
конфігураційний файл. Вміст файлу шаблон-файл буде оцінено як a
Програма на Perl, яка генерує рядки, використовуючи певні змінні для введення та виведення.

Для подальшого обговорення того, як ці шаблони працюють, перегляньте розділ «Деталі про
Шаблони» нижче.

--host-template шаблон-файл
По-перше, це на стадії розробки та є експериментальним.

Використовуйте це, якщо ви хочете мати додаткові цілі, пов’язані з самим хостом, наприклад ЦП
використання, час відповіді ping на хост, кількість зайнятих модемів тощо. Вміст
файлу шаблон-файл буде оцінено один раз на хост як програма Perl, яка
генерує рядки, використовуючи певні змінні для введення та виведення.

Для подальшого обговорення того, як ці шаблони працюють, перегляньте розділ «Деталі про
Шаблони» нижче.

--спільнота спільнота-рядок
Використовуйте це, щоб установити спільноту для маршрутизаторів, які слідують у командному рядку
спільнота-рядок. Окремі маршрутизатори можуть замінити цей рядок спільноти за допомогою
синтаксис community@router.

--enable-ipv6
Ця опція вмикає підтримку IPv6. Для цього потрібні відповідні модулі perl; якщо вони
не знайдено, тоді IPv6 вимкнено (див. документацію ipv6).

cfgmaker використовуватиме IPv6 або IPv4 залежно від цілі. Якщо мета є числом
адресу, протокол залежить від типу адреси. Якщо метою є ім’я хоста,
cfgmaker спробує розв’язати ім’я спочатку в адресу IPv6, а потім у IPv4
адреса

Числові адреси IPv6 потрібно вказувати в квадратних дужках.

Наприклад:

cfgmaker --enable-ipv6 [2001:760:4::1]:165:::2

Якщо мета має адресу IPv6 і IPv4 з однаковим іменем хоста,
cfgmaker спочатку запитує ціль за допомогою IPv6 і повертається до IPv4, якщо це не вдається. Це
корисний для цілей, які не підтримують SNMP через IPv6.

--використання-16 біт
Цей параметр примусово використовує 16-бітні ідентифікатори запитів SNMP. Деякі зламані агенти SNMP цього не роблять
приймати 32-бітні ідентифікатори запитів. Постарайтеся уникати цього варіанту, наскільки це можливо, скаржтеся
натомість ваш агент-постачальник.

--snmp-параметри :[порт][:[Тайм-аут][:[повторити спроби][:[відступаємо][:версія]]]]
Використовуйте це, щоб установити параметри SNMP за замовчуванням для всіх маршрутизаторів, які виконують цю команду
лінія. Окремі значення можуть бути пропущені, а також кінцеві двокрапки. Зауважте, що
маршрутизатори можуть перевизначати окремі (або всі) значення, визначені --snmp-параметри за допомогою
синтаксис

маршрутизатор[:[порт][:[Тайм-аут][:[повторити спроби][:[відступаємо][:версія]]]]]

--глобальний "бла: Азбука"
Використовуйте це, щоб додати глобальні параметри до створеного файлу конфігурації. Ви можете дзвонити --глобальний
кілька разів, щоб додати кілька варіантів. Рядок просто з'явиться в конфігурації
перед тим, як конфігурація для наступного маршрутизатора з’явиться в командному рядку.

--global "робочий каталог: /home/mrtg"

Якщо вам потрібні параметри за замовчуванням, ви можете розмістити

--global "параметри[_]: growright,біти"

Уточнення --глобальний після останнього маршрутизатора в командному рядку буде створено рядок in
конфігураційний файл, який з’явиться після всіх маршрутизаторів.

--noreversedns
Не намагайтеся змінити пошук IP-номерів ... це обов’язково для середовищ без DNS.

--ні вниз
Зазвичай cfgmaker не включатиме інтерфейси, які позначені чимось іншим, крім
адміністративно та оперативно УП. За допомогою цього перемикача ви отримаєте їх усі.

--show-op-down
Включати інтерфейси, які не працюють.

--нульова швидкість швидкість
Призначте цю швидкість у бітах за секунду всім інтерфейсам, які повертають 0 для ifSpeed ​​і
ifHighSpeed. Деякі комутатори, зокрема ливарне обладнання, повертають нульову швидкість для
деякі інтерфейси. Наприклад, щоб усі інтерфейси, які повідомляють про нуль, були встановлені на 100 Мбіт/с,
використовуйте --zero-speed=100000000.

--підкаталоги формат
Надайте кожному маршрутизатору власний підкаталог для файлів HTML і графіки (або .rrd). The
вказано назву каталогу формат рядок із кількома замінами шаблону. The
рядок "HOSTNAME" буде замінено на ім'я хоста маршрутизатора (однак ви
вказано це на cfgmaker командний рядок - це може бути фактичне ім'я хоста або просто IP-адреса
адресу), а "SNMPNAME" буде замінено на ідею власного імені пристрою (the
те саме ім’я, яке відображається праворуч від рядків «Назва»). Наприклад, дзвінок
подібно до:

cfgmaker --subdirs=ІМ'Я ХОСТУ__SNMP [захищено електронною поштою]

призведе до створення рядків, які виглядатимуть приблизно так:

Directory[10.10.0.18_1]: 10.10.0.18__fp2200-bothrip-1.3

- вихід файл
Запишіть вихід з cfgmaker у файл файл. За замовчуванням використовується "STDOUT".
- вихід Очікується, що з’явиться лише один раз у командному рядку. Якщо використовувати багато разів,
файл, вказаний останнім - вихід буде використовуватися.

--немає інтерфейсів
Не створюйте рядки конфігурації для інтерфейсів.

Це змушує cfgmaker пропускати всі кроки, пов’язані з інтерфейсами, що означає, що він не працюватиме
будь-який опитування маршрутизатора для отримання інформації про інтерфейс, що прискорює
виконання cfgmaker, і він не запускатиме жодних шаблонів інтерфейсу.

--інтерфейси
Це змушує cfgmaker генерувати рядки конфігурації для інтерфейсів (за замовчуванням
поведінка).

Основним використанням цього параметра є заперечення параметра --nointerfaces, який з’являвся раніше на
command line.

SNMP V3 Опції
Cfgmaker підтримує SNMP V3 за допомогою Мережа: SNMP модуль perl. Є додаткові параметри
впливає на роботу SNMP.

--enablesnmpv3 {так|ні}
Команда --enablesnmpv3 option є необов'язковим прапором для перевірки наявності
Net::SNMP бібліотеки. Cfgmaker спробує визначити, чи потрібен цей прапорець
автоматично встановить значення.

SNMPv3 Аргументи

Контекст SNMP — це набір управлінської інформації, доступний об’єкту SNMP. Ан
елемент управлінської інформації може існувати в більш ніж одному контексті та об’єкті SNMP
потенційно має доступ до багатьох контекстів. Поєднання contextEngineID і a
contextName однозначно визначає контекст у адміністративному домені. В
Повідомлення SNMPv3, contextEngineID і contextName включені як частина scopedPDU.
Усі методи, які генерують повідомлення SNMP, додатково приймають a --contextengineid та
--contextname аргумент для налаштування цих полів.

Ідентифікатор механізму контексту
Команда --contextengineid аргумент очікує шістнадцятковий рядок, що представляє бажаний
contextEngineID. Довжина рядка має бути від 10 до 64 символів (від 5 до 32 октетів).
мати необов'язковий префікс "0x". Одного разу --contextengineid вказано, що воно залишається
з об’єктом, доки він не буде змінено знову або не буде скинуто до стандартних, передавши в
невизначене значення. За замовчуванням contextEngineID налаштовано на відповідність
authoritativeEngineID повноважного механізму SNMP.

Назва контексту
ContextName передається як рядок, який має мати довжину від 0 до 32 октетів за допомогою
--contextname аргумент. ContextName залишається з об’єктом, доки його не буде змінено.
ContextName за замовчуванням порожній рядок, який представляє контекст "за замовчуванням".

На основі користувачів Безпека Model Аргументи

Модель безпеки на основі користувача (USM), яка використовується SNMPv3, вимагає, щоб SecurityName було
вказано за допомогою --ім'я користувача аргумент. Створення об’єкта Net::SNMP за допомогою
версії, встановленої на SNMPv3, не вийде, якщо --ім'я користувача аргумент відсутній. The --ім'я користувача
аргумент очікує рядок довжиною від 1 до 32 октетів.

Модель безпеки, орієнтована на користувача, дозволяє використовувати різні рівні безпеки
проблеми автентифікації та конфіденційності. Ціль SNMPv3 визначить рівень безпеки
(securityLevel) на основі того, який із наведених нижче аргументів указано.

За замовчуванням передбачається рівень безпеки "noAuthNoPriv". Якщо --authkey or
--authpassword параметри вказано, рівень безпеки стає «authNoPriv». The
--authpassword аргумент очікує рядок довжиною щонайменше 1 октет. Додатково
--authkey Аргумент може бути використаний так, що простий текстовий пароль не обов’язковий
зазначені в сценарії. The --authkey аргумент очікує шістнадцятковий рядок, створений
локалізація пароля з авторитетним ідентифікатором двигуна для конкретного призначення
пристрій. Утиліту "snmpkey", що входить до складу дистрибутива Net::SNMP, можна використовувати для
створити шістнадцятковий рядок (див. snmpkey).

SNMPv3 визначає два різні алгоритми хешування, які можуть використовуватися системою безпеки
Модель для аутентифікації. Це алгоритми HMAC-MD5-96 "MD5" (RFC 1321) і
HMAC-SHA-96 "SHA-1" (NIST FIPS PUB 180-1). Алгоритм за замовчуванням, який використовується модулем
HMAC-MD5-96. Цю поведінку можна змінити за допомогою --authprotocol аргумент. Це
очікує передачі рядка «md5» або «sha» для зміни хешу
алгоритм.

Вказавши аргументи --privkey or --privpassword рівень безпеки, пов’язаний з
об'єкт стає 'authPriv'. Відповідно до SNMPv3 конфіденційність вимагає використання
аутентифікація. Тому, якщо будь-який із цих двох аргументів присутній, і --authkey
or --authpassword аргументи відсутні, створення об'єкта не вдається. The --privkey
та --privpassword аргументи очікують того самого введення, що й --authkey та --authpassword
аргументи відповідно.

Модель безпеки на основі користувача, описана в RFC 3414, визначає єдиний протокол шифрування
для конфіденційності. Цей протокол, CBC-DES "DES" (NIST FIPS PUB 46-1), використовується
за замовчуванням або якщо рядок 'des' передається в --privprotocol аргумент. Працюючи з
Консорціум розширених параметрів безпеки http://www.snmp.com/eso/, модуль також
підтримує додаткові протоколи, які були визначені в проекті специфікацій. Проект
http://www.snmp.com/eso/draft-reeder-snmpv3-usm-3desede-00.txt визначає опору
CBC-3DES-EDE "Triple-DES" (NIST FIPS 46-3) у моделі безпеки на основі користувача. Це
протокол можна вибрати за допомогою --privprotocol аргумент із рядком '3desede'. The
проект http://www.snmp.com/eso/draft-blumenthal-aes-usm-04.txt описує використання
CFB128-AES-128/192/256 "AES" (NIST FIPS PUB 197) в USM. Три шифрування AES
протоколи, що відрізняються розміром ключа, можна вибрати, передавши 'aescfb128',
"aescfb192" або "aescfb256" до -привпротокол аргумент.

ПОДРОБИЦІ on фільтри
Метою фільтрів є визначення того, які інтерфейси прийняти, а які інтерфейси
відхилити. Це рішення приймається для кожного інтерфейсу шляхом оцінки виразу фільтра як a
фрагмент коду Perl і дослідження результату оцінки. Якщо правда, прийняти
інакше відхилити інтерфейс.

Працюючи з фільтрами, пам'ятайте, що Perl має власне уявлення про те, що правда, а що брехня
є. Порожній рядок "" і рядок "0" є false, усі інші рядки є true. Це
далі означає, що будь-яке ціле значення 0 є хибним, а також будь-яке значення undef. Він також
означає, що всі посилання вважаються правдивими.

Оскільки фільтр оцінюється як вираз Perl, у Perl є кілька корисних конструкцій
варто згадати:

Вирази можна згрупувати за допомогою круглих дужок "()". Вирази можна комбінувати
за допомогою логічних операторів, таких як:

"та " (еквівалент "&&")
Логічне "і" двох виразів є істинним, лише якщо обидва вирази істинні.
приклад: вираз1 та вираз2

"or" (еквівалент "||")
Логічне "або" двох виразів є істинним, якщо один або обидва вирази істинні.
приклад: вираз1 or вираз2

"НЕ" (еквівалент "!")
Логічне заперечення одного виразу. приклад: НЕ вираз . Ще один
приклад: !вираз

(Щоб дізнатися більше про це, я рекомендую книгу про Perl)

Наперед визначено фільтр Змінні

Для полегшення існує ряд попередньо визначених значень, доступних для використання у фільтрі.
Зауважте, що ці змінні також доступні, коли оцінюються інтерфейси шаблонів (але
не шаблони хостів).

Застереження: імена всіх цих змінних починаються зі знака долара ($), який є синтаксичним
вимога до скалярних змінних у Perl. Небезпека тут полягає в тому, що знак долара у багатьох
shells є активним символом (часто використовується для змінних оболонки, як і в Perl
змінні), тому важливо переконатися, що вираз Perl не обчислюється
оболонку командного рядка як код оболонки перед передачею в cfgmaker як командний рядок
аргументи. У оболонках, таких як Bourne shell, ksh shell або bash shell, розміщення всього
вираз в межах одного Qouts дозволить уникнути такого випадкового оцінювання:

'--if-filter=($default_iftype && $if_admin)'

$if_type
Це ціле число, що визначає тип інтерфейсу відповідно до стандартів SNMP і as
повідомляє опитуваний пристрій. Повний список типів інтерфейсів буде
це непрактично для цього документа, але нижче є кілька попередньо визначених змінних.
Зазвичай cfgmaker розміщує у верхній частині сторінки цілі це значення iftype у круглих дужках
після назви типу інтерфейсу. (наприклад, "propPointToPointSerial (22)").

Ось список деяких найпоширеніших типів інтерфейсів за номерами:

6 ethernetCsmacd
7 iso88023Csmacd
9 iso88025TokenRing
15 fddi
19 E1
20 базових ISDN
21 основний ISDN
22 propPointToPointSerial
23 ppp
24 програмне забезпечення Loopback
30 ds3
32 фрейм-реле
33 рупії 232
37 atm
39 сонет
44 frameRelayService
46 hssi
49 aal5
53 propVirtual
62 Fast Ethernet (100BaseT)
63 ISDN і X.25
69 Full Duplex Fast Ethernet (100BaseFX)
94 Асиметрична цифрова абонентська петля (ADSL)
117 Gigabit Ethernet
Підінтерфейс 134 ATM

$default
Правда тоді і тільки тоді, коли cfgmaker зазвичай має приймати інтерфейс, заснований на
інтерфейси адміністративного та робочого стану (приймання прапорів --ні вниз та
--show-op-down до уваги) і його тип (і кілька інших речей).

$default_ifstate
Правда тоді і тільки тоді, коли cfgmaker прийняв би інтерфейс, заснований на ньому
оперативно-адміністративних станів (також з урахуванням наявності в
прапори --ні вниз та --show-op-down).

$default_iftype
Правда тоді і тільки тоді, коли cfgmaker прийняв би інтерфейс на основі його типу (і
кілька додаткових деталей).

$if_admin
Правда тоді і тільки тоді, коли інтерфейс знаходиться в адміністративному стані.

$if_oper
Правда тоді і тільки тоді, коли інтерфейс знаходиться в робочому стані.

Кілька змінних також попередньо визначені, щоб легко вирішити, чи належить інтерфейс до a
певна категорія чи ні. Нижче наведено всі ті змінні, які разом із if_type
чисел, для яких кожна змінна буде істинною. Зверніть увагу, що деякі змінні посилаються на інші змінні
а.

$if_is_ethernet
Вірно для інтерфейсів Ethernet (№ 6, 7, 26, 62, 69 і 117).

$if_is_isdn
Вірно для різних типів інтерфейсів ISDN (№ 20, 21, 63, 75, 76 і 77)

$if_is_dialup
Вірно для комутованих інтерфейсів, таких як PPP, а також ISDN. (№ 23, 81, 82 і 108 дюймів
додаток до чисел $if_is_isdn).

$if_is_atm
Вірно для різних типів інтерфейсів, пов’язаних із банкоматами (№ 37, 49, 107, 105, 106, 114 та
134).

$if_is_wan
Вірно для інтерфейсів WAN точка-точка, Frame Relay і високошвидкісного послідовного (
22,32,44,46)

$if_is_lan
Вірно для інтерфейсів LAN (8, 9, 11, 15, 26, 55, 59, 60 і 115 на додаток до
числа $if_is_ethernet).

$if_is_dsl
Вірно для ADSL, RDSL, HDSL і SDSL (№ 94, 95, 96, 97)

$if_is_loopback
Вірно для програмних інтерфейсів петлі (№ 24)

$if_is_ciscovlan
Вірно для інтерфейсів Cisco VLAN (інтерфейси зі словом Vlan або VLAN у своїх
ifdescs)

$if_vlan_id
Повертає ідентифікатор vlan, пов’язаний із певним портом комутаторів Cisco Catalyst
Catalyst OS та IOS, а також комутатори 3Com. Якщо це не інтерфейс vlan, буде
повернення undef.

$if_cisco_trunk
Повертає стан транкінгу певного порту на комутаторах Cisco Catalyst під обома
ОС Catalyst та IOS. Повертає "1", якщо інтерфейс є транком, undef в іншому випадку.

$if_MTU
Повертає максимальну одиницю передачі, пов’язану з певним портом.

Крім того, ви також можете використовувати змінні, визначені для шаблонів нижче. Далі все
змінні, доступні в cfgmaker, доступні для сценаріїв, навіть якщо вони використовуються
функції не рекомендується. Більше «ярликів» у вигляді змінних і функцій буде
стане доступним у майбутньому.

прикладів on фільтри

Наведений нижче фільтр не вплине на те, які інтерфейси буде включено чи виключено
змусити cfgmaker працювати як зазвичай.

'--if-filter=$default'

Наступний фільтр змусить cfgmaker виключити інтерфейси PPP (23):

'--if-filter=$default && $if_type!=23'

Наступний фільтр змусить cfgmaker поводитися як зазвичай, за винятком того, що він враховуватиме
робочий стан інтерфейсу не має значення, але все одно відхиляє всі інтерфейси, які є
адміністративно вниз.

'--if-filter=$if_admin && $default_iftype'

ПОДРОБИЦІ on шаблони
Вміст файлів шаблонів оцінюється як програма на Perl. Число або Perl
змінні доступні програмі для читання, а інші використовуються для запису.

Оскільки досить багато попередньо визначених змінних мають значення, які мають використовуватися
HTML-код, деякі з них мають варіант "HTML-escaped", наприклад, $html_syslocation - це HTML
екранований варіант $syslocation. Екранування HTML означає, що символи "<", ">" і "&"
замінюються на "<", ">" і "&", а нові рядки, вбудовані в рядок,
з початком " " та додається пробілом (якщо новий рядок є останнім у
струна не чіпається).

Запис шаблон Змінні

Це змінні, доступні для зберігання рядків конфігурації. Деякі з них є
ініціалізовано перед оцінкою шаблону, але таким вмістом зазвичай є коментарі
для включення в остаточний файл конфігурації, щоб ці змінні могли бути скинуті до
порожній рядок у коді шаблону, щоб видалити коментарі. Є й зворотний шлях
можливо, вміст цих змінних може бути розширено додатковою інформацією для
різні причини, такі як налагодження тощо.

Після того, як шаблон було оцінено, відбувається наступне: якщо шаблон є a
шаблон інтерфейсу, а фактичний інтерфейс з певних причин відхиляється, тому його потрібно
бути закоментованим, усі рядки у змінній $target_lines перетворюються на коментарі
додаючи на їх початку знак решітки ("#"). Потім усі змінні $head_lines,
$problem_lines , $target_lines та $separator_lines об’єднані разом, щоб утворити
рядків для додавання до файлу конфігурації.

$target_lines
Ця змінна є заповнювачем для рядків конфігурації, створених шаблоном.
$target_lines попередньо визначено як порожнє під час оцінки коду шаблону.

$head_lines
Ця змінна призначена як заповнювач для рядка коментаря, який щойно з’являється
перед метою у файлі конфігурації. Він ініціалізується цим рядком коментаря
перед оцінкою коду шаблону та якщо шаблон не змінюється
$head_lines під час оцінювання коментар виглядатиме як зазвичай у файлі конфігурації.

$problem_lines
Ця змінна призначена як заповнювач для рядків коментарів, що описують будь-які
проблеми, які могли виникнути під час спроби додати ціль до
конфігурація. Для шаблонів хостів він зазвичай не використовується, а для тих – це
попередньо визначений як порожній рядок. Для шаблонів інтерфейсу $problem_lines є попередньо визначеним
з коментарями до опису помилки, які cfgmaker зазвичай використовує для відхилених
інтерфейси або як порожній рядок для прийнятих інтерфейсів.

Можна протестувати проти $problem_lines щоб дізнатися, чи буде інтерфейс
включено або відхилено, але це не рекомендується. Тест проти $if_ok замість цього.

$separator_lines
Ця змінна є заповнювачем для рядка, який використовується як роздільник між
код для окремих цілей. Вміст цієї змінної розміщується після кожної мети
(тому рядки також з’являтимуться після кінця останньої цілі в конфігурації).

Наперед визначено шаблон Змінні

Усі наведені нижче змінні доступні для використання в шаблонах інтерфейсу. Для шаблонів хостів
доступні лише ті, які перераховані в розділі «Змінні хоста та системи».

Для шаблонів інтерфейсу також є змінні, перелічені в розділі «Попередньо визначені змінні фільтра».
в наявності.

Господар та SYSTEM Змінні

$router_name
Це повна назва маршрутизатора. На це впливає наступне
елементи в командному рядку: сама назва маршрутизатора і --dns-домен.

$router_connect
Це еталонний рядок для опитуваного маршрутизатора. Це на формі
community@router, можливо, за яким слідують деякі параметри snmp. На нього впливає
наступні елементи в командному рядку: сама назва маршрутизатора, --спільнота,
--snmp-параметри та --dns-домен. (Немає доступного екранованого варіанту HTML)

$directory_name
Ця змінна має містити назву каталогу, яку cfgmaker зазвичай використовує як
значення для директиви "Directory[]". Значення визначається --підкаталоги
параметр командного рядка. Якщо --підкаталоги не вказано $directory_name буде порожнім
рядок. (Немає доступного екранованого варіанту HTML)

$syscontact
Ця змінна є значенням SNMP sysContact маршрутизатора. (Екранований варіант HTML:
$html_syscontact)

$ sysname
Ця змінна є значенням sysName SNMP маршрутизатора. (Немає доступного екранованого варіанту HTML)

$syslocation
Ця змінна є значенням sysLocation SNMP маршрутизатора. (Екранований варіант HTML:
$html_syslocation)

$sysdescr
Ця змінна є значенням SNMP sysDescr маршрутизатора. Зазвичай не використовується
cfgmaker, але може бути корисним у шаблоні. (Екранований варіант HTML: $html_sysdescr)

інтерфейс Мета споріднений Змінні

$target_name
Це те, що cfgmaker зазвичай використовує як назву цілі. Ціль
name - це те, що міститься в квадратних дужках, "[]", для цільових директив.
(Немає доступного екранованого варіанту HTML)

$if_ref
Це еталонний рядок для інтерфейсу. Очікується, що він буде використовуватися в
Директива "Target[xyz]", щоб визначити, який інтерфейс використовувати. Значення цього
на змінну впливає --ifref параметр командного рядка. Зазвичай використовується разом
з $router_connect. (Немає доступного екранованого варіанту HTML)

$if_ok
Ця змінна має значення true, якщо інтерфейс буде включено до конфігурації
файл, інакше false. Не перевіряйте інші змінні, наприклад $problem_lines до
скористайтеся цим, щоб дізнатися, чи буде інтерфейс відхилено чи ні $if_ok замість цього.

$default_target_lines
Ця змінна містить усі цільові рядки, які cfgmaker за замовчуванням виводить для цього
інтерфейс. Це корисно, якщо ви хочете мати «стандартну ціль», але хочете додати її
додаткові рядки до нього за допомогою шаблону.

За замовчуванням cfgmaker використовує наступні директиви для кожної створеної цілі: Target[],
SetEnv[], MaxBytes[], Title[], PageTop[] і, якщо вказано будь-який каталог, також
Директива Directory[].

Щоб полегшити створення шаблонів, які генерують схожі цільові конфігурації
до типового, кожен із зазначених вище рядків директиви має відповідник
змінна, що містить рядок як cfgmaker, виведе його за замовчуванням.

Зверніть увагу, що жоден із них не має екранованого варіанту HTML, текст у них є екранованим HTML, де
необхідний. Також зауважте, що вони не мають нового рядка в кінці.

$default_target_directive
Ця змінна містить стандартний рядок для рядка директиви Target[].

$default_setenv_directive
Ця змінна містить стандартний рядок для рядка директиви SetEnv[].

$default_directory_directive
Ця змінна містить типовий рядок для рядка директиви Directory[], який
означає, що це порожній рядок (без нового рядка), якщо немає каталогу.

$default_maxbytes_directive
Ця змінна містить стандартний рядок для рядка директиви MaxBytes[].

$default_title_directive
Ця змінна містить типовий рядок для рядка директиви Title[].

$default_pagetop_directive
Ця змінна містить стандартний рядок для рядків директиви PageTop[].

інтерфейс мережу конфігурація Змінні

$if_ip
Ця змінна повинна містити IP-адресу інтерфейсу, якщо такий був призначений
до нього. (Немає доступного екранованого варіанту HTML)

$ifindex
Ця змінна є SNMP ifIndex для інтерфейсу, який за визначенням завжди є an
ціле число. (Немає доступного екранованого варіанту HTML)

$if_index
Еквівалент с $ifindex.

$if_eth
Містить адресу Ethernet інтерфейсу, якщо такий є. (Немає екранованого коду HTML
доступний варіант)

$if_speed
Ця змінна є швидкістю в байтах/секунду (з префіксами). (Немає екранованого коду HTML
доступний варіант)

$if_speed_str
Ця змінна є приготованим описом швидкості, залежно від біт або байтів
незалежно від того, чи активна опція bits, а також з відповідним префіксом для
швидкість (k, M, G тощо). (Немає доступного екранованого варіанту HTML)

$if_type_desc
Ця змінна є текстовим описом типу інтерфейсу. (Екранований варіант HTML:
$html_if_type_desc)

$if_type_num
Ця змінна ціле значення, що відповідає типу інтерфейсу (для лістингу для
значення для більш поширених типів інтерфейсів див. у розділі ДЕТАЛІ ПРО ФІЛЬТРИ
вище). (Немає доступного екранованого варіанту HTML)

$if_dns_name
Це DNS-ім’я інтерфейсу. (Немає доступного екранованого варіанту HTML)

інтерфейс найменування, Опис та кличка Змінні

Це може здатися незрозумілим для обох ІМ'Я, Опис та кличка у цьому контексті й деяким
мірою це є. ІМ'Я та Опис зазвичай підтримуються на більшості обладнання, але як вони
використовуються різні, як між виробниками, так і між різними категоріями
обладнання від того ж виробника. The кличка принаймні підтримується Cisco IOS, і
ця змінна містить те, що використовується в операторі IOS під назвою "опис" для
інтерфейс (не плутати зі змінними SNMP для Опис).

Для кращого керування з командного рядка розгляньте $if_title_desc який вміст
контролюється --if-descr параметр командного рядка.

$if_snmp_descr
Ця змінна повинна містити «необроблений» опис інтерфейсу, визначений
опитування SNMP маршрутизатора. (Екранований варіант HTML: $html_if_snmp_descr)

$if_snmp_name
"Сире" ім'я для інтерфейсу, надане опитуванням SNMP. (Екранований варіант HTML:
$html_if_snmp_name)

$if_snmp_alias
"Необроблений" псевдонім ifAlias ​​для інтерфейсу, який надається опитуванням SNMP. (HTML втік
варіант: $html_if_snmp_alias)

$if_cisco_descr
«Необроблений» CiscolocIfDescr для інтерфейсу, який надається опитуванням SNMP. (HTML
зниклий варіант: $html_if_cisco_descr)

$if_description
Це «приготований» рядок опису для інтерфейсу з урахуванням
Знайдено значення SNMP для RDescr, ifAlias ​​і CiscolocIfDescr інтерфейсу. (HTML
зниклий варіант: $html_if_description)

$if_title
Повний рядок cfgmaker за замовчуванням використовував би для директиви Title[] у
конфігурації, а також вміст самого верхнього тегу H1 у PageTop[]. Є
складається за змістом $desc_prefix, $if_title_desc та $ sysname.

As $if_title залежить від $if_title_desc, можна опосередковано контролювати $if_title
за допомогою параметра командного рядка --if-descr.

(Екранований варіант HTML: $html_if_title)

$if_port_name
Якщо хостом є комутатор локальної мережі Cisco Catalyst, ця змінна є назвою цього порту.
(Немає доступного екранованого варіанту HTML)

$if_pp_port_name
Якщо хостом є комутатор LAN Nortel Passport, ця змінна є назвою цього порту.
(Немає доступного екранованого варіанту HTML)

$desc_prefix
Ця змінна є префіксом опису того, що ціль має використовуватися в
Директива "Title[]" і в розділі H1 "PageTop[]". За замовчуванням: "Трафік
аналіз для ". (Екранований варіант HTML: $html_desc_prefix)

$if_title_desc
Це опис інтерфейсу, який зазвичай використовує cfgmaker як частину
змінна $if_title. Останній використовується як повний рядок у директиві "Title[]".
і розділ H1 у верхній частині сторінки [].

$if_title_desc керується параметром командного рядка --if-descr які опосередковано
контролює вміст $if_title

(Екранований варіант HTML: $html_if_title_desc)

Документи Функції та цінності шаблони

Наведені нижче функції існують для полегшення написання шаблонів хоста та інтерфейсу.

html_escape(рядок)
html_escape() приймає рядок як аргумент і повертає новий рядок, де
зроблено наступні заміни: символи "<", ">" і "&" замінені на
"<", ">" і "&", а нові рядки, вбудовані в рядок, починаються з
" " та додається символом пробілу (нові рядки в кінці рядка не є
торкнувся).

oid_pick($router_connect,$v3opt,"oid1","oid2"...)
Ця функція намагатиметься опитувати кожен із зазначених oid, доки це не буде успішним або
вичерпалися оїди. Він поверне назву першого oid, який спрацював, або undef if
це не вдало

Приклад шаблон Файли

Приклад шаблону 1: Усунення відхилених цілей від появи

Цей файл шаблону генерує точно такий же код конфігурації для кожного інтерфейсу, що й cfgmaker
робить за замовчуванням, за винятком того, що він усуває всі рядки (коментарі, а також
код конфігурації) для інтерфейсу, якщо інтерфейс буде відхилено.

якщо (не $problem_lines)
{
$target_lines .= <

Ціль [$target_name]: $if_ref:$router_connect
SetEnv[$target_name]: MRTG_INT_IP="$if_ip" MRTG_INT_DESCR="$if_snmp_descr"
ECHO

if ($directory_name) {
$target_lines .= "Каталог[$target_name]: $directory_name\n";
}

$target_lines .= <
MaxBytes[$target_name]: $if_speed
Назва[$target_name]: $html_desc_prefix$html_if_title_desc -- $sysname
Верх сторінки[$target_name]: $html_desc_prefix$html_if_title_desc -- $sysname



система:
$sysname у $html_syslocation


Супроводжувач:
$html_syscontact


опис:
$html_if_description


ifType:
$html_if_type_desc ($if_type_num)


ifName:
$html_if_snmp_name

ECHO

$target_lines .= <

Назва порту:
$if_port_name

ECHO

$target_lines .= <

Назва порту:
$if_pp_port_name

ECHO

$target_lines .= <

Максимальна швидкість:
$if_speed_str

ECHO

$target_lines .= <

Ip:
$if_ip ($if_dns_name)

ECHO

$target_lines .= <


ECHO
} Ще {
$head_lines="";
$problem_lines="";
$target_lines="";
$separator_lines="";
}

шаблон Приклад 2: простіше версія of Приклад 1

Приклад 1 частково мав на меті продемонструвати, як налаштувати генерацію інтерфейсу
цілі, а також надати підказку про те, як змінні використовуються в шаблоні "за замовчуванням".
який, як можна вважати, зазвичай використовує cfgmaker.

Якщо вас цікавить лише найпростіший спосіб повного усунення цих відхилень
інтерфейсів, наведений нижче шаблон також виконає цю роботу за допомогою $default_target_lines.

if($if_ok) {
$target_lines = $default_target_lines;
} Ще {
$head_lines="";
$problem_lines="";
$target_lines="";
$separator_lines="";
}

шаблон Приклад 3: створення центральний процесор Цілі та цінності хости

Нижче наведено приклад шаблону хосту.

$head_lines .= <
#------------------------------------------------ --------------------
ECHO

my $target_name = $router_name . ".ЦП";

$target_lines .= <

YLegend[$target_name]: завантаження ЦП у відсотках
ShortLegend[$target_name]: %
Легенда1[$target_name]: навантаження ЦП у %
Легенда2[$target_name]:
Легенда3[$target_name]: максимальне спостережене навантаження на ЦП
Легенда4[$target_name]:
LegendI[$target_name]: навантаження ЦП:
LegendO[$target_name]:
WithPeak[$target_name]: ywm
MaxBytes[$target_name]: 100
Параметри [$target_name]: growright, gauge, nopercent
Назва[$target_name]: $router_name навантаження ЦП
Ціль [$target_name]: 1.3.6.1.4.1.9.2.1.58.0&1.3.6.1.4.1.9.2.1.58.0:$router_connect
Верх сторінки[$target_name]: $router_name навантаження ЦП



система:
$router_name у $html_syslocation


Супроводжувач:
$html_syscontact


опис:
$html_sysdescr


ресурс:
ЦП.



ECHO

ПРИКЛАДИ

У першому прикладі створюється файл конфігурації для router.place.xyz: маршрутизатор має
Ім'я співтовариства громадськість. Інтерфейси ідентифікуються за їх IP-номером. Два глобальних варіанти
бути доданим до файлу конфігурації. Файл конфігурації буде перенаправлено mrtg.conf. "\"
знаки в кінці рядка означають, що ця команда повинна бути написана в одному рядку.

cfgmaker --global "Робочий каталог: /home/tobi" \
--global "Параметри[_]: growright,bits" \
--ifref=ip \
[захищено електронною поштою] > mrtg.cfg

Примітка: якщо cfgmaker не на вашому шляху, але ви перебуваєте в каталозі, де знаходиться cfgmaker
збережено, ви можете запустити його за допомогою ./cfgmaker

У наступному прикладі створюється файл конфігурації для чотирьох пристроїв: router1.place.xyz,
router2.place.xyz, switch1.place.xyz та switch2.place.xyz все з громадою громадськість.

Два маршрутизатори матимуть --ifref встановлений в Descr у той час як використовуватимуться два перемикачі --ifref
встановлений в ім'я. Далі маршрутизатори будуть використовувати --ifdesc встановлений в псевдонім та switch1.place.xyz
буде використовувати --ifdesc встановлений в Descr в той час як switch2.place.xyz використання ім'я замість цього.

Нарешті, у конфігурацію буде вставлено два рядки параметрів: один буде в
початок, а інший буде вставлено після рядків, пов’язаних із двома маршрутизаторами
але перед тими рядками, які стосуються перемикачів.

cfgmaker --global "Робочий каталог: /home/tobi" \
--global "Параметри[_]: growright,bits" \
--ifref=descr \
--ifdesc=псевдонім \
[захищено електронною поштою] \
[захищено електронною поштою] \
--global "Параметри[_]: growright" \
--ifref=назва \
--ifdesc=descr \
[захищено електронною поштою] \
--ifdesc=назва \
[захищено електронною поштою] > mrtg.cfg

Наступний приклад демонструє, як використовувати --спільнота, --snmp-параметри та --dns-домен
щоб спростити командний рядок. Усім обладнанням користуватиметься громада прихований, За винятком
для ppp-сервера, який використовує спільноту доступ. Все обладнання використовує такі параметри SNMP: 1s
Тайм-аут, 1 повторити спробу та SNMP версія 2 (відступаємо та порт не вказано, які засоби вони використовують
значення за замовчуванням). Винятком знову є ppp-сервер, який використовує SNMP версія 1.
Нарешті, все обладнання є частиною домену place.xyz, за винятком ppp-сервера
який є частиною домену remote.place.xyz. Зауважте, що останнє досягається просто
вказавши назву ppp-сервера, який буде використовуватися ppp-сервер.віддалений .

cfgmaker --global "Робочий каталог: /home/tobi" \
--global "Параметри[_]: growright,bits" \
--dns-domain=place.xyz \
--community=hidden \
--snmp-options=::1:1::2 \
роутер1 \
роутер2 \
роутер3 \
роутер4 \
роутер5 \
перемикач1 \
перемикач2 \
перемикач3 \
перемикач4 \
перемикач5 \
перемикач6 \
перемикач7 \
[захищено електронною поштою]:::::1 > mrtg.cfg

Використовуйте cfgmaker онлайн за допомогою сервісів onworks.net