Modifying a drive

You can modify information about a device such as a tape drive in the IBM Security Guardium Key Lifecycle Manager database. For example, you can update the description of the drive.

About this task

You can use the Modify Tape Drive dialog or Device Update REST Service to update a device. Your role must have permissions to the modify action and to the appropriate device group.

Before you begin, create the keys and key groups that you want to associate with the devices that you are about to modify. If you use the REST interface, obtain the value of the uuid for the device that you intend to update.

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 LTO.
      3. Click Go to > Manage keys and devices.
      4. Alternatively, right-click LTO and select Manage keys and devices.
      5. On the management page for LTO, select a drive in the Tape Drives column.
      6. click Modify.
      7. Alternatively, right-click a drive and then select Modify, or double-click a drive entry.
    • REST interface:
      • Open a REST client.
  2. Modify a device:
    • Graphical user interface:
      1. On the Modify Tape Drive dialog, type the required and optional information.
      2. Click Modify Tape Drive.
    • REST interface:
      Use Device Update REST Service to update a device. You must specify the device uuid and the attributes that change. For example, you can send the following HTTP request:
      GET https://localhost:port/SKLM/rest/v1/devices?type=LTO
      Content-Type: application/json
      Accept : application/json
      Authorization: SKLMAuth userAuthId=139aeh34567m
      Accept-Language : en
      PUT https://localhost:port/SKLM/rest/v1/devices
      Content-Type: application/json
      Accept : application/json
      Authorization: SKLMAuth userAuthId=139aeh34567m
      {"uuid":"DEVICE-44b123ad-5ed8-4934-8c84-64cb9e11d990","attributes":
      "symAlias LTOKey000001,description myLTOdrive"}

What to do next

Next, verify that the changes are made. For optional fields, such as the description, you might want to use the Device List REST Service to determine whether the value is changed. Alternatively, reopen the Modify Tape Drive dialog.