PRVT-INTERWORKING-OS-MIB
B.A.T.M. Advance TechnologiesThe MIB enables display configuration of the device OS features.
snmptranslate -m PRVT-INTERWORKING-OS-MIB -Tpsnmpwalk -v2c -c <community> -m PRVT-INTERWORKING-OS-MIB <host> 1.3.6.1.4.1.738.10.111.1Imports
| INET-ADDRESS-MIB | InetAddress, InetAddressType, InetPortNumber |
|---|---|
| PRVT-SWITCH-MIB | software |
| SNMPv2-CONF | MODULE-COMPLIANCE, NOTIFICATION-GROUP |
| SNMPv2-SMI | Bits, Integer32, IpAddress, MODULE-IDENTITY, MibIdentifier, OBJECT-IDENTITY, OBJECT-TYPE, TimeTicks, Unsigned32, iso |
| SNMPv2-TC | DateAndTime, DisplayString, PhysAddress, TEXTUAL-CONVENTION, TestAndIncr |
OID tree
| Name | OID | Type | Access | Status | Example | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| IprvtInterworkingOSMIB | 1.3.6.1.4.1.738.10.111.1 | ||||||||||||
identity The MIB enables display configuration of the device OS features. | |||||||||||||
| NprvtInterworkingOSMIBObjects | 1.3.6.1.4.1.738.10.111.1.1 | ||||||||||||
| Nversion | 1.3.6.1.4.1.738.10.111.1.1.1 | ||||||||||||
| SoSversionNumber | 1.3.6.1.4.1.738.10.111.1.1.1.1 | DisplayString | RO | 2.4.R3.1.1 | |||||||||
scalar · DisplayString · read-only · current This object identifies version number of the OS Example values from LibreNMS test devices
| |||||||||||||
| SoSversionDate | 1.3.6.1.4.1.738.10.111.1.1.1.2 | DisplayString | RO | ||||||||||
scalar · DisplayString · read-only · current This object identifies version date of the OS | |||||||||||||
| SbootVersionDate | 1.3.6.1.4.1.738.10.111.1.1.1.3 | DisplayString | RO | ||||||||||
scalar · DisplayString · read-only · current This object identifies boot version date of the OS | |||||||||||||
| Nmanagement | 1.3.6.1.4.1.738.10.111.1.1.2 | ||||||||||||
| NmanagementMisc | 1.3.6.1.4.1.738.10.111.1.1.2.1 | ||||||||||||
| SmanagementMiscReset | 1.3.6.1.4.1.738.10.111.1.1.2.1.1 | INTEGER | RW | ||||||||||
scalar · INTEGER · read-write · current Physically performs a hardware reset of the unit. Use with care. A reset (2) resets the unit, the resetToDefaults (3) resets the configuration file to factory defaults and then resets the unit, the value of saveAndReset (4) saves the config and then resets the unit and noop (1) does nothing. A value of noop (1) is always returned for a GET operation.
| |||||||||||||
| SmanagementMiscReload | 1.3.6.1.4.1.738.10.111.1.1.2.1.2 | INTEGER | RW | ||||||||||
scalar · INTEGER · read-write · current Reload the unit software, the unit hardware will not be affected. A value of noop (1) is always returned for a GET operation.
| |||||||||||||
| SmanagementMiscReloadInTime | 1.3.6.1.4.1.738.10.111.1.1.2.1.3 | OCTET STRING (SIZE (4)) | RW | ||||||||||
scalar · OCTET STRING (SIZE (4)) · read-write · current Indicates time for scheduled reload without save in hour:min. octets contents range 1 day 0x01..0x1f (1-31) 2 month 0x01..0x0C (1..12) where january = 1 december = 12 3 hour 0x01..0x17 (0..23) 4 min 0x01..3B (0..59) For example: 0x01 0x01 0x01 0x01 means 1 January 01:01. To stop scheduled reload set it to 0x00 0x00 0x00 0x00 | |||||||||||||
| SmanagementMiscReloadAtTime | 1.3.6.1.4.1.738.10.111.1.1.2.1.4 | OCTET STRING (SIZE (4)) | RW | ||||||||||
scalar · OCTET STRING (SIZE (4)) · read-write · current Indicates time for scheduled reload without save at day:month:hour:min. octets contents range 1 day 0x01..0x1f (1-31) 2 month 0x01..0x0C (1..12) where january = 1 december = 12 3 hour 0x01..0x17 (0..23) 4 min 0x01..3B (0..59) For example: 0x01 0x01 0x01 0x01 means 1 January 01:01. To stop scheduled reload set it to 0x00 0x00 0x00 0x00 | |||||||||||||
| NprvtBootConfigUpgrade | 1.3.6.1.4.1.738.10.111.1.1.2.2 | ||||||||||||
| SprvtBootUpgradeSrcURI | 1.3.6.1.4.1.738.10.111.1.1.2.2.1 | DisplayString | RW | ||||||||||
scalar · DisplayString · read-write · current The object represents an address from where the application will be copied during an upgrade process initiated using the object prvtBootUpgradeCmd. The address must be given in a valid URI format. Examples: ftp://myuser:mypass@netaddress/MyApps/Imagev1.5.Z tftp://netaddress/MyApps/Imagev1.5.Z | |||||||||||||
| SprvtBootApplicationName | 1.3.6.1.4.1.738.10.111.1.1.2.2.2 | DisplayString | RW | ||||||||||
scalar · DisplayString · read-write · current This object contains the file name of the application that will be loaded upon the next restart. Sets to this object must be the file name of an existing OS image. A list of existing OS images can be obtained by performing a walk of prvtFileSystemFileName.osImage. Sets with the name of a non-existing OS image will result in an error response. Note that no validation of the image is performed when a new image is selected by writing to this object. | |||||||||||||
| SprvtBootUpgradeCmd | 1.3.6.1.4.1.738.10.111.1.1.2.2.4 | INTEGER | RW | ||||||||||
scalar · INTEGER · read-write · current This field is used to initiate an upgrade process. The object prvtBootUpgradeSrcURI is to contain the source URI of where to obtain the new image. When a get request is executed, the returned value will be always ready. When a set with the value applyExec is made to this object, the upgrade process is started.
| |||||||||||||
| SprvtBootOperStatus | 1.3.6.1.4.1.738.10.111.1.1.2.2.5 | INTEGER | RO | ||||||||||
scalar · INTEGER · read-only · current The object is used to show the current status of the upgrading process. The default value is ready(1), indicating that the process is idle. upgradeInProgress(3) indicates an upgrade process has started and has not finished yet.
| |||||||||||||
| SprvtBootErrorCondition | 1.3.6.1.4.1.738.10.111.1.1.2.2.6 | INTEGER | RO | ||||||||||
scalar · INTEGER · read-only · current This object gives the error condition of the most recent upgrade process initiated using the object prvtBootUpgradeCmd.
| |||||||||||||
| NprvtConfigFiles | 1.3.6.1.4.1.738.10.111.1.1.2.3 | ||||||||||||
| NprvtConfigFileAction | 1.3.6.1.4.1.738.10.111.1.1.2.3.1 | ||||||||||||
| NprvtConfigFileSource | 1.3.6.1.4.1.738.10.111.1.1.2.3.1.1 | ||||||||||||
| SprvtConfigSourceType | 1.3.6.1.4.1.738.10.111.1.1.2.3.1.1.1 | PrvtFileLocationType | RW | ||||||||||
scalar · PrvtFileLocationType · read-write · current The type of the location of the source file used by prvtConfigAction. | |||||||||||||
| SprvtConfigSourceFileName | 1.3.6.1.4.1.738.10.111.1.1.2.3.1.1.2 | DisplayString | RW | ||||||||||
scalar · DisplayString · read-write · current The name of the file intended to be copied if prvtConfigAction='copy'; or the file whose name is to be changed if prvtConfigFileAction='rename'; or the file to be merged to running configuration if prvtConfigAction='merge'. Otherwise, has no significance. | |||||||||||||
| NprvtConfigFileTarget | 1.3.6.1.4.1.738.10.111.1.1.2.3.1.2 | ||||||||||||
| SprvtConfigTargetType | 1.3.6.1.4.1.738.10.111.1.1.2.3.1.2.1 | PrvtFileLocationType | RW | ||||||||||
scalar · PrvtFileLocationType · read-write · current The type of the location of the destination file used by prvtConfigAction. | |||||||||||||
| SprvtConfigTargetFileName | 1.3.6.1.4.1.738.10.111.1.1.2.3.1.2.2 | DisplayString | RW | ||||||||||
scalar · DisplayString · read-write · current The name of the file intended to be copied to if prvtConfigAction='copy'; or the new file name if prvtConfigFileAction='rename'. Otherwise, has no significance. | |||||||||||||
| NprvtConfigFileRemote | 1.3.6.1.4.1.738.10.111.1.1.2.3.1.3 | ||||||||||||
| SprvtConfigRemoteAddressType | 1.3.6.1.4.1.738.10.111.1.1.2.3.1.3.1 | InetAddressType | RW | ||||||||||
scalar · InetAddressType · read-write · current The address type of prvtConfigRemoteAddress. Note that prvtConfigAction currently only support actions that use IPv4 address types. | |||||||||||||
| SprvtConfigRemoteAddress | 1.3.6.1.4.1.738.10.111.1.1.2.3.1.3.2 | InetAddress | RW | ||||||||||
scalar · InetAddress · read-write · current The IP address of the remote file server to use for the upload or download request. | |||||||||||||
| SprvtConfigRemotePort | 1.3.6.1.4.1.738.10.111.1.1.2.3.1.3.3 | InetPortNumber | RW | ||||||||||
scalar · InetPortNumber · read-write · current The transport protocol port to use for the upload or download request. The value '0' indicates to use the IANA default port number for the selected protocol. | |||||||||||||
| SprvtConfigRemoteUser | 1.3.6.1.4.1.738.10.111.1.1.2.3.1.3.4 | DisplayString | RW | ||||||||||
scalar · DisplayString · read-write · current The user name to use for the upload or download request. | |||||||||||||
| SprvtConfigRemotePassword | 1.3.6.1.4.1.738.10.111.1.1.2.3.1.3.5 | DisplayString | RW | ||||||||||
scalar · DisplayString · read-write · current The user password to use for the upload or download request. | |||||||||||||
| SprvtConfigActionSpinLock | 1.3.6.1.4.1.738.10.111.1.1.2.3.1.4 | TestAndIncr | RW | ||||||||||
scalar · TestAndIncr · read-write · current This object is used to facilitate prvtConfigAction
sets by multiple managers, specifically sets that transitions
prvtConfigAction from 'idle' to 'prepare'.
The procedure for performing this transition is as follows:
1. Retrieve the value of prvtConfigAction. If value is not 'idle',
then wait until prvtConfigAction returns to 'idle'.
2. Retrieve the value of prvtConfigActionSpinLock.
3. Within a single set request packet, set the value of prvtConfigActionSpinLock
to the retrieved value, and the value of prvtConfigAction to 'prepare'.
If the set fails for the prvtConfigActionSpinLock object, go back to step 1.
Note that the use of the prvtConfigActionSpinLock object is optional
(prvtConfigAction can be set without using prvtConfigActionSpinLock). | |||||||||||||
| SprvtConfigAction | 1.3.6.1.4.1.738.10.111.1.1.2.3.1.5 | INTEGER | RW | ||||||||||
scalar · INTEGER · read-write · current Represents a file action request to be committed immediately (with set request) or that is being commited (with get request). idle = there is no action being performed or prepared prepare = parameters of an action are being edited. This is used by the manager to willingly avoid editing parameters while another manager does so. copy = copy a file from source to target, where source and target have a broad meaning (local/remote file system or running configuration). See details below. rename = rename a local file (see details below) merge = merge a local file to running configuration Allowed Transitions: * idle to prepare * prepare to any other Automatic Transitions: * copy to idle, when action is done * rename to idle, when action is done * merge to idle, when action is done ****************************** * Action = copy * ****************************** The following table gives the corresponding CLI command for each combination of source and target type. +--------------+----------------------+----------------------+---------------+----------------------+ | \ Target|fileSystem |runningBinary |runningScript |ftp | |Source \ | | | | | +--------------+----------------------+----------------------+---------------+----------------------+ |fileSystem |file cp from |file restore |file replace |file cp from | | |SRC |binary-running-config |SRC |SRC | | |TRG |flash | |FTP_TRG | +--------------+----------------------+----------------------+---------------+----------------------+ |techSupport |file cp |-- not legal -- |-- not legal --|file cp | | |technical-support | | |technical-support | | |TRG | | |FTP_TRG | +--------------+----------------------+----------------------+---------------+----------------------+ |runningBinary |file backup |-- not legal -- |-- not legal --|file backup | | |binary-running-config | | |binary-running-config | | |flash | | |FTP_TRG | +--------------+----------------------+----------------------+---------------+----------------------+ |runningScript |file cp |-- not legal -- |-- not legal --|file cp | | |running-configuration | | |running-configuration | | |TRG | | |FTP_TRG | +--------------+----------------------+----------------------+---------------+----------------------+ |ftp |file cp from |file restore |-- not legal --|-- not legal -- | | |FTP_SRC |binary-running-config | | | | |TRG |FTP_SRC | | | +--------------+----------------------+----------------------+---------------+----------------------+ Comments: (a) FTP_SRC denotes ftp://[USER[:PSW]@]ADR[:PORT]/SRC FTP_TRG denotes ftp://[USER[:PSW]@]ADR[:PORT]/TRG (b) SRC, TRG, USER, PSW, ADR and PORT are respectively the values of prvtConfigSourceFileName, prvtConfigTargetFileName, prvtConfigRemoteUser, prvtConfigRemotePassword, prvtConfigRemoteAddress and prvtConfigRemotePort. When any of these are not mentioned in the command, then the value is not relevant. (c) tftp is the same as ftp, except that USER, PSW are not used (d) the error 'inconsistentValue' is returned for any combination marked 'not legal' (e) a successful execution of a copy action when target type is 'runningBinary' (equivalent CLI command is 'file restore binary-running config ...') results in a system reload (f) The above comments are also applicable to the other actions explained below. ****************************** * Action = rename * ****************************** equivalent to CLI command: file mv SRC TRG prvtConfigTargetType and prvtConfigSourceType must equal to 'fileSystem' ****************************** * Action = merge * ****************************** equivalent to CLI command: file merge SRC prvtConfigSourceType must equal 'fileSystem' prvtConfigTargetType must equal 'runningScript' ****************************** * Examples * ****************************** [1] To save the binary of the running configuration to a remote ftp server, with default username, default password, default port, IP = 10.2.144.20, and target file name 'example.bin', the procedure would be (assuming that prvtConfigAction is initially in 'idle' state): set prvtConfigAction <- 'prepare' set prvtConfigSourceType <- 'runningBinary' set prvtConfigTargetType <- 'ftp' set prvtConfigTargetFileName <- 'example.bin' set prvtConfigRemoteAddress <- '10.2.144.20' set prvtConfigAction <- 'copy' [2] To rename a file named 'first.txt' to 'second.txt', the procedure would be (assuming that prvtConfigAction is initially in 'idle' state): set prvtConfigAction <- 'prepare' set prvtConfigSourceType <- 'fileSystem' set prvtConfigTargetType <- 'fileSystem' set prvtConfigSourceFileName <- 'first.txt' set prvtConfigTargetFileName <- 'second.txt' set prvtConfigAction <- 'rename'
| |||||||||||||
| NprvtFileSystem | 1.3.6.1.4.1.738.10.111.1.1.2.4 | ||||||||||||
| SprvtFileSystemSize | 1.3.6.1.4.1.738.10.111.1.1.2.4.1 | Unsigned32 | RO | ||||||||||
scalar · Unsigned32 · read-only · current The size of the file system flash.
| |||||||||||||
| SprvtFileSystemUsedSize | 1.3.6.1.4.1.738.10.111.1.1.2.4.2 | Unsigned32 | RO | ||||||||||
scalar · Unsigned32 · read-only · current The size of the currently used part of the file system flash.
| |||||||||||||
| SprvtFileSystemFreeSize | 1.3.6.1.4.1.738.10.111.1.1.2.4.3 | Unsigned32 | RO | ||||||||||
scalar · Unsigned32 · read-only · current The size of the currently free to use part of the file system flash.
| |||||||||||||
| TprvtFileSystemFileTable | 1.3.6.1.4.1.738.10.111.1.1.2.4.4 | NA | |||||||||||
table · not-accessible · current A table of files existing in the device's file system. | |||||||||||||
| RprvtFileSystemFileEntry | 1.3.6.1.4.1.738.10.111.1.1.2.4.4.1 | NA | |||||||||||
row · not-accessible · current An entry of prvtFileSystemFileTable. | |||||||||||||
| CprvtFileSystemFileType | 1.3.6.1.4.1.738.10.111.1.1.2.4.4.1.1 | INTEGER | NA | ||||||||||
column · INTEGER · not-accessible · current The file type. The value 'osImage' signals that this file is a software image file for possible use by the device.
| |||||||||||||
| CprvtFileSystemFileIndex | 1.3.6.1.4.1.738.10.111.1.1.2.4.4.1.2 | Unsigned32 (1..4294967295) | NA | ||||||||||
column · Unsigned32 (1..4294967295) · not-accessible · current An index uniquely identifying a file. This value does not change through-out the lifetime of a file, but may change after system restarts. Note that after a file has been deleted, this value may be re-used by a newly created file with the same or a different file name. | |||||||||||||
| CprvtFileSystemFileCreated | 1.3.6.1.4.1.738.10.111.1.1.2.4.4.1.3 | DateAndTime | RO | ||||||||||
column · DateAndTime · read-only · current Represents the date and time this file was created. | |||||||||||||
| CprvtFileSystemFileSize | 1.3.6.1.4.1.738.10.111.1.1.2.4.4.1.4 | Unsigned32 | RO | ||||||||||
column · Unsigned32 · read-only · current Represents the size of this file.
| |||||||||||||
| CprvtFileSystemFileName | 1.3.6.1.4.1.738.10.111.1.1.2.4.4.1.5 | DisplayString | RO | ||||||||||
column · DisplayString · read-only · current Represents the name of this file. | |||||||||||||
| CprvtFileSystemFileDelete | 1.3.6.1.4.1.738.10.111.1.1.2.4.4.1.6 | DisplayString | RW | ||||||||||
column · DisplayString · read-write · current May be used to delete a file. To delete a file, this object must be set equal to the value of prvtFileSystemFileName of the same row. Note that some files are protected from being deleted. Reads of this object always return a zero-length string. | |||||||||||||
| Ncpu | 1.3.6.1.4.1.738.10.111.1.1.3 | ||||||||||||
| NcpuMonitoring | 1.3.6.1.4.1.738.10.111.1.1.3.1 | ||||||||||||
| ScpuMonitoringUtilization | 1.3.6.1.4.1.738.10.111.1.1.3.1.1 | Integer32 | RO | 6 | |||||||||
Textual conventions
PrvtFileLocationTypeINTEGERfileSystem(1)ftp(6)runningBinary(2)runningScript(3)techSupport(4)tftp(5)A value that represents a type of a file location interface. fileSystem(1) -- The local file system. runningBinary(2) -- The running configuration on RAM, as a binary file interface runningScript(3) -- The running configuration on RAM, as a CLI-script file interface techSupport(4) -- The CLI show command output tftp(5) -- A remote file system reached by the TFTP protocol ftp(6) -- A remote file system reached by the FTP protocol.