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

    PDF

    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