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

CHƯƠNG TRÌNH:

TÊN

pysnmpcmd - các tùy chọn và hành vi phổ biến đối với hầu hết các công cụ dòng lệnh PySNMP

SYNOPSIS

pysnmpcmd [TÙY CHỌN] ĐẠI LÝ [THÔNG SỐ]

MÔ TẢ

Trang hướng dẫn sử dụng này mô tả các tùy chọn phổ biến cho các lệnh PySNMP: pysnmpbulkwalk,
pysnmpget, pysnmpset, pysnmpdịch, pysnmpwalk. Các ứng dụng dòng lệnh sử dụng
Giao thức SNMP để giao tiếp với một thực thể mạng có khả năng SNMP, một tác nhân. Riêng biệt, cá nhân, cá thể
các ứng dụng thường (nhưng không nhất thiết) lấy các tham số bổ sung được cung cấp
sau đặc điểm kỹ thuật đại lý. Các thông số này được ghi lại trong các trang hướng dẫn sử dụng cho
mỗi ứng dụng.

LỰA CHỌN

-a giao thức xác thực
Đặt giao thức xác thực (MD5 hoặc SHA) được sử dụng cho SNMPv3 đã xác thực
tin nhắn.

-A xác thựcMật khẩu
Đặt cụm từ mật khẩu xác thực được sử dụng cho các tin nhắn SNMPv3 đã xác thực.

-c cộng đồng
Đặt chuỗi cộng đồng cho các giao dịch SNMPv1 / v2c.

-d Kết xuất (theo hệ thập lục phân) các gói SNMP thô được gửi và nhận.

-D MÃ THÔNG BÁO[,...]
Bật đầu ra gỡ lỗi cho một MÃ THÔNG BÁO(NS). Cố gắng tất cả các cực kỳ dài dòng
đầu ra.

-e ID động cơ
Đặt engineID có thẩm quyền (bảo mật) được sử dụng cho các thông báo YÊU CẦU SNMPv3. Nó là
thường không cần thiết phải chỉ định điều này, vì nó thường sẽ được phát hiện
tự động.

-E ID động cơ
Đặt ID công cụ ngữ cảnh được sử dụng cho các thông báo YÊU CẦU SNMPv3 trong phạm vi Pdu. Nếu không
được chỉ định, điều này sẽ mặc định là engineID có thẩm quyền.

-NS, --Cứu giúp
Hiển thị thông báo sử dụng ngắn gọn và sau đó thoát.

-H Hiển thị danh sách các lệnh tệp cấu hình được hiểu bởi lệnh và sau đó
lối thoát.

-I [hu]
Chỉ định các tùy chọn phân tích cú pháp đầu vào. Nhìn thấy ĐẦU VÀO LỰA CHỌN phía dưới.

-l cấp độ giây
Đặt cấp độ securityLevel được sử dụng cho các thông báo SNMPv3 (noAuthNoPriv | authNoPriv | authPriv).
(Các) cụm từ thích hợp phải được cung cấp khi sử dụng bất kỳ cấp độ nào cao hơn
noAuthNoPriv.

-m MIBLIST
Chỉ định danh sách các mô-đun MIB (không phải tệp) được phân tách bằng dấu hai chấm để tải cho mục này
ứng dụng.

Từ khóa đặc biệt TẤT CẢ CÁC được sử dụng để tải tất cả các mô-đun MIB trong tìm kiếm thư mục MIB
danh sách. Mọi tệp có tên không bắt đầu bằng "." sẽ được phân tích cú pháp như thể nó là một
Tệp MIB.

-M DANH SÁCH TRỰC TIẾP
Chỉ định danh sách thư mục được phân tách bằng dấu hai chấm để tìm kiếm MIB. Lưu ý rằng MIB
được chỉ định bằng cách sử dụng tùy chọn -m sẽ được tải từ một trong các thư mục được liệt kê bởi
tùy chọn -M (hoặc tương đương).

