HP BladeSystem c-Class Virtual Connect Support Utility Version 1.7.0 User Guide Abstract This document provides user information for the HP BladeSystem c-Class Virtual Connect Support Utility Version 1.7.0, which remotely upgrades the VC-Enet and VC-FC module firmware in HP BladeSystem c-Class c3000 and c7000 Enclosures. This document is for the person who installs, administers, and troubleshoots servers and storage systems.
© Copyright 2012 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.
Contents Introduction .................................................................................................................................. 4 Overview ................................................................................................................................................. 4 Using HP-UX ................................................................................................................................... 4 Requirements .........................................
Introduction Overview The HP BladeSystem c-Class Virtual Connect Support Utility enables administrators to upgrade VC-Enet and VC-FC firmware, and to perform other maintenance tasks remotely on both HP BladeSystem c-Class c7000 and c3000 Enclosures using a standalone command line utility. When the utility initiates a firmware upgrade process, VCSU performs an automatic health check, and then all modules are updated at the same time.
• An Onboard Administrator user account with Administrative privileges and access to all Onboard Administrators and interconnect bays must be available for use. If the enclosure is imported into a Virtual Connect domain, a Virtual Connect user account with Domain privileges is also required. • Ethernet network connectivity between the client system and the enclosure Onboard Administrator is required.
• IP addresses that are not accessible timeout within 20 seconds. IP addresses that have an active SSL enabled web server, but not an OA, fail immediately. • Only IPv4 addresses are supported in this release. • Prior to running VCSU, ensure that the maximum supported number of local user accounts for the Onboard Administrator has not been reached. For multi-enclosure domains, verify this information for each enclosure in the domain. Supported modules Module Supported in VCSU 1.7.
o To display the top-level help and available options, enter vcsu -a. o To display version syntax and available options, enter vcsu -a version. o To display report syntax and available options, enter vcsu -a report. o To display update syntax and available options, enter vcsu -a update. o To display discover syntax and available options, enter vcsu -a discover. o To display collect syntax and available options, enter vcsu -a collect.
Interactive mode VCSU enters interactive mode when invoked without any parameters. Users are prompted to enter missing command line parameters. Example: No command line parameters given. Starting interactive mode. Please enter action ("help" for list): healthcheck Please enter Onboard Administrator IP Address: 192.168.1.
Interactive mode question/request Description Please enter the Configuration (optional) Password for the backup password: configuration backup file Please enter Force Update options if any (eg: version,health): Please enter VC-Enet module activation order if any (eg: parallel or odd-even or serial or manual. Default: odd-even): Please enter VC-FC module activation order if any (eg: parallel or odd-even or serial or manual.
Commands collect Contact the OA using the supplied credentials and execute a SHOW ALL from the OA CLI, saving the output to an "oaShowAll.txt" file in the current directory. This support action also contacts the primary VC module using the supplied credentials and executes the following commands, saving the output to a "vcmShowAll.
discover Locate remote OA enclosures that exist on the network within a specified address range. VCSU displays the following: • Number of enclosures found • List of enclosure OA IPs with enclosure type, primary OA IP, and VC domain name This command is useful if an Administrator cannot remember the exact IP address of the OA on a certain enclosure, but knows the general IP address range.
Request a configuration download from Virtual Connect: vcsu -a configbackup -i 192.168.0.100 -u Administrator -p password -vcu Administrator -vcp password healthcheck List the state of modules in the enclosure. This command is useful if an Administrator needs to know if performing an action, such as a failover or a VC or OA firmware upgrade, would cause an outage.
Example List the state of modules in an enclosure: vcsu -a healthcheck -i 192.168.0.100 -u Administrator -p password -vcu Administrator -vcp password packageinfo Extract the package information from the supplied package path and display the following information: • Digital Signature Validation (for Virtual Connect firmware version 2.
Item Description VCM PASS Password for the Virtual Connect user. Minimum length is 3 characters. Maximum length is 31 characters. FILE Full path to the Virtual Connect package on the local computer or supported remote server *In a multi-enclosure environment, this must be the IP address of the active OA in the primary enclosure.
Item Description characters.** VCM USER Name of Virtual Connect user with Domain privileges. Required if an enclosure is in a Virtual Connect domain. Minimum length is 1 character. Maximum length is 31 characters. VCM PASS Password for the Virtual Connect user. Minimum length is 3 characters. Maximum length is 31 characters. LOCATION Full path, including file name, to save the support dump file.
Item Description VCM PASS Password for the Virtual Connect user. Minimum length is 3 characters. Maximum length is 31 characters. -q Optional. Specifies that the firmware update does not prompt for confirmation before updating, and uses the default answer for the confirmation (YES). -oe Optional. Specifies VC-Enet module activation order. The following activation order methods are supported: • • • • -of parallel—All modules are activated at the same time.
Perform an update using a firmware image from an FTP server on the network: vcsu –a update –i 192.168.1.100 –u Administrator –p password –l ftp://user:password@192.168.1.10/vcfw-120.bin Perform an update of the same firmware version on a degraded module: vcsu -a update -i 192.168.1.100 -u Administrator -p password -l C:\images\vcfc-120.bin -f version,health version Display the current running firmware version on all modules in a specific target enclosure.
Downgrades Overview This feature enables you to downgrade to a previously installed and running version of VC. Restrictions The following restrictions apply: • You must be running VC version 3.70 or higher to perform a downgrade. • You cannot downgrade to a VC version lower than v3.17. • A previous upgrade must have been performed on the configuration using VCSU 1.7.0. • All servers in the domain must be powered off. • Multiple, consecutive firmware downgrades are not allowed.
Troubleshooting Error messages Error message Resolution This version of the application does not support the Specify a supported enclosure type. target enclosure Check connectivity with the OA, and then restart the update Unable to get enclosure part number process. More than one instance of the update utility is attempting to Another instance of this application is running. Please wait until all other instances are completed run on the client.
Error message Resolution Firmware update failed on module See the vcsu-####.log file. Unable to transfer file to module Verify connectivity between the client and the enclosure. Unable to configure module for update Verify connectivity between the client and the enclosure. Another firmware update is currently in progress Wait until the current update is complete before attempting to update the firmware.
Error code Details VCSU_ERROR_PACKAGE_NOT_SUPPORTED The specified firmware package does not support the module. VCSU_ERROR_INVALID_URL The specified URL is not valid. VCSU_ERROR_URL_NOT_FOUND The specified URL could not be found. VCSU_ERROR_INVALID_ADDRESS The specified address is not valid or does not exist. VCSU_ERROR_INVALID_TARGET_FILE The specified target file is not valid or does not exist. VCSU_ERROR_FILE_OPEN_FAILED The specified file could not be opened.
Error code Details VCSU_ERROR_SSH_SESSION_NOT_ESTABLISHED The SSH session is not established. VCSU_ERROR_SSH_INVALID_COMMAND Invalid SSH command. VCSU_ERROR_SFTP_SHUTDOWN_FAILED Failed to shut down SFTP. VCSU_ERROR_INVALID_IP_ADDRESS Invalid IP address. VCSU_ERROR_CONNECT_FAILED Socket or connection call to the specified IP failed. VCSU_ERROR_OA_COMMUNICATION_FAILED Unable to communicate using the given OA IP.
Error code Details VCSU_ERROR_CLI_COMMAND_FAILED CLI command exited with non zero status. VCSU_ERROR_WEBSERVER_NOT_RESPONDING The web server is not responding. VCSU_ERROR_CHECKPOINT_NOT_REDUNDANT Checkpoint not redundant. VCSU_ERROR_CHECKPOINT_PENDING Checkpoint pending redundancy. VCSU_ERROR_VCM_LOCKED VC is in a locked state. VCSU_ERROR_VCM_NOT_LOCKED VC is not in a locked state. VCSU_ERROR_CONFIG_PARSE_ERROR Failed to read the VC configuration details.
Error code Details VCSU_ERROR_RESET_FAILED The reset on the target module failed. VCSU_ERROR_INVALID_MODULEID The specified module ID is invalid. VCSU_ERROR_PREVIOUS_UPDATE_NOT_COMPLETETD A previous firmware update operation on one or more modules is not complete. VCSU_ERROR_MULTIPLE_INSTANCE Another firmware update is running against the specified OA.
Error code Details VCSU_ERROR_POWER_STAGED_OFF Staged Off VCSU_ERROR_POWER_REBOOT Reboot VCSU_ERROR_HEALTH_UNKNOWN Unknown VCSU_ERROR_HEALTH_OTHER Other VCSU_ERROR_HEALTH_DEGRADED Degraded VCSU_ERROR_HEALTH_STRESSED Stressed VCSU_ERROR_HEALTH_PREDICTIVE_FAILURE Predictive Failure VCSU_ERROR_HEALTH_ERROR Error VCSU_ERROR_HEALTH_NON_RECOVERABLE_ERROR Non Recoverable Error VCSU_ERROR_HEALTH_STARTING Starting VCSU_ERROR_HEALTH_STOPPING Stopping VCSU_ERROR_HEALTH_STOPPED Stopped VCSU_ER
Error code Details VCSU_ERROR_VCEM_FW_MAINTENANCE_MODE VC is locked and in firmware maintenance state VCSU_ERROR_PRIMARY_BACKUP_HEALTH_NOT_OK The health of primary or standby module is not OK.
Support and other resources Before you contact HP Be sure to have the following information available before you call HP: • Active Health System log Download and have available an Active Health System log for 3 days before the failure was detected. For more information, see the HP iLO 4 User Guide or HP Intelligent Provisioning User Guide on the HP website (http://www.hp.com/go/ilo/docs).
Documentation feedback HP is committed to providing documentation that meets your needs. To help us improve the documentation, send any errors, suggestions, or comments to Documentation Feedback (mailto:docsfeedback@hp.com). Include the document title and part number, version number, or the URL when submitting your feedback.
Acronyms and abbreviations DHCP Dynamic Host Configuration Protocol DNS domain name system FC Fibre Channel HTTPS hypertext transfer protocol secure sockets OA Onboard Administrator SOAP Simple Object Access Protocol SSH Secure Shell SSL Secure Sockets Layer TLS Transport Layer Security VC Virtual Connect VCM Virtual Connect Manager VCSU Virtual Connect Support Utility Acronyms and abbreviations 29