Capprofile (1m), Capprofile(1m), Name – HP Matrix Operating Environment Software User Manual
Page 139: Synopsis, Description
capprofile (1M)
NAME
capprofile -- Import, export, display, invalidate and remove Capacity Advisor data collected for
workloads or systems.
SYNOPSIS
Path on CMS:
•
/opt/vse/bin
capprofile
-c
[ -b begin-time ] [ -e end-time ] [ -y delimiter ]
profileID
capprofile
-i
[ -p | -S ] [ -b begin-time ] [ -e end-time ] [ -o ] [ -y
delimiter
] profileID
capprofile
-l [n|t|v]
[-p] [ -b begin-time ] [ -e end-time ] [profileID
...
]
capprofile
-m [i|v]
[ -b begin-time ] [ -e end-time ] profileID ...
capprofile
-r
profileID
capprofile
-x
[ -p ] [ -b begin-time ] [ -e end-time ] [ -t ] [ -y
delimiter
] profileID ...
DESCRIPTION
The capprofile command manages utilization data collected on the HP Systems Insight Manager
Central Management Server (CMS) for Capacity Advisor. With capprofile, you can export
profile data, either as a file formatted for further processing, or as a table with headings; you can
also import data. With the capprofile command, you can display the names of systems or
workloads that have sufficient utilization data for Capacity Advisor to analyze and, for a particular
system or workload, you can display those time intervals that have valid data. The capprofile
command also lets you mark utilization data for specified time intervals as invalid.
Refer to the capprofile command reference pages for information on capprofile file formats.
The capprofile command compensates for certain imperfections in imported data. If profile
data is missing for a sample time, the data is assumed to be unavailable. No data for these samples
is shown in the profile viewer and the samples do not affect utilization aggregation. A warning is
issued for each group of consecutive missing samples when importing. Duplicate entries may
appear for a sample time. Only the values from the last sample in the file for that time are used.
A warning is issued for each duplicated sample. You can also import data from non-Matrix
Operating Environment (non-Matrix OE) workloads, such as data from nodes without Capacity
Advisor licenses.
During a transition to Daylight Savings Time, sample times may decrease by an hour and then
increment again as usual. After such a transition, samples are ignored until the time reaches the
next expected sample time.
Sample times may differ from times aligned to the hour (the usual case) as long as they are 5
minutes apart. Each sample time is modified to the nearest 5-minute multiple from the hour. For
example, if the first sample time is 18 minutes after the hour, the time for the data sample is imported
with a time of 20 minutes after the hour. The next sample time must be 23 minutes after the hour,
and it is imported with a time of 25 minutes after the hour, and so on. A warning is issued when
a file with non-aligned sample times is imported.
The following cases cause imported data to be ignored or converted and a warning message
issued:
•
A sample line with missing or extra metrics, as compared to the labels in the file header; the
sample line is ignored.
•
A sample with negative values for one or more metrics. Negative values are converted to
“Not A Number” floating point values.
•
A sample with invalidly formatted floating point numbers for the value of a metric; these sample
lines are ignored.
139