pysnmpwalk - מקוון בענן

תָכְנִית:

שֵׁם

pysnmpcmd - אפשרויות והתנהגות משותפים לרוב כלי שורת הפקודה של PySNMP

תַקצִיר

pysnmpcmd [אפשרויות] סוכן [פרמטרים]

תיאור

דף מדריך זה מתאר את האפשרויות הנפוצות עבור פקודות PySNMP: pysnmpbulkwalk,
pysnmpget, pysnmpset, pysnmptranslate, pysnmpwalk. יישומי שורת הפקודה משתמשים ב-
פרוטוקול SNMP לתקשורת עם ישות רשת בעלת יכולת SNMP, סוכן. אִישִׁי
יישומים בדרך כלל (אך לא בהכרח) לוקחים פרמטרים נוספים שניתנו
לאחר מפרט הסוכן. פרמטרים אלו מתועדים בדפי המדריך עבור
כל יישום.

אפשרויות

-a authProtocol
הגדר את פרוטוקול האימות (MD5 או SHA) המשמש עבור SNMPv3 מאומת
הודעות.

-A authPassword
הגדר את ביטוי המעבר לאימות המשמש עבור הודעות SNMPv3 מאומתות.

-c קהילה
הגדר את מחרוזת הקהילה עבור עסקאות SNMPv1/v2c.

-d זרוק (בהקסדצימלי) את מנות ה-SNMP הגולמיות שנשלחו והתקבלו.

-D אֲסִימוֹן[,...]
הפעל פלט ניפוי באגים עבור הנתון אֲסִימוֹן(ש). לְנַסוֹת את כל למילולי ביותר
פלט.

-e מזהה מנוע
הגדר את מזהה המנוע הסמכותי (האבטחה) המשמש עבור הודעות SNMPv3 REQUEST. זה
בדרך כלל אין צורך לציין זאת, מכיוון שבדרך כלל זה יתגלה
באופן אוטומטי.

-E מזהה מנוע
הגדר את מזהה המנוע ההקשר המשמש עבור הודעות SNMPv3 REQUEST scopedPdu. אם לא
שצוין, זה יקבע כברירת מחדל את מזהה המנוע הסמכותי.

-ח, - עזרה
הצג הודעת שימוש קצרה ולאחר מכן צא.

-H הצג רשימה של הנחיות קבצי תצורה המובנות על ידי הפקודה ולאחר מכן
יציאה.

-I [הו]
מציין אפשרויות ניתוח קלט. לִרְאוֹת קלט אפשרויות לְהַלָן.

-l secLevel
הגדר את רמת האבטחה המשמשת עבור הודעות SNMPv3 (noAuthNoPriv|authNoPriv|authPriv).
יש לספק ביטויי סיסמה מתאימים בעת שימוש בכל רמה גבוהה מ-
noAuthNoPriv.

-m MIBLIST
מציין רשימה מופרדת בנקודתיים של מודולי MIB (לא קבצים) לטעינה עבור זה
יישום.

מילת המפתח המיוחדת הכל משמש לטעינת כל מודולי MIB בחיפוש ספריית MIB
רשימה. כל קובץ ששמו אינו מתחיל ב-"." ינותח כאילו היה א
קובץ MIB.

-M DIRLIST
מציין רשימה מופרדת בנקודתיים של ספריות לחיפוש MIBs. שימו לב כי MIBs
שצוין באמצעות האפשרות -m ייטען מאחת מהספריות הרשומות על ידי
אפשרות -M (או מקבילות).

-n contextName
הגדר את שם ההקשר המשמש עבור הודעות SNMPv3. ברירת המחדל של contextName הוא הריק
מחרוזת "".

-O [abeEfnqQsStTuUvxX]
מציין אפשרויות הדפסה של פלט. לִרְאוֹת תפוקה אפשרויות לְהַלָן.

-r מנסה שוב
מציין את מספר הניסיונות החוזרים שישמשו בבקשות. ברירת המחדל היא 5.

-t פסק זמן
מציין את הזמן הקצוב בשניות בין ניסיונות חוזרים. ברירת המחדל היא 1.

-u secName
הגדר את ה-securityName המשמש עבור הודעות SNMPv3 מאומתות.

-v 1 | 2c | 3
מציין את גרסת הפרוטוקול לשימוש: 1 (RFCs 1155-1157), 2c (RFCs 1901-1908), או
3 (RFCs 2571-2574). ברירת המחדל היא בדרך כלל גרסה 3.

-V, --גִרְסָה
הצג מידע גרסה עבור היישום ולאחר מכן צא.