-n tên bối cảnh
Đặt Tên ngữ cảnh được sử dụng cho tin nhắn SNMPv3. Ngữ cảnh mặc địnhName trống
dây "".

-O [abeEfnqQsStTuUvxX]
Chỉ định các tùy chọn in đầu ra. Nhìn thấy OUTPUT LỰA CHỌN phía dưới.

-r thử lại
Chỉ định số lần thử lại sẽ được sử dụng trong các yêu cầu. Giá trị mặc định là 5.

-t thời gian chờ
Chỉ định thời gian chờ tính bằng giây giữa các lần thử lại. Giá trị mặc định là 1.

-u tên giây
Đặt tên securityName được sử dụng cho các tin nhắn SNMPv3 đã xác thực.

-v 1 | 2c | 3
Chỉ định phiên bản giao thức để sử dụng: 1 (RFCs 1155-1157), 2c (RFCs 1901-1908) hoặc
3 (RFCs 2571-2574). Mặc định thường là phiên bản 3.

-V, --phiên bản
Hiển thị thông tin phiên bản cho ứng dụng và sau đó thoát.

-x giao thức riêng tư
Đặt giao thức bảo mật (DES hoặc AES) được sử dụng cho các tin nhắn SNMPv3 được mã hóa.

-X mật khẩu riêng tư
Đặt cụm từ mật khẩu được sử dụng cho các tin nhắn SNMPv3 được mã hóa.

-Z ủng, thời gian
Đặt engineBoots và engineTime được sử dụng cho các thông báo SNMPv3 đã xác thực. Cái này
sẽ khởi tạo khái niệm cục bộ về các tác nhân khởi động / thời gian với một
giá trị được lưu trữ trong màn hình LCD. Thường không cần thiết phải chỉ định tùy chọn này, vì
những giá trị này thường sẽ được phát hiện tự động.

ĐẶC VỤ ĐẶC ĐIỂM KỸ THUẬT

Chuỗi ĐẶC VỤ trong SYNOPSIS ở trên chỉ định thực thể SNMP từ xa để
giao tiếp. Đặc điểm kỹ thuật này có dạng:

[ :]

Nói một cách đơn giản nhất, ĐẶC VỤ đặc điểm kỹ thuật có thể bao gồm tên máy chủ hoặc địa chỉ IPv4 trong
ký hiệu tiêu chuẩn "quad dotted quad". Trong trường hợp này, giao tiếp sẽ được cố gắng sử dụng
UDP / IPv4 đến cổng 161 của máy chủ nhất định. Nếu không một phần của
đặc điểm kỹ thuật được phân tích cú pháp theo bảng sau:

định dạng

tên máy chủ udp [: port] or Địa chỉ IPv4 [: port]

Lưu ý rằng chuỗi không phân biệt chữ hoa chữ thường, ví dụ: "tcp"
và "TCP" là tương đương. Dưới đây là một số ví dụ, cùng với diễn giải của chúng:

tên máy chủ: 161 thực hiện truy vấn bằng cách sử dụng biểu đồ dữ liệu UDP / IPv4 để hostname trên cảng 161.
": 161" là dư thừa ở đây vì đó là cổng SNMP mặc định
trong bất kỳ trường hợp nào.

udp: tên máy chủ giống với đặc điểm kỹ thuật trước đó. "Udp:" là thừa
ở đây vì UDP / IPv4 là phương tiện truyền tải mặc định.

OUTPUT LỰA CHỌN

Định dạng của đầu ra từ các lệnh SNMP có thể được kiểm soát bằng cách sử dụng các tham số khác nhau của
các -O lá cờ. Tác động của các tùy chọn phụ này có thể được nhìn thấy khi so sánh với
sau đầu ra mặc định (trừ khi được chỉ định khác):
$ snmpget -c công khai -v 1 máy chủ cục bộ sysUpTime.0
SNMPv2-MIB :: sysUpTime.0 = Dấu thời gian: (14096763) 1 ngày, 15: 09: 27.63

