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 specification for a partner certificate that the drive uses, or specify an alternate device group within the same device family.

About this task

Before you begin, create the certificates that you need 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. Also, obtain the alias of any certificate that is associated with the drive.

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

Procedure

  • Using graphical user interface
    1. Log in to the graphical user interface.
    2. In the Key and Device Management section on the Welcome page, select 3592.
    3. Click Go to > Manage keys and devices. Alternatively, right-click 3592 and select Manage keys and devices.
    4. On the management page for 3592, select a drive in the Tape Drives column.
    5. Click Modify.
    6. Alternatively, right-click a drive and then select Modify, or double-click a drive entry.
    7. In the Modify Tape Drive dialog, type the required and optional information. Then, click Modify Tape Drive.
  • Using REST interface
    1. Open the Swagger UI. For more information, see Using Swagger UI.
    2. Authenticate and authorize to access the REST APIs. For more information, see Authentication process for REST services.
    3. Use the Device List REST Service to locate a device and Device Update REST Service to update a device. For example, you can send the following HTTP requests:
      GET https://localhost:port/SKLM/rest/v1/devices?type=3592
      Content-Type: application/json
      Accept : application/json
      Authorization : SKLMAuth userAuthId=37ea1939-1374-4db7-84cd-14e399be2d20
      Accept-Language : en
      PUT https://localhost:port/SKLM/rest/v1/devices
      Content-Type: application/json
      Accept : application/json
      Authorization: SKLMAuth authId=139aeh34567m
      {"uuid":"DEVICE-64c588ad-5ed8-4934-8c84-64cb9e11d990","attributes":
      "aliasTwo myPartner99"}

What to do next

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