Collecting Data

HP Integrity Essentials Capacity Advisor works best with lots of data to generate reports and create scenarios. It is most effective to collect data on a regular schedule; you can also trigger an up-to-date data collection for reports and profile generation. Collected data is kept on a managed system for 30 days and on the CMS for two years.




	IMPORTANT: The data collection process is purposely designed to consume few resources on the systems from which data is being collected. This means you can feel free to collect data whenever you want. However, the data collection process can take a relatively long time to run to completion when collecting data from a large number of systems. Collected Capacity Advisor data is not the same as VSE data. For a diagram of the VSE infrastructure, see Figure 2–1, Capacity Advisor Data Collection Infrastructure, in the HP Integrity Essentials Capacity Advisor User's Guide Version A.03.00.00 (this document if you are reading the manual).




	NOTE: You can import OVPA data into the historical database; see “Importing OVPA Data” in HP Integrity Essentials Capacity Advisor User's Guide Version A.03.00.00 (this document if you are reading the manual) and the capovpaextract(1m) manpage for additional information.Some of the menu items described below are repeated on other menus. Where an item is repeated on multiple menus, any of the duplicate menu items can be used to accomplish the result.

Once you have gathered data using the process described below, you may want to see reports or graphs based on the collected data (see Overview of Graphs and Reports) or build models based on the data to help plan future systems by creating scenarios (see Overview of Working with Scenarios).




	TIP: If, on gathering or collecting data, your data is not current, the time or time zone on a managed node may be set incorrectly. For instructions on correcting this, see Handling Old Data.

Dynamic Memory

A new dynamic memory feature is available in Integrity VMs. This allows the memory allocated to each virtual machine to be changed without rebooting the virtual machines. Capacity Advisor is aware of this feature and records both the memory allocated to each virtual machine as well as how much of this memory is in use for each five-minute interval. Both of these values will be correct when the virtual machines are using the dynamic memory feature.

When a virtual machine is running HP-UX 11.23, most built-in commands such as top and sar will not be aware of the dynamic memory feature and can show memory sizes that are very different from what is recorded by Capacity Advisor. If a virtual machine is initially booted with 16 Gigabytes of memory, and is then re-sized to 4 Gb, the built-in commands will not know about the change and will show 16 Gb for physical RAM. When a virtual machine is sized less than its maximum size, some built-in commands will show the kernel using more memory than it is actually using.

First Data Collection

Prerequisites. To gather data for the first time:

You must be logged in to HP Systems Insight Manager (see Accessing Capacity Advisor).

Procedure 4-2 To Gather Data the First Time

Select OptimizeCapacity AdvisorCollect Capacity Advisor Data ALL... from the upper, HP SIM menu-bar.
This will start the wizard for collecting data from all systems licensed for Capacity Advisor.
Click the Schedule button.
The Schedule Task screen will be displayed.
Select Periodically from the list labeled When would you like this task to run?.
In the area labeled Refine Schedule: set the top line to 1 day(s) at 12:01 AM using the interval and time fields. (Use a different time if this is a busy time for your systems.)
Under the list labeled In addition: click the check box labeled Run now.
Click the Done button.
The Task Results screen will be displayed. Once the Status field shows Complete, the collection task is complete. An Exit code that is 0 means complete success; positive values indicates partial or complete failure. For a complete explanation of the error codes, see the capcollect(1m) manpage. The results of the task are presented in the Stdout and Stderr tabs. The messages on the Stdout tab include indications of any errors that occur (see “Error Notification on the Standard Out Tab”, below, for an explanation of the messages). Be sure to check both tabs for a complete understanding of what happened.




	IMPORTANT: If you do not get data on systems you expect to have data from, triggering the license scan can help. To trigger the license scan: Select ToolsVSE Management... from the upper menu bar. The VSE Managment screen will be displayed. Select ToolsVSEMgmt Licenses... from the lower menu bar. The VSE Management: Scan for Licenses screen will be displayed. Click the Scan Systems button. This will pull in licenses from all licensed systems.

Modifying a Collection Schedule

As conditions evolve over time, you may want to modify the schedule for collections.

Prerequisites. To modify a collection schedule:

You must be logged in to HP Systems Insight Manager (see Accessing Capacity Advisor).
You must have created the collection schedule you want to remove (see “First Data Collection”) or be the HP SIM administrator (select HelpFor HP Systems Insight Manager from the upper, HP SIM menu-bar for information on HP SIM).

Procedure 4-3 To Modify a Collection Schedule

Select Tasks & LogsView All Scheduled Tasks...from the upper, HP SIM menu-bar.
The All Scheduled Tasks screen will be displayed, with a list of the tasks created by this user.
Click the radio button beside the task you wish to reschedule.
Click the Edit button.
The Task Confirmation screen of the Collect Capacity Advisor All wizard will be displayed.
Click the Schedule button.
The Schedule Task screen of the Collect Capacity Advisor Data All wizard will be displayed.
Modify the Schedule Task screen of the Collect Capacity Advisor Data All wizard.
Click the Done button.
The All Scheduled Tasks screen will be displayed.

Removing a Collection Schedule

As your collection needs change over time, you might need to remove a collection schedule.

Prerequisites. To remove a collection schedule:

You must be logged in to HP Systems Insight Manager (see Accessing Capacity Advisor).
You must have created the collection schedule you want to remove(see “First Data Collection”) or be the HP SIM administrator (select HelpFor HP Systems Insight Manager from the upper, HP SIM menu-bar for information on HP SIM).

