tklmPendingDeviceAccept

Use the tklmPendingDeviceAccept command to accept a device from a pending list. After acceptance from the pending list, IBM Security Key Lifecycle Manager serves keys to the device upon request.

Note: The IBM Security Key Lifecycle Manager command-line interface commands will be deprecated in the later versions of IBM Security Key Lifecycle Manager. Use the REST interfaces instead.

Purpose

Use this command to accept a device from a pending list. After acceptance from the pending list, IBM Security Key Lifecycle Manager serves keys to the device upon request.

This command does not store any relationships that a device might have with a specific machine in the DS5000 device family. You can only accept devices that you have permission to create in a device group.

Permissions

Your role must have a permission to the create action and a permission to the appropriate device group.

Syntax

tklmPendingDeviceAccept -deviceUUID deviceuniversalid -usage {LTO | 3592 | DS5000 | DS8000 | BRCD_ENCRYPTOR | ONESECURE | ETERNUS_DX |XIV | GPFS | GENERIC | userdevicegroup} -deviceText devicetextvalue

Parameters

-deviceText

Optional. Specifies unique text greater than with a minimum length greater than zero bytes and a maximum length of 96 bytes that describes a DS5000 storage server. Use the tklmDeviceUpdate command to update this value.

-deviceUUID

Required. Specify a value for a unique universal identifier for the device, such as DEVICE-7d588437-e725-48bf-a836-00a47df64e78. Use the tklmPendingDeviceList or the tklmPendingMachineDeviceList command to locate the pending device uuid.

-usage

Optional. Specify a device group, such as DS5000. You can include the following values:

LTO: Specifies the LTO device group.
3592: Specifies the 3592 device group.
DS5000: Specifies the DS5000 device group.
DS8000: Specifies the DS8000 device group.
BRCD_ENCRYPTOR: Specifies the BRCD_ENCRYPTOR device group that is in the LTO device family.
ONESECURE: Specifies the ONESECURE device group that is in the DS5000 device family.
ETERNUS_DX: Specifies the ETERNUS_DX device group that is in the DS5000 device family.
XIV: Specifies the IBM Spectrum Accelerate (previously known as XIV) device group.
GPFS: Specifies the IBM Spectrum Scale (previously known as GPFS) device group.
GENERIC: Specifies a device family that uses the Key Management Interoperability Protocol to interact with IBM Security Key Lifecycle Manager. The GENERIC device group enables management of KMIP objects.
Do not use the command-line interface to add a device to the GENERIC device group, or to change a GENERIC device group attribute.
userdevicegroup: Specifies a user-defined group that is based on a supported device family.

Example

This Jython-formatted command accepts a specific device in the pending list.

print AdminTask.tklmPendingDeviceAccept 
('[-deviceUUID DEVICE-7d588437-e725-48bf-a836-00a47df64e78
 -usage DS5000]')