HP Version Control Agent Manufacturing Part Number: 367262-003 February 2006, Edition 10 ©Copyright 2005-2006 Hewlett-Packard
Table of Contents Product overview ............................................................................................................ 4 Additional resources ............................................................................................... 5 Related topics ......................................................................................................... 5 Legal notices ..........................................................................................................
HP Version Control Agent Related topics ....................................................................................... 30 Updating software ........................................................................................ 30 Related topics ....................................................................................... 31 Refreshing inventory data ............................................................................... 31 Related topics ........................................
Product overview The HP Version Control Agent (VCA) is an HP Insight Management Agent that is installed on a system to enable you to view the HP software and firmware that is installed on that system. The VCA can be configured to point to a repository being managed by the HP Version Control Repository Manager (VCRM), allowing easy version comparison and software updates from the repository to the system on which the VCA is installed.
Product overview "Changing log settings" - Configure the log to automatically delete older entries reducing maintenance activity for administrators ● "Changing log settings" - Change the log settings ● 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.
Product overview Copyright notice © Copyright 2004-2006 Hewlett-Packard Development Company, L.P. All rights reserved. Reproduction, adaptation, or translation of this document without prior written permission is prohibited, except as allowed under copyright laws. Trademark notices Java is a U.S. trademark of Sun Microsystems, Inc. Linux is a U.S. registered trademark of Linus Torvalds.
Product overview Apache Apache license 2.0 January 2004 http://www.apache.org 1. Definitions. "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity.
Product overview 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License.
Product overview 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty.
Product overview GNU GNU general public license Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
Product overview of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole.
Product overview place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 5. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License.
Product overview version number. If the Program specifies a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 11.
Product overview A "library" means a collection of software functions and/or data prepared so as to be conveniently linked with application programs (which use some of those functions and data) to form executables. The "Library", below, refers to any such software library or work which has been distributed under these terms.
Product overview sections as part of a whole which is a work based on the Library, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it.
Product overview Otherwise, if the work is a derivative of the Library, you may distribute the object code for the work under the terms of Section 6. Any executables containing that work also fall under Section 6, whether or not they are linked directly with the Library itself. 6.
Product overview b. Give prominent notice with the combined library of the fact that part of it is a work based on the Library, and explaining where to find the accompanying uncombined form of the same work. 8. You may not copy, modify, sublicense, link with, or distribute the Library except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense, link with, or distribute the Library is void, and will automatically terminate your rights under this License.
Product overview 13. The Free Software Foundation may publish revised and/or new versions of the Lesser General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number.
Getting started To start using the HP Version Control Repository Manager (VCRM) and the HP Version Control Agent (VCA), 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 Version Control Installation Guide. 2. Install and configure the SMH. For more information regarding the SMH, refer to the System Management Homepage Installation Guide. 3.
Getting started 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.
Getting started 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.
Navigating the software The HP Version Control Agent (VCA) provides an interface that enables you to easily navigate through the tabbed pages: ● "Home" ● "Log" Related topics ● Viewing overall software status icons ● Home ● Log Home The Home page lists the HP software and version currently installed. The content of the Home page depends on the configuration of the HP Version Control Repository Manager (VCRM).
Navigating the software ● Licensing ● Viewing overall software status Viewing overall software status The Overall Status icon is not displayed until an HP Version Control Repository Manager (VCRM) has been configured using the Change Agent Settings link. After a repository has been configured, the Overall Software Status icon is based on a comparison between the installed software or firmware versions and newest components available from the configured VCRM.
Navigating the software Note: There is a Software Status icon for every system except HP-UX. The status is based on comparing the installed versions against versions in the repository. Icon Status There are different reasons why an Unknown status icon might display: ● The VCA does not have an HP Version Control Repository Manager (VCRM) configured. ● 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.
Navigating the software Icon Status 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 configured at the VCA is no longer valid at the configured VCRM.
Navigating the software newest available version of the component in the configured repository. Click any version number in the Latest Version column to link to a description of that version stored in the repository. The Support Pack Version column is not shown if a Reference Support Pack has not been defined using the Change Agent Settings link.
Navigating the software 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 Overall Software Status.
Navigating the software Related topics ● Home ● Viewing overall software status icons Showing or hiding software The Show Additional Items Available in the Repository link provides the Available Software list of ProLiant and Integrity Support Packs and components available for installation. Available ProLiant and 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.
Navigating the software 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.
Navigating the software Note: If the VCRM cannot be accessed, an error message appears, and you are returned to the HP Version Control Agent Change Agent Settings page to reenter the settings. ● In the Select the Reference Support Pack field, select the name of an HP ProLiant and Integrity Support Pack from the dropdown menu to use as the default reference for the Support Pack Version column on the Home page.
Navigating the software b. Automatic Reboot. Enables the 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.
Navigating the software ● Reference Support Pack ● Names of installed software ● 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.
Navigating the software To view the VCA Log, click the Log tab. The Log page appears. 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 Status Icons column lists icons that denote the severity of each task. A definition of each status icon is shown. Icon Status Major Warning Normal Informational ● Severity.
Navigating the software Viewing details for single log entry The VCA Log page enables you to view details regarding a log entry when available. If log entry details 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" .
Navigating the software 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. Note: Do not clear the log while an installation is in progress, because the file is in use by the component setup programs, and clearing it can interfere with the overall result status returned to HP SIM.
Navigating the software Changing log settings The Change Log Settings link 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.
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: The VCRM's SMH has anonymous access enabled. HP recommends that you upgrade the VCRM with the version from the 7.50 HP Management CD.
Troubleshooting Solution: You are attempting to install the VCRM with the VCA, whose service does not have administrative 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.
Troubleshooting 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 the failed component. 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.
Troubleshooting 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. Replicate Agent Settings problems The Replicate Agent Settings feature in HP SIM denies access to the source system for security reasons.
Troubleshooting exist in the repository. 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: When SMH is installed, the VCA cannot be configured to access a VCRM 2.1 or later using the administrator login credentials.
Troubleshooting This problem will be corrected in future releases of the VCA. Some of the software installed on the system shown in the Software Inventory of the VCA is not shown. Why? Solution: The following components do not appear if you have HP Insight Management Agents 5.
Troubleshooting HP Version Control Repository Manager Access problems After updating my Windows XP system with Service Pack 2, I am unable to access the HP Version Control Repository Manager. What happened? Solution: The Windows XP Service Pack 2 implements a software firewall that prevents browsers or other clients from accessing the ports required for access to the VCRM.
Troubleshooting To resolve this issue, use Internet Explorer 6.0 SP1 or later, or HP Remote Deployment Utility to configure components. The Upload Support Pack task does not work. What is happening? Solution: The browser settings to download and run ActiveX controls must be enabled for the Upload ProLiant Support Pack task to work. To configure the Microsoft Internet Explorer security settings 1. From the Microsoft Internet Explorer toolbar, click Tools and select Internet Options.
Troubleshooting ● Verify the domain name server (DNS) settings are correct. ● Verify that the proxy server, port, and proxy user authentication settings are correct. After I use the 'Upload a Support Pack' feature, why are some of the new Support Packs marked invalid and other files missing, even though the upload appeared to complete successfully? Solution: The upload completes after all files have been transferred from the local system to the VCRM.
Troubleshooting 2. Stop the following services: ❍ All Insight Management Agents ❍ Array Configuration Utility ❍ HP Version Control Repository Manager ❍ HP Version Control Agent ❍ HP Insight Management Agent ❍ Surveyor ❍ HP Performance Management Pack (PMP) ❍ HP PMP Tools 3. Rename the directory \compaq\wbem to \compaq\wbem_old. 4. Create a new directory \compaq\wbem. 5. Copy the contents of the directory \compaq\wbem_old to \compaq\wbem. 6.
Troubleshooting To resolve this issue, 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. The Security tab appears. 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.
Troubleshooting 4. When you select the certificate file using Browse, an Internet Explorer warning appears regarding ActiveX Controls. Click Yes to load the certificate file. ProLiant Support Pack problems After setting the repository directory with the encryption attribute and restarting the VCRM service, none of the ProLiant Support Packs are displayed in the VCRM Catalog page. In addition, the Log page indicates that a component has been deleted from the repository.
Troubleshooting Solution: The 6.40 ProLiant Support Pack does not work with VCRM 1.0. HP recommends that you install VCRM 2.0 or later. Note: The installation of the VCRM 2.0 does not require a reboot. I have the VCRM Auto Update feature configured to automatically download ProLiant and Integrity Support Packs and the VCRM states the updates have completed successfully. However, no files have been downloaded. Solution: A log entry appears in the VCRM Log indicating Automatic update downloaded 0 files.
Troubleshooting tab, or the category does not display at all. When I click the link under the Integrated Agents, a page displays indicating The application is not available. Solution: On Windows, the associated Win32 service is stopped. You must restart the HP Version Control 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.
Troubleshooting Event ID Facility Severity Text 28 Application Informational The installation task succeeded. VCA Log URL. 53 Application Informational The configuration task succeeded. VCA Log URL 60 Application Informational Started the VCA (normal startup). 65 Application Informational The VCA Win32 service was stopped 208 Application Error The installation task failed. VCA Log URL: 503 Application Error The configuration task failed.
Glossary available software A 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. component A 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.
Glossary installed version A particular HP software component that is installed on the server on which the VCA is installed. latest version The latest version of a particular HP software component that is contained in the repository. overall software status 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.
Glossary 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.
print, 40 ProLiant Support Pack, 48 Replicate Agent Settings, 40 software inventory, 41 Index A accessing, 20 R B Reference Support Pack, 27 refreshing, 31 release history, 5 replicating, 4 reporting, 31 browser errors, 19 C changing, 28, 36 clearing, 34 copyright, 5 G S showing, 28 signing out, 21 software status, 23 getting started, 19 H hiding, 28 Home page HP Version Control Agent, 22 HP ProLiant and Integrity Support Pack, 27 HP Version Control Agent, 4, 6–7, 10, 19–20, 22– 23, 25, 27–28, 30–