chprofile
Use the
chprofile command
to modify a workload profile. Use the profile later with the
mkrecom command to create a performance recommendation for assigning
ESS volumes.
- You must use this command with the mkrecom command
in order to generate a performance recommendation.
- You cannot save a profile with the same name as a preexisting profile.
Syntax

>>-perfcli-- --chprofile-- -- --+--------------------------+---->
'--desc--"new description"-'
>-- --+--------------+-- --+------------------+-- -------------->
'-io--new_rate-' '-trans--new_rsize-'
>--+--------------------------+-- ------------------------------>
'--readcache--new_rpercent-'
>--+-----------------------------+-- --------------------------->
'--writedestage--new_rpercent-'
>--+---------------------+-- --+----------------------+-- ------>
'--read--new_rpercent-' '--write--new_rpercent-'
>--+------------------------+-- --+-------------------------+--->
'--seqread--new_rpercent-' '--seqwrite--new_rpercent-'
>-- ---starttime--starttime-- ---endtime--endtime-- ------------>
>---startdate--startdate-- ---enddate--enddate-- --------------->
>--original_profile_name---------------------------------------><
Parameters
- -desc "new description"
- An optional parameter that changes the user-defined description of the
profile to a new description.
- -io new_rate
- An optional parameter that specifies the average I/Os per second per
GB over all LUNs.
- -trans new_size
- An optional parameter that specifies the average transfer size in KB.
- -readcache new_percent
- An optional parameter that specifies the percentage of random read cache
hits to the total number of random read operations. Valid ranges are 1 - 100.
- -writedestage new_percent
- Specifies the percentage of random write destage operations to the total
number of random write destage operations. Valid ranges are 1 - 100.
- -read new_percent
- An optional parameter that specifies the percentage of random reads
to the total number of I/O operations. Valid ranges are 1 - 100. Values specified
with -read, -write, -seqread, and -seqwrite combined cannot exceed 100.
- -write new_percent
- An optional parameter that specifies the percentage of random writes
to the total number of I/O operations. Valid ranges are 1 - 100. Values specified
with -read, -write, -seqread, and -seqwrite combined cannot exceed 100.
- -seqread new_percent
- An optional parameter that specifies the percentage of sequential reads
to the total number of I/O operations. Valid ranges are 1 - 100. Values specified
with -read, -write, -seqread, and -seqwrite combined cannot exceed 100.
- -seqwrite new_percent
- An optional parameter that specifies the percentage of sequential writes
to the total number of I/O operations. Valid ranges are 1 - 100. Values specified
with -read, -write, -seqread, and -seqwrite combined cannot exceed 100.
- -starttime starttime
- An optional parameter that specifies the time, in HH:MM format, of the
start peak duration..
- -endtime endtime
- An optional parameter that specifies the time, in HH:MM format, of the
end peak duration.
- -startdate startdate
- An optional parameter that specifies the date, in yyyymmdd format, when
the profile should start.
- -enddate enddate
- An optional parameter that specifies the date, in yyyymmdd format, when
the profile should end.
- original_profile_name
- An optional parameter that specifies the profile to be changed.
Description
You can use the chprofile command to
modify a workload profile that can later be used with the mkrecom command
to create a performance recommendation for assigning ESS volumes.
Return values
Profile profile_name successfully modified.
Possible failures
- Profile profile_name already exists.
- Profile profile_name does not exist.
- The total of the values specified for -read, -write, -segread,
and -segwrite cannot exceed 100%.
- The predefined profile {0} cannot be modified.
Examples
An invocation example:
perfcli> chprofile -read 20 -write 25 -seqread 25 -seqwrite 30 -startdate 20040402
-starttime 08:30 -enddate 20040403 -endtime 13:00 -timemode device myprofile
The resulting output:
Profile myprofile successfully modified.