NAME
esfadm volume qosset - configuring or changing the parameters for Automated QoS function
SYNOPSIS
esfadm volume qosset -ipaddr ipAddr -volume volumeNumber
-qosfunc {enable {-resptime targetResponseTime | -priority priority} [-quotatune {on | off}] | disable}
COMMAND PATH
$INS_DIR\Common\bin\esfadm volume qosset
($INS_DIR is the "Program directory" when ETERNUS SF Manager has been installed.)
/opt/FJSVesfcm/bin/esfadm volume qosset
DESCRIPTION
For the specified FTV, configure or change Enable/Disable of Automated QoS, Automated QoS Priority, target response time and Tune by Quota Share.
OPERANDS
Configure or change Enable/Disable of Automated QoS, Automated QoS Priority, target response time and Tune by Quota Share.
OPTIONS
Specify the IP address of the ETERNUS Disk storage system. You cannot specify multiple addresses or use wildcards.
Specify the FTV Number to which the target response time is configured in decimal notation. Only a single volume can be specified.
Specify Tuning by Automated QoS. Select either of the following:
Select this when tuning by Automated QoS is enabled.
Select this when tuning by QoS is not enabled.
When "disable" is selected, -priority option, -resptime option and -quotatune option cannot be specified.
This specifies the target response time. Specify an integer from 0 to 10000. The unit of it is millisecond.
This cannot be specified together with the -priority option at the same time.
If zero (0) is specified, "on" cannot be specified for -quotatune option.
Specify Automated QoS Priority. Specify any of the following values:
Specify this when you do not want to limit I/O performance. You can get higher I/O performance than High.
Specify this when high I/O performance is required.
If high I/O performance is required, but other volume exists for which High is specified for priority and I/O competes at the same time, specify this when it does not matter that I/O performance is limited.
Specify this when giving priority to others and it does not matter that I/O performance is low.
Specify this when a target of I/O performance need not be specified and it does not matter that I/O performance is limited for performance tuning of other volumes sharing resources.
This cannot be specified together with the -resptime option at the same time.
If "noset" or "unlimited" is specified, "on" cannot be specified for -quotatune option.
It is specification of the cooperation between the Automated QoS Function and the Automated Storage Tiering. Specify either of the following values:
Specify to enable Tune by Quota Share.
Specify to disable Tune by Quota Share.
This option can be omitted. If zero (0) is specified for -resptime option, or if "noset" or "unlimited" is specified for -priority option, "on" cannot be specified.
OUTPUT INFORMATION
The following execution history information is output to the operation history of the Web Console.
Output Items | Output Details |
|---|---|
Date | Process execution date |
User ID | Execution user |
Action | Set QoS(CLI) |
Status | Submit, Start, or Complete |
Results | Success, Failed, or Warning |
Target | - |
Details | Detailed information |
Message | Error message |
EXIT STATUS
=0: Completed successfully
!=0: Terminated abnormally
EXAMPLES
When specifying Automated QoS enabled volumes, setting Target Response Time to 10 milliseconds and setting Tune by Quota Share to "Enable" in relation to FTV#0:
> C:\ETERNUS_SF\Common\bin\esfadm volume qosset -ipaddr 192.0.2.10 -volume 0 -qosfunc enable -resptime 10 -quotatune on esqos0002 The target response time has been set normally.
# /opt/FJSVesfcm/bin/esfadm volume qosset -ipaddr 192.0.2.10 -volume 0 -qosfunc enable -resptime 10 -quotatune on esqos0002 The target response time has been set normally.
NOTES
Before executing this command, be sure to register the ETERNUS SF Storage Cruiser Quality of Service Management Option license.
If not registered, the command terminates with an error.
Execution privilege
In order to execute the command, the following administrator privilege of the server OS is required.
Windows environment
Users of the Administrators group
Solaris or Linux environment
OS administrator privilege (root group)
If "disable" is specified for -qosfunc option, the existing Automated QoS Priority, target response time and Tune by Quota Share are all disabled to cause the QoS performance value set to the ETERNUS Disk storage system to be set to no limit (0).
If a target is specified by this command while Automated QoS Priority and target response time are specified, the existing settings are disabled and the settings by this command are enabled. If a target value is specified and -quotatune option is omitted, the existing Tune by Quota Share settings are maintained.
If "Enable" is set to an Automated QoS tuning enabled volume by this command, the command ends normally. If "Disable" is set to an Automated QoS tuning disabled volume by this command, the command ends normally.
If Tune by Quota Share is enabled for Tune by Quota Share enabled volumes by this command, the command ends normally. If Tune by Quota Share is disabled for Tune by Quota Share disabled volumes by this command, the command ends normally. Any message that displays the result of Tune by Quota Share setting is not output.
