Managing the FAST Cache using the CLI (supported physical deployments only)

Manage FAST Cache

FAST Cache is a storage efficiency technology that uses disks to expand the cache capability of the storage system to provide improved performance.

The following table lists the attributes for FAST Cache:

Table 1. FAST Cache attributes
Attribute	Description
Capacity	Capacity of the FAST Cache.
Drives	The list of disk types, and the number of disks of each type in the FAST Cache.
Number of drives	Total number of disks in the FAST Cache.
RAID level	RAID level applied to the FAST Cache disks. This value is always RAID 1.
Health state	Health state of the FAST Cache. The health state code appears in parentheses.
Health details	Additional health information. See Appendix A, Reference, for health information details.

Create FAST Cache

Configure FAST Cache. The storage system generates an error if FAST Cache is already configured.

Format

/stor/config/fastcache create [-async] -diskGroup <value> -drivesNumber <value> [-enableOnExistingPools]

Action qualifier

Qualifier	Description
-async	Run the operation in asynchronous mode.
-diskGroup	Specify the disk group to include in the FAST Cache.
-drivesNumber	Specify the number of disks to include in the FAST Cache.
-enableOnExistingPools	Specify whether FAST Cache is enabled on all existing pools.

Example

The following command configures FAST Cache with six disks from disk group DG_1, and enables FAST Cache on existing pools:

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/fastcache create -diskGroup dg_2 -drivesNumber 6 -enableOnExistingPools

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.

View FAST Cache settings

View the FAST Cache parameters.

Format

/stor/config/fastcache show

Example

The following command displays the FAST Cache parameters:

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/fastcache show -detail

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:     Total space              = 390770196480 (363.9G)
       Drives                   = 4 x 200.0G SAS Flash 2
       Number of drives         = 4
       RAID level               = 1
       Health state             = OK (5)
       Health details           = "The component is operating normally. No action is required."

Extend FAST Cache

Extend the FAST Cache by adding more disks.

Format

/stor/config/fastcache extend [-async] -diskGroup <value> -drivesNumber <value>

Action qualifier

Qualifier	Description
-async	Run the operation in asynchronous mode.
-diskGroup	Specify the comma-separated list of SAS Flash disks to add to the FAST Cache. Any added disks must have the same disk type and disk size as the existing disks.
-drivesNumber	Specify the number of drives for each corresponding disk group to be added to the FAST Cache.

Example

The following command adds six drives from disk group "dg_2" to FAST cache.

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/fastcache extend -diskGroup dg_2 -drivesNumber 6

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.

Shrink FAST Cache

Shrink the FAST Cache by removing storage objects.

Format

/stor/config/fastcache shrink [-async] -so <value>

Action qualifier

Qualifier	Description
-async	Run the operation in asynchronous mode.
-so	Specify the comma-separated list of storage objects to remove from the FAST Cache. Run the `/stor/config/fastcache/so show` command to obtain a list of all storage objects currently in the FAST Cache.

Example

The following command removes Raid Group RG_1 from the FAST Cache.

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/fastcache shrink –so rg_1

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.

Delete FAST Cache

Delete the FAST Cache configuration. The storage system generates an error if FAST Cache is not configured on the system.

Format

/stor/config/fastcache delete [-async]

Action qualifier

Qualifier	Description
-async	Run the operation in asynchronous mode.

Example

The following command deletes the FAST Cache configuration:

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/fastcache delete

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

Operation completed successfully.

Manage FAST Cache storage objects (physical deployments only)

FAST Cache storage objects include the RAID groups and disk drives that are in the FAST Cache.

Table 2. FAST Cache storage object attributes
Attribute	Description
ID	Identifier of the storage object.
Type	Type of storage object.
RAID level	RAID level applied to the storage object.
Drive type	Type of disk drive.
Number of drives	Number of drives in the storage object.
Disks	Comma-separated list of the disk IDs for each storage object.
Total space	Total space used by the storage object.

View FAST Cache storage objects

View a list of all storage objects, including RAID groups and disk drives, that are in the FAST Cache.

Format

/stor/config/fastcache/so show

Example 1

The following example shows FAST Cache storage objects on the system.

uemcli -d 10.0.0.1 -u Local/joe -p MyPassword456! /stor/config/fastcache/so show

                          Storage system address: 10.0.0.1
Storage system port: 443
HTTPS connection

1:    ID                  = rg_6
      Type                = RAID group 
      Stripe length       = 2
      RAID level          = 1
      Number of drives    = 2
      Drive type          = SAS Flash 2
      Drives              = dae_0_1_disk_1, dae_0_1_disk_2 
      Total space         = 195400433664 (181.9G)
      Device state        = OK