-oa Hiển thị các giá trị chuỗi dưới dạng chuỗi ASCII (trừ khi có HIỂN THỊ-HINT được xác định cho
đối tượng MIB tương ứng). Theo mặc định, thư viện cố gắng xác định
liệu giá trị là một chuỗi có thể in được hay nhị phân và hiển thị nó tương ứng.

Tùy chọn này không ảnh hưởng đến các đối tượng do có Gợi ý hiển thị.

-Ob Hiển thị các chỉ mục bảng bằng số, thay vì cố gắng diễn giải phiên bản
số phụ dưới dạng chuỗi hoặc giá trị OID:
$ snmpgetnext -c công khai -v 1 localhost vacmSecurityModel
SNMP-VIEW-BASED-ACM-MIB :: vacmSecurityModel.0. "Wes" = xxx
$ snmpgetnext -c công khai -v 1 -Ob localhost vacmSecurityModel
SNMP-VIEW-BASED-ACM-MIB :: vacmSecurityModel.0.3.119.101.115 = xxx

-NS Loại bỏ các nhãn tượng trưng khỏi các giá trị liệt kê:
$ snmpget -c công khai -v 1 máy chủ cục bộ ipForwarding.0
IP-MIB :: ipForwarding.0 = INTEGER: chuyển tiếp(1)
$ snmpget -c công khai -v 1 -NS máy chủ cục bộ ipForwarding.0
IP-MIB :: ipForwarding.0 = INTEGER: 1

-NS Sửa đổi các chuỗi chỉ mục để thoát khỏi các ký tự trích dẫn:
$ snmpgetnext -c công khai -v 1 localhost vacmSecurityModel
SNMP-VIEW-BASED-ACM-MIB :: vacmSecurityModel.0. "Wes" = xxx
$ snmpgetnext -c công khai -v 1 -NS localhost vacmSecurityModel
SNMP-VIEW-BASED-ACM-MIB :: vacmSecurityModel.0. \ "Wes \" = xxx

Điều này cho phép đầu ra được sử dụng lại trong các lệnh shell.

-Của Bao gồm danh sách đầy đủ các đối tượng MIB khi hiển thị OID:
.iso.org.dod.internet.mgmt.mib-2.system.sysUpTime.0 =
Các mốc thời gian: (14096763) 1 ngày, 15: 09: 27.63

-Trên Hiển thị OID ở dạng số:
.1.3.6.1.2.1.1.3.0 = Thanh thời gian: (14096763) 1 ngày, 15: 09: 27.63

-Oq Loại bỏ dấu bằng và thông tin loại khi hiển thị các giá trị varbind:
SNMPv2-MIB::sysUpTime.0 1:15:09:27.63

-OQ Loại bỏ thông tin loại khi hiển thị các giá trị varbind:
SNMPv2-MIB::sysUpTime.0 = 1:15:09:27.63

-Bạn Hiển thị tên đối tượng MIB (cùng với bất kỳ trường hợp nào hoặc các mã định danh con khác):
sysUpTime.0 = Timeticks: (14096763) 1 ngày, 15: 09: 27.63

-XƯƠNG Hiển thị tên của MIB, cũng như tên đối tượng:
SNMPv2-MIB :: sysUpTime.0 = Dấu thời gian: (14096763) 1 ngày, 15: 09: 27.63

Đây là định dạng đầu ra OID mặc định.

-Ốt Hiển thị các giá trị TimeTicks dưới dạng số thô:
SNMPv2-MIB :: sysUpTime.0 = 14096763

-KHÔNG Nếu các giá trị được in dưới dạng chuỗi Hex, hãy hiển thị cả phiên bản có thể in được.

- Ờ Hiển thị OID theo kiểu UCD truyền thống (kế thừa từ CMU ban đầu
mã số). Điều đó có nghĩa là xóa một loạt tiền tố "chuẩn" khỏi OID và
hiển thị danh sách còn lại của tên đối tượng MIB (cộng với bất kỳ mã định danh con nào khác):
system.sysUpTime.0 = Timeticks: (14096763) 1 ngày, 15: 09: 27.63

