cfgmaker - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

cfgmaker - Tạo tập tin mrtg.cfg (cho mrtg-2.17.4)

SYNOPSIS

cfgmaker [tùy chọn] [cộng đồng@]bộ định tuyến [[tùy chọn] [cộng đồng@]bộ định tuyến ...]

LỰA CHỌN

--ifref=name tham chiếu giao diện theo Tên giao diện (mặc định)
--ifref=ip ... theo địa chỉ IP
--ifref=eth ... theo số Ethernet
--ifref=descr ... theo Mô tả Giao diện
--ifref=nr ... theo số giao diện
--ifref=type ... theo loại giao diện
Bạn cũng có thể sử dụng nhiều tùy chọn được phân tách bằng dấu phẩy,
trong trường hợp đó cái có sẵn đầu tiên được sử dụng:
ví dụ --ifref=ip,name,nr

--ifdesc=nr mô tả giao diện sử dụng Số giao diện (mặc định)
--ifdesc=ip ... sử dụng Địa chỉ IP
--ifdesc=eth ... sử dụng Số Ethernet
--ifdesc=descr ... sử dụng Mô tả Giao diện
--ifdesc=name ... sử dụng Tên giao diện
--ifdesc=catname ... sử dụng Tên giao diện CatOS
--ifdesc=ppname ... sử dụng Tên cổng hộ chiếu
--ifdesc=alias ... sử dụng Bí danh giao diện
--ifdesc=type ... sử dụng Loại giao diện
Bạn cũng có thể sử dụng nhiều tùy chọn được phân tách bằng dấu phẩy,
trong trường hợp đó cái có sẵn đầu tiên được sử dụng:
ví dụ --ifdesc=catname,ppname,descr,alias,ip,name,nr

--if-filter=f Kiểm tra mọi giao diện dựa trên bộ lọc f để quyết định thời tiết
hoặc không đưa giao diện đó vào bộ sưu tập.
Hiện tại f đang được đánh giá dưới dạng biểu thức Perl
và giá trị thật của nó được sử dụng để từ chối hoặc chấp nhận
diệnngười dùng.
(Thử nghiệm, đang phát triển, có thể thay đổi)

--if-template=tệp mẫu
Thay thế các mục tiêu bình thường cho các giao diện
với một mục được chỉ định bởi nội dung trong tệp
tệp mẫu. Tệp này được cho là chứa Perl
mã được thực thi để tạo ra các dòng cho
target trong tập tin cấu hình.
(Thử nghiệm, đang phát triển, có thể thay đổi)

--host-template=tập tin mẫu
Ngoài việc tạo mục tiêu cho giao diện của máy chủ
cũng tạo mục tiêu cho chính máy chủ như đã chỉ định
theo nội dung trong tệp templatefile. Tập tin này là
được cho là chứa mã Perl sẽ được thực thi để tạo ra
các dòng dành cho các mục tiêu liên quan đến máy chủ (chẳng hạn như CPU,
đo thời gian phản hồi ping, v.v.) trong cấu hình-
tập tin uration.
(Thử nghiệm, đang phát triển, có thể thay đổi)

--global "x: a" thêm các mục cấu hình chung

--no-down không nhìn vào trạng thái quản trị viên hoặc opr của giao diện

--show-op-down hiển thị các giao diện đang hoạt động không hoạt động

--zero-speed=spd sử dụng tốc độ này tính bằng bit trên giây làm giao diện
tốc độ cho tất cả các giao diện trả về tốc độ 0
thông qua ifSpeed/ifHighSpeed. 100Mbps = 100000000

--subdirs=format cung cấp cho mỗi bộ định tuyến thư mục con riêng, đặt tên cho mỗi bộ định tuyến
"định dạng", trong đó HOSTNAME và SNMPNAME sẽ là
được thay thế bằng giá trị của các mục đó -- ví dụ:
--subdirs=HOSTNAME hoặc --subdirs="HOSTNAME (SNMPNAME)"

--noreversedns không đảo ngược số ip tra cứu

--community=cmty Đặt chuỗi cộng đồng mặc định thành "cmty" thay vì
"công cộng".

--enable-ipv6 Kích hoạt hỗ trợ IPv6, nếu các thư viện được yêu cầu
hiện tại. Địa chỉ IPv6 dạng số phải được kèm theo
trong ngoặc vuông, ví dụ public@[2001:760:4::1]:161

--use-16bit Sử dụng ID yêu cầu SNMP 16bit để truy vấn tất cả các bộ định tuyến.

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

Chỉ định các tùy chọn SNMP mặc định sẽ được thêm vào tất cả
các bộ định tuyến theo sau. Các trường riêng lẻ có thể trống.
Các bộ định tuyến sau đây có thể ghi đè một số hoặc tất cả các
các tùy chọn được cung cấp cho --snmp-options.

--dns-domain=miền
Chỉ định một miền để gắn vào tên của tất cả
các bộ định tuyến theo sau.

--nointerfaces Không tạo bất kỳ dòng cấu hình nào cho giao diện,
bỏ qua bước thu thập thông tin giao diện và
không chạy bất kỳ mã mẫu giao diện nào.

--interfaces Tạo dòng cấu hình cho giao diện (đây là
mặc định). Mục đích chính của tùy chọn này là phủ nhận
một --nointerfaces xuất hiện trước đó trên dòng lệnh.

- thông báo trợ giúp ngắn gọn
--man tài liệu đầy đủ
--version in phiên bản của cfgmaker

--output=file tên file đầu ra mặc định là STDOUT

MÔ TẢ

Cfgmaker tạo các tệp cấu hình MRTG dựa trên thông tin được lấy từ bộ định tuyến hoặc
một thiết bị có thể quản lý SNMP khác.

[cộng đồng@]Router

Cộng đồng là tên cộng đồng của thiết bị bạn muốn tạo cấu hình. Nếu như
không được chỉ định, nó mặc định là 'công khai'; bạn có thể muốn thử cái này trước nếu bạn không
biết tên cộng đồng của một thiết bị. Nếu bạn sử dụng sai tên cộng đồng, bạn sẽ
không nhận được phản hồi từ thiết bị.

bộ định tuyến là tên DNS hoặc số IP của thiết bị có thể quản lý SNMP. Theo tên
bạn có thể chỉ định thêm 6 tùy chọn được phân tách bằng dấu hai chấm. Cú pháp đầy đủ trông như thế này:

Router[: [Sẵn sàng] [: [tmout] [: [rút lui] [: [rút lui] [:đến]]]]]

Quan tâm đặc biệt có thể là tham số cuối cùng, đến. Nếu bạn đặt giá trị này thành '2' thì
thiết bị sẽ được truy vấn với các yêu cầu SNMP phiên bản 2. Điều này cho phép bạn thăm dò 64 bit
bộ đếm lưu lượng trong thiết bị và do đó sẽ hoạt động tốt hơn nhiều với các giao diện nhanh (không
tràn bộ đếm nhiều hơn). Lưu ý rằng thứ tự các bộ định tuyến được chỉ định trên
dòng lệnh rất quan trọng vì thứ tự tương tự được sử dụng khi tạo tệp cấu hình.
Bộ định tuyến được chỉ định đầu tiên có các dòng cấu hình được tạo đầu tiên, tiếp theo là
các dòng thuộc về bộ định tuyến tiếp theo, v.v.

