Rescanning disk storage: vSnap server

If IBM Spectrum Protect Plus reports that a vSnap server is reaching its storage capacity, the vSnap storage pool must be expanded. To expand a vSnap storage pool, you must first add virtual or physical disks on the vSnap server, either by adding virtual disks to the vSnap virtual machine or adding physical disks to the vSnap physical server. See the vSphere documentation for information about creating additional virtual disks.

Method and URI

To rescan a vSnap server with {storageId}, use a POST method and a URI:

POST    https://{hostname|IPv4}/api/storage/{storageId}

To get information about vSnap server disks that are not registered with IBM Spectrum Protect Plus, use a GET method and a URI:

GET     https://{hostname|IPv4}/api/storage/{storageId}/management/disk

Parameters

Parameter 1: action

Rescan the vSnap server.

  • Value: rescan

  • Type: System string. Required. Available in the web user interface.

Data

None.

Example 1: Rescan vSnap server

Assume that you have a vSnap server ({storageId} 2101).

A Python snippet that is similar to the following example can be used to rescan the vSnap server:

storage_id = "2101"

_params = {"action": "rescan"}

requests.post('https://' + spp_ipv4 + '/api/storage/' + storage_id,
     headers={...}, params=_params, verify=...)
_images/reference_vsnap_rescan01.png

Figure 34 The same action can be taken in the IBM Spectrum Protect Plus web user interface: In the navigation pane, click System Configuration > Backup Storage > Disk and click the Edit icon of the vSnap server to edit. In the Manage Backup Storage page, click the Disks tab, and click Rescan.

You will receive a response with the HTTP status of 200 (OK).

Example 2: Get information about unregistered disks in a vSnap server

Assume that you rescanned a vSnap server ({storageId} 2101) in the previous example, and this vSnap server has an unused, virtual hard disk drive with the capacity of 200 GB.

A Python snippet that is similar to the following example can be used to get information about

storage_id = "2101"

requests.get('https://' + spp_ipv4 + '/api/storage/' + storage_id
     + '/management/disk'
     headers={...}, params=_params, verify=...)

The request prompts a response that is structured as shown, with the HTTP status of 200 (OK).

{
    "links":{...},
    "total":1,
    "disks": [
        {
            "links":           {...},
            "resourceType":    "disk",
            "model":           "Virtual disk",
            "name":            "/dev/sdd",
            "size":            214748364800,
            "type":            "SCSI",
            "uuid":            "1234567890abcdef1234567890abcdef",
            "vendor":          "VMware",
            "usedAs":          "unused",
            "id":              "1234567890abcdef1234567890abcdef",
            "storageId":       "2101",
            "storageServerId": "2101",
            "originalPk":      null,
            "protectionTime":  null,
            "sessionId":       null,
            "name":            "/dev/sdd"
        }
    ]
}