FS System: How to Enable or Disable Automatic QoS (Quality of Service) Rebalancing

Asset ID:	1-71-2045089.1
Update Date:	2017-07-17
Keywords:

Solution Type Technical Instruction Sure

Solution 2045089.1 : FS System: How to Enable or Disable Automatic QoS (Quality of Service) Rebalancing

Applies to:

Oracle FS1-2 Flash Storage System - Version 6.1 and later
Information in this document applies to any platform.

Goal

The intent is to provide detailed instructions to enable or disable the Automatic QoS Rebalancing.

What is Automatic QoS Rebalancing?

When a LUN is created, the Oracle FS System might provision the volume across fewer drive groups than the optimal number that would satisfy the desired QoS settings for the volume. This situation can occur, for example, when an insufficient number of drive groups are available in the Storage Domain in which the volume is created. When the Automatic QoS Rebalancing feature is enabled for a Storage Domain, the Oracle FS System runs daily scans for any volumes that are sub-optimally provisioned across the Drive Groups. If sufficient space exists in the Storage Domain, the system begins migrating the data for those volumes to the available space. This situation can also occur when a Drive Enclosure is added to the Storage Domain.

Automatic QoS rebalancing occurs for auto-tiered LUNs and for single-tiered LUNs.

The scanning and the migration depend on the Storage Class of each volume in the Storage Domain. The migration occurs only when sufficient free space exists in the same Storage Class that is configured for the volume.

Refer to <Document 2044829.1> FS System: Automatic QoS (Quality of Service) Rebalancing Recommended Setting for FS1-2 for important information.

Starting from 6.1.18 and below 6.2, the Automatic QoS Rebalancing will be disabled by default in the FS1 so that the system will not perform the daily rebalance scan, regardless of customer setting.

Solution

Enabling or disabling the Automatic QoS Rebalancing is an online activity. To accomplish this activity, use one of the following two methods:

Using the Command Line (CLI)
Using the Graphical User Interface (GUI)

Using the Command Line

Please refer to the document "Oracle Flash Storage System CLI Reference" for more information.

Login to the Oracle Flash Storage FS1 system:

# fscli login -u <admin-user> -oracleFs <FS1 IP>
Turn ON or OFF the automatic rebalancing:

# fscli storage_domain -modify -storageDomain <storage domain id or fqn> [-enableAutomaticQosRebalancing | -disableAutomaticQosRebalancing]

Example:

bash-3.2$ ./fscli storage_domain -modify -storageDomain "/Storage Domain 1" -disableAutomaticQosRebalancing

NewObject
    Id                      : 414B303031373438A214000000000000
    Fqn                     : /Storage Domain 1
    ObjectType              : storageDomain
Command Succeeded
bash-3.2$
Confirm the status of Automatic QoS Rebalancing:

# fscli storage_domain -list -storageDomain <storage domain id or fqn> -details | grep Rebalancing

Unix Example:

bash-3.2$ ./fscli storage_domain -list -storageDomain "/Storage Domain 1" -details | grep Rebalancing
EnableAutomaticQosRebalancing : false
bash-3.2$

Using the Graphical User Interface

Display the storage domains:
Select your storage domain, then right click and select "Modify Storage Domain":
Tick or untick the "Enable Automatic QoS Rebalancing", then click "OK":

For TSC engineers

When you receive FS1 log bundles, you have different methods to verify if the Automatic QoS Rebalancing is enabled or not.

Using the script "FSInfo.pl" in cores3.
Using the file SystemConfiguration.txt generated by scanlog6 on cores3.
Using the file *.chsh.xml which is in the log bundle.

Using the script "FSInfo.pl" in cores3.

Run scanlog6 against your log bundle.
Change the directory into the result from scanlog6.
Execute FSInfo.pl using the argument -sd, and look at the column "AutoQrMigrationDisabled" under the "Storage Domain Information":

AutoQrMigrationDisabled = false ---> this means Automatic QoS Rebalancing is enabled.
AutoQrMigrationDisabled = true ---> this means Automatic QoS Rebalancing is disabled.

Example:

# FSInfo.pl -sd

R6 (FS1) XML parser
Oracle (c) 2015 Version: 1.0

Parsing A136D36D85E9D14C.chsh.xml file...

FS1 Serial: AK00165967
Initiating Event Type: COLLECT_LOGS_INITIATED
Date & Time: 2015-08-06T14:44:52.707

Storage Domain Information:
Storage Domain     | Mgmt State   | Phys. Total Cap.   | Phys. Alloc. Cap.   | Phys. Unavail. Cap.   | Slat Used Cap.   | Progess. Enabled   | Background Copy Pri.   | AutoQrMigrationDisabled   | Scan Cycle (min)   | # of Scan Cycles
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Storage Domain 1   | AVAILABLE    | 195.7 TB           | 150.3 TB            | 0.0 GB                | 0.0 GB           | true               | SYSTEM_CHOOSES         | false                     | 1440               | 7

