Hoe gebruikt u de CISCO-BULK-FILE-MIB
Inhoud
Inleiding
Dit document legt uit hoe de CISCO-BULK-FILE-MIB en de overdrachtsbestanden moeten worden gebruikt die met die Management Information Base (MIB) zijn gemaakt met behulp van CISCO-FTP-CLIENT-MIB.
Vanaf Cisco IOS® softwarerelease 12.0 heeft Cisco een manier geïmplementeerd om een Eenvoudig Network Management Protocol (SNMP) object of tabel op het apparaat op te slaan. Dit bestand kan dan worden opgeroepen met de CISCO-FTP-CLIENT-MIB. Met deze technologie kan je grote hoeveelheden gegevens overdragen met een betrouwbare transportmethode.
Voordat u begint
Vereisten
Zorg er voordat u deze configuratie probeert voor dat u aan deze vereisten voldoet:
-
U hebt een Cisco-apparaat dat de Cisco IOS® softwarerelease 12.0 of hoger uitvoert. Controleer het MIB Locator Tool om er zeker van te zijn dat CISCO-BULK-FILE-MIB voor uw apparaat wordt ondersteund. Een link naar het gereedschap is te vinden op de pagina Cisco IOS MIB-tools.
Opmerking: deze MIB wordt niet ondersteund op Catalyst OS-apparaten.
-
SNMP moet op het apparaat worden geconfigureerd met zowel alleen-lezen als gemeenschapskoorden die lezen. Dit wordt niet in dit document behandeld. Voor informatie bij het configureren van SNMP op IOS® apparaten, lees hoe u SNMP Community Strings op Routers kunt configureren, Cisco IOS op software gebaseerde XL Switches, RSM's, MSFC's en Catalyst Switches.
Gebruikte componenten
De informatie in dit document is gebaseerd op de volgende software- en hardware-versies:
-
CISCO-BULK-FILE-MIB om de ifTable op te slaan van een 7507 router die 12.1(12) in een bestand draait. Gebruik vervolgens CISCO-FTP-CLIENT-MIB om dat bestand van de router naar een FTP-server over te brengen.
-
De net-snmp
SNMP commandosuite geïnstalleerd op UNIX of Windows. -
Deze MIB's worden gebruikt:
-
SNMPv2-TC
-
SNMPv2-SMI
-
SNMPv2-CONF
-
SNMPv2-MIB
-
IANAifType-MIB
-
INDIEN-MIB
-
CISCO-SMI
-
CISCO-TC
-
CISCO-BULK-FILE-MIB
-
CISCO-FTP-CLIENT-MIB
-
De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk live is, moet u de potentiële impact van elke opdracht begrijpen.
Conventies
Raadpleeg Cisco Technical Tips Conventions (Conventies voor technische tips van Cisco) voor meer informatie over documentconventies.
Achtergrondinformatie
Zorg ervoor dat de MIB's in deze tabel in uw beheerplatform zijn geladen. Dit staat u toe om de objectnamen en -waarden hierboven te gebruiken in plaats van de numerieke Objectidentificatoren (OIDs). In het algemeen verwijst dit document naar objectnamen en niet naar OID's.
De CISCO-BULK-FILE-MIB gebruiken
Een BULKBESTAND-bewerking maken
In dit voorbeeld vangen we de ifTable van een router en slaan het op in een bulkbestand. U kunt echter elk object of elke tabel van MIB gebruiken.
Gebruik de netto-versie van de computer. Het IP-adres van de router is 14.32.8.2. Zijn read-writer string is privé. De alleen-lezen community string is openbaar.
Telkens wanneer u een nieuwe bulkbestandhandeling maakt, kiest u twee willekeurige getallen voor de rijinstantie. Ze kunnen elk getal zijn tussen 1 en 4294967295 inclusief. Gebruik voor dit voorbeeld 333 en 444.
Stapsgewijze instructies
Voltooi de volgende stappen om een BULK-FILE-bewerking te maken:
-
Stel het te maken bestand in.
$ snmpset -c private 14.32.8.2 cbfDefineFileEntryStatus.333 i 5 $ snmpset -c private 14.32.8.2 cbfDefineFileName.333 s ifTable.txt $ snmpset -c private 14.32.8.2 cbfDefineFileFormat.333 i bulkASCII
-
Specificeer het MIB-object dat moet worden opgenomen.
Dit object heeft twee indexen nodig voor een correct gebruik. 333 is de 333 uit de tabel voor het maken van bestanden hierboven. De 444 is een nieuw willekeurig aantal dat voor de primaire index in de cbfDefineObjectTable wordt gebruikt.
Dit voorbeeld demonstreert het gebruiken van een objectnaam voor cbfDefineObjectID (ifTable). Je zou hier ook een volledig gekwalificeerde OID kunnen gebruiken.
$ snmpset -c private 14.32.8.2 cbfDefineObjectID.333.444 o ifTable
-
Activeert de nieuwe rijen.
U moet beide indexen hebben voor uw cbfDefineObjectTable rij.
$ snmpset -c private 14.32.8.2 cbfDefineObjectEntryStatus.333.444 i 1 $ snmpset -c private 14.32.8.2 cbfDefineFileEntryStatus.333 i 1
-
Maak het bestand.
$ snmpset -c private 14.32.8.2 cbfDefineFileNow.333 i 3
Het bulkbestand wordt gemaakt.
-
Controleer of het bestand met succes is gemaakt met behulp van de snapget in het cbfStatusFileState-object.
Dit object vereist twee indices. De eerste index is het willekeurige nummer dat is geselecteerd voor de Bestandstabel (333 in dit voorbeeld). De tweede index hangt af van het aantal bestanden dat u in uw router hebt gemaakt. Aangezien dit uw eerste bestand is, is de index 1. Gebruik daarom de opdracht:
$ snmpget -c public 14.32.8.2 cbfStatusFileState.333.1
Een waarde van actief(1) betekent dat het bestand momenteel wordt aangemaakt. Een waarde van gereed(2) betekent dat het bestand met succes is gemaakt en wacht op het lezen.
Dit bestand is echter niet rechtstreeks toegankelijk vanaf de router. Gebruik CISCO-FTP-CLIENT-MIB om dit bestand te lezen.
Het bestand overdragen met CISCO-FTP-CLIENT-MIB
Bij elke FTP-client moet u een willekeurig nummer voor de rijinstantie selecteren. U kunt één van de zelfde willekeurige nummers gebruiken die u hierboven gebruikte. Dit voorbeeld gebruikt 555.
Stapsgewijze instructies
Als u het bestand wilt overdragen met een CISCO-FTP-CLIENT-MIB, voert u deze stappen uit:
-
Maak een rij-exemplaar van de FTP-client.
$ snmpset -c private 14.32.8.2 cfcRequestEntryStatus.555 i 5
-
Vul de gewenste parameters in. Het LocalFile moet dezelfde naam zijn als het bestand dat u hierboven hebt gemaakt! Gebruik putASCII om bulkASCII bestanden over te brengen.
Als u het cbfDefineFileFormat instelt op bulkBinary hierboven, moet u cfcApplication Operatie instellen om Binair te maken.
$ snmpset -c private 14.32.8.2 cfcRequestOperation.555 i putASCII $ snmpset -c private 14.32.8.2 cfcRequestLocalFile.555 s ifTable.txt $ snmpset -c private 14.32.8.2 cfcRequestRemoteFile.555 s /home/Marcus/ifTable.txt $ snmpset -c private 14.32.8.2 cfcRequestServer.555 s 172.18.123.33 $ snmpset -c private 14.32.8.2 cfcRequestUser.555 s Marcus $ snmpset -c private 14.32.8.2 cfcRequestPassword.555 s marcus123
-
Begin met de overdracht door de rij in te stellen op actief.
$ snmpset -c private 14.32.8.2 cfcRequestEntryStatus.555 i 1
De FTP-overdracht begint. Na voltooiing, wordt het bestand opgeslagen op /home/Marcus/ifTable.txt.
-
Om de status van de FTP-overdracht te krijgen, gebruikt u de snapget opnieuw op het cfcrequestResult-object.
Dit object gebruikt dezelfde index als bij de andere FTP-objecten.
$ snmpget -c public 14.32.8.2 cfcRequestResult.555
Een waarde van hangende(1) betekent dat het bestand nog steeds overdraagt. Een waarde van succes(2) betekent het overgedragen bestand. Elke andere waarde is een fout.
-
Wanneer het bestand overgemaakt is, probeert u het pictogram van het cbfStatusFileState opnieuw. Het heeft nu een andere waarde.
$ snmpget -c public 14.32.8.2 cbfStatusFileState.333.1 enterprises.cisco.ciscoMgmt.ciscoBulkFileMIB.ciscoBulkFileMIBObjects.cbfStatus. cbfStatusFileTable.cbfStatusFileEntry.cbfStatusFileState.333.1 = emptied(3)
De waarde van geleegd(3) betekent dat het bestand is gelezen. Het bestand kan niet opnieuw worden overgedragen.
-
Het is nu veilig om dit bestand te verwijderen door de rij voor de bestandstatus te vernietigen. Dit object krijgt dezelfde indices als de bovenstaande cbfStatusFileState.
$ snmpset -c private 14.32.8.2 cbfStatusFileEntryStatus.333.1 i 6
-
Verwijdert het bestand zodra het is verwijderd, het betreffende object en de rijen van het bestand.
$ snmpset -c private 14.32.8.2 cbfDefineObjectEntryStatus.333.444 i 6 $ snmpset -c private 14.32.8.2 cbfDefineFileEntryStatus.333 i 6
Op deze manier kunt u CISCO-FTP-CLIENT-MIB gebruiken om een bestand van de router over te dragen met behulp van FTP.
Het resultaat controleren
Deze sectie helpt u bij het lezen van een aantal syntax voor dit bestand.
-
De eerste regel is de regel prefix. Voor ons ifTable voorbeeld is het:
prefix 1.3.6.1.2.1.2.2.1
Dit komt overeen met de OID voor het ifEntry object. De ifTable bestaat uit een of meer if.
-
De volgende regel toont het aantal objecten in de tabel. De lijn bestaat uit de sleutelwoordenlijst gevolgd door het aantal objecten in de tabel, gevolgd door de index van elk object.
Bijvoorbeeld:
table 22 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22
Deze lijn verklaart dat de tabel 22 objecten bevat, en elk object heeft een stijgende index. Deze objecten komen uit het ifTable voorbeeld:
ifIndex ifDescr ifType ifSpeed ...
-
Na deze regel worden er meerdere rijen items ingevoegd. In het voorbeeld ifTable correspondeert elke rij met een interface. De rijen beginnen met de sleutelwoordenrij, gevolgd door hun indexidentificatie, en gevolgd door de objecten die door de vorige tabelingang zijn opgesomd.
Bijvoorbeeld:
row 1 1 546F6B656E52696E67302F30 9 4464 16000000 0008B0851800 2 2 6551 0 0 0 0 0 0 0 0 0 0 0 0 0.0
-
De vierde ingang is de ifDescr voor interface 1. Dit is echter de ifDescr in hexadecimale gecodeerde ASCII.
U kunt deze regel als volgt vertalen in een leesbaarder indeling: gebruik deze opdracht:
$ perl -e 'print pack("H*", "546F6B656E52696E67302F30")' TokenRing0/0Deze ingang komt overeen met interface TokenRing0/0. Alle objecten die normaal strijken zijn worden weergegeven als hexadecimale gecodeerde ASCII in de bulkbestanden. U kunt deze opdracht Perl gebruiken om een hexadecimale ASCII-string te vertalen in leesbare tekst. Als u geen Perl hebt, gebruik dan deze ASCII tekentabel
om de string te vertalen. -
Sommige items tonen ~ karakters voor waarden. Dit betekent dat de waarde voor dat object NULL is. Dat wil zeggen, het object is niet op het apparaat geïnstalleerd.
Bijvoorbeeld:
row 9 9 41544D312F302F302D61746D206C61796572 37 ~ 0 1 1 5971 ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
Dit komt overeen met de ATM1/0/0 ATM laaginterface. Merk op dat alsMtu NULL is voor deze interface. Aangezien het om een virtuele interface gaat, is het logisch dat deze geen MTU heeft. Als u dit wenst, kunt u deze NULLs met 0 vervangen door deze opdracht aan de configuratie van het apparaat toe te voegen:
Router(config)#no snmp-server sparse-table
Resultaat oplossen
Bij het opvragen van het cbfStatusFileState-object is uw operatie een fout opgetreden als u een andere waarde ontvangt dan actief(1), klaar(2) of geleegd(3). Dit zijn oorzaken voor de fouten:
noSpace no data due to insufficient file space
badName no data due to a name or path problem
writeErr no data due to fatal file write error
noMem no data due to insufficient dynamic memory
buffErr implementation buffer too small
aborted short terminated by operator command
Als het aantal objecten in het bestand kleiner is dan u verwacht, is mogelijk dat cbfDefineMaxObjects van CISCO-BULK-FILE-MIB te laag is ingesteld. Om de huidige waarde van het object te bepalen, gebruikt u een bom.
$ snmpget -c public 14.32.8.2 cbfDefineMaxObjects.0
Een waarde van 0 betekent dat er geen limiet wordt ingesteld. De waarde kan worden ingesteld op elk integer tussen 0 en 4294967295, inclusief. Als u de maximale objecten per bestand op 10 wilt instellen, gebruikt u de opdracht SNMP. De index voor dit object is altijd 0.
$ snmpset -c private 14.32.8.2 cbfDefineMaxObjects.0 u 10
Dit object kan niet op alle platforms instelbaar zijn. Als de bom faalt met deze fout, is het object niet Configureerbaar op uw platform:
Error in packet. Reason: (noSuchName) There is no such variable name in this MIB. Failed object: enterprises.cisco.ciscoMgmt.ciscoBulkFileMIB.ciscoBulkFileMIBObjects.cbfDefine.cbfDefineMaxObjects.0
Bij het opiniepeilen van het cfcApplicationResultaat-object en als u een andere waarde dan hangend(1) of succes(2) ontvangt, heeft de FTP-operatie een fout aangetroffen. Dit zijn oorzaken voor de fouten:
aborted user aborted the transfer
fileOpenFailLocal local bulk file was not found
fileOpenFailRemote remote file could not be opened for writing
badDomainName FTP server's hostname could not be resolved
unreachableIpAddress route to the FTP server could not be found
linkFailed connection could not be made to the remote server
fileReadFailed local file could not be read
fileWriteFailed remote file could not be written
Caveats
-
Op dit moment is er geen ondersteunde manier om de bulkbestanden rechtstreeks te benaderen. U moet door de CISCO-FTP-CLIENT-MIB gaan om de bestanden te lezen.
-
Het object cbfDefineFileStorage definieert drie typen: vluchtig, vluchtig en permanent. Op dit moment is het enige type dat in IOS wordt ondersteund kortstondig. Ephemeral bestanden bestaan in kleine hoeveelheden tot ze gelezen zijn.
-
Nadat de bestanden zijn gelezen, kunnen ze niet meer worden gelezen. Ze moeten eerst opnieuw gecreëerd worden.
-
Het object cbfDefineFileFormat definieert drie typen: StandardBER, bulkBinary, en bulkASCII. De enige ondersteunde formaten zijn bulkBinary en bulkASCII. Het standaardformaat is bulkBinary.
-
Het is bekend dat de FTP-server van Chameleon voor Windows niet met CISCO-FTP-CLIENT-MIB kan werken omdat deze geen correcte resultaatcodes teruggeeft.
Feedback