Lưu ý rằng dòng đầu tiên của tệp cfg được tạo sẽ chứa tất cả dòng lệnh
các tùy chọn bạn đã sử dụng để tạo nó. Điều này cho phép 'tái tạo' dễ dàng trong trường hợp
bạn muốn thêm máy chủ mới hoặc thực hiện một số thay đổi toàn cầu khác.

Cấu hình
Ngoại trừ - đầu ra và --toàn cầu tùy chọn, tất cả các tùy chọn chỉ ảnh hưởng đến bộ định tuyến
theo dõi họ trên dòng lệnh. Nếu một tùy chọn được chỉ định trước đó trên dòng lệnh
xuất hiện lại sau trên dòng lệnh với một giá trị khác, giá trị mới sẽ ghi đè giá trị cũ
giá trị liên quan đến các bộ định tuyến còn lại. Bằng cách này, các tùy chọn có thể được điều chỉnh cho
nhóm bộ định tuyến hoặc cho từng bộ định tuyến.

Xem - đầu ra và --toàn cầu hành vi của họ bị ảnh hưởng như thế nào bởi ở đâu và bao nhiêu lần
chúng xuất hiện trên dòng lệnh.

Xem Các ví dụ bên dưới về cách đặt tùy chọn khác nhau cho nhiều bộ định tuyến.

--Cứu giúp
In một thông báo trợ giúp ngắn gọn và thoát.

--Đàn ông
In trang hướng dẫn sử dụng và thoát.

--phiên bản
In phiên bản của cfgmaker. Phiên bản này phải phù hợp với phiên bản MRTG dành cho cấu hình nào
các tập tin đang được tạo.

--ifref nr|ip|đạo đức|sự mô tả|tên
Chọn phương pháp nhận dạng giao diện. Mặc định là nr xác định bộ định tuyến
giao diện theo số lượng của họ. Thật không may, sơ đồ đánh số giao diện trong SNMP
cây có thể thay đổi Một số bộ định tuyến thay đổi cách đánh số khi thêm giao diện mới,
những người khác thay đổi cách đánh số vào mỗi dịp trăng tròn chỉ để cho vui.

Để giải quyết vấn đề đáng buồn này, MRTG có thể xác định giao diện bằng 4 thuộc tính khác.
Không có cái nào trong số này hoạt động cho tất cả các giao diện, nhưng bạn sẽ có thể tìm thấy một giao diện phù hợp
tốt cho bạn. Lưu ý rằng các địa chỉ ethernet đặc biệt có thể có vấn đề vì một số
bộ định tuyến có cùng địa chỉ ethernet trên hầu hết các thẻ giao diện của chúng.

Chọn ip để xác định giao diện bằng số IP của nó. Sử dụng đạo đức sử dụng ethernet
địa chỉ để nhận dạng. Sử dụng sự mô tả để sử dụng mô tả Giao diện. Hoặc dùng tên đến
sử dụng tên Giao diện.

Bạn có thể chỉ định nhiều thuộc tính nếu muốn, cách nhau bằng dấu phẩy. Trong trường hợp này,
cfgmaker sẽ sử dụng mục đầu tiên trong danh sách có thể cung cấp nhận dạng duy nhất.
Điều này cho phép bạn chỉ định, ví dụ, sử dụng địa chỉ IP và sử dụng ifName nếu điều này
không được xác định:
--ifref ip, tên

Nếu phương pháp bạn đã chọn không cho phép nhận dạng giao diện duy nhất trên thiết bị thì bạn
đang truy vấn, nhà sản xuất cfg sẽ cho bạn biết về nó.

--ifdesc nr|ip|đạo đức|sự mô tả|tên|kiểu|bí danh
Chọn nội dung sẽ sử dụng làm mô tả giao diện. Mô tả xuất hiện trong
thuộc tính "Title[]" cho mục tiêu cũng như tiêu đề văn bản trong mã HTML
được xác định trong "PageTop[]" của mục tiêu. Mặc định là sử dụng nr đó chỉ là giao diện
số không phải lúc nào cũng hữu ích cho người xem biểu đồ.

Có 6 thuộc tính khác có thể được sử dụng. Sử dụng ip nếu bạn muốn sử dụng
địa chỉ IP của giao diện. Sử dụng đạo đức nếu bạn muốn sử dụng địa chỉ ethernet của giao diện.
Nếu bạn muốn mô tả tốt hơn, bạn có thể sử dụng một trong hai sự mô tả, tên or bí danh. Chính xác
công việc của mỗi thứ này sẽ khác nhau giữa các thiết bị khác nhau, vì vậy bạn có thể cần phải
cuộc thí nghiệm. Chẳng hạn, đối với giao diện nối tiếp trên bộ định tuyến Cisco chạy iOS bằng cách sử dụng
tên có thể dẫn đến "S0" là mô tả giao diện, sự mô tả có thể dẫn đến
"Nối tiếp0" và bí danh có thể dẫn đến "Liên kết tới HQ" (với điều kiện đó là nội dung được sử dụng làm
"mô tả" của giao diện trong cấu hình của bộ định tuyến).

Cuối cùng, nếu bạn muốn mô tả giao diện bằng Btype (tức là "ethernetCSMA",
"propPointtoPoint", v.v.), bạn có thể sử dụng kiểu.

Bạn có thể chỉ định nhiều thuộc tính nếu muốn, cách nhau bằng dấu phẩy. Trong trường hợp này,
cfgmaker sẽ sử dụng mục đầu tiên trong danh sách có sẵn cho giao diện này.
Điều này cho phép bạn chỉ định, ví dụ, sử dụng bất kỳ bí danh nào khác theo thứ tự
ưu tiên.

--if-lọc 'bộ lọc-biểu thức'
Trước hết, đây là một số phát triển và đang thử nghiệm.

Hãy sử dụng tính năng này nếu bạn muốn kiểm soát tốt hơn những giao diện nào được đưa vào
Cấu hình. Các bộ lọc-biểu thức được đánh giá như một đoạn mã Perl và được
mong đợi sẽ trả về một giá trị thật. Nếu đúng, hãy bao gồm giao diện và nếu sai,
loại trừ giao diện.

Để thảo luận thêm về cách hoạt động của các bộ lọc này, hãy xem phần "Chi tiết về
Bộ lọc" bên dưới.

--if-mẫu tệp mẫu
Trước hết, đây là một số phát triển và đang thử nghiệm.

Sử dụng điều này nếu bạn muốn kiểm soát dòng cho mỗi mục tiêu sẽ trông như thế nào trong
tập tin cấu hình. Nội dung của tập tin tệp mẫu sẽ được đánh giá là
Chương trình Perl tạo ra các dòng sử dụng các biến nhất định cho đầu vào và đầu ra.

Để thảo luận thêm về cách các mẫu này hoạt động, hãy xem phần "Chi tiết về
Mẫu" bên dưới.

--mẫu máy chủ tệp mẫu
Trước hết, đây là một số phát triển và đang thử nghiệm.

Sử dụng điều này nếu bạn muốn có thêm một số mục tiêu liên quan đến chính máy chủ như CPU
mức sử dụng, thời gian phản hồi ping đến máy chủ, số lượng modem bận, v.v. Nội dung
của tập tin tệp mẫu sẽ được đánh giá một lần trên mỗi máy chủ dưới dạng chương trình Perl
tạo ra các dòng sử dụng các biến nhất định cho đầu vào và đầu ra.