-x privProtocol
הגדר את פרוטוקול הפרטיות (DES או AES) המשמש עבור הודעות SNMPv3 מוצפנות.

-X privPassword
הגדר את ביטוי סיסמת הפרטיות המשמש עבור הודעות SNMPv3 מוצפנות.

-Z מגפיים, זמן
הגדר את engineBoots ואת engineTime המשמשים עבור הודעות SNMPv3 מאומתות. זֶה
יאתחל את הרעיון המקומי של מגפי/זמן הסוכנים עם אימות
הערך המאוחסן ב-LCD. בדרך כלל אין צורך לציין אפשרות זו, כמו
ערכים אלו יתגלו בדרך כלל באופן אוטומטי.

סוֹכֵן מפרט

המיתר סוֹכֵן ב תַקצִיר לעיל מציין את ישות ה-SNMP המרוחקת שאיתה
לתקשר. מפרט זה מקבל את הצורה:

[ :]

בפשטות שלו, ה סוֹכֵן המפרט עשוי להיות מורכב משם מארח, או כתובת IPv4 ב
הסימון הסטנדרטי "מרובע מנוקד". במקרה זה, ינוסה תקשורת באמצעות
UDP/IPv4 ליציאה 161 של המארח הנתון. אחרת ה חלק מ
המפרט מנותח לפי הטבלה הבאה:

פוּרמָט

שם מארח udp[:port] or כתובת IPv4[:port]

ציין זאת מחרוזות אינן תלויות רישיות כך שלדוגמה, "tcp"
ו-"TCP" שוות ערך. הנה כמה דוגמאות, יחד עם הפרשנות שלהן:

שם מארח:161 לבצע שאילתה באמצעות UDP/IPv4 datagrams כדי המארח על הנמל 161.
ה-":161" מיותר כאן מכיוון שזוהי יציאת ברירת המחדל של SNMP
בכל מקרה.

udp:hostname זהה למפרט הקודם. ה-"udp:" מיותר
כאן מכיוון ש-UDP/IPv4 הוא תעבורת ברירת המחדל.

תפוקה אפשרויות

ניתן לשלוט בפורמט הפלט מפקודות SNMP באמצעות פרמטרים שונים של
מה היא -O דֶגֶל. ניתן לראות את ההשפעות של אפשרויות משנה אלה בהשוואה ל-
פלט ברירת המחדל הבא (אלא אם צוין אחרת):
$ snmpget -c public -v 1 localhost sysUpTime.0
SNMPv2-MIB::sysUpTime.0 = תווי זמן: (14096763) יום אחד, 1:15:09

-אוה הצג ערכי מחרוזת כמחרוזות ASCII (אלא אם כן הוגדר רמז ל-DISPLAY-HINT עבור
אובייקט MIB המתאים). כברירת מחדל, הספרייה מנסה לקבוע
האם הערך הוא מחרוזת ניתנת להדפסה או בינארית, ומציגה אותו בהתאם.

אפשרות זו אינה משפיעה על אובייקטים do יש רמז לתצוגה.

-אוב הצג את אינדקסי הטבלה באופן מספרי, במקום לנסות לפרש את המופע
מזהי משנה כמחרוזת או ערכי OID:
$ snmpgetnext -c public -v 1 localhost vacmSecurityModel
SNMP-VIEW-BASED-ACM-MIB::vacmSecurityModel.0."wes" = xxx
$ snmpgetnext -c public -v 1 -אוב localhost vacmSecurityModel
SNMP-View-BASED-ACM-MIB::vacmSecurityModel.0.3.119.101.115 = xxx

-אוי מסיר את התוויות הסמליות מערכי הספירה:
$ snmpget -c public -v 1 localhost ipForwarding.0
IP-MIB::ipForwarding.0 = מספר שלם: העברה(1)
$ snmpget -c public -v 1 -אוי localhost ipForwarding.0
IP-MIB::ipForwarding.0 = מספר שלם: 1

-או משנה מחרוזות אינדקס כדי להימלט מתווי המירכאות:
$ snmpgetnext -c public -v 1 localhost vacmSecurityModel
SNMP-VIEW-BASED-ACM-MIB::vacmSecurityModel.0."wes" = xxx
$ snmpgetnext -c public -v 1 -או localhost vacmSecurityModel
SNMP-VIEW-BASED-ACM-MIB::vacmSecurityModel.0.\"wes\" = xxx

זה מאפשר שימוש חוזר בפלט בפקודות מעטפת.

-שֶׁל כלול את הרשימה המלאה של אובייקטי MIB בעת הצגת OID:
.iso.org.dod.internet.mgmt.mib-2.system.sysUpTime.0 =
לוחות זמנים: (14096763) יום אחד, 1:15:09