-OU Không in hậu tố UNITS ở cuối giá trị.

-V Chỉ hiển thị giá trị varbind, không hiển thị OID:
$ snmpget -c công khai -v 1 -NS máy chủ cục bộ ipForwarding.0
SỐ SỐ: chuyển tiếp(1)

-Con bò đực Hiển thị các giá trị chuỗi dưới dạng chuỗi Hex (trừ khi có HIỂN THỊ-HINT được xác định cho
đối tượng MIB tương ứng). Theo mặc định, thư viện cố gắng xác định
liệu giá trị là một chuỗi có thể in được hay nhị phân và hiển thị nó tương ứng.

Tùy chọn này không ảnh hưởng đến các đối tượng do có Gợi ý hiển thị.

-CON BÒ ĐỰC Hiển thị các chỉ mục của bảng trong một đầu ra "giống chương trình" hơn, bắt chước truyền thống
định dạng chỉ mục kiểu mảng:
$ snmpgetnext -c công khai -v 1 localhost ipv6RouteTable
IPv6-MIB :: ipv6RouteIfIndex.63.254.1.0.255.0.0.0.0.0.0.0.0.0.0.0.64.1 = INTEGER: 2
$ snmpgetnext -c công khai -v 1 -NS localhost ipv6RouteTable
IPv6-MIB::ipv6RouteIfIndex[3ffe:100:ff00:0:0:0:0:0][64][1] = INTEGER: 2

Hầu hết các tùy chọn này cũng có thể được định cấu hình thông qua mã thông báo cấu hình. Xem
snmp.conf(5) trang hướng dẫn để biết chi tiết.

ĐẦU VÀO LỰA CHỌN

Có thể kiểm soát việc diễn giải tên đối tượng đầu vào và các giá trị được gán
sử dụng các tham số khác nhau của -I lá cờ. Hành vi mặc định sẽ được mô tả tại
cuối phần này.

-B chỉ định rằng tên đã cho phải được coi là một biểu thức chính quy, để phù hợp với
(phân biệt chữ hoa chữ thường) so với tên đối tượng trong cây MIB. Trận đấu "tốt nhất" sẽ
được sử dụng - được tính toán như là kết quả phù hợp nhất với phần đầu của
tên nút và cao nhất trong cây. Ví dụ, đối tượng MIB
vacmSecurityModel có thể được khớp với biểu thức vacmsecurity model (tên đầy đủ,
nhưng trường hợp khác), hoặc mô hình vacm. * (mô hình regexp).

Lưu ý rằng '.' là một ký tự đặc biệt trong các mẫu biểu thức chính quy, vì vậy
biểu thức không thể chỉ định số phụ bản thể hoặc nhiều hơn một tên đối tượng. MỘT
biểu thức "phù hợp nhất" sẽ chỉ được áp dụng cho các tên đối tượng MIB duy nhất. Vì
ví dụ, biểu thức sys * ontact.0 sẽ không khớp với phiên bản sysContact.0
(Mặc du sys * ontact sẽ khớp với sysContact). Tương tự, chỉ định một mô-đun MIB
tên sẽ không thành công (vì vậy SNMPv2-MIB :: sys. * Ontact cũng sẽ không phù hợp).

-Tôi vô hiệu hóa việc sử dụng thông tin HIỂN THỊ-HINT khi gán giá trị. Cái này sẽ
sau đó yêu cầu cung cấp giá trị thô:
snmpset ... HOST-RESOURCES-MIB :: hrSystemData.0
x "07 D2 0C 0A 02 04 06 08"
thay vì một phiên bản được định dạng:
snmpset ... HOST-RESOURCES-MIB :: hrSystemDate.0
= 2002-12-10,2:4:6.8

-Là vô hiệu hóa việc kiểm tra các chỉ mục của bảng và giá trị được chỉ định so với giá trị có liên quan
Các định nghĩa của MIB. Điều này (hy vọng) sẽ dẫn đến việc tác nhân từ xa báo cáo một
yêu cầu không hợp lệ, thay vì kiểm tra (và từ chối) điều này trước khi nó được gửi đến
đại lý từ xa.