Procedure 4-4 To Remove a Collection Schedule

Select Tasks & LogsView All Scheduled Tasks...from the upper, HP SIM menu-bar.
The All Scheduled Tasks screen will be displayed, with a list of the tasks created by this user.
Click the radio button beside the task you wish to delete.
Click the Delete button.
A confirmation screen will be displayed.
Click the OK button on the confirmation screen.
The task will be removed from the list. If this is the last in the list, “There are no available tasks to display.” will replace the list of tasks.

Updating Collected Data

At times, such as when you are generating reports and developing or refining scenarios, it is desirable to trigger data collection so that your work is based on the most up-to-date data. Some possible cases are:

Bring the collected data on all available systems up to date ( see “Updating Collected Data on All Systems”).
Bring the collected data from some systems up to date (see “Updating Collected Data on Selected Systems”).
Bring the collected data presented in a Profile Viewer report up to date (see “Updating Data Displayed in a Profile Viewer”).

Updating Collected Data on All Systems

Prerequisites. To update collected data on all systems:

You must be logged in to HP Systems Insight Manager (see Accessing Capacity Advisor).

Procedure 4-5 To Update Collected Data on All Systems

Select OptimizeCapacity AdvisorCollect Capacity Advisor Data ALL... from the upper, HP SIM menu-bar.
This will start the wizard for collecting data from all systems licensed for Capacity Advisor.
Click the Run Now button.
The Task Results screen will be displayed. Once the Status field shows Complete, the collection task is complete. An Exit code that is 0 means complete success; positive values indicates partial or complete failure. For a complete explanation of the error codes, see the capcollect(1m) manpage. The results of the task are presented in the Stdout and Stderr tabs. The messages on the Stdout tab include indications of any errors that occur (see “Error Notification on the Standard Out Tab”, below, for an explanation of the messages). Be sure to check both tabs for a complete understanding of what happened.

Updating Collected Data on Selected Systems

At times, you might want to collect data on selected systems.

Prerequisites. To update data on selected systems:

You must be logged in to HP Systems Insight Manager (see Accessing Capacity Advisor).

Procedure 4-6 To Update Collected Data on Selected Systems

Select OptimizeCapacity AdvisorCollect Capacity Advisor Data... from the upper, HP SIM menu-bar.
The Collect Capacity Advisor Data wizard will start.
Click the word - select - in the drop-down list below the title Add targets by selecting from:.
A list of filters will be presented.
Select an appropriate filter from the list (All Systems will list all the available systems, while other choices will constrain the selection list to subclasses of systems. The choice All VSE Resources restricts the list to those likely to be licensed for data collection.
Click the check boxes beside the systems you wish to collect data on. If necessary, use the plus sign controls beside classes of systems to display specific systems by expanding the list to expose hidden items. Access the help system by clicking the ? button for details on the controls.
Click the Apply button.
The Verify Target Systems screen of the wizard will be displayed with the filter applied.
If you wish to collect data on more targets, click the Add Targets button and repeat the preceding two steps.
If you wish to remove any targets from the list:
1. Click the check boxes by the targets you wish to remove.
  Check marks will appear in the check boxes.
2. Click the Remove Targets button.
  The targets with check marks in the check boxes will be removed from the list.
Once the list has the correct set of targets, click the Next button.
The Task Confirmation screen of the wizard will be displayed.
Click the Run Now button.
The Task Results screen will be displayed. Once the Status field shows Complete, the collection task is complete. An Exit code that is 0 means complete success; positive values indicates partial or complete failure. For a complete explanation of the error codes, see the capcollect(1m) manpage. The results of the task are presented in the Stdout and Stderr tabs. The messages on the Stdout tab include indications of any errors that occur (see “Error Notification on the Standard Out Tab”, below, for an explanation of the messages). Be sure to check both tabs for a complete understanding of what happened.

Updating Data Displayed in a Profile Viewer

Prerequisites. To update the data a Profile Viewer displays:

You must be in a Profile Viewer (see Accessing a Profile Viewer).

Procedure 4-7 To Update Data a Profile Viewer is Displaying

Click the Collect Capacity Advisor Data... button.
The busy indicator will appear over the grayed out Profile Viewer screen. When the busy indicator disappears, the information displayed will be based on updated data.
NOTE: If the data collection fails, the output from stdout and stdErr of the command are shown at the top of the screen.

Error Notification on the Standard Out Tab

While error messages are sent to the Stderr tab, the fact that errors have occurred is indicated on the Stdout tab. The messages sent to the Stdout tab are explained below.

All utilization data collected for "system-name"

Data collection succeeded on the system. No need to check the Stderr tab if this is the only type of notification.

Some utilization data collected for "system-name"

Although data collection was not entirely successful, some utilization data was collected. Check the Stderr tab for details of the problem.

Warning: message text.

A condition was detected while collecting that may affect the “usefulness” of the data collected. Check the Stderr tab for details of the problem.

NN Warnings issued.

Appears at the end of output on the Stdout tab.

Warnings were issued. Check the Stderr tab for details.

Collection failed on NN systems.

Appears at the end of output on the Stdout tab.

No data was collected from one or more systems. Check the Stderr tab. For each of the failed systems, there will be one or more messages, including the host name.