Để thảo luận thêm về cách các mẫu này hoạt động, hãy xem phần "Chi tiết về
Mẫu" bên dưới.

--cộng đồng chuỗi cộng đồng
Sử dụng tính năng này để thiết lập cộng đồng cho các bộ định tuyến theo dòng lệnh thành
chuỗi cộng đồng. Các bộ định tuyến riêng lẻ có thể ghi đè chuỗi cộng đồng này bằng cách sử dụng
cú pháp cộng đồng @ bộ định tuyến.

--enable-ipv6
Tùy chọn này cho phép hỗ trợ IPv6. Nó yêu cầu các mô-đun Perl thích hợp; nếu họ
không tìm thấy thì IPv6 bị vô hiệu hóa (xem tài liệu ipv6).

cfgmaker sẽ sử dụng IPv6 hoặc IPv4 tùy theo mục tiêu. Nếu mục tiêu là số
địa chỉ, giao thức phụ thuộc vào loại địa chỉ. Nếu mục tiêu là tên máy chủ,
cfgmaker sẽ cố gắng phân giải tên trước tiên thành địa chỉ IPv6 sau đó thành IPv4
địa chỉ nhà.

Địa chỉ số IPv6 phải được chỉ định giữa các dấu ngoặc vuông.

Ví dụ:

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

Nếu mục tiêu có cả địa chỉ IPv6 và địa chỉ IPv4 có cùng tên máy chủ,
Trước tiên, cfgmaker truy vấn mục tiêu bằng IPv6 và quay lại IPv4 nếu thất bại. Cái này
rất hữu ích cho các mục tiêu không hỗ trợ SNMP qua IPv6.

--use-16bit
Tùy chọn này buộc sử dụng ID yêu cầu SNMP 16 bit. Một số tác nhân SNMP bị hỏng không
chấp nhận ID yêu cầu 32 bit. Cố gắng tránh tùy chọn này càng nhiều càng tốt, khiếu nại với
thay vào đó là nhà cung cấp đại lý của bạn.

--snmp-tùy chọn :[cổng] [: [thời gian chờ] [: [thử lại] [: [rút lui] [:phiên bản]]]]
Sử dụng tùy chọn này để đặt các tùy chọn SNMP mặc định cho tất cả các bộ định tuyến theo lệnh
đường kẻ. Các giá trị riêng lẻ cũng như dấu hai chấm cuối cùng có thể bị bỏ qua. Lưu ý rằng
bộ định tuyến có thể ghi đè các giá trị riêng lẻ (hoặc tất cả) được chỉ định bởi --snmp-tùy chọn bằng cách sử dụng
cú pháp

Router[: [cổng] [: [thời gian chờ] [: [thử lại] [: [rút lui] [:phiên bản]]]]]

--toàn cầu "bla: abc"
Sử dụng điều này để thêm các tùy chọn chung vào tệp cấu hình được tạo. Bạn có thể gọi --toàn cầu
nhiều lần để thêm nhiều tùy chọn. Dòng này sẽ chỉ xuất hiện trong cấu hình
trước khi cấu hình cho bộ định tuyến tiếp theo xuất hiện trên dòng lệnh.

--global "workdir: /home/mrtg"

Nếu bạn muốn một số Tùy chọn mặc định, bạn có thể muốn đặt

--global "options[_]: Growright,bit"

Chỉ định --toàn cầu sau bộ định tuyến cuối cùng trên dòng lệnh sẽ tạo một dòng trong
tệp cấu hình sẽ xuất hiện sau tất cả các bộ định tuyến.

--noreversedns
Đừng cố gắng đảo ngược số IP tra cứu... điều bắt buộc đối với môi trường không có DNS.

--Không xuống
Thông thường cfgmaker sẽ không bao gồm các giao diện được đánh dấu bất cứ thứ gì ngoại trừ
UP về mặt hành chính và vận hành. Với công tắc này, bạn sẽ có được tất cả.

--show-op-down
Bao gồm các giao diện đang hoạt động.

--không tốc độ tốc độ
Chỉ định tốc độ này tính bằng bit trên giây cho tất cả các giao diện trả về 0 cho ifSpeed ​​và
ifHighSpeed. Một số công tắc, đặc biệt là thiết bị Foundry, trả về tốc độ bằng 0 cho
một số giao diện Ví dụ: để đặt tất cả các giao diện báo cáo số 100 thành XNUMXMbps,
sử dụng --zero-speed=100000000.

--thư mục con định dạng
Cung cấp cho mỗi bộ định tuyến thư mục con riêng cho các tệp HTML và đồ họa (hoặc .rrd). Các
tên thư mục đã cho định dạng chuỗi với một vài mẫu thay thế. Các
chuỗi "HOSTNAME" sẽ được thay thế bằng tên máy chủ của bộ định tuyến (tuy nhiên bạn
đã chỉ định nó trên nhà sản xuất cfg dòng lệnh - nó có thể là tên máy chủ thực tế hoặc chỉ là IP
địa chỉ) và "SNMPNAME" sẽ được thay thế bằng tên riêng của thiết bị (tên
cùng tên xuất hiện ở bên phải dòng "Tiêu đề"). Ví dụ, một cuộc gọi
như:

cfgmaker --subdirs=HOSTNAME__SNMPNAME [email được bảo vệ]

sẽ dẫn đến việc tạo ra các dòng trông giống như:

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

- đầu ra hồ sơ
Viết đầu ra từ nhà sản xuất cfg vào tập tin hồ sơ. Mặc định là sử dụng "STDOUT".
- đầu ra dự kiến ​​​​sẽ chỉ xuất hiện một lần trên dòng lệnh. Nếu sử dụng nhiều lần,
tập tin được chỉ định bởi lần cuối - đầu ra sẽ được sử dụng.

--không có giao diện
Không tạo dòng cấu hình cho giao diện.

Điều này khiến cfgmaker bỏ qua tất cả các bước liên quan đến giao diện, nghĩa là sẽ không thực hiện được
bất kỳ việc thăm dò nào của bộ định tuyến để lấy thông tin giao diện giúp tăng tốc độ
thực thi cfgmaker và nó sẽ không chạy bất kỳ mẫu giao diện nào.

- giao diện
Điều này làm cho cfgmaker tạo ra các dòng cấu hình cho các giao diện (mặc định
cư xử).

Cách sử dụng chính của tùy chọn này là phủ nhận --nointerfaces xuất hiện trước đó trên
dòng lệnh.

SNMP V3 Các lựa chọn
Cfgmaker hỗ trợ SNMP V3 bằng cách sử dụng Mạng:SNMP mô-đun perl. Có các thông số tùy chọn
ảnh hưởng đến hoạt động của SNMP.

--enablesnmpv3 {có|không}
Sản phẩm --enablesnmpv3 tùy chọn là một cờ tùy chọn để kiểm tra sự hiện diện của
Mạng::SNMP thư viện. Cfgmaker sẽ cố gắng xác định xem cờ này có cần thiết hay không và
sẽ tự động thiết lập các giá trị.

SNMPv3 Lập luận

Ngữ cảnh SNMP là tập hợp thông tin quản lý mà thực thể SNMP có thể truy cập. MỘT
Mục thông tin quản lý có thể tồn tại trong nhiều ngữ cảnh và một thực thể SNMP
có khả năng truy cập vào nhiều bối cảnh. Sự kết hợp giữa contextEngineID và
contextName xác định rõ ràng một bối cảnh trong miền quản trị. trong một
Thông báo SNMPv3, contextEngineID và contextName được đưa vào như một phần củascopedPDU.
Tất cả các phương thức tạo thông báo SNMP tùy chọn đều có một --contextengineid và
--tên ngữ cảnh đối số để cấu hình các trường này.

