enable you to view the HP software and firmware that is installed on that system. The VCA can be configured
to point to a
easy version comparison and software updates from the repository to the system on which the VCA is installed.
The VCA provides
system software status by comparing each
components or a specified ProLiant or Integrity Support Pack listed in the VCRM.
An entire ProLiant or Integrity Support Pack can be updated by clicking the install icon located next to the
system software status icon. Individual components are provided with check box to select for installation.
VCA is enhanced to identify the presence of Trusted Platform Module (TPM) on a TPM-enabled Windows
operating system. VCA supports installation/upgrading of both System ROM and option ROM components
on TPM-based systems. If VCA detects TPM module as being enabled, the user will be provided with a
checkbox to continue with the installation. The Install button on the component installation page of VCA is
enabled when the user confirms the decision to go ahead with the installation, confirming that the user is
aware of the recovery procedures by selecting the Continue checkbox.
NOTE:TPM is a secure microcontroller with cryptographic functionalities. It works with supporting software
and firmware to prevent unauthorized access to a system. TPM with BitLocker measures a system state and
upon detection of a changed ROM image, locks the user out of accessing the Windows file system if the
user cannot provide the recovery key.
repository
version control
being managed by the
(VCA) is an
and system update capabilities for a single HP system. The VCA determines
HP Insight Management Agent
that is installed on a system to
HP Version Control Repository Manager
component
installed on the local system with the set of individual
(VCRM), allowing
The VCRM and the VCA are integrated with the
standard single-server management tool in the ProLiant Essentials Foundation Pack.
Manager
software versioning, update, and tasks related to it.
The VCA is available for Windows and Linux operating systems. The VCA is an integrated part of the SMH
that is designed to display the
also allows the installation, comparison, and update of system software from a repository that is managed
by a VCRM.
Users with administrator or operator privileges can access the VCA to maintain the
the system manually. The installation of components and configuration activities are logged to a log file at
the system. The VCA logs activities, such as software installations. However, installations done outside the
VCA do not appear in this log.
The VCA enables you to view the software installed on selected HP equipment, the available updates, and
whether the installed software is compliant with the latest updates found in the selected repository. In addition,
you can add or update HP software on the system remotely, using the browser interface of the VCA.
You can use the
For more information regarding the Replicate Agent Settings feature, refer to the online HP SIM help
system.
The VCA permits:
•“Viewing installed software” - View the currently installed software
•“Changing settings” - Select a VCRM as a reference point for obtaining software updates
•“Viewing overall software status” - Select a ProLiant or Integrity Support Pack as a managed baseline
•“Viewing HP ProLiant and HP Integrity Support Pack details” - View the details associated with a ProLiant
•“Updating software” - Install a ProLiant or Integrity Support Pack or individual software component from
•“Printing software status”- Print the installed software inventory and software status
•“Viewing the log” - View the VCA log
•“Clearing the log” - Clear the VCA log
(HP SIM), also part of the ProLiant Essentials Foundation Pack, uses the VCRM and VCA to facilitate
available software
Replicate Agent Settings
or Integrity Support Pack or individual software component that is in the version control repository
the version control repository
feature in HP SIM to update multiple servers with VCA settings.
System Management Homepage
(SMH), which is the
HP Systems Insight
inventory of the system on which it is installed. The VCA
software inventory
of
5
•“Changing log settings” - Configure the log to automatically delete older entries reducing maintenance
activity for administrators
•“Changing log settings” - Change the log settings
•Identifying the presence of the TPM before proceeding to install the firmware components
In addition to maintaining the software inventory of the system, the VCA integrates with HP SIM. This
integration enables administrators to take advantage of the Software Update capabilities of the agent.
Additional resources
For additional resources, go to http://www.hp.com/servers/manage.
Related topics
▲The Home page
6Product overview
2 Getting started
To start using the
use the following steps as a guideline for installing and configuring your machines properly:
1.Verify that your system meets minimum requirements. For more information regarding minimum
requirements, refer to the
2.Install and configure the SMH. For more information regarding the SMH, refer to the
Homepage Installation Guide
3.Install and configure the VCRM with an
from the server where you are installing the VCA. One VCRM can support many VCAs, so in most
cases, you need only one repository. However, multiple repositories might be required for large or
widely dispersed enterprises.
4.Install and configure the VCA on the target system. Installing the VCRM before installing the VCA enables
you to configure the VCA to use data in the repository specified from the Change Settings link in the
VCA. For more information regarding installing the VCRM, refer to the
Guide
5.Browse to the
in.
6.Configure the VCA to use data provided by the repository defined by the Change Settings link.
Procedures
•Changing settings
•Updating software
•Viewing installed software
Related topics
HP Version Control Repository Manager
Version Control Installation Guide
.
.
System Management Homepage
(VCRM) and the
.
HP ProLiant and Integrity Support Pack
(SMH) located at https://hostname:2381 to log
HP Version Control Agent
Version Control Installation
(VCA),
System Management
on a machine accessible
•The Home page
•The Log page
•Viewing overall software status icons
Internet Explorer security settings
By default, Internet Explorer security settings block some actions performed by the HP Version Control Agent.
To correctly configure Internet Explorer security settings, HP recommends that you add the SMH URL to
Internet Explorer's Trusted Sites.
To add the SMH to Internet Explorer's Trusted Sites:
1.From Internet Explorer, click Tools→Internet Options.
2.Click the Security tab.
3.Select the Trusted sites icon.
4.Click Sites.... The Trusted sites dialog box appears.
5.In the Add this Web site to the zone field, enter https://hostname:2381/ and click Add.
6.Click OK to save your changes and close the Trusted sites dialog box.
7.Click OK to close the Internet Options dialog box.
Related topics
•Viewing the log
•Troubleshooting
Logging in
Access the
web browser. For information about which browsers are supported, refer to the
Guide
HP Version Control Agent
.
(VCA)
graphical user interface
(GUI) from any network client using a
Version Control Installation
Internet Explorer security settings7
IMPORTANT:If an
Software and Firmware Inventory of items currently installed on the system are displayed on the Home page.
The VCA settings must be configured for full functionality.
NOTE:Login accounts, which have Administrator or Operator privileges defined in the SMH, can access
all features of the VCA.
Logging into the VCA
To log into the VCA:
1.To access the VCA with access to all available features, you must log into the SMH with administrator
or operator level access.
2.Navigate to https://hostname:2381. The Login page appears if Anonymous Access is disabled.
If Anonymous Access is enabled, the SMH page appears.
3.After you have logged in, you can browse directly to the VCA by entering
https://hostname:2381/vcagent in the browser address field, or you can open it in a new
browser window by clicking the HP Version Control Agent link from the SMH under Integrated Agents,
or in the Version Control status box on the Home tab. The VCA page appears.
NOTE:In SMH 3.x and later, the Version Control (VCA and VCRM) agents links are available only under
the Version Control status box on the Home tab and it opens in the same window. The Integrated Agents
will be available in Webapps tab, but there is no link available for any agent.
Related topics
HP Version Control Repository Manager
(VCRM) has not been configured, only the
•Getting started
•Logging out
Logging out
Logging out of the HP Version Control Agent
You are logged out automatically from the
after approximately 15 minutes of inactivity.
To log out:
1.Browse to the VCA. You can click the servername Homepage link on the VCA banner.
2.Click the Sign out link in the upper right corner.
3.Close the web browser.
Related topics
▲Logging in
System Management Homepage
and
HP Version Control Agent
8Getting started
3 Navigating the software
The
HP Version Control Agent
tabbed pages:
•“The Home page”
•“The Log page”
•“The Help page”
Related topics
•Viewing overall software status icons
•The Home page
•The Log page
•The Help page
(VCA) provides an interface that enables you to easily navigate through the
9
10
4 The Home page
The Home page lists the HP software and version currently installed. The content of the Home page depends
on the configuration of the
for information regarding the configuration of the VCRM and
The following screen shows the Version Control Agent Home page with the current Software Status and the
list of the Installed Software.
HP Version Control Repository Manager
Reference Support Pack
(VCRM). Refer to “Changing settings”
.
The HP Version Control Agent Home page permits the following:
•“Viewing overall software status”
•“Viewing overall software status icons”
•“Viewing installed software”
•“Viewing HP ProLiant and HP Integrity Support Pack details”
•“Viewing the Reference Support Pack”
•“Showing or hiding software”
•“Changing settings”
•“Updating software”
•“Refreshing inventory data”
•“Printing software status”
Related procedures
•Logging in
•Logging out
Related topics
•Viewing overall software status icons
•Viewing overall software status
11
Viewing overall software status
The Overall Software Status icon is not displayed until an
has been configured using the Change Settings link. After a
Software Status
newest
component
icon is based on a comparison between the installed software or firmware versions and
s available from the configured VCRM. The
HP Version Control Repository Manager
repository
overall software status
has been configured, the
that appears depends
(VCRM)
Overall
on the configuration defined using the Change Settings link. You can configure the Overall SoftwareStatus to display a Major status if the server software version does not match the
Reference Support Pack
version. When both a repository and Reference Support Pack have been configured, the Overall SoftwareStatus icon is based on a comparison between the installed software or firmware versions and the software
or firmware versions in the Reference Support Pack.
For more information regarding the Software Status icons, refer to “Viewing overall software status icons”.
NOTE:If any custom software baseline is set as the reference support pack and the complete software in
the custom software baseline is not available in the Installed Software list, then the uninstalled softwares will
be listed in Not Installed list, and the overall status changes to Major only when the When checked, force
VCA to consider all the components in reference support for software status calculation and report
items that are not installed checkbox is selected when configuring a custom software baseline as reference
support pack.
IMPORTANT:Software status is based on a comparison of installed software against what is available in
the repository. You can configure software status to display
Major
when the server software version does
not match the Reference Support Pack version using the Change Settings link. If there are no comparable
items in the repository, the status is considered
current
.
To view overall software status, click the Home tab. The Home page appears.
Related procedures
•Changing settings
•Updating software
Related topics
•Viewing overall software status icons
•Navigating the software
Viewing overall software status icons
NOTE:Click a Software Status icon to access the
be accessed, help displays describing how to configure the VCA or trust relationship on that system.
NOTE:There is a Software Status icon for every system except HP-UX.
The status is based on comparing the
installed versions
HP Version Control Agent
against versions in the
StatusIcon
There are different reasons why an Unknown status icon might
display:
• The VCA does not have an
Manager
• The configured VCRM is not reachable or does not respond
to HTTP requests, for example, the system or service is down
or the password has been changed.
• A VCA cannot be detected on the system or cannot
communicate with the VCA.
(VCRM) configured.
(VCA). If the VCA cannot
repository
HP Version Control Repository
.
Status Values When no Reference Suppor t Pack is Set
Note: The status is that of the latest version of the component in the configured repository.
12The Home page
StatusIcon
This update contains critical bug fixes. HP requires that you apply
this update at your earliest convenience.
The repository contains a version of this component that might
contain bug fixes or new hardware support. HP recommends that
you review information about this version and apply this update
appropriately.
The installed software versions are the same or newer than the
latest versions
available at the VCRM.
Status Values When a Reference Suppor t Pack is Set but the Exact Match Setting is Not Selected
StatusIcon
This update contains critical bug fixes. HP requires that you apply
this update at your earliest convenience.
This update might contain bug fixes or new hardware support.
HP recommends that you review information about this version
and apply this update appropriately.
The installed software versions are the same or newer than the
versions in the Reference Support Pack.
The
Reference Support Pack
valid at the configured VCRM.
configured at the VCA is no longer
Status Values When a Reference Suppor t Pack is Set and the Exact Match is Selected
StatusIcon
The installed version does not match the version of the same item
in the Reference Support Pack, and the VCA settings specify that
an exact match is expected.
The installed software versions are the same or newer than the
versions in the Reference Support Pack.
The Reference Support Pack configured at the VCA is no longer
valid at the configured VCRM.
When the
overall software status
indicates that an item is not current, identify the software or firmware items
that have available updates, read the item descriptions, and determine whether the update is appropriate
for the server.
In the event a repository has been configured and a Reference Support Pack has not, the status is based on
a comparison between the installed software or firmware versions and the newest components available
from the configured repository.
In the event a repository and Reference Support Pack have been configured, the status is based on a
comparison between the installed software or firmware versions and the software or firmware versions in
the Reference Support Pack.
Related topics
•The Home page
•The Log page
Viewing installed software
The Installed Software section displays software and firmware versions.
If the
HP Version Control Agent
the software or firmware versions currently installed on the agent system.
After an
link, the
of the
link to a description of that version stored in the repository.
HP Version Control Repository Manager
Latest Version
component
column appears. The Latest Version column displays the newest available version
in the configured
(VCA) options have not been set, only the
(VCRM) has been configured using the Change Settings
repository
. Click any version number in the Latest Version column to
Installed Version
Viewing installed software13
column displays
The
Support Pack Version
Change Settings link. After a VCRM and the Reference Support Pack have been configured using the
Change Settings link, both the Support Pack Version and the Latest Version columns are listed. The
Support Pack Version column displays the component version of software or firmware that is part of the
configured Reference Support Pack. Click any version number in the Support Pack Version column to link
to a description of that version stored in the repository.
Status icons for installed software have the following meanings:
NOTE:The Overall Software Status appears depending on the configuration assigned by the Change
Settings feature.
NOTE:The Install icon is disabled if you are not logged in as SMH's Operator or Administrator privilege.
NOTE:If an installed software or firmware item does not have any version available in the configured
repository, it will not have an entry in the Support Pack or Latest Version columns. That item will not have
a status icon but is considered current when determining the
column is not shown if a
Reference Support Pack
StatusIcon
This update contains critical bug fixes. HP requires that you apply
this update at your earliest convenience.
This update might contain bug fixes or new hardware support.
HP recommends that you review information about this version
and apply this update appropriately.
The installed software version is equal or greater than this version.
Overall Software Status
has not been defined using the
.
VCA supports the SAS and SATA disk drive firmware smart components. The Installed Software section
displays disk drive firmware components. Based on the disk drive model, the components are grouped and
listed them as separate items with expandable and collapsible tree view.
Related topics
•Viewing overall software status icons
•Updating software
Viewing HP ProLiant and HP Integrity Support Pack details
The
HP Version Control Agent
Packs
and
components
Integrity Support Pack or component such as File, Name, Version, Languages, Release Date, Description,
Installation Notes, Prerequisites, Revision History, Availability Notes and Contents.
To view details about a specific ProLiant and Integrity Support Pack or component:
1.Click the Home tab. The Home page appears.
2.Click the hyperlink associated with the item you want to view detailed information about. A page
appears linking you to a page in the
Related topics
•The Home page
•Viewing overall software status icons
•Viewing installed software
. The detailed information provides you with information about the ProLiant and
(VCA) enables you to view details about
HP Version Control Repository Manager
HP ProLiant and Integrity Support
(VCRM).
Viewing the Reference Support Pack
The
Reference Support Pack
You can select a Reference Support Pack to be used to determine the
This configuration enables the monitoring of installed software versions against a known, stable set of software
versions. You can use an
Support Pack. A
Manager
14The Home page
Custom Software Baseline
(VCRM).
is configured by using the “Changing settings” link.
HP ProLiant and Integrity Support Pack
can be generated using the
overall software status
or a
Custom Software Baseline
HP Version Control Repository
of the system.
as a Reference
Related procedures
•Changing settings
•Viewing overall software status icons
Related topics
•The Home page
•Viewing overall software status icons
Showing or hiding software
The Show Additional Items Available in the Repository link provides the
ProLiant and Integrity Support Packs
Integrity Support Packs and components are appropriate for the version of the operating system installed on
the system, but might not necessarily be applicable to the specific server hardware. Only the ProLiant and
Integrity Support Packs and components available in the configured
To show additional items available in the repository:
1.Click the Home tab. The Home page appears.
2.Click Show Additional Items. The available software appears on the Home page.
NOTE:When the repository is empty, the Show Additional Items tab displays the following message:
There is no available software to show.
To hide additional items in the repository:
1.Click the Home tab. The Home page appears.
2.Click the Hide Additional Items link. The installed software appears on the Home page.
Related topics
•The Home page
•Viewing overall software status icons
•Changing settings
Changing settings
and
components
Available Software
available for installation. Available ProLiant and
repository
are displayed.
list of
The
HP Version Control Repository Manager
Configuring the VCRM enables the
that
repository
To change the settings:
.
(VCRM) is a directory of software that is available for installation.
HP Version Control Agent
(VCA) to monitor the software contained in
Showing or hiding software15
1.Select the Home tab. The Home page appears.
2.Click Change Settings. The Select the Version Control Repository Manager page appears.
a.In the Computer Name field, enter the name or IP address of a system with a VCRM installed.
Specifying the name of a computer with a VCRM installed allows a more detailed
software inventory
to be generated and provides a way to update HP software on the system.
b.In the Login Account field, enter a login that has the appropriate security level for the SMH on
the specified system. The type of account, account name and password depends on whether the
SMH or Management HTTP Server is installed at the system specified in the previous step. This
account must have Operator or Administrator level at the VCRM system, so it is recommended
that you use a browser to verify the login account and password before entering it.
Note: You must enter the administrator or operator account defined in the SMH and provide the
appropriate password for the VCA to download software from the VCRM. If anonymous access is
disabled at the VCRM, you must enter at least an account with user privileges and provide the
appropriate password for the VCA to provide software status by comparing the inventory with what
is available at the VCRM.
For Windows XP Service Pack 2 or Windows Server 2003 Service Pack 1, you might be unable
to access the VCRM because Windows XP Service Pack 2 and Windows Server 2003 Service
Pack 1implements a software firewall that prevents browsers or other clients from accessing the
ports required for access to the VCRM. To resolve this issue, you must configure the firewall with
exceptions to allow access through the ports used by HP SIM, VCA and other VCRMs.
To configure the firewall exceptions:
a.Select Start→Settings→Control Panel.
b.Double-click Windows Firewall to configure the firewall settings.
c.Select Exceptions.
d.Click Add Port.
You must enter the product name and the port number.
Add the following exceptions to the firewall protection:
Port NumberProduct
2301HP SMH Insecure Port:
2381HP SMH Secure Port:
Note: For more information regarding HP SIM secure and insecure ports, refer to the HP Systems
Insight Manager Technical Reference Guide at http://h18013.www1.hp.com/products/
servers/management/hpsim/infolibrary.html in the
Problems
section.
Troubleshooting
help file under
Login
e.Click OK to save your settings and close the Add a Port dialog box.
f.Click OK to save your settings and close the Windows Firewall dialog box.
This configuration leaves the default SP2 security enhancements intact, but will allow traffic over
the ports previously indicated. The secure and insecure ports must be added to enable proper
communication from your browser and other clients that access the VCRM.
c.In the Password field, enter the appropriate password for the login account that you selected in
the Login Account field.
3.Click Next to continue. The Select the Reference Support Pack page appears. Click Reset to clear
the settings you just specified or Cancel to abort the changes.
Note: If the VCRM cannot be accessed, an error message appears, and you are returned to the HP
Version Control Agent Change Settings page to reenter the settings.
•In the Select the Reference Support Pack field, select the name of an
Support Pack
from the dropdown menu to use as the default reference for the
HP ProLiant and Integrity
Support Pack Version
16The Home page
column on the Home page. If you changed the VCRM settings and do not want to specify a new
Reference Support Pack, you can click Finish without specifying a new Reference Support Pack.
•Select When checked, software status is based on installed software’s version matching
exactly that software’s version in the Reference Support Pack to alert you if software versions
do not match.
Note: If no Reference Support Pack was previously configured or the configured ProLiant and
Integrity Support Pack does not exist, the Reference Support Pack field displays (No Selection).
•Select When checked, force VCA to consider all the components in reference support for
software status calculation and report items that are not installed to consider the items in
the Custom Software Baseline as the Reference Support Pack for the VCA.
NOTE:The Mandatory Support Pack check box option is enabled only if a Custom Software
Baseline is selected as the Reference Support Pack.
4.Click Reset to clear the changes and return to the previous settings, Cancel to discard the changes
and retain the original settings, or Finish to save your changes. The updated configuration appears
on the Current Settings page.
5.Click Close to return to the Home page.
Note: If you click Cancel, a Confirm Cancel dialog box appears asking you to confirm your intention
to discard the changes and retain the original settings. Click No to return to the Current Settings page
or Yes to discard the changes, retain the original settings, and return to the Home page.
Related topics
▲Viewing the Reference Support Pack
Updating software
The Home page enables you to install
click the name of the software or firmware item to link to a description of that item from the
To install a component or ProLiant and Integrity Support Pack:
1.Click the Home tab. The Home page appears.
2.Select one, more than one, or all items under Support Pack Version and/or Latest Version.
HP ProLiant and Integrity Support Packs
and
components
. You can
repository
.
Updating software17
3.The Automatically Install Minimum Dependencies option appears at the bottom of the page. Select
this option to install the minimum dependencies required to install the selected items. This option is
available in VCA 2.2 or later connecting with VCRM version 2.2 or later.
NOTE:The Windows VCA shows the Automatically Install Minimum Dependencies option only
when the windows HP SUM smart component is available in the repository.
4.Click Install.
The PSP/Components selected for Install page appears for selecting the installation options.
•When the Automatically Install Minimum Dependencies option is selected, VCA displays the
selected components for installation under Components selected for Install and the components
that did not meet dependency under Dependency Failed Components List. By default, all the
components under Dependency Failed Components List are selected to force the installation.
•When the Automatically Install Minimum Dependencies option is not selected, VCA displays
the selected components with Delete, Move Up, and Move Down options to remove or reorder
the installation of components.
•Force downgrade or re-install.Enables the software to re-install itself over an existing or newer
•Automatic Reboot.Enables the
18The Home page
NOTE:CPLD firmware upgrade reflects only after unplugging and plugging the power supply
cable to the server. This is applicable for Hydrazine servers.
version.
Note: A
downgrade
to an older version might not succeed, even though this box is selected.
Selecting this box enables the installation to be attempted because normal processing for most
components does not attempt to install if a newer version is already present.
HP Version Control Agent
(VCA) to automatically reboot the
system if the installation requires a reboot when finished. In the case of a ProLiant and Integrity
Support Pack installation, this event occurs after all component installations complete without error.
If any component installation returns an error result, the reboot will not occur. Inspect the
VCA Log
after an installation error to determine whether the system must be restarted. If you do not select
Automatic Reboot, look at the log to determine if a reboot is needed. If the log indicates a reboot
is required, manually reboot the server for the installations to complete.
Important: When a task completes, be sure to read the details in the log to determine whether a
reboot is required.
•Proceed with Installation.Proceed with Installation checkbox is available on TPM-enabled
systems running on Windows operating systems only. Select the Proceed with Installation
checkbox.
5.Click Install to begin the installation or Cancel to abort the installation and return to the Home page.
NOTE:All components are downloaded before installation begins. An error in the download process
causes the installation to fail, and no component installations occur. An error in the installation of a
single component does not stop the installation of the rest of the components from a ProLiant and Integrity
Support Pack, but it does prevent an automatic reboot from occurring. In Windows, if an installation of
a single component does not complete within 15 minutes, a timeout occurs and the component installation
is terminated.
NOTE:Only one installation task can progress at a time. Clicking the Install icon while another
installation is in progress redirects you to the Log page for status of the current installation in progress.
NOTE:When using VCA 6.3 with VCRM 6.3, if any component upgrade fails with an exit code
3 during deployment, VCA hides this component’s version information from the latest and referenced
version information in INSTALLED item section. The version information of the same component
re-appears in the INSTALLED item section for the latest and referenced versions in case the component’s
installed version is changed.
Related topics
•Viewing installed software
•Viewing overall software status icons
Refreshing inventory data
The
HP Version Control Agent
To refresh the inventory data:
1.Click the Home tab. The Home page appears.
2.Click Refresh Inventory. The Home page is refreshed.
Related topics
•The Home page
•Viewing overall software status icons
Printing software status
The Print Software Status and Installed Software feature enables you to print a report that contains the
following:
•
Overall software status
•
Reference Support Pack
•Names of installed software
(VCA) enables you to manually refresh the inventory data.
•Installed version
•
Latest version
To print the software status and installed software:
1.From the HP Version Control Agent Home page, click the printer icon in the upper right corner. The
Software Status and Installed Software report appears. The default Print dialog box is also displayed.
2.Click Print. The report is printed.
Refreshing inventory data19
Related topics
▲The Home page
20The Home page
5 The Log page
The Log page contains information logged by the
The log is often informational when you are trying to troubleshoot a problem, such as why a specific task
failed. The log can be cleared using the Clear the Log tab.
The Log page permits:
•“Viewing the log”
•“Viewing details for single log entry”
•“Clearing the log”
•“Changing log settings”
Related topics
•Viewing the log
•Viewing details for single log entry
•Clearing the log
•Changing log settings
Related topics
•The Home page
•Navigating the software
•Viewing overall software status icons
•Windows events
HP Version Control Agent
(VCA) during its operation.
Viewing the log
The Log page displays information regarding specific tasks that have been executed.
To view the
NOTE:You can navigate through a log that has multiple pages by clicking the numbers or the arrows at
the bottom of the Log page.
You can display details for a specific task by clicking the details link associated with the Task ID. The StatusIcons column lists icons that denote the severity of each task. A definition of each status icon is shown.
•Severity.The severity icons shown report the severity of an event.
VCA Log
, click the Log tab. The Log page appears.
StatusIcon
Major
Warning
Normal
Informational
Viewing the log21
•Informational and Normal events are logged to confirm the internal event, such as startup, or the
result of a successful task completion, such as a
•Warning events can indicate a condition that might mean a feature of the VCA is not fully
operational, such as an incorrect configuration.
•Major events are logged when a task or process fails. This severity can indicate a problem with
the VCA but can also be caused by invalid input in a task or an external condition (such as a
network problem), which can prevent a task from completing.
•Task ID.Clicking links in the Task ID column displays a filtered log for that task. Click the Log tab
again or click Back from your browser to return to an unfiltered log. Tasks performed on behalf of an
interactive user have an ID generated by the VCA.
provide an ID for the tasks performed by Replicate Agent Settings and Install Software andFirmware.
•Date/Time.The date and time are recorded when an event occurs. The time is converted to the local
time at your browser so that it represents the actual time the event occurred, even if the server is in a
different time zone.
•Message.When additional information is available, a details link appears. Click the details link to
display details. To view details of a specific event, click the details link associated with the message
you want to view.
Related topics
•Viewing overall software status icons
•Clearing the log
component
install.
HP Systems Insight Manager
(HP SIM) commands
Viewing details for single log entry
The
VCA Log
are available, a details link appears at the end of the applicable log entry.
NOTE:For more information regarding Severity, Task ID, Date/Time, and Message fields, refer to
“Viewing the log”.
NOTE:Depending on the type of situation that caused a log entry to be written, detail information is written
in the VCRM's local operating system language or the client browser's language setting, if detail information
in that language is available. Changes to the browser language setting after the log entry is written do not
change the displayed language of the detail information.
To view log entry details:
1.Click the Log tab. The Log page appears.
2.Click the details link that is associated with the log entry about which you want to view details. The
Entry Details page appears.
Related topics
•Viewing the log
•Viewing HP ProLiant and HP Integrity Support Pack details
page enables you to view details regarding a log entry when available. If log entry details
22The Log page
Clearing the log
If the logs become lengthy and cumbersome, it can become difficult to find the information for which you
are searching. The Clear the Log tab enables you to clear the
CAUTION:Clearing the HP Version Control Agent log file is irreversible. Use this feature with caution.
IMPORTANT:Be sure that you have configure the Internet Explorer security settings properly. For more
information, refer to “Internet Explorer security settings”.
NOTE:You must be logged into the system with Operator or Administrator privileges to clear the log.
VCA Log
.
NOTE:Do not clear the log while an installation is in progress, because the file is in use by the
setup programs, and clearing it can interfere with the overall result status returned to HP SIM.
To clear the VCA log:
1.Click the Log tab. The Log page appears.
2.Click Clear the Log. The Clear the HP Version Control Agent Log page appears.
3.In the Text Save Option section, select Save Log Text if you want to save the existing log entries in
a text file for future reference.
4.Click Cancel to abort the clear operation or click Clear to clear the log.
The message The Version Control Agent Log was successfully cleared is displayed
and also provides a link to save the log in a different path before closing.
NOTE:The log is saved automatically in the default location, system
drive:\hp\hpsmh\data\cgi-bin\vcagent
5.To save the log message at a different location, click on Click here link.
The File Download dialog box appears.
6.Click Save. The Save As dialog box appears. Navigate to the location where you want to save the
text file, and click Save. The Clear the HP Version Control Agent Log page appears again, indicating
whether the VCA Log was cleared successfully.
7.Click Close. The Log page is refreshed.
Related topics
component
•Viewing the log
•Viewing installed software
Changing log settings
The Change Log Settings tab enables you to configure the log settings. You can specify whether you want
to automatically delete log entries, the number of days you want to keep the entries before deleting, and
the number of log entries displayed per page.
NOTE:You must be logged into the system with Operator or Administrator privileges to make changes
to the configuration or enable the Log Management features.
To change the Log Settings:
1.Click the Log tab. The Log page appears.
2.Click Change Log Settings. The Log Settings page appears.
3.In the Log Aging section, select Log Aging to specify a certain number of days to retain the log entries
before automatically deleting them. You can deselect Enable Log Aging if you do not want to
automatically delete log entries.
Clearing the log23
4.In the Days to Keep Entries field, enter the number of days that you want to retain the log entries
before deleting them.
Note: By default, log entries are kept for 90 days.
5.In the Log Entries Displayed Per Page section, select the number of entries that you want to display
on each Log page from the dropdown menu.
6.Click Reset to return the Log Settings page and restore the default settings, or Cancel to abort the
changes.
7.Click Finish to save the new settings. The Log Settings page appears indicating whether the log
settings were saved successfully.
8.Click Close. The Log page is refreshed.
Related topics
•Clearing the log
•Viewing the log
24The Log page
6 The Help page
The Help page provides help for the VCA and the options available in VCA.
To access VCA help, complete the following steps:
1.Click Help.
2.Click the HP Version Control Agent Help link.
Search Form
The Search Form section provides a field for you to input a
To execute a search, complete the following steps:
1.In the search terms textbox in the Search Form section, enter a search term.
2.Click Search.
If the search criteria is valid, a list of all documents matching the query appears.
Related Topics
•The Home page
•The Log page
search term
to search the VCA help.
Search Form25
26
7 Troubleshooting
HP Version Control Agent
Access problems
My Install buttons are grayed out in the VCA when I configure the VCA with administrator, operator or even
invalid credentials to connect to the VCRM.
Solution:
HP recommends that you upgrade the VCRM with the version from the 7.50 HP Management CD.
HP SIM problems
The VCRM's SMH has anonymous access enabled.
How do I recover from a failed update when the software
is performed in
Solution:
and the Smart Components that are deployed are only installed if supported by the target servers.
Use the task log to examine the target systems and determine where the update failed.
The software update feature in HP SIM does not locate any repositories. How can this be corrected?
Solution:
of available repositories. Also, for a repository to announce itself as such to HP SIM, ensure that the repository
is managed by the
to set up a VCRM on a system before you run Discovery in HP SIM for the first time. Make sure that the
VCRM trusts HP SIM.
One of the three items I was trying to install from HP SIM failed to download from the repository, yet the
other two items, which downloaded properly, did not install.
Solution:
I set up a task to notify me using email when a software update task completed in HP SIM, but when the
event arrived, not all of the software was completely installed.
Solution:
components. After the install command has been sent to the last system, the software update task completes,
and the completion event is sent. However, at this time, some of the systems might still be in the process of
downloading components and installing them.
Why can’t I install or update the VCRM using the VCA? I receive an Unable to install the Microsoft XML Parser
3.0 (1603) error.
Solution:
privileges.
Perform the recommended changes only on servers running both the VCA and VCRM:
1.Launch the Services program.
2.Right-click the VCA service.
3.Select Properties.
4.Click the Log On tab.
5.Click This account.
6.Enter the name of or browse to a user with administrative privileges using Browse.
7.Click OK to save the changes.
You will now be able to install and upgrade the VCRM using the VCA.
HP Systems Insight Manager
If the update task uses a software version criteria, execute the task again. The update starts over
Verify the Discovery settings and ensure that the IP range specified does not exclude the selection
HP Version Control Repository Manager
If any items fail to download from the repository, the VCA will not attempt to install any of the items.
The software update task sends the VCA on each target system a command to install the specified
You are attempting to install the VCRM with the VCA, whose service does not have administrative
(HP SIM)?
repository
(VCRM). While it is not necessary, it is useful
becomes unavailable while the update
Log problems
Why do I see a reboot required, Status 2 in the VCA Log but not in the Install Log?
Solution:
is often informational when you are trying to troubleshoot a problem, such as why a specific task failed. In
The VCA Log page contains information logged by the VCA during its operation. The VCA Log
HP Version Control Agent27
this specific case, the component setup program detected that the installation succeeded, but will not be
complete until the system is rebooted. The VCA does not reboot the system after each component install, but
at the end of all installations, to avoid unnecessary restarts. If the installation task was started without the
reboot automatically option selected, you must restart the server manually to ensure proper installation of
all software.
The Log page contains information logged by the component setup program.
Why do some of my components not install and report in the log as failed, although the hardware exists on
my server and requires the update?
Solution:
Windows NT, which is an installation that requires user intervention. The VCA can only install components
that are written for silent installation. The following components currently do not support silent installation:
•NetFlex/Netelligent Adapter Driver for Windows NT 4.0
•Ethernet/Fast Ethernet or Gigabit NIC Driver for Windows NT 4.0
•Array Redundancy Software for Windows 2000
In the event silent installation is not supported, HP recommends the following procedure
1.View the VCA log and determine which component failed.
2.Access the failed system, and browse to the VCRM repository from that system.
3.Browse to the Catalog and identify the component.
4.Click the component. The Component Details page appears.
5.Click the link associated with the component at the top of the Component Details page to download
6.Save the component to the system.
7.Install the component manually.
In the event components fail because they are not signed by Authenticode technology or have not cleared
the Microsoft Windows logo testing, check the target system for messages.
If these components do not or will not install without user intervention or silently, why does the VCA report
Failed to Install?
Solution:
After installing the SMH from the installation icon in the VCA, the VCA log disappeared and indicated that
the page cannot be displayed. What happened to the log?
Solution:
application and the system. To resolve this issue, HP recommends that you login to the SMH again and view
the VCA log directly to determine the status of the installation task.
Some HP components are not written to support silent installation, such as HP NIC drivers for
the failed component.
At the current time, the VCA does not differentiate between silent and non-silent components.
The SMH is restarted during the installation which disrupts the connection between the client browser
Print problems
When I try to print from a Mozilla browser, a dialog box displays indicating there is an Unknown Error.
Why is this happening?
Solution:
resolve this issue.
A default printer has not been configured. HP recommends that you configure a default printer to
ProLiant Support Pack problems
After initiating the ProLiant Support Pack installation on a server, a message displays indicating XML PARSING
ERROR and the log details display The xml file was tainted. The ProLiant Support Pack installation
is terminated.
Solution: The ProLiant Support Pack installation is terminating due to low disk space.
To resolve this issue, ensure the server has at least 200 MB or more of free disk space so the installation can
complete successfully.
Replicate Agent Settings problems
The Replicate Agent Settings feature in HP SIM denies access to the source system for security reasons. How
is this corrected?
28Troubleshooting
Solution:
authorized users. This security relies on security settings between HP SIM with managed systems. HP SIM
will deny access if the trust relationship between HP SIM and the source system's SMH is not configured
correctly. To correct this problem, HP suggests the following procedure:
1.Navigate to https://hostname:2381.
2.From SMH, click Settings→Security→Trust Mode.
3.Correct the configuration.
Note: For more information regarding Trust Relationships, refer to
SIM User Guide
Complete information on the security implemented by the management system, where the VCRM is installed,
and the managed systems, or SMH, are available in the
white paper, go to http://www.hp.com/servers/manage.
HP SIM implements security to ensure that access to management information is available only to
.
Repository problems
The job of the Software Version Status Polling tasks in HP SIM is to retrieve a list of installed software
and firmware from systems and obtain the software status from the
systems. Why do I need to specify a repository when setting up this task? Does it matter which repository I
choose?
Solution:
so that HP SIM can properly handle searches that include software version comparisons. The VCRM can
return a sorted list of versions for a
However, it is generally a good idea to choose a repository with the most complete set of software.
I cannot seem to configure the VCA settings to access the VCRM using the administrator credentials. Why
is this happening?
Solution:
administrator login credentials. A feature in the VCA prevents you from using the administrator credentials
to ensure that the administrator OS Account for the VCRM is not locked out when the VCA retries the login
to the VCRM several times.
HP recommends that you create an account with administrator privileges to be used specifically by the VCA,
for example, vcadmin.
HP SIM sends the selected VCRM a list of all the software versions in sorted order. This is necessary
When SMH is installed, the VCA cannot be configured to access a VCRM 2.1 or later using the
component
Setting up Trust Relationships
Security
white paper. To download the
HP Version Control Agent
even if that component does not exist in the repository.
in the
Security
(VCA) on those
HP
Software inventory problems
Why do some of the components display in the inventory for hardware that is not physically located on my
server?
Solution:
status icons in the
SmartStart installs all components, specifically storage components, for hardware, regardless of the physical
location of hardware on the server, for example:
•32-Bit SCSI Controller Driver for Windows NT 4.0
•Drive Array Driver for Windows NT 4.0
•Smart Array-2 Controllers Driver for Windows NT 4.0
•64-Bit/66Mhz Dual Channel Wide Ultra3 SCSI Controller Driver for Windows NT 4.0
•Smart Array 5x Controller Driver for Windows NT.40
The inventory for these components might display with Yellow status icons, stating an upgrade is needed
and available, which occurs when the VCRM configured on the VCA is cataloged with newer versions of
these components.
For example, if your server is configured with components from HP SmartStart CD 5.2 and the Catalog of
your VCRM contains new HP SmartStart CD 5.3 components, the inventory of the VCA displays the previously
mentioned items with Yellow status icons. You cannot upgrade these components because the physical
hardware does not exist on the system or allow the status icons to display with a Green icon reporting the
components are current. The Overall Status also continues to display with a Yellow icon because the VCA
is reporting components that need updating.
This issue is caused by a conflict between SmartStart and the VCA and might display with Yellow
Latest Version
and Support Pack columns.
HP Version Control Agent29
You can create a
as its
Reference Support Pack
components during its version comparison, which allows your Overall Status to display with a Green icon
stating the inventory is current. However, the Latest Version column will continue to display with Yellow
icons for these components.
This solution should only be applied to those systems without the storage hardware physically installed.
This problem will be corrected in future releases of the VCA.
“ati2mtag.sys" and "HPCISSs2.sys" are observed as software names under Installed Software.
Solution 1:
community string with read access. This will make VCA to collect inventory from SNMP.
Solution 2:
the latest applicable description from VCRM for that product.
Solution 3:
and driver name description.
Custom Software Baseline
Install Insight Management Agents for SNMP and install/configure SNMP with at least one
Populate VCRM with latest updates and configure VCA to VCRM. This will make VCA to update
Use Smart Start CD to install the required drivers. This will install drivers with the HP Metadata
Miscellaneous problems
Should the VCRM be installed before running Discovery in HP SIM, and if so, why?
Solution:
this repository trusts HP SIM. Refer to
information on trust relationships. It is a good idea to install a VCRM is so that the Software Version StatusPolling task can properly sort the versions of software retrieved from systems. If you do not set up a repository
before running Discovery, then the versions are sorted when a software criteria search is set up for the first
time.
Why is it that when I search for systems with Foundation Agents for Windows in HP SIM, I get only the
Windows 2000 systems back and not Windows NT?
Solution:
the search only returns the systems that match the operating system tree from which you chose the component
when you created the search. In this example, if you chose the Foundation Agents for Windows from the
Windows 2000 branch of the criteria tree, then only Windows 2000 systems are returned. If you want
systems from both Windows 2000 and Windows NT, choose the Foundation Agents for Windows from the
Windows 2000 and Windows NT branch.
What capabilities do I get from the VCA alone?
Solution:
installed on the local server. For the VCA to provide version control and software distribution functionality,
it must be configured to refer to a VCRM.
Does HP have any intention of disabling the Install icon on those components that do not install silently or
without user intervention in future releases?
Solution:
The VCA or VCRM display as links under the Integrated Agents list on the SMH, but the application is
missing from the version control category on the SMH's Home tab, or the category does not display at all.
When I click the link under the Integrated Ag ents, a page displays indicating The application isnot available.
Solution:
Agent or HP Version Control Repository Manager's Win32 service on the server. If the service is not set for
automatic startup, then configure the service to start automatically. If the service stopped unexpectedly, check
the Windows NT Event Log as well as the application's log for additional information.
On Linux, the associated VCA daemon process is stopped, and the VCA daemon can be restarted by the
root user running /etc/init.d/hpvca restart.
While it is not essential, it is a good idea to install a VCRM before running Discovery. Be sure that
Even though you choose a component that is supported for both Windows NT and Windows 2000,
The VCA provides a list of the
Yes.
On Windows, the associated Win32 service is stopped. You must restart the HP Version Control
excluding these components and configure your VCA to use it
. This option enables the
Setting up Trust Relationships
HP Web-enabled System Management Software
Support Pack Version
in the
HP SIM User Guide
column to exclude these
for more
and firmware
30Troubleshooting
Service and support
Support for
HP Version Control Agent
(VCA) is provided as an adjunct to support of the underlying hardware.
The purpose of the HP Support page is to provide you with a variety of product-, service-, and support-related
resources. In particular, you can use this page to:
•Go to http://www.hp.com/servers/manage. This website is devoted to Systems Management Products.
You will find a wealth of product- and service-related information on this portal.
•Access links to HP’s support home page and World-Wide-Website locator for phone numbers, online
tools, and information.
•Contact the HP Support Forum to get answers to your questions about HP products. The HP Support
Forum can be found at http://forums.itrc.hp.com/.
Keeping good records of your configuration can significantly speed up the troubleshooting process. Consult
the following list when you obtain assistance from your HP service provider:
•Management PC make, model, and serial number information
•Operating system information, including version number, a list of all service packs that have been
applied, the Compaq SSD version, and Insight Management Agent's names and versions that have
been applied
•Hardware configuration information:
Survey Utility output or Inspect printout•
•System Configuration Utility printout
•Description of any non-HP or non-Compaq equipment that is not shown on the Inspect or System
Configuration printout.
Windows events
The following table shows a listing of Windows events that are applicable to the VCA.
Related topics
•The Home page
•The Log page
•Navigating the software
TextSeverityFacilityEvent ID
InformationalApplication28
InformationalApplication53
InformationalApplication60
InformationalApplication65
ErrorApplication208
ErrorApplication503
ErrorApplication604
The installation task succeeded.
VCA Log URL.
The configuration task
succeeded. VCA Log URL
Started the VCA (normal
startup).
The VCA Win32 service was
stopped
The installation task failed. VCA
Log URL:
The configuration task failed.
VCA Log URL
The VCA Win32 service could
not be started successfully.
Service and support31
32
8 Legal notices
Warranty
The information in this document is subject to change without notice. Hewlett-Packard makes no warranty
of any kind with regard to this manual, including, but not limited to, the implied warranties of merchantability
and fitness for a particular purpose. Hewlett-Packard shall not be held liable for errors contained herein or
direct, indirect, special, incidental, or consequential damages in connection with the furnishing, performance,
or use of this material.
A copy of the specific warranty terms applicable to your Hewlett-Packard product and replacement parts
can be obtained from your local Sales and Service Office.
U.S. Government License
Confidential computer software. Valid license from HP required for possession, use or copying. Consistent
with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and
Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial
license.
HP-UX Release 10.20 and later and HP-UX Release 11.00 and later (in both 32- and 64-bit configurations)
on all HP 9000 computers are Open Group UNIX 95-branded products.
Intel and Itanium are registered trademarks of Intel Corporation in the US and other countries and are used
under license.
Java is a U.S. trademark of Sun Microsystems, Inc.
MS-DOS®, Microsoft®, and Windows® are registered trademarks of Microsoft Corporation in the United
States of America and in other countries.
Warranty33
34
Glossary
available softwareA listing of the software components available in the repository that the VCA has been configured
to point to. When browsing directly into a VCA, these additional components can be selected
for installation.
componentA component is a single, self-describing, installable (interactive or silent) binary file containing a
single piece of software, such as firmware image, driver, agent, or utility, that is supported by
the management and update tools.
Custom Software
Baseline
graphical user
interface (GUI)
HP Insight
Management
Agent
HP ProLiant and
Integrity Support
Pack
HP Systems Insight
Manager
A set of HP software components that have been bundled together as a baseline by the customer.
Modifying the contents of an existing Support Pack provides customers with the flexibility to define
their own baselines for their environment.
A program interface that takes advantage of the computer's graphics capabilities to make the
program easier to use. HP SIM's GUI is Web-enabled and displays in a web browser.
A program that regularly gathers information or performs some other service without the user's
immediate presence.
An HP ProLiant and Integrity Support Pack, or Custom Software Baseline is a set of HP software
components that have been bundled together by HP, and verified to work with a particular
operating system. A ProLiant and Integrity Support Pack contains driver components, agent
components, and application and utility components. All of these are verified to install together.
The system management software that is capable of managing a wide variety of systems, including
HP systems, clusters, desktops, workstations, and portables.
HP SIM combines the strengths of HP Insight Manager 7, HP Toptools, and HP Servicecontrol
Manager to deliver a single tool for managing HP ProLiant, Integrity, and HP 9000 systems
running Windows, Linux, and HP-UX. The core HP SIM software delivers the essential capabilities
required to manage all HP server platforms. HP SIM can also be extended to deliver unparalleled
breadth of system management with plug-ins for HP storage, power, client, and printer products.
Plug-ins for rapid deployment, performance management, and workload management enable
systems administrators to pick the value added software required to deliver complete lifecycle
management of their hardware assets.
HP Version Control
Agent
HP Version Control
Repository
Manager
HP Web-enabled
System
Management
Software
installed versionA particular HP software component that is installed on the server on which the VCA is installed.
latest versionThe latest version of a particular HP software component that is contained in the repository.
overall software
status
Red Hat Package
Manager (RPM)
Reference Support
Pack
An Insight Management Agent that is installed on a server to enable the customer to see the HP
software that is installed on that server. The VCA can be configured to point to a repository being
managed by the VCRM, enabling easy version comparison and software deployment from the
repository to the server that the VCA is installed upon.
An Insight Management Agent that enables a customer to manage software from HP that is stored
in a directory/repository known as the Version Control Repository.
The software that manages HP Web-enabled products.
This section indicates whether the software on the server on which the VCA is installed has any
updates available within the repository in which it has been configured to monitor.
The Red Hat Package Manager is a powerful package manager that can be used to build, install,
query, verify, update, and uninstall individual software packages. A package consists of an
archive of files and package information, including name, version, and description.
A baseline bundle of HP software components that the VCA can be configured to point to in the
repository. This setting enables users to indicate that they want to keep all of their software up to
a certain Support Pack level.
35
Replicate Agent
A tool that can be used to copy Web-based agent settings to a group of systems.
Settings
repositoryA directory containing ProLiant and Integrity Support Packs and Smart Components.
Secure Task
Execution (STE)
The secure execution of a task from a managed system. This feature of HP SIM ensures that the
user requesting the task has the appropriate rights to perform the task, and encrypts the request
to protect data from snooping.
Simple Network
Management
Protocol (SNMP)
One of the management protocols supported by HP SIM. Traditional management protocol used
extensively by networking systems and most servers. MIB-2 is the standard information available
consistently across all vendors.
single loginPermission granted to an authenticated user browsing to HP SIM to browse to any of the managed
systems from within HP SIM without re-authenticating to the managed system. HP SIM is the initial
point of authentication and browsing to another managed system must be from within HP SIM.
software inventoryA listing of the HP software installed on the system where the VCA is installed.
support pack
version
A field that displays the version of a particular HP software component that is contained in the
Reference Support Pack that the VCA has been configured to use as a baseline. There might be
a later version than this available in the repository, but this is the latest version of this particular
component in the Reference Support Pack.
System
Management
Homepage
An integrated piece of software used by the HP suite of HP Web-enabled System Management
Software to communicate over HTTP and HTTPS. It provides a uniform set of functionality and
security to HP Web-enabled System Management Software.
VCA logA listing of all the software maintenance tasks completed by the VCA and reports resulting from
those tasks.
version controlReferred to as the VCRM installed on a Windows system for Windows and Linux ProLiant systems,
and Software Distributor on HP-UX operating systems. Provides an overview of the software status
for all managed ProLiant or Integrity systems and can update system software and firmware on
those systems programmatically using predetermined criteria. Version control identifies systems
that are running out-of-date system software, indicates if an upgrade is available, and provides
reasons for upgrading. For HP-UX systems, Software Distributor can be launched from an HP SIM
CMS against one or more installed HP-UX systems.