mkprofile

Use the mkprofile command to create a workload profile that you can use later with the mkrecom command to create a performance recommendation for ESS volume allocation.

Syntax

Read syntax diagramSkip visual syntax diagram>>-perfcli-- --mkprofile--+----------------------+-- ----------->
                          '--desc--"description"-'

>--+-----------+-- --+---------------+-- ----------------------->
   '--io--rate-'     '--trans-- size-'

>--+---------------------+-- --+------------------------+-- ---->
   '--readcache--percent-'     '--writedestage--percent-'

>--+----------------+-- --+-----------------+-- ---------------->
   '--read--percent-'     '--write--percent-'

>--+-------------------+-- --+--------------------+-- ---------->
   '--seqread--percent-'     '--seqwrite--percent-'

>--+-----------------------+--+-------------------+-- ---------->
   '--starttime--starttime-'  '--endtime--endtime-'

>--+-----------------------+--+-------------------+-- ---------->
   '--startdate--startdate-'  '--enddate--enddate-'

>--+-----------------------+--profile_name---------------------><
   '--timemode--+-client-+-'
                +-server-+
                +-device-+
                '-gmt----'

Parameters

-desc "description"
An optional parameter that assigns a user-defined description of the performance data collection task. The maximum character limit is 25.
-trans size
An optional parameter that specifies the average transfer size in KB.
-io rate
An optional parameter that specifies the average I/Os per second per GB over all logical unit numbers.
-readcache percent
An optional parameter that specifies the percentage of random read cache hits to the total number of random read operations. Valid ranges are 0-100. The default value is 50%.
-writedestage percent
An optional parameter that specifies the percentage of random write destages operations to the total number of random write operations. Valid ranges are 0-100. The default value is 50%.
-read percent
An optional parameter that specifies the percentage of random reads to the total number of I/O operations. Valid ranges are 0-100. The default value is 70%. Values specified with -read, -write, -seqread, and -seqwrite combined cannot exceed 100.
-write percent
An optional parameter that specifies the percentage of random writes to the total number of I/O operations. Valid ranges are 0-100. The default value is 30%. Values specified with -read, -write, -seqread, and -seqwrite combined cannot exceed 100.
-seqread percent
An optional parameter that specifies the percentage of sequential reads to the total number of I/O operations. Valid ranges are 0-100. The default value is 0%. Values specified with -read, -write, -seqread, and -seqwrite combined cannot exceed 100.
-seqwrite percent
An optional parameter that specifies the percentage of sequential writes to the total number of I/O operations. Valid ranges are 0-100. The default value is 0%. 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.
-timemode client | server | device | gmt
An optional parameter that indicates how the starttime, endtime, startdate, and enddate parameters are interpreted in terms of time zone.
client
Dates and times are specified in the time zone of the client.
server
Dates and times are specified in the time zone of the server.
device
Dates and times are specified in the time zone of the device.
gmt
Dates and times are specified in the time zone of the server expressed as Greenwich Mean Time (GMT).
profile_name
A user-assigned name for the profile that is being created.

Description

You can use the mkprofile command to recreate a workload profile that can later be used with the mkrecom command to create a performance recommendation for ESS volume allocation.

Return values

Profile profile_name successfully created.

Possible failures

Examples

An invocation example:

perfcli> mkprofile -desc "my description" -read 20 -write 25 -seqread 25 -seqwrite 30 -startdate 20040214
-starttime 08:30 -enddate 20040403 -endtime 13:00 -timemode device myprofile

The resulting output:

Profile myprofile successfully created.

In this example, the client is in the EST time zone, the server is in the PST time zone, device A is in PST, device B in is CST, the starttime is specified as 13:00, and the endtime is specified as 14:00. The timemode values are interpreted as:

client
The server will query the server database for device A and device B data with server timestamps between 10:00 and 11:00, three hours earlier than specified.
device
The server will query the database for device A and device B data with device timestamps between 13:00 and 14:00.
server
The server will query the database for device A and device B data with server timestamps between 13:00 and 14:00.
gmt
Since PST is (GMT - 8), the server will query for device A and device B data with server timestamps between 05:00 and 06:00.

Related topics

(C) Copyright International Business Machines Corporation 2004