ID công cụ bối cảnh
Sản phẩm --contextengineid đối số mong đợi một chuỗi thập lục phân đại diện cho giá trị mong muốn
contextEngineID. Chuỗi phải dài từ 10 đến 64 ký tự (5 đến 32 octet) và có thể
được bắt đầu bằng "0x" tùy chọn. Một khi --contextengineid được chỉ định là nó vẫn ở đó
với đối tượng cho đến khi nó được thay đổi lần nữa hoặc đặt lại về mặc định bằng cách chuyển vào
giá trị không xác định. Theo mặc định, contextEngineID được đặt để khớp với
AuthoritativeEngineID của công cụ SNMP có thẩm quyền.

Tên ngữ cảnh
contextName được truyền dưới dạng một chuỗi phải có độ dài từ 0 đến 32 octet bằng cách sử dụng
--tên ngữ cảnh lý lẽ. contextName ở lại với đối tượng cho đến khi nó được thay đổi.
contextName mặc định là một chuỗi trống đại diện cho ngữ cảnh "mặc định".

Dựa trên người dùng Bảo mật Mô hình Lập luận

Mô hình bảo mật dựa trên người dùng (USM) được SNMPv3 sử dụng yêu cầu Tên bảo mật phải
được chỉ định bằng cách sử dụng --tên tài khoản lý lẽ. Việc tạo một đối tượng Net::SNMP với
phiên bản được đặt thành SNMPv3 sẽ không thành công nếu --tên tài khoản lập luận không có mặt. Các --tên tài khoản
đối số mong đợi một chuỗi có độ dài từ 1 đến 32 octet.

Các mức độ bảo mật khác nhau được Mô hình bảo mật dựa trên người dùng cho phép nhằm giải quyết
mối quan tâm về xác thực và quyền riêng tư. Mục tiêu SNMPv3 sẽ lấy được mức độ bảo mật
(securityLevel) dựa trên đối số nào sau đây được chỉ định.

Theo mặc định, mức độ bảo mật là 'noAuthNoPriv' được giả định. Nếu --authkey or
--mật khẩu xác thực đối số được chỉ định, securityLevel trở thành 'authNoPriv'. Các
--mật khẩu xác thực đối số mong đợi một chuỗi có độ dài ít nhất là 1 octet. Tùy chọn,
các --authkey đối số có thể được sử dụng để không cần phải có mật khẩu văn bản đơn giản
được chỉ định trong một kịch bản. Các --authkey đối số mong đợi một chuỗi thập lục phân được tạo bởi
bản địa hóa mật khẩu bằng AuthoritativeEngineID cho đích cụ thể
thiết bị. Tiện ích "snmpkey" có trong bản phân phối Net::SNMP có thể được sử dụng để
tạo chuỗi thập lục phân (xem snmpkey).

Hai thuật toán băm khác nhau được xác định bởi SNMPv3 có thể được Cơ quan bảo mật sử dụng
Mô hình để xác thực. Các thuật toán này là HMAC-MD5-96 "MD5" (RFC 1321) và
HMAC-SHA-96 "SHA-1" (NIST FIPS PUB 180-1). Thuật toán mặc định được mô-đun sử dụng là
HMAC-MD5-96. Hành vi này có thể được thay đổi bằng cách sử dụng --giao thức xác thực lý lẽ. Cái này
đối số mong đợi chuỗi 'md5' hoặc 'sha' được chuyển để sửa đổi hàm băm
thuật toán.

Bằng cách chỉ định các đối số --khóa riêng or --mật khẩu riêng tư mức độ bảo mật được liên kết với
đối tượng trở thành 'authPriv'. Theo SNMPv3, quyền riêng tư yêu cầu sử dụng
xác thực. Vì vậy, nếu một trong hai lập luận này tồn tại và --authkey
or --mật khẩu xác thực đối số bị thiếu, việc tạo đối tượng không thành công. Các --khóa riêng
và --mật khẩu riêng tư các đối số mong đợi đầu vào giống như --authkey và --mật khẩu xác thực
các đối số tương ứng.

Mô hình bảo mật dựa trên người dùng được mô tả trong RFC 3414 xác định một giao thức mã hóa duy nhất
được sử dụng cho sự riêng tư. Giao thức này, CBC-DES "DES" (NIST FIPS PUB 46-1), được sử dụng bởi
mặc định hoặc nếu chuỗi 'des' được chuyển tới --giao thức riêng tư lý lẽ. Bằng cách làm việc với
Hiệp hội Tùy chọn Bảo mật Mở rộng http://www.snmp.com/eso/, mô-đun này cũng
hỗ trợ các giao thức bổ sung đã được xác định trong thông số kỹ thuật dự thảo. Bản thảo
http://www.snmp.com/eso/draft-reeder-snmpv3-usm-3desede-00.txt xác định sự hỗ trợ của
CBC-3DES-EDE "Triple-DES" (NIST FIPS 46-3) trong Mô hình bảo mật dựa trên người dùng. Cái này
giao thức có thể được chọn bằng cách sử dụng --giao thức riêng tư đối số bằng chuỗi '3desede'. Các
dự thảo http://www.snmp.com/eso/draft-blumenthal-aes-usm-04.txt mô tả việc sử dụng
CFB128-AES-128/192/256 "AES" (NIST FIPS PUB 197) trong USM. Ba mã hóa AES
các giao thức, được phân biệt bởi kích thước khóa của chúng, có thể được chọn bằng cách chuyển 'aescfb128',
'aescfb192' hoặc 'aescfb256' cho -rivprotocol tranh luận.

Chi tiết on Bộ lọc
Mục đích của bộ lọc là quyết định giao diện nào sẽ được chấp nhận và giao diện nào sẽ được chấp nhận.
từ chối. Quyết định này được thực hiện cho từng giao diện bằng cách đánh giá biểu thức bộ lọc dưới dạng
đoạn mã Perl và điều tra kết quả đánh giá. Nếu đúng thì chấp nhận
giao diện nếu không thì từ chối nó.

Khi làm việc với các bộ lọc, hãy nhớ rằng Perl có ý tưởng riêng về việc đâu là đúng và đâu là sai.
là. Chuỗi trống "" và chuỗi "0" là sai, tất cả các chuỗi khác đều đúng. Cái này
ngụ ý thêm rằng mọi giá trị nguyên bằng 0 đều sai cũng như mọi giá trị undef. Nó cũng
ngụ ý rằng tất cả các tài liệu tham khảo được coi là đúng.

Vì bộ lọc được đánh giá dưới dạng biểu thức Perl nên một số cấu trúc hữu ích trong Perl được
đáng nói:

Các biểu thức có thể được nhóm lại bằng cách sử dụng dấu ngoặc đơn "()". Biểu thức có thể được kết hợp
sử dụng các toán tử boolean như sau:

"và" (tương đương với "&&")
Boolean "và" của hai biểu thức chỉ đúng nếu cả hai biểu thức đều đúng.
Ví dụ: biểu thức1 và biểu thức2

"or" (tương đương với "||")
Boolean "hoặc" của hai biểu thức là đúng nếu một trong hai hoặc cả hai biểu thức đều đúng.
Ví dụ: biểu thức1 or biểu thức2

