9.1.5 esfast ftvshare set (Volume Quota Share Set Command)

NAME

esfast ftvshare set - Set volume quota share

SYNOPSIS

esfast ftvshare set -ipaddr ipAddr -name tierPoolName -volume volumeNumber[,volumeNumber,...]
                    -share lowshare:middleshare:highshare [-s]

COMMAND PATH

For Windows environments
```
$INS_DIR\AST\Manager\opt\FJSVssast\sbin\esfast ftvshare set
```
($INS_DIR is the "Program directory" of when ETERNUS SF Manager has been installed to a new environment.)
For Solaris or Linux environments
```
/opt/FJSVssast/sbin/esfast ftvshare set
```

DESCRIPTION

For the specified volume, register or delete the quota share (%) of each sub-pool. In order to execute the command, the administrator privilege of the OS is required.

OPERAND

set: For the specified volume, register or delete the quota share (%) of each sub-pool.

OPTIONS

-ipaddr ipAddr: Specify the IP address of the storage device.

-name tierPoolName: Specify the Tier pool name.
Specify a maximum of 16 characters containing one-byte alphanumeric characters, number sign (#), hyphen (-) and underscore (_) for the name.
Non-case sensitive.
Specify the Tier pool name that has been created on Web Console.

-volume volumeNumber[,volumeNumber,...]

Specify the FTV number for which to register or delete quota shares.

Set a decimal value.
Specify the FTV number that has been created on Web Console.

-share lowshare:middleshare:highshare

Specify the quota share (%) set to each sub-pool

Set a decimal value so that the total amount of quota shares (%) of all the sup-pools is 100.
Specify in the colon-separated form of Low sub-pool quota share (%): Middle sub-pool quota share (%): High sub-pool quota share (%).
If it is a two layer Tier pool, specify a hyphen (-) in the Middle sub-pool quota share field.
When deleting the volume quota share (%), specify a dotted line like "-:-:-".

-s: No confirmation message is output but the processing continues.

EXIT STATUS

=0: Completed successfully
>0: Terminated abnormally

EXAMPLES

For Windows environments

> C:\ETERNUS_SF\AST\Manager\opt\FJSVssast\sbin\esfast ftvshare set -ipaddr 192.0.2.10 -name Trpool1 -volume 0 -share 0:0:100 -s
INFO:esast9000:Command terminated normally.

For Solaris or Linux environments

# /opt/FJSVssast/sbin/esfast ftvshare set -ipaddr 192.0.2.10 -name Trpool1 -volume 0 -share 0:0:100
Are you sure? [y/n]: y
INFO:esast9000:Command terminated normally.

When setting quota shares to the volume existing in a two layer Tier pool

> C:\ETERNUS_SF\AST\Manager\opt\FJSVssast\sbin\esfast ftvshare set -ipaddr 192.0.2.10 -name Trpool1 -volume 0 -share 30:-:70 -s
INFO:esast9000:Command terminated normally.

When setting quota shares to the volume existing in a three layer Tier pool

> C:\ETERNUS_SF\AST\Manager\opt\FJSVssast\sbin\esfast ftvshare set -ipaddr 192.0.2.10 -name Trpool1 -volume 0 -share 20:30:50 -s
INFO:esast9000:Command terminated normally.

When deleting quota shares set to the volume

> C:\ETERNUS_SF\AST\Manager\opt\FJSVssast\sbin\esfast ftvshare set -ipaddr 192.0.2.10 -name Trpool1 -volume 0 -share -:-:- -s
INFO:esast9000:Command terminated normally.

NOTES

Before executing this command, be sure to register the ETERNUS SF Storage Cruiser Optimization Option license.
If registration has not been performed, although the execution of the command is started, migration of Tiering policies terminates in an error.
Refer to "8.5 Check of Start of ETERNUS SF Storage Cruiser Optimization Option Service/Daemon" to make sure that the service or daemon is started.
If not, the command terminates abnormally.
If this command is executed toward a one layer Tier pool, the command terminates abnormally.
Quota share (%) is a rough indication and may not be allocated as specified.
If quota shares (%) are deleted, the volume is relocated based on the Tiering policy.
If RAID groups are being deleted, this command may terminate abnormally because the information of Tier pools that are managed by the Management Server is not completely reconfigured. In this case, re-execute the command either after waiting for a while or after reconfiguring the Tier pool information by performing the Status Update operation for Automated Storage Tiering. Refer to "Update Automated Storage Tiering Information" in the Web Console Guide for information on how to perform the Status Update operation.