Storage Domain Drive Groups:
Storage Domain     | Drive Group
------------------------------------------
Storage Domain 1   | /DRIVE_GROUP-016
Storage Domain 1   | /DRIVE_GROUP-001
Storage Domain 1   | /DRIVE_GROUP-009
Storage Domain 1   | /DRIVE_GROUP-014
Storage Domain 1   | /DRIVE_GROUP-002
Storage Domain 1   | /DRIVE_GROUP-011
Storage Domain 1   | /DRIVE_GROUP-004
Storage Domain 1   | /DRIVE_GROUP-006
Storage Domain 1   | /DRIVE_GROUP-012
Storage Domain 1   | /DRIVE_GROUP-017
Storage Domain 1   | /DRIVE_GROUP-005
Storage Domain 1   | /DRIVE_GROUP-013
Storage Domain 1   | /DRIVE_GROUP-018
Storage Domain 1   | /DRIVE_GROUP-007
Storage Domain 1   | /DRIVE_GROUP-008
...
...

The script FSInfo.pl as well as a number of other FS1 diagnostic tools/scripts are available in the cores3 servers under /cores_data/local/tools/pillar/FlashStorage/.

Using the file SystemConfiguration.txt generated by scanlog6 on cores3.

Run scanlog6 against your log bundle.
Change the directory into the result from scanlog6.
Open the file "SystemConfiguration.txt" and look for the variable "StorageDomainInformation_AutoQrMigrationDisabled" at the "Storage Domains" section:

=====================================
Storage Domains (1)
=====================================
Name                  Capacity              Status
----                  --------              ------
/Storage Domain 1     182300 GB             AVAILABLE

-------------------------------------
/Storage Domain 1
-------------------------------------
StorageDomainInformation_Identity_Id                                             = 414B303031363539A214000000000000
StorageDomainInformation_Identity_Fqn                                            = /Storage Domain 1
StorageDomainInformation_Name                                                    = Storage Domain 1
StorageDomainInformation_ManagementState                                         = AVAILABLE
StorageDomainInformation_DriveGroupIdentity_Id                                   = 414B303031363539A2860CE60AAD973F
StorageDomainInformation_DriveGroupIdentity_Fqn                                  = /DRIVE_GROUP-016
StorageDomainInformation_DriveGroupIdentity[1]_Id                                = 414B303031363539A2860CE60AB50CA3
StorageDomainInformation_DriveGroupIdentity[1]_Fqn                               = /DRIVE_GROUP-001
StorageDomainInformation_DriveGroupIdentity[2]_Id                                = 414B303031363539A2860CE60AB430F4
StorageDomainInformation_DriveGroupIdentity[2]_Fqn                               = /DRIVE_GROUP-009
StorageDomainInformation_DriveGroupIdentity[3]_Id                                = 414B303031363539A2860CE60AB7B02C
StorageDomainInformation_DriveGroupIdentity[3]_Fqn                               = /DRIVE_GROUP-014
StorageDomainInformation_DriveGroupIdentity[4]_Id                                = 414B303031363539A2860CE60ABA5DA6
...
...
StorageDomainInformation_SlatMaxCapacityPercent[3]_PercentCapacity               = 100
StorageDomainInformation_AutoQrMigrationDisabled                                 = false            <=== Automatic QoS Rebalancing is enabled for this storage domain "/Storage Domain 1".
StorageDomainInformation_ScanDelay                                               = 1440
StorageDomainInformation_HoldMultiple                                            = 7

Using the file *.chsh.xml which is in the log bundle.

Run scanlog6 against your log bundle.
Change the directory into the result from scanlog6.
You can execute the following command which will extract the information from the file *.chsh.xml directly:

# sed -n "/GetStorageDomainResponse/,/\/GetStorageDomainResponse/p" *chsh* | egrep "<Name>|<AutoQrMigrationDisabled>"

Example:

# sed -n "/GetStorageDomainResponse/,/\/GetStorageDomainResponse/p" *chsh* | egrep "<Name>|<AutoQrMigrationDisabled>"
    <Name>SD_BAJA_PRIORIDAD</Name>
    <AutoQrMigrationDisabled>false</AutoQrMigrationDisabled>
    <Name>SD_ALTA_PRIORIDAD</Name>
    <AutoQrMigrationDisabled>false</AutoQrMigrationDisabled>
#

References

<BUG:21569373> - HIGHER LATENCY DURING COPY BACK MAINTENANCE
<NOTE:2044829.1> - FS System: Automatic QoS (Quality of Service) Rebalancing Recommended Setting for FS1-2

Attachments

This solution has no attachment