-עַל מציג את ה-OID באופן מספרי:
.1.3.6.1.2.1.1.3.0 = תווי זמן: (14096763) יום אחד, 1:15:09

-Oq מסיר את סימן השוויון ואת מידע הסוג בעת הצגת ערכי varbind:
SNMPv2-MIB::sysUpTime.0 1:15:09:27.63

-OQ מסיר את פרטי הסוג בעת הצגת ערכי varbind:
SNMPv2-MIB::sysUpTime.0 = 1:15:09:27.63

-אוס הצג את שם האובייקט MIB (בתוספת כל מופע או מזהי משנה אחרים):
sysUpTime.0 = תווי זמן: (14096763) יום אחד, 1:15:09

-עֶצֶם הצג את שם ה-MIB, כמו גם את שם האובייקט:
SNMPv2-MIB::sysUpTime.0 = תווי זמן: (14096763) יום אחד, 1:15:09

זהו פורמט הפלט של OID המוגדר כברירת מחדל.

-אוט הצג ערכי TimeTicks כמספרים גולמיים:
SNMPv2-MIB::sysUpTime.0 = 14096763

-OT אם ערכים מודפסים כמחרוזות Hex, הצג גם גרסה להדפסה.

-או הצג את ה-OID בסגנון UCD המסורתי (הועבר בירושה מה-CMU המקורי
קוד). זה אומר הסרת סדרה של קידומות "סטנדרטיות" מה-OID, ו
הצגת הרשימה הנותרת של שמות אובייקטי MIB (בתוספת כל מזהי משנה אחרים):
system.sysUpTime.0 = תווי זמן: (14096763) יום אחד, 1:15:09

-OU אל תדפיס את הסיומת UNITS בסוף הערך.

-Ov הצג את ערך varbind בלבד, לא את ה-OID:
$ snmpget -c public -v 1 -אוי localhost ipForwarding.0
מספר שלם: העברה(1)

-שׁוֹר הצג ערכי מחרוזת כמחרוזות Hex (אלא אם כן הוגדר רמז לתצוגה עבור
אובייקט MIB המתאים). כברירת מחדל, הספרייה מנסה לקבוע
האם הערך הוא מחרוזת ניתנת להדפסה או בינארית, ומציגה אותו בהתאם.

אפשרות זו אינה משפיעה על אובייקטים do יש רמז לתצוגה.

-שׁוֹר הצג אינדקסים של טבלאות בפלט "כמו תוכנית" יותר, תוך חיקוי מסורתי
פורמט אינדקס בסגנון מערך:
$ snmpgetnext -c public -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 = מספר שלם: 2
$ snmpgetnext -c public -v 1 -או localhost ipv6RouteTable
IPv6-MIB::ipv6RouteIfIndex[3ffe:100:ff00:0:0:0:0:0][64][1] = INTEGER: 2

ניתן להגדיר את רוב האפשרויות הללו גם באמצעות אסימוני תצורה. ראה את
snmp.conf(5) דף מדריך לפרטים.

קלט אפשרויות

ניתן לשלוט בפרשנות של שמות אובייקטי קלט והערכים שיוקצו
באמצעות פרמטרים שונים של -I דֶגֶל. התנהגות ברירת המחדל תתואר ב-
סוף סעיף זה.

-איב מציין שיש לראות את השם הפרטי כביטוי רגולרי, כדי להתאים
(ללא רגישות רישיות) כנגד שמות אובייקטים בעץ MIB. ההתאמה ה"טובה ביותר" תהיה
להיות בשימוש - מחושב כאחד שמתאים הכי קרוב לתחילת ה-
שם הצומת והגבוהה בעץ. לדוגמה, אובייקט MIB
ניתן להתאים את vacmSecurityModel על ידי הביטוי vacmsecuritymodel (שם מלא,
אבל מקרה שונה), או vacm.*מודל (דפוס ביטוי רגיל).

ציין זאת '.' הוא תו מיוחד בדפוסי ביטוי רגולרי, אז ה
ביטוי אינו יכול לציין מזהי משנה של מופעים או יותר משם אובייקט אחד. א
ביטוי "ההתאמה הטובה ביותר" יוחל רק על שמות אובייקט MIB בודדים. ל
למשל, הביטוי sys*ontact.0 לא יתאים למופע sysContact.0
(למרות ש sys*ontact יתאים ל-sysContact). באופן דומה, ציון מודול MIB
השם לא יצליח (אז SNMPv2-MIB::sys.*ontact גם לא יתאים).

