Deleting a device

You can delete a device such as a DS5000 storage server. Deleting the device removes the device serial number and its key data from the IBM Security Guardium Key Lifecycle Manager database.

About this task

If the device is in the DS5000 device family and machine affinity is enabled, deleting the device also deletes any relationship between a device and a machine.

You can use the Delete menu item or the Device Delete REST Service to delete a device. Your role must have permissions to the delete action and to the appropriate device group.

Procedure

  1. Go to the appropriate page or directory.
    • Graphical user interface:
      1. Log on to the graphical user interface.
      2. In the Key and Device Management section on Welcome page, select DS5000.
      3. Click Go to > Manage keys and devices.
      4. Alternatively, right-click DS5000 and select Manage keys and devices.
      5. On the management page for DS5000, select a device.
      6. click Delete.
      7. Alternatively, right-click a drive and then select Delete.
    • REST interface:
      • Open a REST client.
  2. Use the Machine Device List REST Service to obtain the uuid of the device that you intend to delete. Use the Machine Device Delete REST Service to delete any associations that the device has with machines.
    For example, you can send the following HTTP requests:
    GET https://localhost:port/SKLM/rest/v1/machines/device?machineID=
    3042383030303437000000000000
    Content-Type: application/json
    Accept : application/json
    Authorization: SKLMAuth authId=139aeh34567m
    DELETE https://localhost:port/SKLM/rest/v1/machines/device
    Content-Type: application/json
    Accept : application/json
    Authorization: SKLMAuth authId=139aeh34567m
    {"deviceUUID”:”DEVICE-663b6d37-e6d5-4c9f-af90-e40e48d27f3c","machineID":
    "3042383030303437000000000000”}
  3. Delete the device.
    • Graphical user interface:

      On the Confirm dialog, read the confirmation message before you delete the device. Deleting the device removes the device serial number and its key data from the IBM Security Guardium Key Lifecycle Manager database.

      Then, click OK.

    • REST interface:
      Use the Device Delete REST Service to delete a device. For example, you can send the following HTTP request:
      DELETE https://localhost:port/SKLM/rest/v1/devices/DEVICE-74386920-148c-
      47b2-a1e2-d19194b315cf
      Content-Type: application/json
      Accept : application/json
      Authorization: SKLMAuth authId=139aeh34567m