HP Version Control Repository Manager HP Part Number: 367261-401 Published: Arpil 2011 Edition: 1
© Copyright 2004, 2011 Hewlett-Packard Development Company, L.P.
Table of Contents 1 Product overview........................................................................................7 Additional resources................................................................................................................................8 Related topics.........................................................................................................................................8 2 Getting started.................................................................
Related topics............................................................................................................................23 Creating a custom software baseline..................................................................................................23 Related topics............................................................................................................................24 Catalog.......................................................................................
Catalog problems............................................................................................................................44 Error problems.................................................................................................................................44 HP SIM problems.............................................................................................................................44 Log problems....................................................................
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).
By default, Internet Explorer security settings block some actions performed by the VCRM. To correctly configure Internet Explorer security settings, HP recommends that you add the System Management Homepage (SMH) URL to Internet Explorer's Trusted Sites. To add the SMH to Internet Explorer's Trusted Sites: 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....
Overview of software baselines The Software Baselines section lists all of the ProLiant and Integrity Support Packs that the VCRM has cataloged in the repository. If a ProLiant or Integrity Support Pack has a Minor status icon displayed with 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.
status and software updates. If something is downloaded that does not apply to your environment, for 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.
5. Click Next. The Automatic Update Settings 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.
i. j. 6. 7. Click OK. Your new proxy settings are saved and you are returned to the Automatic Update Settings dialog box. Click Cancel to return to the Automatic Update Settings dialog box, if you do not want to enter the proxy server settings. The configuration you specified appears in the wizard. When the upload task completes, view the Log to confirm that all of the ProLiant and Integrity Support Packs and components were successfully uploaded to the VCRM.
click Cancel, a message appears asking you if you are sure you want to cancel the operation. Click OK, and the upload is canceled as soon as the current task is completed. Note: The Progress bar, located in the bottom of the browser window, indicates the status of the task currently being executed, while the one in the Upload Progress section shows the overall progress for all files being uploaded. 5. After the upload is complete, click Close to close the upload window and refresh the VCRM display.
6. 7. Click Finish. The Result page appears indicating whether the Software Baseline was successfully created. Click Close. The Home page refreshes, and a link to the new Custom Software Baseline appears in the list. Related topics • Viewing a custom software baseline • Uploading support packs • Configuring auto update Catalog The Catalog page displays all of the Software Baselines, HP ProLiant and Integrity Support Packs, and components stored in the repository.
Catalog icons The following icons indicate various information regarding the Software Baselines. Icon Status Closed/collapsed node. Open/expanded node. Open/expanded all. Close/collapse all. Component item. Not configured. The component was never configured. You can configure the associated component by clicking this icon. Configured. The component is configured. By moving your mouse over this icon, the configuration date appears. You can reconfigure the associated component by clicking this icon.
• Deleting items from the repository • Rescanning the repository Viewing specific custom software baseline The Software Baselines, displayed on the Catalog page, are grouped in the following order: • Division • Operating System • Category 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.
1. 2. Click the Log tab. The Log page appears. Locate the log entry for the component about which you want to view details. Click the link provided at the end of the log entry. The Component Details page appears. Related topics • Log • Changing log settings • Clearing the log 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).
4. Click Next. The Copy page appears. a. In the Name field, enter the name of the repository to which the selected Support Packs and components are to be copied. b. In the Login field, enter the login account name for the SMH at that computer. c. In the Password field, enter the password for the account you entered. Note: Step 4.b and Step 4.c are the login for the HP SMH system where the VCRM is located. You must login as Administrator or Operator to complete the Copy operation. 5. 6. Click Finish.
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.
NOTE: The reporting option is available on VCA versions 6.2 and above. NOTE: Reports are available and can be generated for the VCA systems which are connected to VCRM. Detailed Report of the all the VCA health status can be generated by clicking from the Detailed Report option on the Report page. Related topics ▲ Generating a detailed report Generating a detailed report Select the Detailed Report option available on the report page.
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.
Related topics ▲ Reports Archive The archive tab in VCRM provides you options to archive the software bundles and components.
The Archive Bundle field on the Archive page provides the following options to select the software bundles and components for archival: • Select bundles/components older than __ recent version(s): When selected, selects all the bundles/components that are older than the number of recent versions (entered by the user) for archival. NOTE: • The valid inputs for this option is 2 - 5 versions.
Restoring/Deleting the archived components The Restore/Delete Support Pack and Components page provides options either to delete the software bundles/components from the archived directory or restore back to the respository directory. The Restore/Delete Support Pack and Components page enables you to set the display options. To set the display option on the Restore/Delete Support Pack and Components page, complete the following steps: Setting the display option 1. 2. 3.
1. 2. Select the software bundles/components for restoring/deleting on the Restore/Delete Support Pack and Components page, and click Restore to restore back to repository, Delete to delete permanently, or Cancel to cancel the operation. The Restore page or the Delete page appears based on the selection in Step 1 listing the components which are selected in Step 1. Click Finish to complete restoration, or click Back to make any changes to the selection for Restore/Delete.
Procedures • Changing log settings • Clearing the log • Viewing component details • Viewing the log • 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.
Icon Status Events of this type are operating normally and are green in color. Events of this type require no attention. They are provided as useful information and are blue in color. 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.
Clearing the log If you are logged into the system with Operator or Administrator privileges, you can clear the HP Version Control Repository Manager Log. To clear the log: 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.
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.
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 A about, 10 archive page icons, 36 C catalog page icons, 24 changing, 41 clearing HP Version Control Repository Manager , 42 configuring, 17, 19, 27 copying, 27 copyright notice, 49 creating, 23 D data migration, 28 deleting, 32 G getting started, 9 H Home page HP Version Control Repository Manager, 18 HP ProLiant and HP Integrity Support Pack, 22 HP Version Control Repository Manager, 7, 10, 11, 17, 18, 19, 22, 23, 24, 26, 27, 28, 30, 31, 32, 39, 40, 41, 42, 43, 48 archive page, 36 archive restor