HP BladeSystem c-Class Virtual Connect Support Utility User Guide Version 1.2.0 Part Number 482172-001 February 2008 (First Edition) © Copyright 2008 Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. 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. Microsoft, Windows XP, and Windows Vista are U.S. registered trademarks of Microsoft Corporation. Windows Server 2003 is a trademark of Microsoft Corporation. Audience assumptions This document is for the person who installs, administers, and troubleshoots servers and storage systems. HP assumes you are qualified in the servicing of computer equipment and trained in recognizing hazards in products with hazardous energy levels. Contents Introduction .................................................................................................................................. 4 Overview .................................................................................................................................................... 4 Requirements ............................................................................................................................................... 4 Restrictions and limitations ............................................................................................................................ 4 Command line syntax ................................................................................................................................... 5 Usage ......................................................................................................................................................... 5 Password masking........................................................................................................................................ 6 version ........................................................................................................................................................ 7 report.......................................................................................................................................................... 7 discover ...................................................................................................................................................... 8 update ........................................................................................................................................................ 8 Commands .................................................................................................................................. 7 Troubleshooting .......................................................................................................................... 10 Error messages .......................................................................................................................................... 10 Technical support........................................................................................................................ 12 Before you contact HP ................................................................................................................................ 12 HP contact information................................................................................................................................ 12 Acronyms and abbreviations........................................................................................................ 13 Contents 3 Introduction Overview The HP BladeSystem c-Class Virtual Connect Support Utility enables administrators to upgrade VC-Enet and VC-FC module firmware remotely on both HP BladeSystem c-Class c7000 and c3000 enclosures using a standalone, Windows-based command line utility. When the utility initiates a firmware process, all modules are updated at the same time. The utility displays a progress message indicating that an update is in progress and the percentage complete. After the module firmware updates are complete, the utility activates all of the modules. Requirements The Virtual Connect Support Utility requires the following: · · · · · · · Microsoft® Windows® XP, Microsoft® Windows ServerTM 2003, or Microsoft® Windows Vista® operating system Administrator or Power User group membership No FTP Service, or other service running bound to TCP port 21 Add the Virtual Connect Support Utility application to the list of exceptions for any host-based firewall on the client Connectivity between client and OA on enclosure Onboard Administrator user account with Administrative privileges to all interconnect bays VC Manager account with domain rights if Virtual Connect is configured Restrictions and limitations · · · · · · This version of VCSU supports c3000 and c7000 enclosures. The utility does not update modules that are not physically present, are powered off, or are nonfunctional. A status message indicates if any modules are in these states. The utility does not update unknown or unsupported module types, including pass-thru Ethernet and FC modules. HTTP downloads are restricted to non-SSL, non-authenticated websites. FTP downloads are restricted to non-SSL/TLS, Passive Transfer Mode FTP sites. Any IP addresses that are not accessible timeout within 20 seconds. Any IP addresses that have an active SSL enabled web server, but not an OA, fail immediately. Introduction 4 Command line syntax CLI input is case-insensitive except when otherwise noted. The general CLI syntax format is as follows: vcutil -a Valid commands include the following. Command version report update discover Description Display list of current module firmware versions on target enclosure Display current module firmware versions, package firmware versions, and whether a module is updateable Update the module firmware on the target enclosure using the specified Virtual Connect firmware package Search a range of IP addresses for Onboard Administrator configurations Parameters are extensions that provide extra information required for the execution of a particular command. Whether or not a parameter is required depends on the specific action being executed. For example, the version command includes parameters for IP address, username, password, and bay location. The syntax is: vcutil -a version -i -u -p [-b ] To display a single module and its current firmware version, enter: vcutil -a version -i 192.168.1.100 -u Administrator -p password -b 1 Usage Use the following steps to install and run the HP BladeSystem c-Class Virtual Connect Support Utility. 1. 2. Install the application on the client system by running SETUP.EXE. After the program is installed, click Start>Programs>Hewlett-Packard>Virtual Connect Support Utility to start a console. o o o o To display the top-level help and available options, enter vcutil. To display version syntax and available options, enter vcutil -a version. To display report syntax and available options, enter vcutil -a report. To display update syntax and available options, enter vcutil -a update. 3. 4. Download a valid Virtual Connect firmware package file from the HP website (http://www.hp.com/go/bladesystemupdates), and then save it to your local file system. Enter the version command to display all of the modules in the enclosure and ensure that the required connectivity exists between the utility and the remote enclosure. Non-VC modules are shown as "Unknown or unsupported module." Version information is displayed for supported VC modules only. 5. Enter the report command to display all modules in the target enclosure and which modules can be updated. The report command also displays the firmware package file contents and versions. To use the report command, a valid firmware package must be available on the local filesystem. Introduction 5 Non-VC modules are shown as "Unknown or unsupported module." Detailed information is displayed for supported VC modules only. 6. Enter the update command to update the firmware on supported VC-Enet and VC-FC modules in the enclosure. The update process takes approximately 20 minutes for each VC-Enet module, and 5 minutes for each VC-FC module to be updated. The utility only updates supported VC modules that are able to be updated and require an update. Password masking For all of the commands provided by VCSU, the username, password, and IP address of the enclosure OA must be provided. In some cases, the VC domain username and password must also be specified. VCSU enables the user to enter the password interactively with password masking, primarily for security reasons. To do this, enter the password as "*" and a prompt is provided that masks the input. Example: vcutil -a version -i 192.168.1.100 -u Administrator -p * OA Password :*********** Confirm Password :*********** Introduction 6 Commands version Display the current running firmware version on all modules in a specific target enclosure. Item Syntax Parameters: IP USER PWD BAY IP address of the active OA in the enclosure Name of the OA user with privileges to access all enclosure interconnect bays Password of the OA user Optional. The bay number of the target module. If not specified, the default is all supported modules. Description vcutil -a version -i -u -p [-b ] Examples Display all modules and their current firmware versions: vcutil -a version -i 192.168.1.100 -u Administrator -p password Display a single module and its current firmware version: vcutil -a version -i 192.168.1.100 -u Administrator -p password -b 1 report Display the current running firmware version on all modules in a specific target enclosure, plus display the VC-Enet and VC-FC firmware versions provided in the specified VC package file, and whether or not the module can be updated. In addition to displaying the module firmware version and status, the report command also displays details about the VC package contents. Because the package version details are displayed, the user must provide a VC package file as part of the input at the command line. The report command does not require VC privileges because it is a readonly command. Item Syntax Parameters: IP USER PWD FILE BAY IP address of the active OA in the enclosure Name of the OA user with privileges to access all enclosure interconnect bays Password of the OA user Full path to the Virtual Connect package on the local computer Optional. The bay number of the target module. If not specified, the default is all supported modules. Description vcutil -a report -i -u -p -l [-b ] Commands 7 Examples Display all modules in an enclosure: vcutil -a report -i 192.168.1.100 -u Administrator -p password -l VCpackage Display a single module in an enclosure: vcutil -a report -i 192.168.1.100 -u Administrator -p password -1 VCpackage -b 2 discover Locate remote OA enclosures that exist on the network within a specified address range. This command is useful if an Administrator cannot remember the exact IP address of the OA on a certain enclosure, but the general IP address range is known. Item Syntax Parameters: START IP END IP First IP address in the range to search Last IP address in the range to search Description vcutil -a discover -s -e Example Discover an enclosure in a certain address range: vcutil -a discover -s 192.168.1.100 -e 192.168.1.200 update Update the firmware. The user must provide the primary OA IP address, user credentials, the package file to use for the update, and an optional bay number. The user can also force an update of modules in the following circumstances: · · Item The target module contains a running firmware image that is the same version as the one in the source package. The target module contains a running firmware image that is newer than the version in the source package. Description vcutil -a update -i -u -p -l [-b ] [-f ] [-vcu -vcp ] [-q] [-o ] IP address of the active OA in the enclosure Name of the OA user with privileges to access all enclosure interconnect bays Password of the OA user Full path to the Virtual Connect package on the local computer Syntax Parameters: IP USER PWD FILE Commands 8 Item BAY -f version VCM USER VCM PASS -q -o Description Optional. ...