startesscollection

You can use the startesscollection command to start a named data collection task on the Performance Manager server for an Enterprise Storage Server (ESS).

Syntax

Read syntax diagramSkip visual syntax diagram>>-perfcli-- --startesscollection-- ---devid--device_id [...]--->

>-- ---devip--device_ip [...]-- -- ---freq--frequency-- -------->

>---length--hours-- --collection_name | -----------------------><

Parameters

-devid device_id [...]
Specifies the nickname or manufacturer, model, and serial number (for example, ESS2105-123123-IBM) of the device to be included in the performance data collection task. Multiple devices must be separated by commas with no white space before or after each comma. All devices must be of the same device type.
-devip device_ip [...]
Specifies the device IPs to be included in performance data collection task. Multiple devices must be separated by commas with no white space before or after each comma. All devices must be of the same device type.
-freq frequency
Specifies how often the performance data is to be collected in increments of 5 minutes. For ESS devices, options are 5, 10, 15, ..., 60.
-length hours
Specifies how long, in increments of 1 hour, the collection task is to run. Valid values are between 1 hour and 720 hours.
collection_name name
Specifies the name of the collection task. Alternatively, use the dash (-) to specify that input for this parameter comes from an input stream (stdin). The name cannot be > 64 characters.

Description

You can use the startesscollection command to collect data. After you create and name a data collection task for an ESS, you can start the data collection task in one of these ways:

Return values

success
Collection collection_name was successfully executed.

Possible failures

Examples

The following example starts a collection against two ESS devices to run every 10 minutes for five hours.

perfcli startcollection -devid 1234.12345,6789.67890 -devip 192.168.0.10,192,168.0.11
 -freq 10 -length 5 collection2

The following example starts a collection against a single ESS device to run every minute for an hour.

perfcli startcollection -devid 1234.12345 -devip 192.168.0.10 
 -freq 1 -length 1 collection2

The resulting output:

Performance task collection2 successfully started.

Related topics

(C) Copyright International Business Machines Corporation 2004