"không" (tương đương với "!")
Phủ định Boolean của một biểu thức. Ví dụ: không biểu hiện . Còn nữa
thí dụ: !biểu hiện

(Để biết thêm chi tiết về điều này, tôi giới thiệu một cuốn sách về Perl)

Được xác định trước Lọc Biến

Để thuận tiện, có một số giá trị được xác định trước có sẵn để sử dụng trong bộ lọc.
Lưu ý rằng các biến này cũng có sẵn khi giao diện mẫu được đánh giá (nhưng
không phải mẫu máy chủ).

Hãy cẩn thận: Tên của tất cả các biến này đều bắt đầu bằng ký hiệu đô la ($), đây là cú pháp
yêu cầu về các biến vô hướng trong Perl. Điều nguy hiểm ở đây là ký hiệu đô la ở nhiều nơi
shell là một ký tự hoạt động (thường được sử dụng cho các biến shell chính xác như trong Perl
biến) vì vậy điều quan trọng là đảm bảo rằng biểu thức Perl không được đánh giá bởi
dòng lệnh shell dưới dạng mã shell trước khi được chuyển tới cfgmaker dưới dạng dòng lệnh
tranh luận. Trong các shell như Bourne shell, ksh shell hoặc bash shell, đặt toàn bộ
biểu thức trong các qoutes đơn lẻ sẽ tránh được việc đánh giá ngẫu nhiên như vậy:

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

$if_type
Đây là một số nguyên xác định loại giao diện theo tiêu chuẩn SNMP và như
được báo cáo bởi thiết bị được thăm dò. Một danh sách đầy đủ các loại giao diện sẽ là
không thực tế đối với tài liệu này, nhưng có một số biến được xác định trước bên dưới.
Thông thường, cfgmaker đặt giá trị iftype này vào PageTop của mục tiêu trong dấu ngoặc đơn
sau tên của loại giao diện. (ví dụ: "propPointToPointSerial (22)").

Dưới đây là danh sách một số loại giao diện phổ biến nhất theo số lượng:

6 ethernetCsmacd
7 iso88023Csmacd
9 iso88025TokenRing
15 fddi
19 E1
20 ISDN cơ bản
21 ISDN chính
22 propPointToPointSerial
Ppp
24 phần mềmLoopback
30 ds3
32 khung chuyển tiếp
XNXX rs33
37 máy rút tiền
39 bài hát
Dịch vụ chuyển tiếp khung 44
46 giờ
49 aal5
53 propảo
62 Ethernet nhanh (100BaseT)
63 ISDN & X.25
69 Ethernet nhanh song công hoàn toàn (100BaseFX)
94 Vòng thuê bao kỹ thuật số bất đối xứng (ADSL)
117 Gigabit Ethernet
Giao diện phụ ATM 134

$ mặc định
Đúng khi và chỉ nếu cfgmaker thường chấp nhận giao diện dựa trên
giao diện trạng thái quản trị và vận hành (lấy cờ --Không xuống và
--show-op-down được tính đến) và đó là loại (và một vài thứ khác).

$default_ifstate
Đúng khi và chỉ khi cfgmaker chấp nhận giao diện dựa trên nó
trạng thái hoạt động và hành chính (cũng có tính đến sự hiện diện của
cờ --Không xuống và --show-op-down).

$default_iftype
Đúng khi và chỉ nếu cfgmaker chấp nhận giao diện dựa trên loại của nó (và
ngoài ra còn có một số loại chi tiết cụ thể).

$if_admin
Đúng khi và chỉ khi giao diện ở trạng thái quản trị.

$if_oper
Đúng khi và chỉ khi giao diện ở trạng thái hoạt động.

Một số biến cũng được xác định trước để dễ dàng quyết định xem một giao diện có thuộc về một
danh mục nhất định hay không. Dưới đây là tất cả các biến được liệt kê cùng với if_type
số mỗi biến sẽ đúng. Lưu ý rằng một số biến tham chiếu đến các biến khác
là tốt.

$if_is_ethernet
Đúng với giao diện ethernet (số 6, 7, 26, 62, 69 và 117).

$if_is_isdn
Đúng với nhiều loại giao diện ISDN khác nhau (số 20, 21, 63, 75, 76 và 77)

$if_is_dialup
Đúng cho các giao diện quay số như PPP cũng như ISDN. (số 23, 81, 82 và 108 in
cộng với số lượng $if_is_isdn).

$if_is_atm
Đúng với các loại giao diện liên quan đến ATM khác (số 37, 49, 107, 105, 106, 114 và
134).

$if_is_wan
Đúng cho các giao diện WAN điểm tới điểm, Frame Relay và High Speed ​​Serial (
22,32,44,46)

$if_is_lan
Đúng cho các giao diện LAN (8, 9, 11, 15, 26, 55, 59, 60 và 115 ngoài
Con số của $if_is_ethernet).

$if_is_dsl
Đúng cho ADSL, RDSL, HDSL và SDSL (nr 94, 95, 96, 97)

$if_is_loopback
Đúng cho các giao diện loopback phần mềm (số 24)

$if_is_ciscovlan
Đúng với các giao diện Cisco VLAN (các giao diện có từ Vlan hoặc VLAN trong
ifdescs)

$if_vlan_id
Trả về id vlan được liên kết với một cổng cụ thể trên thiết bị chuyển mạch Cisco Catalyst trong
cả Catalyst OS và iOS cũng như các thiết bị chuyển mạch 3Com. Nếu nó không phải là giao diện vlan, sẽ
trả về undef.

$if_cisco_trunk
Trả về trạng thái trung kế của một cổng cụ thể trên thiết bị chuyển mạch Cisco Catalyst theo cả hai
Hệ điều hành Catalyst và iOS. Trả về "1" nếu giao diện là trung kế, nếu không thì trả về undef.

$if_MTU
Trả về Đơn vị truyền tối đa được liên kết với một cổng cụ thể.

Ngoài ra, bạn cũng có thể sử dụng các biến được xác định cho các mẫu bên dưới. Hơn nữa, tất cả
các biến có sẵn trong cfgmaker đều được sử dụng theo ý muốn của các tập lệnh ngay cả khi việc sử dụng các biến đó
các tính năng không được khuyến khích. Sẽ có nhiều "phím tắt" hơn ở dạng biến và hàm
thay vào đó sẽ có sẵn trong tương lai.

Các ví dụ on Bộ lọc

Bộ lọc sau sẽ không ảnh hưởng đến giao diện nào được bao gồm hoặc loại trừ, nó sẽ
làm cho cfgmaker hoạt động như bình thường.

'--if-filter=$mặc định'

Bộ lọc sau sẽ khiến cfgmaker loại trừ giao diện PPP (23):

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

Bộ lọc sau đây sẽ làm cho cfgmaker hoạt động như bình thường ngoại trừ việc nó sẽ xem xét
trạng thái hoạt động của một giao diện không liên quan nhưng vẫn từ chối tất cả các giao diện
xuống về mặt hành chính.

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

Chi tiết on Templates
Nội dung của các tệp mẫu được đánh giá là chương trình Perl. Một số hoặc Perl
các biến có sẵn để chương trình đọc và các biến khác được sử dụng để ghi vào.