Kiểm tra cục bộ hiệu quả hơn (và chẩn đoán được cung cấp cũng có xu hướng
chính xác), nhưng vô hiệu hóa hành vi này đặc biệt hữu ích khi kiểm tra
đại lý từ xa.

-ĐI cho phép tra cứu tên MIB "truy cập ngẫu nhiên". Thay vì cung cấp một đường dẫn OID đầy đủ
cho đối tượng MIB mong muốn (hoặc đủ điều kiện cho đối tượng này với một mô-đun MIB rõ ràng
tên), cây MIB sẽ được tìm kiếm tên đối tượng phù hợp. Như vậy
.iso.org.dod.internet.mib-2.system.sysDescr.0 (hoặc SNMPv2-MIB :: sysDescr.0) có thể
được chỉ định đơn giản là sysDescr.0.

Cảnh báo:
Vì tên đối tượng MIB không phải là duy nhất trên toàn cầu, phương pháp này có thể trả về
đối tượng MIB khác nhau tùy thuộc vào tệp MIB nào đã được tải.

MIB-MODULE :: objectName cú pháp có lợi thế là xác định duy nhất một
đối tượng MIB cụ thể, cũng như hiệu quả hơn một chút (và tự động
tải tệp MIB cần thiết nếu cần).

-Là HẬU VỆ
thêm hậu tố được chỉ định vào từng OID văn bản được đưa ra trên dòng lệnh. Cái này có thể
được sử dụng để truy xuất nhiều đối tượng từ cùng một hàng của bảng, bằng cách chỉ định một
giá trị chỉ số chung.

-LÀ TIẾP ĐẦU NGỮ
thêm tiền tố được chỉ định vào mỗi OID văn bản được cung cấp trên dòng lệnh. Cái này có thể
được sử dụng để chỉ định tên mô-đun MIB rõ ràng cho tất cả các đối tượng đang được truy xuất (hoặc
cho những người đánh máy lười biếng).

-Tôi cho phép phương pháp tiếp cận kiểu UCD truyền thống để giải thích các OID đầu vào. Cái này
giả định rằng các OID được bắt nguồn từ điểm 'mib-2' trong cây (trừ khi chúng bắt đầu
với một '.' rõ ràng. hoặc bao gồm tên mô-đun MIB). Vì vậy, ví dụ sysDescr ở trên
sẽ được tham chiếu là system.sysDescr.0.

Tên đối tượng được chỉ định bằng dấu '.' luôn được hiểu là "hoàn toàn đủ điều kiện"
OID, liệt kê chuỗi các đối tượng MIB từ gốc của cây MIB. Các đối tượng như vậy và
những người đủ điều kiện bởi một tên mô-đun MIB rõ ràng không bị ảnh hưởng bởi -B, -ĐI và -Tôi
cờ.

Ngược lại, nếu không có tùy chọn đầu vào nào ở trên được chỉ định, thì hành vi mặc định cho
OID "tương đối" là thử và diễn giải nó như một OID (ngầm hiểu) hoàn toàn đủ điều kiện, sau đó
áp dụng tra cứu "truy cập ngẫu nhiên" (-ĐI), tiếp theo là đối sánh mẫu "đối sánh tốt nhất" (-B).

MÔI TRƯỜNG BIẾN

PREFIX Tiền tố chuẩn cho số nhận dạng đối tượng (khi sử dụng đầu ra kiểu UCD). Mặc định
tới .iso.org.dod.internet.mgmt.mib-2

MIBS Danh sách các MIB cần tải. Mặc định cho SNMPv2-TC: SNMPv2-MIB: IF-MIB: IP-MIB: TCP-
MIB: UDP-MIB: SNMP-VACM-MIB. Bị ghi đè bởi -m tùy chọn.

MIBDIR
Danh sách các thư mục để tìm kiếm MIB. Mặc định là DATADIR / snmp / mibs.
Bị ghi đè bởi -M tùy chọn.

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