-- =========================================================================================================== -- Copyright (c) 2004-2018 New H3C Tech. Co., Ltd. All rights reserved. -- -- Description: ISSU MIB -- Reference: -- Version: V1.2 -- History: -- Revision 1.0 2012-12-20 created by Wang Feng -- 2013-4-20 modified by Zhu Liuxing -- Revision 1.1 2014-01-10 change hh3cIssuUpgradeImageIndex and -- hh3cIssuUpgradeImageURL range by z03030 -- Revision 1.2 2018-04-08 change hh3cIssuUpgradeImageType by l07660 -- ============================================================================================================ HH3C-ISSU-MIB DEFINITIONS ::= BEGIN IMPORTS hh3cCommon FROM HH3C-OID-MIB Integer32, OBJECT-TYPE, MODULE-IDENTITY, NOTIFICATION-TYPE FROM SNMPv2-SMI DisplayString, RowStatus, TruthValue FROM SNMPv2-TC; hh3cIssuUpgrade MODULE-IDENTITY LAST-UPDATED "201301151536Z" -- January 15, 2013 at 15:36 GMT ORGANIZATION "New H3C Tech. Co., Ltd." CONTACT-INFO "Platform Team New H3C Tech. Co., Ltd. Haidian District Beijing P.R. China http://www.h3c.com Zip:_100085" DESCRIPTION "This MIB provides objects for upgrading images on modules in the system, objects for showing the result of an upgrade operation, and objects for showing the result of a test operation. To perform an upgrade operation, a management application must first read the hh3cIssuUpgradeImageTable table and use the information in other tables, as explained below. You can configure a new image name for each image type as listed in hh3cIssuUpgradeImageTable. The system will use this image on the particular module at the next reboot. The management application used to perform an upgrade operation must first check if an upgrade operation is already in progress in the system. This is done by reading the hh3cIssuOpType ('none' indicates that no other upgrade operation is in progress. Any other value indicates that an upgrade is already in progress and a new upgrade operation is not allowed. To start an 'install' operation, the user must first perform a 'test' operation to examine the version compatibility between the given set of images and the running images. Only if the result of the 'test' operation is 'success' can the user proceed to do an install operation. The table hh3cIssuTestResultTable provides the result of the 'test' operation performed by using hh3cIssuOpType. The table hh3cIssuUpgradeResultTable provides the result of the 'install' operation performed by using hh3cIssuOpType. " REVISION "201301151536Z" -- January 15, 2013 at 15:36 GMT DESCRIPTION "Initial version of this MIB module. Added hh3cIssuUpgradeImageTable hh3cIssuOp hh3cIssuCompatibleResult hh3cIssuTestResultTable hh3cIssuUpgradeResultTable" ::= { hh3cCommon 133 } -- -- Node definitions -- hh3cIssuUpgradeMibObjects OBJECT IDENTIFIER ::= { hh3cIssuUpgrade 1 } hh3cIssuUpgradeGroup OBJECT IDENTIFIER ::= { hh3cIssuUpgradeMibObjects 1 } hh3cIssuUpgradeImageTable OBJECT-TYPE SYNTAX SEQUENCE OF Hh3cIssuUpgradeImageEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A table listing the image variable types that exist in the device." ::= { hh3cIssuUpgradeGroup 1 } hh3cIssuUpgradeImageEntry OBJECT-TYPE SYNTAX Hh3cIssuUpgradeImageEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An hh3cIssuUpgradeImageEntry entry. Each entry provides an image variable type that exists in the device." INDEX { hh3cIssuUpgradeImageIndex } ::= { hh3cIssuUpgradeImageTable 1 } Hh3cIssuUpgradeImageEntry ::= SEQUENCE { hh3cIssuUpgradeImageIndex Integer32, hh3cIssuUpgradeImageType INTEGER, hh3cIssuUpgradeImageURL DisplayString, hh3cIssuUpgradeImageRowStatus RowStatus } hh3cIssuUpgradeImageIndex OBJECT-TYPE SYNTAX Integer32 (1..2147483647) MAX-ACCESS not-accessible STATUS current DESCRIPTION "Index of each image." ::= { hh3cIssuUpgradeImageEntry 1 } hh3cIssuUpgradeImageType OBJECT-TYPE SYNTAX INTEGER { boot(1), system(2), feature(3), ipe(4), patch(5) } MAX-ACCESS read-create STATUS current DESCRIPTION "Types of images that the system can run. The value of this object has five image variable names: 'boot', 'system', 'feature', 'ipe' and 'patch'. This table will then list these five strings as follows: hh3cIssuUpgradeImageType boot system feature IPE patch The user can assign images (using hh3cIssuUpgradeImageURL) to these variables and the system will use the assigned images to boot." ::= { hh3cIssuUpgradeImageEntry 2 } hh3cIssuUpgradeImageURL OBJECT-TYPE SYNTAX DisplayString (SIZE (1..127)) MAX-ACCESS read-create STATUS current DESCRIPTION "This object contains the path of the image of this entity." ::= { hh3cIssuUpgradeImageEntry 3 } hh3cIssuUpgradeImageRowStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "Row-status of image table." ::= { hh3cIssuUpgradeImageEntry 4 } hh3cIssuOp OBJECT IDENTIFIER ::= { hh3cIssuUpgradeGroup 2 } hh3cIssuOpType OBJECT-TYPE SYNTAX INTEGER { none(1), done(2), test(3), install(4), rollback(5) } MAX-ACCESS read-write STATUS current DESCRIPTION "Command to be executed. The 'test' command must be performed before the 'install' command can be executed. The 'install' command is allowed only if a read of this object returns 'test' and the value of object hh3cIssuOpStatus is 'success'. Command Remarks none If the user sets this object to 'none', the agent will return a success without performing an upgrade operation. done If this object returns any value other than 'none', setting this to 'done' will do the required cleanup of the previous upgrade operation and get the system ready for a new upgrade operation. test Check the version compatibility and upgrade method for the given set of image files. install For all the image entities listed in the hh3cIssuUpgradeImageTable, perform the required upgrade operation listed in that table. rollback Abort the current 'install' operation and roll back to the previous version. " DEFVAL { none } ::= { hh3cIssuOp 1 } hh3cIssuImageFileOverwrite OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION "If you want to overwrite the existing file, set the value of this object to enable. Otherwise, set the value of this object to disable." DEFVAL { true } ::= { hh3cIssuOp 2 } hh3cIssuOpTrapEnable OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION "If you want to enable the trap, set the value of this object to enable. Otherwise, set the value of this object to disable." DEFVAL { true } ::= { hh3cIssuOp 3 } hh3cIssuOpStatus OBJECT-TYPE SYNTAX INTEGER { none(1), failure(2), inProgress(3), success(4), rollbackInProgress(5), rollbackSuccess(6) } MAX-ACCESS read-only STATUS current DESCRIPTION "Status of the specified operation. none - No operation was performed. failure - Specified operation has failed. inProgress - Specified operation is in progress. success - Specified operation completed successfully. rollbackInProgress - Rollback operation is in progress. rollbackSuccess - Rollback operation completed successfully. " DEFVAL { none } ::= { hh3cIssuOp 4 } hh3cIssuFailedReason OBJECT-TYPE SYNTAX DisplayString (SIZE (0..255)) MAX-ACCESS read-only STATUS current DESCRIPTION "Indicates the the cause of 'failure' state of the object 'hh3cIssuOpStatus'. This object would be a null string if the value of 'hh3cIssuOpStatus' is not 'failure'." ::= { hh3cIssuOp 5 } hh3cIssuOpTimeCompleted OBJECT-TYPE SYNTAX DisplayString (SIZE (0..255)) MAX-ACCESS read-only STATUS current DESCRIPTION "Indicates the time when the upgrade operation was completed. This object would be a null string if hh3cIssuOpType is 'none'. " ::= { hh3cIssuOp 6 } hh3cIssuLastOpType OBJECT-TYPE SYNTAX INTEGER { none(1), done(2), test(3), install(4), rollback(5) } MAX-ACCESS read-only STATUS current DESCRIPTION "This object indicates the previous hh3cIssuOp value. It will be updated after a new hh3cIssuOp is set and delivered to the upgrade process. Command Remarks none If the user sets this object to 'none', agent will return a success without performing an upgrade operation. done If this object returns any value other than 'none', setting this to 'done' will do the required cleanup of the previous upgrade operation and get the system ready for a new upgrade operation. test Check the version compatibility and upgrade method for the given set of image files. install For all the image entities listed in the hh3cIssuUpgradeImageTable, perform the required upgrade operation listed in that table. rollback Abort the current install operation and roll back to the previous version. " DEFVAL { none } ::= { hh3cIssuOp 7 } hh3cIssuLastOpStatus OBJECT-TYPE SYNTAX INTEGER { none(1), failure(2), inProgress(3), success(4), rollbackInProgress(5), rollbackSuccess(6) } MAX-ACCESS read-only STATUS current DESCRIPTION "This object indicates previous hh3cIssuOpStatus value. It will be updated after new hh3cIssuOp is set and delivered to upgrade process. none - No operation was performed. failure - Specified operation has failed. inProgress - Specified operation is active. success - Specified operation completed successfully. rollbackInProgress - Rollback operation is in progress. rollbackSuccess - Rollback operation completed successfully. " DEFVAL { none } ::= { hh3cIssuOp 8 } hh3cIssuLastOpFailedReason OBJECT-TYPE SYNTAX DisplayString (SIZE (0..255)) MAX-ACCESS read-only STATUS current DESCRIPTION "Indicates the cause of 'failure' state of the object 'hh3cIssuOpStatus'. This object would be a null string if the value of 'hh3cIssuOpStatus' is not 'failure'. The value will be updated when new hh3cIssuOp is set and delivered to the upgrade process." ::= { hh3cIssuOp 9 } hh3cIssuLastOpTimeCompleted OBJECT-TYPE SYNTAX DisplayString (SIZE (0..255)) MAX-ACCESS read-only STATUS current DESCRIPTION "Indicates the previous hh3cIssuOpTimeCompleted value. The value will be updated when new hh3cIssuOp is set and delivered to the upgrade process." ::= { hh3cIssuOp 10 } hh3cIssuUpgradeResultGroup OBJECT IDENTIFIER ::= { hh3cIssuUpgradeMibObjects 2 } hh3cIssuCompatibleResult OBJECT IDENTIFIER ::= { hh3cIssuUpgradeResultGroup 1 } hh3cIssuCompatibleResultStatus OBJECT-TYPE SYNTAX INTEGER { none(1), inCompatible(2), compatible(3), failure(4) } MAX-ACCESS read-only STATUS current DESCRIPTION "Specifies whether the images provided in hh3cIssuUpgradeImageTable are compatible with each other as far as this module is concerned. none - No operation was performed. inCompatible - The images provided are compatible and can be run on this module. compatible - The images provided are incompatible and can be run on this module. failure - Failed to get the compatibility. " DEFVAL { none } ::= { hh3cIssuCompatibleResult 1 } hh3cIssuCompatibleResultFailedReason OBJECT-TYPE SYNTAX DisplayString (SIZE (0..255)) MAX-ACCESS read-only STATUS current DESCRIPTION "Indicates the cause of 'failure' state of the object 'hh3cIssuCompatibleResultStatus'. This object would be a null string if the value of 'hh3cIssuCompatibleResultStatus' is not 'failure'." ::= { hh3cIssuCompatibleResult 2 } hh3cIssuTestResultTable OBJECT-TYPE SYNTAX SEQUENCE OF Hh3cIssuTestResultEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Shows the result of the test operation, from which you can see the upgrade method." ::= { hh3cIssuUpgradeResultGroup 2 } hh3cIssuTestResultEntry OBJECT-TYPE SYNTAX Hh3cIssuTestResultEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An hh3cIssuTestResultEntry entry. Each entry provides the test result of a card in the device." INDEX { hh3cIssuTestResultIndex } ::= { hh3cIssuTestResultTable 1 } Hh3cIssuTestResultEntry ::= SEQUENCE { hh3cIssuTestResultIndex Integer32, hh3cIssuTestDeviceChassisID Integer32, hh3cIssuTestDeviceSlotID Integer32, hh3cIssuTestDeviceCpuID Integer32, hh3cIssuTestDeviceUpgradeWay INTEGER } hh3cIssuTestResultIndex OBJECT-TYPE SYNTAX Integer32 (1..65535) MAX-ACCESS not-accessible STATUS current DESCRIPTION "Internal index, not accessible." ::= { hh3cIssuTestResultEntry 1 } hh3cIssuTestDeviceChassisID OBJECT-TYPE SYNTAX Integer32 (0..255) MAX-ACCESS read-only STATUS current DESCRIPTION "Chassis ID of the card." ::= { hh3cIssuTestResultEntry 2 } hh3cIssuTestDeviceSlotID OBJECT-TYPE SYNTAX Integer32 (0..255) MAX-ACCESS read-only STATUS current DESCRIPTION "Slot ID of the card." ::= { hh3cIssuTestResultEntry 3 } hh3cIssuTestDeviceCpuID OBJECT-TYPE SYNTAX Integer32 (0..7) MAX-ACCESS read-only STATUS current DESCRIPTION "CPU ID of the card." ::= { hh3cIssuTestResultEntry 4 } hh3cIssuTestDeviceUpgradeWay OBJECT-TYPE SYNTAX INTEGER { none(1), reboot(2), sequenceReboot(3), issuReboot(4), serviceUpgrade(5), fileUpgrade(6), incompatibleUpgrade(7) } MAX-ACCESS read-only STATUS current DESCRIPTION "Upgrade method of the device. none - No operation was performed. reboot - The upgrade method of this device is Reboot. sequenceReboot - The upgrade method of this device is SequenceReboot. issuReboot - The upgrade method of this device is IssuReboot. serviceUpgrade - The upgrade method of this device is ServiceReboot. fileUpgrade - The upgrade method of this device is FileReboot. incompatibleUpgrade - The upgrade method of this device is IncompatibleUpgrade. " DEFVAL { none } ::= { hh3cIssuTestResultEntry 5 } hh3cIssuUpgradeResultTable OBJECT-TYPE SYNTAX SEQUENCE OF Hh3cIssuUpgradeResultEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Shows the result of the install operation." ::= { hh3cIssuUpgradeResultGroup 3 } hh3cIssuUpgradeResultEntry OBJECT-TYPE SYNTAX Hh3cIssuUpgradeResultEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An hh3cIssuUpgradeResultEntry entry. Each entry provides the upgrade result of a card in the device." INDEX { hh3cIssuUpgradeResultIndex } ::= { hh3cIssuUpgradeResultTable 1 } Hh3cIssuUpgradeResultEntry ::= SEQUENCE { hh3cIssuUpgradeResultIndex Integer32, hh3cIssuUpgradeDeviceChassisID Integer32, hh3cIssuUpgradeDeviceSlotID Integer32, hh3cIssuUpgradeDeviceCpuID Integer32, hh3cIssuUpgradeState INTEGER, hh3cIssuDeviceUpgradeWay INTEGER, hh3cIssuUpgradeDeviceStatus INTEGER, hh3cIssuUpgradeFailedReason DisplayString } hh3cIssuUpgradeResultIndex OBJECT-TYPE SYNTAX Integer32 (1..65535) MAX-ACCESS not-accessible STATUS current DESCRIPTION "Internal Index, not accessible." ::= { hh3cIssuUpgradeResultEntry 1 } hh3cIssuUpgradeDeviceChassisID OBJECT-TYPE SYNTAX Integer32 (0..255) MAX-ACCESS read-only STATUS current DESCRIPTION "Chassis ID of the card." ::= { hh3cIssuUpgradeResultEntry 2 } hh3cIssuUpgradeDeviceSlotID OBJECT-TYPE SYNTAX Integer32 (0..255) MAX-ACCESS read-only STATUS current DESCRIPTION "Slot ID of the card." ::= { hh3cIssuUpgradeResultEntry 3 } hh3cIssuUpgradeDeviceCpuID OBJECT-TYPE SYNTAX Integer32 (0..7) MAX-ACCESS read-only STATUS current DESCRIPTION "CPU ID of the card." ::= { hh3cIssuUpgradeResultEntry 4 } hh3cIssuUpgradeState OBJECT-TYPE SYNTAX INTEGER { init(1), loading(2), loaded(3), switching(4), switchover(5), committing(6), committed(7), rollbacking(8), rollbacked(9) } MAX-ACCESS read-only STATUS current DESCRIPTION "Upgrade status of the device. init -The current status of the device is Init. loading -The current status of the device is Loading. loaded -The current status of the device is Loaded. switching -The current status of the device is Switching. switchover -The current status of the device is Switchover. committing -The current status of the device is Committing. committed -The current status of the device is Committed. rollbacking -The current status of the device is Rollbacking. rollbacked -The current status of the device is Rollbacked. " ::= { hh3cIssuUpgradeResultEntry 5 } hh3cIssuDeviceUpgradeWay OBJECT-TYPE SYNTAX INTEGER { none(1), reboot(2), sequenceReboot(3), issuReboot(4), serviceUpgrade(5), fileUpgrade(6), incompatibleUpgrade(7) } MAX-ACCESS read-only STATUS current DESCRIPTION "Upgrade method of the card. none - No operation was performed. reboot - The upgrade method of this device is Reboot. sequenceReboot - The upgrade method of this device is SequenceReboot. issuReboot - The upgrade method of this device is IssuReboot. serviceUpgrade - The upgrade method of this device is ServiceReboot. fileUpgrade - The upgrade method of this device is FileReboot. incompatibleUpgrade - The upgrade method of this device is IncompatibleUpgrade. " ::= { hh3cIssuUpgradeResultEntry 6 } hh3cIssuUpgradeDeviceStatus OBJECT-TYPE SYNTAX INTEGER { waitingUpgrade(1), inProcess(2), success(3), failure(4) } MAX-ACCESS read-only STATUS current DESCRIPTION "Upgrade status of the device." ::= { hh3cIssuUpgradeResultEntry 7 } hh3cIssuUpgradeFailedReason OBJECT-TYPE SYNTAX DisplayString (SIZE (0..255)) MAX-ACCESS read-only STATUS current DESCRIPTION "Indicates the cause of 'failure' state of the object 'hh3cIssuUpgradeDeviceStatus'. This object would be a null string if the value of 'hh3cIssuCompatibleResultStatus' is not 'failure'." ::= { hh3cIssuUpgradeResultEntry 8 } hh3cIssuUpgradeNotify OBJECT IDENTIFIER ::= { hh3cIssuUpgrade 2 } hh3cIssuUpgradeTrapPrefix OBJECT IDENTIFIER ::= { hh3cIssuUpgradeNotify 0 } hh3cIssuUpgradeOpCompletionNotify NOTIFICATION-TYPE OBJECTS { hh3cIssuOpType, hh3cIssuOpStatus, hh3cIssuFailedReason, hh3cIssuOpTimeCompleted } STATUS current DESCRIPTION "An hh3cIssuUpgradeOpCompletionNotify is sent at the completion of upgrade operation denoted by hh3cIssuOp object, if such a notification was requested when the operation was initiated. hh3cIssuOpType indicates the type of the operation. hh3cIssuOpStatus indicates the result of the operation. hh3cIssuFailedReason indicates the operation failure reason. hh3cIssuOpTimeCompleted indicates the time when the operation was completed." ::= { hh3cIssuUpgradeTrapPrefix 1 } END