Vì khá nhiều biến được xác định trước có các giá trị được cho là sẽ được sử dụng trong
Mã HTML, một số trong số chúng có biến thể "thoát HTML", ví dụ: $html_syslocation là HTML
biến thể thoát của $syslocation. Việc thoát HTML có nghĩa là các ký tự "<", ">" và "&"
được thay thế bằng "<", ">" và "&" và các dòng mới được nhúng trong chuỗi là
thêm vào trước " " và được thêm vào một ký tự khoảng trắng (nếu có dòng mới cuối cùng trong
chuỗi nó không được chạm vào).

Ghi Template Biến

Đây là các biến có sẵn để lưu trữ các dòng cấu hình. Một số trong số đó là
được khởi tạo trước khi đánh giá mẫu nhưng nội dung đó thường là nhận xét
để đưa vào tệp cấu hình cuối cùng để các biến đó có thể được đặt lại về
chuỗi trống trong mã mẫu để loại bỏ nhận xét. Ngược lại cũng là
có thể, nội dung của các biến này có thể được mở rộng với nhiều thông tin hơn cho
nhiều lý do khác nhau như gỡ lỗi, v.v.

Khi mẫu đã được đánh giá, điều sau đây sẽ xảy ra: nếu mẫu là
mẫu giao diện và giao diện thực tế vì lý do nào đó bị từ chối và do đó cần phải
được nhận xét, tất cả các dòng trong biến $target_lines được chuyển thành nhận xét bởi
thêm dấu băm ("#") vào đầu chúng. Sau đó tất cả các biến $head_lines,
$problem_lines , $target_lines và $dấu phân cách_dòng được nối với nhau để tạo thành
dòng để thêm vào tập tin cấu hình.

$target_lines
Biến này là phần giữ chỗ cho các dòng cấu hình được tạo bởi mẫu.
$target_lines được xác định trước để trống khi mã mẫu được đánh giá.

$head_lines
Biến này nhằm mục đích giữ chỗ cho dòng chú thích chỉ xuất hiện
trước mục tiêu trong tệp cấu hình. Nó được khởi tạo với dòng bình luận đó
trước khi đánh giá mã mẫu và nếu mẫu không sửa đổi
$head_lines trong quá trình đánh giá, nhận xét sẽ trông như bình thường trong tệp cấu hình.

$problem_lines
Biến này được dự định là phần giữ chỗ cho các dòng chú thích mô tả bất kỳ
các vấn đề có thể gặp phải khi cố gắng thêm mục tiêu vào
cấu hình. Đối với các mẫu máy chủ, nó thường không được sử dụng và đối với những mẫu đó thì nó
được xác định trước là chuỗi trống. Đối với mẫu giao diện $problem_lines được xác định trước
với các nhận xét mô tả lỗi mà cfgmaker thường sử dụng để từ chối
giao diện hoặc dưới dạng chuỗi trống cho các giao diện được chấp nhận.

Có thể kiểm tra chống lại $problem_lines để tìm hiểu xem một giao diện sẽ
bao gồm hoặc bị từ chối nhưng điều này không được khuyến khích. Kiểm tra chống lại $if_ok thay thế.

$dấu phân cách_dòng
Biến này là phần giữ chỗ cho chuỗi được sử dụng làm dấu phân cách giữa
mã cho các mục tiêu riêng lẻ. Nội dung của biến này được đặt sau mỗi mục tiêu
(vì vậy các dòng cũng sẽ xuất hiện sau khi kết thúc mục tiêu cuối cùng trong cấu hình).

Được xác định trước Template Biến

Tất cả các biến bên dưới đều có sẵn cho các mẫu giao diện để sử dụng. Đối với các mẫu máy chủ,
chỉ những cái được liệt kê trong "Biến máy chủ và hệ thống" mới khả dụng.

Đối với các mẫu giao diện, các biến được liệt kê trong "Biến bộ lọc được xác định trước" cũng được
có sẵn.

Máy chủ và WELFARE Biến

$router_name
Đây là tên đầy đủ cho bộ định tuyến. Nó bị ảnh hưởng bởi những điều sau đây
các mục trên dòng lệnh: tên bộ định tuyến và --dns-miền.

$router_connect
Đây là chuỗi tham chiếu cho bộ định tuyến đang được thăm dò. Nó ở trên mẫu
Community@router có thể được theo sau bởi một số tùy chọn snmp. Nó bị ảnh hưởng bởi
các mục sau trên dòng lệnh: tên bộ định tuyến, --cộng đồng,
--snmp-tùy chọn và --dns-miền. (Không có biến thể thoát HTML nào)

$directory_name
Biến này phải chứa tên thư mục mà cfgmaker thường sử dụng làm
giá trị cho lệnh "Directory[]". Giá trị được xác định bởi --thư mục con
tùy chọn dòng lệnh. Nếu như --thư mục con không được chỉ định $directory_name sẽ trống rỗng
sợi dây. (Không có biến thể thoát HTML nào)

$syscontact
Biến này là giá trị SNMP syscontact của bộ định tuyến. (Biến thể thoát HTML:
$html_syscontact)

$sysname
Biến này là giá trị SNMP sysName của bộ định tuyến. (Không có biến thể thoát HTML nào)

$syslocation
Biến này là giá trị SNMP sysLocation của bộ định tuyến. (Biến thể thoát HTML:
$html_syslocation)

$sysdescr
Biến này là giá trị SNMP sysDescr của bộ định tuyến. Nó thường không được sử dụng bởi
cfgmaker nhưng có thể hữu ích trong một mẫu. (Biến thể thoát HTML: $html_sysdescr)

Giao thức Mục tiêu Sản phẩm liên quan Biến

$target_name
Đây là tên mà cfgmaker thường sử dụng làm tên của mục tiêu. Mục tiêu
tên là tên được tìm thấy trong dấu ngoặc vuông, "[]", dành cho chỉ thị đích.
(Không có biến thể thoát HTML nào)

$if_ref
Đây là chuỗi tham chiếu cho giao diện. Dự kiến ​​nó sẽ được sử dụng trong
Lệnh "Target[xyz]" để phân biệt giao diện nào sẽ sử dụng. Giá trị của điều này
biến bị ảnh hưởng bởi --ifref tùy chọn dòng lệnh. Nó thường được sử dụng cùng nhau
với $router_connect. (Không có biến thể thoát HTML nào)

$if_ok
Biến này đúng nếu giao diện sẽ được đưa vào cấu hình
tập tin, nếu không thì sai. Đừng kiểm tra các biến khác như $problem_lines đến
tìm hiểu xem một giao diện có bị từ chối hay không, hãy sử dụng giao diện này $if_ok thay thế.

$default_target_lines
Biến này chứa tất cả các dòng mục tiêu mà cfgmaker xuất ra theo mặc định cho dòng này
giao diện. Sẽ rất hữu ích nếu bạn muốn có "mục tiêu chuẩn" nhưng muốn thêm một số
thêm dòng vào nó bằng cách sử dụng một mẫu.

Theo mặc định, cfgmaker sử dụng các lệnh sau cho từng mục tiêu mà nó tạo ra: Target[],
SetEnv[], MaxBytes[], Title[], PageTop[] và nếu có bất kỳ thư mục nào được chỉ định thì
Chỉ thị Directory[]

Để tạo thuận lợi cho việc tạo các mẫu tạo ra các cấu hình đích tương tự
thành mặc định, mỗi dòng lệnh nêu trên có một dòng lệnh tương ứng
biến chứa dòng như cfgmaker sẽ xuất nó theo mặc định.