-אה משבית את השימוש במידע DISPLAY-HINT בעת הקצאת ערכים. זה היה
לאחר מכן נדרש לספק את הערך הגולמי:
snmpset ... HOST-RESOURCES-MIB::hrSystemData.0
x "07 D2 0C 0A 02 04 06 08"
במקום גרסה מעוצבת:
snmpset ... HOST-RESOURCES-MIB::hrSystemDate.0
= 2002-12-10,2:4:6.8

-איר משבית את בדיקת אינדקסי הטבלה ואת הערך שיוקצו מול הרלוונטי
הגדרות MIB. זה יגרום (בתקווה) לכך שהסוכן המרוחק ידווח על
בקשה לא חוקית, במקום לבדוק (ולדחות) זאת לפני שהיא נשלחת ל-
סוכן מרחוק.

הבדיקות המקומיות יעילות יותר (וגם האבחון הניתן נוטה להיות יותר
מדויק), אך השבתת התנהגות זו שימושית במיוחד בעת בדיקת ה
סוכן מרחוק.

-ללכת מאפשר חיפוש "גישה אקראית" של שמות MIB. במקום לספק נתיב OID מלא
לאובייקט MIB הרצוי (או הכשרת אובייקט זה עם מודול MIB מפורש
שם), יתבצע חיפוש בעץ MIB עבור שם האובייקט התואם. לכן
.iso.org.dod.internet.mib-2.system.sysDescr.0 (או SNMPv2-MIB::sysDescr.0) יכול להיות
צוין פשוט בתור sysDescr.0.

אַזהָרָה:
מכיוון ששמות אובייקטי MIB אינם ייחודיים באופן גלובלי, גישה זו עשויה להחזיר א
אובייקט MIB שונה בהתאם לקבצי MIB שנטענו.

השמיים MIB-MODULE::objectName לתחביר יש את היתרון של זיהוי ייחודי של א
אובייקט MIB מסוים, כמו גם להיות מעט יותר יעיל (ואוטומטי
טעינת קובץ MIB הדרוש במידת הצורך).

-אני סִיוֹמֶת
מוסיף את הסיומת שצוינה לכל OID טקסטואלי שניתן בשורת הפקודה. זה יכול
לשמש לאחזור אובייקטים מרובים מאותה שורה בטבלה, על ידי ציון א
ערך אינדקס משותף.

-IS PREFIX
מוסיף את הקידומת שצוינה לכל OID טקסטואלי שניתן בשורת הפקודה. זה יכול
ישמש כדי לציין שם מודול MIB מפורש עבור כל האובייקטים שאוחזרו (או
עבור קלדניות עצלות חסרות מרפא).

-Iu מאפשר את הגישה המסורתית בסגנון UCD לפענוח קלט OIDs. זֶה
מניח ש-OIDs מושרשים בנקודת 'mib-2' בעץ (אלא אם כן הם מתחילים
עם '.' מפורש או כלול שם מודול MIB). אז מופע sysDescr למעלה
ייקרא system.sysDescr.0.

שמות אובייקטים שצוינו עם '.' מוביל מתפרשים תמיד כ"מוסמכים לחלוטין"
OIDs, המפרטים את רצף אובייקטי ה-MIB מהשורש של עץ ה-MIB. חפצים כאלה ו
אלה המוסמכים בשם מודול MIB מפורש אינם מושפעים מה- -איב, -ללכת ו -Iu
דגלים.

אחרת, אם אף אחת מאפשרויות הקלט שלעיל לא צוינה, התנהגות ברירת המחדל עבור a
OID "יחסי" הוא לנסות ולפרש אותו כ-OID מוסמך לחלוטין (במרומז).
החל חיפוש "גישה אקראית" (-ללכת), ואחריו התאמת דפוס "ההתאמה הטובה ביותר" (-איב).

הסביבה וריאציות

PREFIX הקידומת הסטנדרטית למזהי אובייקטים (בעת שימוש בפלט בסגנון UCD). ברירות מחדל
אל .iso.org.dod.internet.mgmt.mib-2

MIBS רשימת ה-MIBs לטעינה. ברירת המחדל היא SNMPv2-TC:SNMPv2-MIB:IF-MIB:IP-MIB:TCP-
MIB:UDP-MIB:SNMP-VACM-MIB. נדחק על ידי ה -m אוֹפְּצִיָה.

MIBDIRS
רשימת הספריות לחיפוש MIBs. ברירת המחדל היא DATADIR/snmp/mibs.
נדחק על ידי ה -M אוֹפְּצִיָה.

השתמש ב-pysnmpwalk באופן מקוון באמצעות שירותי onworks.net