NAME
capcollect — Collect Capacity Advisor
data from systems to examine workload scenarios, do capacity planning, and
store the data on the CMS.
SYNOPSIS
Path: /opt/vse/bin
capcollect [hostname
...]
DESCRIPTION
The capcollect command enables the user to collect
historical utilization data from systems licensed for Capacity Advisor for
analysis on the Central Management Server (CMS). Utilization data is gathered
from systems specified using Web-Based Enterprise Management (WBEM). WBEM
Credentials for the systems are used as set up in HP-SIM. The data gathered
is stored on the CMS in files.
During a run, capcollect attempts to gather all
utilization data stored on the managed system that is not already present
on the CMS. Configuring capcollect to be run daily allows
the last 24 hours of data to be gathered on each run. If a system is inaccessible
when capcollect runs, an attempt is made to gather the
missing data during the next run. Previously collected data on the CMS older
than two years is removed. HP recommends that collection be configured to
occur daily.
Operands
- hostname
Specifies the names of the systems from which to collect utilization
data. By default, data is collected from all systems licensed for Capacity
Advisor. Note that Capacity Advisor does not consider a complex to be a system.
You cannot use the following special characters as part of a hostname:
grave accent ('`'), semi-colon (';'), ampersand ('&'), bar ('|'), left
parenthesis ('('), hash mark ('#'), greater than sign ('>'), less than sign
('<'), and the new-line character (ASCII 012).
Disk space needed on the CMS is about 32K per day per workload.
In addition to explicitly created workloads, there is a workload for the whole
system and a workload for orphan processes not assigned to any others.
RETURN VALUES
Exit values are:
- 0
Successful completion.
- 9
An invalid option was specified on the command line.
- 11
While accessing HP SIM to obtain licensing information and WBEM credentials,
an error occurred.
- 12
One or more of the specified systems is not licensed for Capacity
Advisor.
- 13
No HP SIM system or WBEM credentials were available.
- 14
While collecting data, an error occurred.
- 15
An error was encountered accessing the WBEM server on a managed system.
- 16
One or more of the system names specified on the command line could
not be resolved as a system name.
- 17
One or more of the systems specified on the command line is running
an operating system type that is not supported.
- 18
HP-SIM has identified one of the systems specified on the command
line as a device for which collection is not supported.
WARNINGS
Write access to profile data using the capprofile(1M) command may be delayed while
the capcollect command is running.
If you receive the following message: "Unable
to contact the WBEM server. See the capcollect(1M) manual page."
A network or system problem is preventing contact with the WBEM server.
To determine the cause of the problem, use the RETRY AND VERIFY PROCESS described
below.
RETRY AND VERIFY PROCESS
Retry the operation to see if the same error occurs.
Verify that the system is connected to the network.
Verify that the WBEM server process is running on the system.
Use the /opt/wbem/bin/cimprovider -ls command
to verify that the provider is responding to requests.
For additional error messages, their meaning and corrective action,
see the Capacity Advisor Help system or the error appendix to the HP
Integrity Essentials Capacity Advisor User's Guide.
DEPENDENCIES
You must run the capcollect command on the HP-SIM
CMS. For data collection to occur, the utilization provider must have been
installed, configured, and running for at least 10 minutes.
FILES
- /var/opt/vse/profile/bin
Root directory for storing collected data.
SEE ALSO
capprofile(1M), , capprofile(4)
Printable version