Lưu ý rằng không có biến thể nào trong số này có biến thể thoát HTML, văn bản trong đó là HTML thoát ở đâu
cần thiết. Cũng lưu ý rằng họ không có bất kỳ dòng mới nào ở cuối.

$default_target_directive
Biến này chứa chuỗi mặc định cho dòng lệnh Target[].

$default_setenv_directive
Biến này chứa chuỗi mặc định cho dòng lệnh SetEnv[].

$default_directory_directive
Biến này chứa chuỗi mặc định cho dòng lệnh Directory[]
có nghĩa đó là một chuỗi trống (không có dòng mới) nếu không có thư mục.

$default_maxbytes_directive
Biến này chứa chuỗi mặc định cho dòng lệnh MaxBytes[].

$default_title_directive
Biến này chứa chuỗi mặc định cho dòng lệnh Title[].

$default_pagetop_directive
Biến này chứa chuỗi mặc định cho các dòng lệnh PageTop[].

Giao thức mạng Cấu hình Biến

$if_ip
Biến này phải chứa địa chỉ IP của giao diện, nếu có đã được chỉ định
đến nó. (Không có biến thể thoát HTML nào)

$ifindex
Biến này là SNMP ifIndex cho giao diện mà theo định nghĩa luôn là một
số nguyên. (Không có biến thể thoát HTML nào)

$if_index
Tương đương với $ifindex.

$if_eth
Chứa địa chỉ ethernet của giao diện, nếu có. (Không có HTML nào thoát được
biến thể có sẵn)

$if_speed
Biến này là tốc độ tính bằng byte/giây (có tiền tố). (Không có HTML nào thoát được
biến thể có sẵn)

$if_speed_str
Biến này là mô tả tốc độ được tính bằng bit hoặc byte tùy thuộc vào
dù thời tiết hay không, tùy chọn bit có hoạt động và cũng có tiền tố thích hợp cho
tốc độ (k, M, G, v.v.). (Không có biến thể thoát HTML nào)

$if_type_desc
Biến này là một mô tả văn bản của loại giao diện. (Biến thể thoát HTML:
$html_if_type_desc)

$if_type_num
Biến này giá trị số nguyên tương ứng với loại giao diện (đối với danh sách cho
giá trị cho các loại giao diện phổ biến hơn, xem phần CHI TIẾT VỀ BỘ LỌC
bên trên). (Không có biến thể thoát HTML nào)

$if_dns_name
Đây là tên DNS cho giao diện. (Không có biến thể thoát HTML nào)

Giao thức tên, Mô tả và tên giả Biến

Nó có vẻ khó hiểu với cả hai Họ tên, Mô tả và tên giả trong bối cảnh này và với một số
nó ở mức độ nào. Họ tên và Mô tả thường được hỗ trợ trên hầu hết các thiết bị nhưng chúng
được sử dụng khác nhau, giữa các nhà sản xuất cũng như giữa các loại khác nhau của
thiết bị của cùng một nhà sản xuất. Các tên giả ít nhất được hỗ trợ bởi Cisco IOS và
biến đó chứa bất cứ thứ gì được sử dụng trong câu lệnh iOS được gọi là "mô tả" cho
giao diện (đừng nhầm lẫn với các biến SNMP cho Mô tả).

Để kiểm soát tốt hơn từ dòng lệnh, hãy xem xét $if_title_desc nội dung nào
được kiểm soát bởi --if-descr tùy chọn dòng lệnh.

$if_snmp_descr
Biến này phải chứa mô tả "thô" của giao diện được xác định bởi
thăm dò SNMP của bộ định tuyến. (Biến thể thoát HTML: $html_if_snmp_descr)

$if_snmp_name
Tên "thô" cho giao diện được cung cấp bởi cuộc bỏ phiếu SNMP. (Biến thể thoát HTML:
$html_if_snmp_name)

$if_snmp_alias
IfAlias ​​"thô" cho giao diện được cung cấp bởi tính năng bỏ phiếu SNMP. (HTML đã thoát
khác nhau: $html_if_snmp_alias)

$if_cisco_descr
CiscolocIfDescr "thô" cho giao diện được cung cấp bởi tính năng bỏ phiếu SNMP. (HTML
biến thể thoát: $html_if_cisco_descr)

$if_description
Đây là chuỗi mô tả được "nấu chín" cho giao diện, có tính đến
Đã tìm thấy các giá trị SNMP cho RDescr, ifAlias ​​và CiscolocIfDescr của giao diện. (HTML
biến thể thoát: $html_if_description)

$if_title
Theo mặc định, chuỗi cfgmaker đầy đủ sẽ được sử dụng cho lệnh Title[] trong
cấu hình cũng như nội dung của thẻ H1 trên cùng trong PageTop[]. Là
được sáng tác theo nội dung của $desc_prefix, $if_title_desc và $sysname.

As $if_title phụ thuộc vào $if_title_desc, có thể điều khiển gián tiếp $if_title
bằng cách sử dụng tùy chọn dòng lệnh --if-descr.

(Biến thể thoát HTML: $html_if_title)

$if_port_name
Nếu máy chủ là bộ chuyển mạch LAN Cisco Catalyst thì biến này là tên của cổng đó.
(Không có biến thể thoát HTML nào)

$if_pp_port_name
Nếu máy chủ là bộ chuyển mạch Nortel Passport LAN thì biến này là tên của cổng đó.
(Không có biến thể thoát HTML nào)

$desc_prefix
Biến này là tiền tố mô tả mục tiêu sẽ sử dụng trong
Chỉ thị "Title[]" và trong phần H1 của "PageTop[]". Mặc định là "Giao thông
phân tích cho ". (Biến thể thoát HTML: $html_desc_prefix)

$if_title_desc
Đây là mô tả về giao diện thường được cfgmaker sử dụng như một phần của
biến $if_title. Chuỗi sau được sử dụng làm chuỗi đầy đủ trong chỉ thị "Title[]"
và phần H1 trong PageTop[].

$if_title_desc được điều khiển bởi tùy chọn dòng lệnh --if-descr gián tiếp
điều khiển nội dung của $if_title

(Biến thể thoát HTML: $html_if_title_desc)

Trợ giúp Chức năng cho Templates

Các chức năng sau tồn tại để hỗ trợ việc viết các mẫu máy chủ và giao diện.

html_escape(chuỗi)
html_escape() lấy một chuỗi làm đối số và trả về một chuỗi mới trong đó
các thay thế sau đây đã được thực hiện: các ký tự "<", ">" và "&" được thay thế bằng
"<", ">" và "&" và các dòng mới được nhúng trong chuỗi được thêm vào trước
" " và được thêm vào một ký tự khoảng trắng (không có dòng mới ở cuối chuỗi
chạm vào).

oid_pick($router_connect,$v3opt,"oid1","oid2"...)
Hàm này sẽ cố gắng thăm dò từng oid được chỉ định cho đến khi thành công hoặc
đã hết oid. Nó sẽ trả về tên của oid đầu tiên hoạt động hoặc không hoạt động nếu
nó không thành công

Ví dụ Template Các tập tin

Ví dụ mẫu 1: Loại bỏ các mục tiêu bị từ chối xuất hiện

Tệp mẫu này tạo chính xác mã cấu hình cho mỗi giao diện giống như cfgmaker
thực hiện theo mặc định, ngoại trừ việc nó loại bỏ tất cả các dòng (nhận xét cũng như
config code) cho một giao diện nếu giao diện đó bị từ chối.

