clmgmtLicenseActionEntry
CISCO-LICENSE-MGMT-MIB ·
.1.3.6.1.4.1.9.9.543.1.1.2.1
Object
row
An entry for each action that is being executed or was
executed recently. The management application executes an
action
by creating this entry. This can be done in the following
2 methods
1. CREATE-AND-GO method
Management application sets clmgmtLicenseActionRowStatus to
createAndGo(4) and all other required objects to valid
values in a single SNMP SET request. If all the values
are valid, the device creates the entry and executes the
action. If the SET request fails, the entry will not be
created.
2. CREATE-AND-WAIT method
Management application sets clmgmtLicenseActionRowStatus to
createAndWait(5) to create an entry. Management application
can set all other required objects to valid
values in more than one SNMP SET request. If SET request
for any of the objects fails, management application can
set
just only that object. Once all the required objects
are set to valid values, management application triggers
action
execution by setting clmgmtLicenseActionRowStatus to
active(1).
To stop the action from being executed, the management
application
can delete the entry by setting clmgmtLicenseActionRowStatus
to destroy(6) when clmgmtLicenseActionState is pending(2).
The status of action execution can be known by querying
clmgmtLicenseActionState. If the action is still in
pending(2) or in inProgress(3) state, the management
application need to check back again after few seconds.
Once the action completes and status of the action is
failed(6), the reason for failure can be retrieved
from clmgmtLicenseActionFailCause. If the status of the
action is partiallySuccessful(5), results of individual
licenses can be queried from clmgmtLicenseActionResultTable.
Not all objects in the entry are needed to execute every
action. Below is the list of actions and the required
objects that are needed to be set for executing that
action.
1. Installing a license
The following MIB objects need to be set for installing a
license
a. clmgmtLicenseActionTransferProtocol
b. clmgmtLicenseServerAddressType
c. clmgmtLicenseServerAddress
d. clmgmtLicenseServerUsername
e. clmgmtLicenseServerPassword
f. clmgmtLicenseFile
g. clmgmtLicenseStore
h. clmgmtLicenseStopOnFailure
i. clmgmtLicenseAcceptEULA
j. clmgmtLicenseAction
clmgmtLicenseActionEntPhysicalIndex need not be set
explicitly for license installs. License itself identifes
the device where the license needs to be installed.
clmgmtLicenseStore need to be set to store the licenses
in a non-default license store. But, if a license file
has more than one license and licenses need to be
installed on multiple devices (for example to multiple
members with in a stack), then value of clmgmtLicenseStore
is ignored and the licenses will be installed in default
license stores of the respective devices.
2. Clearing a license
The following MIB objects need to be set for clearing a
license
a. clmgmtLicenseActionEntPhysicalIndex
b. clmgmtLicenseActionLicenseIndex
c. clmgmtLicenseStore
d. clmgmtLicenseAction
3. Revoking a license
The following MIB objects need to be set for revoking a
license
a. clmgmtLicenseActionTransferProtocol
b. clmgmtLicenseServerAddressType
c. clmgmtLicenseServerAddress
d. clmgmtLicenseServerUsername
e. clmgmtLicenseServerPassword
f. clmgmtLicensePermissionTicketFile
g. clmgmtLicenseRehostTicketFile
h. clmgmtLicenseStopOnFailure
i. clmgmtLicenseAction
4. Regenerate last rehost ticket
The following MIB objects need to be set for regenerating
last rehost ticket
a. clmgmtLicenseActionTransferProtocol
b. clmgmtLicenseServerAddressType
c. clmgmtLicenseServerAddress
d. clmgmtLicenseServerUsername
e. clmgmtLicenseServerPassword
f. clmgmtLicensePermissionTicketFile
g. clmgmtLicenseRehostTicketFile
h. clmgmtLicenseStopOnFailure
i. clmgmtLicenseAction
5. Save all licenses to a backup storage
The following MIB objects need to be set for storing all
licenses to a backup store
a. clmgmtLicenseActionEntPhysicalIndex
b. clmgmtLicenseActionTransferProtocol
c. clmgmtLicenseServerAddressType
d. clmgmtLicenseServerAddress
e. clmgmtLicenseServerUsername
f. clmgmtLicenseServerPassword
g. clmgmtLicenseBackupFile
h. clmgmtLicenseAction
6. Generate and export EULA if the licenses need EULA to be
accepted for installing.
The following MIB objects need to be set exporting required
EULAs
a. clmgmtLicenseActionTransferProtocol
b. clmgmtLicenseServerAddressType
c. clmgmtLicenseServerAddress
d. clmgmtLicenseServerUsername
e. clmgmtLicenseServerPassword
f. clmgmtLicenseFile
g. clmgmtLicenseEULAFile
h. clmgmtLicenseAction
For any action, if clmgmtLicenseActionTransferProtocol
is set to local(2), the following objects need not be set.
a. clmgmtLicenseServerAddressType
b. clmgmtLicenseServerAddress
c. clmgmtLicenseServerUsername
d. clmgmtLicenseServerPassword
Entry can be deleted except when clmgmtLicenseAction is set
to pending(2). All entries are volatile and are cleared
on agent reset.
Context
- MIB
- CISCO-LICENSE-MGMT-MIB
- OID
.1.3.6.1.4.1.9.9.543.1.1.2.1- Type
- row
- Status
- current
- Parent
- clmgmtLicenseActionTable
- Table
- clmgmtLicenseActionTable
- Children
- 22
Syntax
No syntax metadata recorded.
Values & Constraints
No enumerated values or constraints recorded.
Related Objects
Child Objects
| Object | Type | Syntax | OID |
|---|---|---|---|
| clmgmtLicenseActionIndex This object uniquely identifies a row in
clmgmtLicenseActionTable. The management application should choose
this value by reading clmgmtNextFreeLicenseActionIndex
while creating a… | column | Unsigned32 | .1.3.6.1.4.1.9.9.543.1.1.2.1.1 |
| clmgmtLicenseActionLicenseIndex This object indicates the the license index of the license
that is the subject of this action. This is used for
identifying a license for performing actions specific to
that licen… | column | ClmgmtLicenseIndexOrZero | .1.3.6.1.4.1.9.9.543.1.1.2.1.10 |
| clmgmtLicensePermissionTicketFile This object indicates the file name of the permission
ticket. This object need to be set only if
clmgmtLicenseAction is set to processPermissionTicket(4)
or regenerateLastRehostTi… | column | OctetString | .1.3.6.1.4.1.9.9.543.1.1.2.1.11 |
| clmgmtLicenseRehostTicketFile This object indicates the file where the rehost ticket
generated by the device need to be exported to. The rehost
ticket is generated as a result of processPermissionTicket
and re… | column | OctetString | .1.3.6.1.4.1.9.9.543.1.1.2.1.12 |
| clmgmtLicenseBackupFile This object indicates the file where all the licenses in
the device need to be backed up. This object need to be set
only if clmgmtLicenseAction is set to backup(6) and the
manage… | column | OctetString | .1.3.6.1.4.1.9.9.543.1.1.2.1.13 |
| clmgmtLicenseStopOnFailure This object indicates whether the license action should
stop if the action on a license fails. This object is
applicable only if there are more than one licenses
involved in an ac… | column | SNMPv2-TCTruthValue | .1.3.6.1.4.1.9.9.543.1.1.2.1.14 |
| clmgmtLicenseAction This object indicates the the command/action to be executed.
Command Remarks
------- -------
noOp(1) … | column | Enumeration | .1.3.6.1.4.1.9.9.543.1.1.2.1.15 |
| clmgmtLicenseActionState This object indicates the state of this license action. | column | ClmgmtLicenseActionState | .1.3.6.1.4.1.9.9.543.1.1.2.1.16 |
| clmgmtLicenseJobQPosition This object represents the position of the action
in the license action job queue that is maintained
internally. Only actions in pending(2) state will
be put in the queue until th… | column | SNMPv2-SMIUnsigned32 | .1.3.6.1.4.1.9.9.543.1.1.2.1.17 |
| clmgmtLicenseActionFailCause This object indicates the reason for this license action
failure. The value of this object is valid only when
clmgmtLicenseActionState is failed(6). | column | ClmgmtLicenseActionFailCause | .1.3.6.1.4.1.9.9.543.1.1.2.1.18 |
| clmgmtLicenseActionStorageType This object indicates the storage type for this conceptual
row. Conceptual rows having the value 'permanent' need not
allow write-access to any columnar objects in the row. | column | SNMPv2-TCStorageType | .1.3.6.1.4.1.9.9.543.1.1.2.1.19 |
| clmgmtLicenseActionEntPhysicalIndex This object represents the entPhysicalIndex of the device
where the action is being executed. This object is mainly
used in devices where one device is acting as a master and
rest… | column | ENTITY-MIBPhysicalIndexOrZero | .1.3.6.1.4.1.9.9.543.1.1.2.1.2 |
| clmgmtLicenseActionRowStatus This object indicates the the status of this table entry.
Once the entry status is set to active(1), the associated
entry cannot be modified until the action completes
(clmgmtLice… | column | SNMPv2-TCRowStatus | .1.3.6.1.4.1.9.9.543.1.1.2.1.20 |
| clmgmtLicenseAcceptEULA This object indicates whether the End User License Agreement
needed for installing the licenses is accepted.
true(1) - EULA is read and accepted
false(2) - EULA is … | column | SNMPv2-TCTruthValue | .1.3.6.1.4.1.9.9.543.1.1.2.1.21 |
| clmgmtLicenseEULAFile This object indicates the file where all the End User License
Agreements (EULAs) need to be exported to. This object need to
be set only if clmgmtLicenseAction is set to generateE… | column | OctetString | .1.3.6.1.4.1.9.9.543.1.1.2.1.22 |
| clmgmtLicenseActionTransferProtocol This object represents the transfer protocol to be used
when copying files as specified in the following objects.
1. clmgmtLicenseFile
2. clmgmtLicensePermissionTicketFile
3. clmg… | column | ClmgmtLicenseTransferProtocol | .1.3.6.1.4.1.9.9.543.1.1.2.1.3 |
| clmgmtLicenseServerAddressType This object indicates the transport type of the
address contained in clmgmtLicenseServerAddress object.
This must be set when clmgmtLicenseActionTransferProtocol
is not none(1) or… | column | INET-ADDRESS-MIBInetAddressType | .1.3.6.1.4.1.9.9.543.1.1.2.1.4 |
| clmgmtLicenseServerAddress This object indicates the ip address of the server from
which the files must be read or written to if
clmgmtLicenseActionTransferProtocol is not none(1) or
local(2).
… | column | INET-ADDRESS-MIBInetAddress | .1.3.6.1.4.1.9.9.543.1.1.2.1.5 |
| clmgmtLicenseServerUsername This object indicates the remote user name for accessing
files via ftp, rcp, sftp or scp protocols. This object must
be set when the clmgmtLicenseActionTransferProtocol is
ftp(4),… | column | OctetString | .1.3.6.1.4.1.9.9.543.1.1.2.1.6 |
| clmgmtLicenseServerPassword This object indicates the password used by ftp, sftp or
scp for copying a file to/from an ftp/sftp/scp server.
This object must be set when the
clmgmtLicenseActionTransferProtocol… | column | OctetString | .1.3.6.1.4.1.9.9.543.1.1.2.1.7 |
| clmgmtLicenseFile This object represents the location of the license file
on the server identified by clmgmtLicenseServerAddress. This
object MUST be set to a valid value before or concurrently
wit… | column | OctetString | .1.3.6.1.4.1.9.9.543.1.1.2.1.8 |
| clmgmtLicenseStore This object represents the clmgmtLicenseStoreIndex of the
license store to use within the device. The license store
can be a local disk or flash. A device can have more than
one l… | column | SNMPv2-SMIUnsigned32 | .1.3.6.1.4.1.9.9.543.1.1.2.1.9 |
Indexes
| Object | Type | Syntax | OID |
|---|---|---|---|
| clmgmtLicenseActionIndex This object uniquely identifies a row in
clmgmtLicenseActionTable. The management application should choose
this value by reading clmgmtNextFreeLicenseActionIndex
while creating a… | column | Unsigned32 | .1.3.6.1.4.1.9.9.543.1.1.2.1.1 |