HP Version Control Repository Manager HP Part Number: 367261-009 Published: September 2010 Edition: 1
© Copyright 2004, 2010 Hewlett-Packard Development Company, L.P.
Table of Contents 1 Product overview........................................................................................7 Additional resources................................................................................................................................8 Related topics.........................................................................................................................................8 2 Getting started.................................................................
Related topics............................................................................................................................22 Creating a custom software baseline..................................................................................................22 Related topics............................................................................................................................23 Catalog.......................................................................................
Related topics..................................................................................................................................46 5 Legal notices............................................................................................47 Warranty.............................................................................................................................................47 U.S. Government License...............................................................................
1 Product overview The HP Version Control Repository Manager (VCRM) is a repository that stores the software and firmware components used to support ProLiant servers on Windows and Linux platforms. By default, the VCRM is installed on the HP Systems Insight Manager (HP SIM) central management server; however, you can specify a custom directory or a server location.
• GUI-based screen page for downloading Integrity Support Packs and ProLiant Support Packs: VCRM provides a GUI-based screen page for downloading the Integrity Support Packs and ProLiant Support Packs for Windows and Linux operating systems. • VCRM Command Line Interface: The VCRM CLI provides a Command Line Interface to interact with the installed VCRM for configuring the repository folder and initiating the auto download of ProLiant Support Packs and Integrity Support Packs.
2 Getting started To start using the HP Version Control Repository Manager (VCRM), use the following steps as a guideline for installing and configuring your machines properly: The recommended installation for the VCRM is on a single system that has a reliable, high-performance network connection between it and all managed systems that have the HP Version Control Agents installed. If the Auto Update feature is being used, that system must have Internet access. 1. 2. 3. 4. 5.
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 • Getting started • Logging out Logging out Log out of the HP Version Control Repository Manager (VCRM) to prevent someone from accessing your active session if you walk away. To log out of the GUI: 1. 2. 3.
Updating the repository Configuring the repository using VCRM CLI This section describes procedures that you can use to configure the repository using the VCRM CLI.
NOTE: Executing the command vcrmcli.exe /os without any value displays all the supported operating system attributes. NOTE: VCRM downloads ProLiant Support Packs for HP Version Control Agent's operating systems. Changing the repository folder From the command prompt, enter the following command: vcrmcli.exe /repository “location” The command configures the VCRM repository directory to the new location while retaining all of the other settings. Example: vcrmcli.
NOTE: Specify the values for each of the parameters in double quotation marks (""). where, /interval "7" corresponds to one week (7 days, valid values: 1, 2, 7, 14, 28) /dayofweek "0" corresponds to Sunday (0 is default, and is not used if the interval is less than 7. Valid values: 0, 1, 2, 3, 4, 5, 6) /time “22” corresponds to 10 PM (24-hour time format, valid values: 0 to 23) /proxyname “proxy.domain.com” "proxy.domain.
Repository Population - Initial Installation 1. 2. Click Add to select a directory that contains a ProLiant and Integrity Support Pack. The Browse for Folder dialog box appears. Navigate to the directory that contains a ProLiant and Integrity Support Pack, and click OK or Cancel to abort the selection. All Support Packs found in the selected directory are added to the list shown in the Initial Repository Configuration dialog box.
Updating the Repository The automatic update feature of the HP Version Control Repository Manager (VCRM) is the preferred solution for updating repositories automatically. The automatic update feature of the VCRM keeps servers connected to HP for proactive delivery of the latest HP ProLiant and Integrity Support Packs and components directly to a specified repository. You can configure the automatic population of the repository during the VCRM installation or after installation.
5. 6. 7. 8. 9. The CSP directory contains a Linux directory for Linux-related Support Packs and a Windows NT® directory that contains all of the components and support packs and an XML file for each supported Microsoft operating system. Click Linux or NT depending on the type of Support Packs with which you want to populate your repository. After you have opened one of the directories, select all of the Support Pack files, click Edit from the Windows Explorer toolbar, and select Copy.
3 Navigating the software You can access the HP Version Control Repository Manager (VCRM) by navigating to https://VCRMSystem:2381/vcrepository, or you can access it from the Version Control status box on the System Management Homepage (SMH).
1. 2. 3. 4. 5. 6. 7. From Internet Explorer, click Tools→Internet Options. Click the Security tab. The Security tab appears. Select the Trusted sites icon. Click Sites.... The Trusted sites dialog box appears. In the Add this Web site to the zone field, enter https://hostname:2381/ and click Add. Click OK to save your changes and close the Trusted sites dialog box. Click OK to close the Internet Options dialog box.
it, the ProLiant or Integrity Support Pack is invalid because one or more items listed in the ProLiant or Integrity Support Pack was not found in the repository. Note: You can access a full listing of all available ProLiant and Integrity Support Packs and components by clicking the Catalog tab.
example, certain ROM components, use the Delete feature of the VCRM to remove it from the system and catalog. To configure the repository and automatic update settings: NOTE: 1. 2. 3. You can also configure the Automatic Update Settings using the Command Line Interface (CLI). Click the Home tab. The Home page appears. Click the Change Repository and Update Settings link. The Repository Directory page appears.
a. Select the Enable automatic downloading of new HP ProLiant and HP Integrity Support Pack and components from Hewlett-Packard's website at a specified interval and time option if you want the repository to automatically update. Note: If you select the option to automatically receive updates, the Download schedule settings enable you to configure the frequency and times that you want to automatically update. b. c.
NOTE: You can install ProLiant Support Packs from the HP SmartStart CD. Refer to “Updating the repository” to learn how to update the repository from the HP SmartStart CD. NOTE: This feature is only supported on the Internet Explorer browser, and you must have configured your security settings to allow downloading and installing the Version Control Upload (ActiveX) Control. NOTE: For information regarding Microsoft Internet Explorer Security Settings, refer to “Configuring Internet Explorer settings”.
NOTE: You can also create a support pack from the Home or Catalog page. To create a Support Pack from the Home page: 1. 2. Click the Home tab. The Home page appears. Click the Create a Custom Software Baseline link. The Create a Custom Software Baseline page appears. Note: The Create a Custom Software Baseline link is also available from the Catalog tab. a. b. c. d. In the Operating System field, select the appropriate operating system from the dropdown menu.
NOTE: HP Smart Update Manager (HP SUM) component will be available automatically to VCRM during an automatic update. NOTE: Display option is available on main Catalog page, Create a custom software baseline page, Delete items page, and Copy items to another repository page. The following tasks can be performed: • “Viewing specific custom software baseline” - Viewing the contents in the repository • “Creating a custom software baseline” - Creating a Custom Software Baseline.
Icon Status Disabled Configuration. Configuration is disabled because you are not logged in as Administrator or Operator. ProLiant and Integrity Support Pack item. Custom Software Baseline item. Setting the display option The Catalog page enables you to set the display options. To set the display option on the Catalog page, complete the following steps: Setting the display option 1. 2. 3. Click Display Option, on the right of the Catalog page. The Display Option window opens.
NOTE: Document links can appear inside the details view, but these links will not work. The data displayed is specific to the http://www.hp.com website. NOTE: You can view the HP ProLiant and HP Integrity Support Pack Details from the Home page or the Catalog page. NOTE: The Server division and Windows 2000 operating system items are displayed.
Configuring a component The Catalog page enables you to select a configurable component and modify the component in the repository of the HP Version Control Repository Manager (VCRM). This process can be initiated to preconfigure component settings before it is installed on a server using the HP Version Control Agent (VCA) with or without HP Systems Insight Manager (HP SIM). NOTE: Only components for the Windows operating system currently support pre-configuration. To configure a component: 1. 2.
Related topics • Catalog • Configuring a component • Deleting items from the repository • Rescanning the repository • Viewing specific custom software baseline Copying VCRM settings and migrating the data to another repository The HP Version Control Repository Manager (VCRM) enables you to copy the VCRM settings and migrate the data from one repository to another repository.
1. Click the Catalog tab. The Catalog page appears. 2. Click the Copy Items to Another Repository link. The Copy Support Packs and Components page appears. 3. Select the Migrate HP Version Control Repository Manager Settings checkbox. Click Reset to clear the selected checkbox or Cancel to abort the VCRM data migration operation.
4. Click Next. The Destination Version Control Repository Manager page appears. a. b. c. 5. 6. In the Computer Name field, enter the name of the computer to which the VCRM settings and data are to be copied. In the Login field, enter the login name. In the Password field, enter the password for the account you entered. Click Finish. Click Back to return to the previous page, or Cancel to abort the Copy request. Click Close. The Catalog page is refreshed.
1. 2. 3. Click the Catalog tab. The Catalog page appears. Click the Rescan repository and rebuild catalog link. The Confirm Rescan dialog box appears. Click Cancel to abort the rescan process. Click Ok to rescan the repository directory and rebuild the catalog. When the process is complete, the refreshed Catalog page appears.
Deleting items from the repository The HP Version Control Repository Manager (VCRM) enables you to delete selected Custom Software Baselines, HP ProLiant and Integrity Support Packs, and components. CAUTION: Deleting a ProLiant and Integrity Support Pack or component is irreversible. Use this feature with caution. If you delete a file and want to recover it, you must use one of the manual methods to restore the component or ProLiant and Integrity Support Pack to the repository.
The report statistics provide a list of overall health status of all the VCAs connected to the VCRM. The different parameters listed are: • Systems with Major Status: Provides the count for the number of VCA systems with major status. Click on the Systems with Major Status hyper link to view the consolidated details of all the VCA systems with the Server Name or IP address, Last updated timestamp, Operating System, and Reference Support Pack information.
hyper link to view the consolidated details of all the VCA systems with the Server Name or IP address, Last updated timestamp, Operating System, and Reference Support Pack information. • VCAs connected to VCRM: Provides the count of the total number of VCAs connected to the VCRM. Click on the VCAs connected to VCRM hyper link to view the consolidated details of all the VCA systems with the Server Name or IP address, Last updated timestamp, Operating System, and Reference Support Pack information.
Generating a detailed report 1. 2. 3. 4. Select the systems running on operating system/s from the operating system list, and also the System Status for which you wish to generate the report. Select the Inventory filter either Green, Major, Minor, or Unknown for which you want to generate a detailed report. Select either ascending or descending order sort in the System Name or IP field and also select either ascending or descending order sort in the Operating System field.
NOTE: VCRM can save up to six last generated reports for viewing it later. Related topics ▲ Report Log The Log page displays a log of all actions performed by the HP Version Control Repository Manager (VCRM).
• Viewing log entry details • Viewing recently added HP ProLiant and HP Integrity Support Packs Viewing the log To view the log, click the Log tab. The Log page appears. The Log entries are displayed in three columns: • Severity The status icons report the severity of an event. • 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 component install.
Related topics ▲ Home Viewing log entry details There are two types of links in log entries: • Log entries for items that have been added to the catalog or existing catalog items that have been modified have the file name as a link to the details page for the item. • Some log entries can have additional information and have a details link. NOTE: Most log entries do not have additional data, so they do not have a details link.
1. 2. 3. 4. Click the Log tab. The Log page appears. Click Clear the Log. The Clear the HP Version Control Repository Manager Log page appears. 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. Click Clear to clear the log. A message is displayed The Version Control Repository Manager Log was successfully cleared and also provides a link to save the log in a different path before closing.
4 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.
5. 6. Under Script ActiveX controls marked safe for scripting, select Enable. Click OK to save your settings. You are returned to the browser. Catalog problems When I copy the files from a ProLiant and Integrity Support Pack into the repository manually, I might not see all of the new components listed on the Catalog page. What can I do to see these files? Solution: When you copy files into the repository manually without using the VCRM, the repository might need to be rescanned and the catalog rebuilt.
HP recommends the following actions: • Install HP SIM 4.2. Or • Download and install HP Web-enabled System Management Software Security Patch for Windows 5.94, which is available as SoftPaq SP25771 from http://h18007.www1.hp.com/support/files/server/ us/download/22728.html. 1. Log into the system with administrative privileges. 2. Stop the following services: 3. 4. 5. 6.
Pre-configuration problems I am unable to add a certificate to the SMH component when preconfiguring it in the VCRM or HP SIM. I receive the error Unable to Read the certificate file when I select a certificate using Browse. Solution: By default, Internet Explorer security settings block some actions. HP recommends the following actions: 1. 2. Be sure the selected certificate file has at least read access.
by a search that compares ProLiant Support Packs only if every component in the ProLiant Support Pack is present on the targeted system. It is unlikely that all of the components in a ProLiant Support Pack will be installed on any system. This causes most searches that include Support Pack software criteria to return no systems. After downloading the 6.40 ProLiant Support Pack into my existing VCRM 1.
Service and support Support for VCRM 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: • Access 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.
5 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.
To ensure that you receive newer versions when they become available, subscribe to the appropriate product support service. See your HP sales representative for details.
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.
Replicate Agent Settings A tool that can be used to copy Web-based agent settings to a group of systems. repository A directory containing ProLiant and Integrity Support Packs and Smart Components. Secure Task Execution (STE) 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.
Index access, 41 browser, 41 catalog, 42 Log, 43 miscellaneous, 45 ProLiant Support Pack, 44 A about, 10 C catalog page icons, 23 changing, 38 clearing HP Version Control Repository Manager , 38 configuring, 17, 19, 27 copying, 27 copyright notice, 47 creating, 22 D data migration, 28 deleting, 32 G getting started, 9 H R release history, 47 report generate report, 34 report page icons, 32 repository, 11, 27, 28, 30, 31, 32 rescanning, 30 S security, 17 service support, 46 signing out, 10 software re