if(không phải $problem_lines)
{
$target_lines .= <

Mục tiêu[$target_name]: $if_ref:$router_connect
SetEnv[$target_name]: MRTG_INT_IP="$if_ip" MRTG_INT_DESCR="$if_snmp_descr"
ECHO

nếu ($thư mục_name) {
$target_lines .= "Thư mục[$target_name]: $directory_name\n";
}

$target_lines .= <
MaxBytes[$target_name]: $if_speed
Tiêu đề[$target_name]: $html_desc_prefix$html_if_title_desc -- $sysname
TrangTop[$target_name]: $html_desc_prefix$html_if_title_desc -- $sysname



Hệ thống:
$sysname ở $html_syslocation


Người bảo trì:
$html_syscontact


Sự miêu tả:
$html_if_description


ifType:
$html_if_type_desc ($if_type_num)


nếu Tên:
$html_if_snmp_name

ECHO

$target_lines .= <

Tên cổng:
$if_port_name

ECHO

$target_lines .= <

Tên cổng:
$if_pp_port_name

ECHO

$target_lines .= <

Tốc độ tối đa:
$if_speed_str

ECHO

$target_lines .= <

IP:
$if_ip ($if_dns_name)

ECHO

$target_lines .= <


ECHO
} Else {
$head_lines="";
$problem_lines="";
$target_lines="";
$dấu phân cách_lines="";
}

Template Ví dụ 2: Đơn giản hơn phiên bản of Ví dụ 1

Ví dụ 1 một phần nhằm trình bày cách tùy chỉnh việc tạo giao diện
mục tiêu mà còn cung cấp gợi ý về cách sử dụng các biến trong mẫu "mặc định"
mà người ta có thể coi là cfgmaker thường sử dụng.

Nếu bạn chỉ quan tâm đến cách dễ nhất để loại bỏ hoàn toàn những lời từ chối đó
giao diện, mẫu bên dưới cũng sẽ thực hiện công việc này bằng cách sử dụng $default_target_lines.

nếu($if_ok) {
$target_lines = $default_target_lines;
} Else {
$head_lines="";
$problem_lines="";
$target_lines="";
$dấu phân cách_lines="";
}

Template Ví dụ 3: Tạo CPU Mục tiêu cho Máy chủ

Dưới đây là một ví dụ về mẫu máy chủ.

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

$target_name = $router_name của tôi. ".CPU";

$target_lines .= <

YLegend[$target_name]: Phần trăm tải CPU
ShortLegend[$target_name]: %
Legend1[$target_name]: Tải CPU tính bằng %
Truyền thuyết2[$target_name]:
Legend3[$target_name]: Tải CPU quan sát tối đa
Truyền thuyết4[$target_name]:
LegendI[$target_name]: Tải CPU:
Truyền thuyếtO[$target_name]:
WithPeak[$target_name]: ywm
MaxBytes[$target_name]: 100
Tùy chọn[$target_name]: tăng trưởng, đo lường, không phần trăm
Title[$target_name]: Tải CPU của $router_name
Đích[$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
TrangTop[$target_name]: Tải CPU $router_name



Hệ thống:
$router_name ở $html_syslocation


Người bảo trì:
$html_syscontact


Sự miêu tả:
$html_sysdescr


Nguồn:
CPU.



ECHO

VÍ DỤ

Ví dụ đầu tiên tạo một tập tin cấu hình cho bộ định tuyến.place.xyz: bộ định tuyến có
tên cộng đồng công khai. Các giao diện được xác định bằng số IP của chúng. Hai lựa chọn toàn cầu
được thêm vào tập tin cấu hình. Tệp cấu hình được chuyển hướng đến mrtg.conf. Các '\'
dấu hiệu ở cuối dòng có nghĩa là lệnh này phải được viết trên một dòng duy nhất.

cfgmaker --global "WorkDir: /home/tobi" \
--global "Tùy chọn[_]: Growright,bit" \
--ifref=ip \
[email được bảo vệ] > mrtg.cfg

Lưu ý: nếu cfgmaker không có trong đường dẫn của bạn, nhưng bạn đang ở trong thư mục chứa cfgmaker
được lưu trữ, bạn có thể khởi động nó bằng ./cfgmaker

Ví dụ tiếp theo tạo một tệp cấu hình cho bốn thiết bị: bộ định tuyến1.place.xyz,
bộ định tuyến2.place.xyz, switch1.place.xyz và switch2.place.xyz tất cả cùng cộng đồng công khai.

Hai bộ định tuyến sẽ có --ifref đặt thành sự mô tả trong khi hai công tắc sẽ sử dụng --ifref
đặt thành tên. Hơn nữa các bộ định tuyến sẽ sử dụng --ifdesc đặt thành bí danh và switch1.place.xyz
sẽ sử dụng --ifdesc đặt thành sự mô tả trong khi switch2.place.xyz sử dụng tên thay thế.

Cuối cùng, sẽ có hai dòng Tùy chọn được chèn vào trong cấu hình: Một dòng sẽ nằm trong
đầu, trong khi dòng còn lại sẽ được chèn vào sau các dòng liên quan đến hai bộ định tuyến
nhưng trước những dòng liên quan đến công tắc.

cfgmaker --global "WorkDir: /home/tobi" \
--global "Tùy chọn[_]: Growright,bit" \
--ifref=descr \
--ifdesc=bí danh \
[email được bảo vệ] \
[email được bảo vệ] \
--global "Tùy chọn[_]: Growright" \
--ifref=tên \
--ifdesc=descr \
[email được bảo vệ] \
--ifdesc=tên \
[email được bảo vệ] > mrtg.cfg

Ví dụ tiếp theo minh họa cách sử dụng --cộng đồng, --snmp-tùy chọn và --dns-miền
để làm cho dòng lệnh đơn giản hơn. Tất cả các thiết bị sẽ sử dụng cộng đồng ẩn, ngoại trừ
dành cho máy chủ ppp sử dụng cộng đồng truy cập. Tất cả các thiết bị đều sử dụng các tùy chọn SNMP sau: 1s
thời gian chờ, 1 thử lại và SNMP phiên bản 2 (rút lui và cổng không được chỉ định có nghĩa là họ sử dụng
các giá trị mặc định). Một lần nữa ngoại lệ là máy chủ ppp sử dụng SNMP phiên bản 1.
Cuối cùng, tất cả các thiết bị là một phần của miền địa điểm.xyz, ngoại trừ máy chủ ppp
đó là một phần của miền từ xa.place.xyz. Lưu ý rằng điều sau đạt được đơn giản bằng cách
chỉ định tên của máy chủ ppp là máy chủ ppp.xa .

cfgmaker --global "WorkDir: /home/tobi" \
--global "Tùy chọn[_]: Growright,bit" \
--dns-domain=place.xyz \
--cộng đồng=ẩn \
--snmp-options=::1:1::2 \
bộ định tuyến1 \
bộ định tuyến2 \
bộ định tuyến3 \
bộ định tuyến4 \
bộ định tuyến5 \
chuyển đổi1 \
chuyển đổi2 \
chuyển đổi3 \
chuyển đổi4 \
chuyển đổi5 \
chuyển đổi6 \
chuyển đổi7 \
[email được bảo vệ]:::::1 > mrtg.cfg

Sử dụng cfgmaker trực tuyến bằng dịch vụ onworks.net