StoreOnce software revision 3.14.1 (BB943-10504) release notes Abstract This document describes the StoreOnce System 3.14.1 software release, BB943-10504.rpm. This is a mandatory upgrade for the products listed. Part Number: BB913-90924 Published: 30th March, 2016 Edition: 1
Description This document outlines the functional changes and defect fixes for StoreOnce System software in the 3.14.1 software release, BB943-10504.rpm. This software revision contains new features as well as enhancements and fixes. Update recommendation Update recommendation: StoreOnce 3.14.1 software is valid for all StoreOnce Systems in Product models (page 2). It is a mandatory upgrade for systems already running StoreOnce 3.14.0 software. Supersedes information Supersedes: StoreOnce 3.14.0 software. In order to upgrade to 3.14.1 software you should first be running 3.14.0 software. IMPORTANT: This upgrade is not supported on products running software earlier than 3.14.0. Product models The 3.14.1 software release is applicable only to the following product models: BB913A: HPE StoreOnce 3100 System BB922A: HPE StoreOnce 3520 System BB914A: HPE StoreOnce 3540 System BB915A: HPE StoreOnce 5100 System Operating systems Languages This release is supported on: Cross operating system (BIOS, Firmware, Diagnostics, etc.) Languages supported for this release: English Japanese Chinese French German Brazilian Portuguese Russian Spanish Features and enhancements Support for new StoreOnce product, StoreOnce 5500 System Support for new StoreOnce product, StoreOnce 6600 System 2 Description
Fixes System navigates automatically back to Reporting Central online help page: This occurred when the Reporting Central GUI pages automatically refreshed the help page/ids and has been fixed. Virtual Tape Libraries: The following items have been addressed: Issues when deleting or erasing cartridges using the StoreOnce appliance internal functions (Customer Bulletin = c05048489) A rare issue where the Cartridge edit buttons on the GUI could become greyed out (disabled) when editing a library (Customer Advisory = c05050695) Firmware updates: The firmware for the following hardware components has been updated for reliability and quality fixes and upgrade is strongly recommended. Storage Controllers: p440ar update to 3.56 (also adds support for 5500 and 6600) 2 TB and 4 TB Hard Disk Drives: MB2000FCWDF/MB4000FCWDK update to HPD9 (reliability improvement) Localization fixes in the management GUI: Languages other than English - Date and Time setting and Firmware Update Success reporting Japanese only - SNMP configuration and Support Ticket configuration Reporting Central: Addressed English only content for Reporting Central help pages (Customer Advisories: c04976041 and c04995313) Addressed rare issue when obtaining information from a remote large multi-node system Replication reliability fixes: Addressed a small number of minor issues to improve operational reliability StoreOnce GUI Support Ticket Generation change: The option to exclude the Basic Support ticket at the time of generating a Full Support ticket has been removed. Event reporting : Addressed erroneous memory events. Added recommended customer actions to CPU events Optional Hardware Configuration: Changed Slot message and event "Invalid load order" to "Card installed in the wrong PCI-E slot" CLI net set wizard: Addressed intermittent issues seen when configuring dual IPv4 and IPv6 settings. Known Issues and customer advisories Locating customer advisories To find the most current product advisories and bulletins: 1. Go to www.hpe.com/support/hpesc. 2. Enter your product name (StoreOnce System) in the search box under Get drivers, manuals, parts & solutions. 3. Navigate to your specific product, if given additional product choices. 4. Select the Top Issues & Solutions tab. 5. Click Advisories, bulletins & notices in the right column. Fixes 3
HPE recommends that you register your product for Support Alerts at: www.hpe.com/support/ e-updates. After registering, you will receive e-mail notification of product enhancements, new driver versions, firmware updates, and other product resources. Known issues HPE StoreOnce 5500 and 6600 Systems and confidence checker report: The StoreOnce CLI command, system confidencechecker, may report as passed even if there are SAS cabling issues. Please do not rely on the SAS test within the confidencechecker diagnostic tests within 3.14.1. (Customer Advisory = c05054265) Software upgrade process may hang if a Support Ticket is collected too soon before the upgrade: This error is caused because Support Ticket processing has not completed. It is important to wait for the full support ticket to be generated before running the software upgrade. If you experience this issue, contact HPE Support. (Customer Advisory = c05062182) The server may unexpectedly power-cycle, due to a System ROM BIOS issue: If you think you have experienced this issue, contact HPE Support. StoreOnce CLI command 'system set config' may crash on license task' : The workaround is to add the licences outside of this wizard, using StoreOnce CLI command 'license add/load" or via StoreOnce GUI. View Storage configuration help page looks empty on the StoreOnce GUI: The help is available on subsesquent pages by pressing the Next link. The drawer numbering on the enclosure s 7 digit display does not match the physical drawer numbering on StoreOnce 5500 and 6600 enclosures: Always use the physical label on the drawer to identify the correct number for it within the StoreOnce System. Firmware flash of smart array p440ar leads to the OS not seeing the controller or a kernel panic: If you think you have experienced this issue after replacing the motherboard or a firmware update on a StoreOnce 5100 System, contact HPE Support. Event reporting incorrect when a drive is removed: The drive is correctly reported with MISSING status, but the event is incorrectly reported as DRIVE_NO_REMOTE_PATH instead of DRIVE_MISSING. GUI Hardware tree not reporting when FC port re-enabled: Hardware monitoring may take several minutes to refresh hardware status. Check the VTL or StoreOnce Catalyst pages to see if the FC port is available. Only 15 characters are allowed if configuring an IPSEC Passphrase via StoreOnce GUI: The workaround is to use StoreOnce CLI commands, that allows for 64 characters. Web browser crashes when a text field in the DHCP section of the Networking pages in the StoreOnce GUI is backspaced: The cursor is visible and the field is editable. However, on backspace the user is taken one page back and logged out this is normal browser behavior for Internet Explorer and does not occur with other browsers. Drive in error state not being shown by StoreOnce in error state: The StoreOnce GUI and CLI show hardware issues, but delving into the status shows no errors in subsystems - so the user is unable to identify the problem. Generate a Support Ticket and contact HPE Support. Alerts for "presentedvolume:missing": Under extremely heavy load conditions on the StoreOnce 5500, erroneous Alerts may be reported for "presentedvolume:missing". These then change to "presentedvolume:ok" on the next 5 minute cycle for the monitoring software. These alerts can be ignored. 4 Known Issues and customer advisories
Software upgrade prerequisites IMPORTANT: The software and firmware update processes require service sets to stop and the system to reboot. These actions are disruptive to any IO running on the system at the time, including: backup, restore, StoreOnce Catalyst Copy, Replication and housekeeping. Maintenance window required To perform the StoreOnce software upgrade a maintenance window is required in which the unit will be unavailable for normal operations. When scheduling the maintenance window, please use the following as guidelines of a typical amount of time that the upgrade will take: For StoreOnce single-node products, the entire upgrade process is expected to take up to 2 hours, depending on your hardware configuration. The software upgrade is expected to take 40 minutes. A further 20 80 minutes is required to perform necessary hardware firmware updates. This upgrade is not applicable to StoreOnce multi-node products. Pre-update checks It is advisable to perform the following checks before carrying out the software update process. Ensure that no backup or restore jobs are running when the upgrade is started. Any running backup or restore jobs will fail. NOTE: If the system is already approaching maximum capacity utilization, applying this release could result in future backup jobs failing due to insufficient space now remaining. To avoid this, before applying this software update: Review the Events log for any file system capacity events, for example: event codes E01070000, E01070001, E01070002. Look for the last file system capacity event. If the severity was ALERT, either use your backup application to expire and delete obsolete data to free space on the system or expand the system storage. To protect Customer data, the upgrade utility will check the status of the Product Hardware, Service Set(s) and Event Database size. If any elements are in a degraded or non-functional state, the upgrade utility will not carry out the requested software and\or firmware upgrade(s). if this happens, please use the system with the old software and contact HPE Support for further help. For improved confidence that the update will be successful when run, the three checks that the upgrade utility is based upon can be run manually before attempting the upgrade. Hardware status To check hardware status run the StoreOnce CLI command, hardware show problems. If any of the hardware, except HBA_Port, shows a status of removed, failure/failed, down/offline, the upgrade will be blocked. IMPORTANT: All configured network ports must be properly connected otherwise they will be flagged as down/offline and the software upgrade will not proceed. If there are warnings or errors reported on any of the hardware the details can be found by running the StoreOnce CLI command: hardware show status <dev-id of failed hw> detail, where <dev-id of failed hw> is the value shown in the dev-id of failed hw column of the output from the hardware show problems command. Software upgrade prerequisites 5
NOTE: You can also check the Hardware page on the StoreOnce GUI and drill down to the failed item. Read the Diagnostic messages for the failed hardware and ensure the problem is rectified before attempting an upgrade. Service set status To check the service set status run the StoreOnce CLI command, serviceset show status. A typical example of the output of this command is shown below: # serviceset show status Service Set 1 Status ------------- ------- Overall : Running StoreOnce Subsystem : Running Virtual Tape : Running NAS : Running StoreOnce Catalyst : Running Replication : Running Housekeeping : Running If any of the service sets is in a state other than Not Started / Running, upgrades will fail. Event database size To check the Event Database size look it up in the StoreOnce GUI on the Events page, where the count is displayed at the top. We have seen upgrades fail when the number of events is greater than 50,000. If this is the case the number should be reduced by using the Delete button in the GUI to remove older events and reduce the number to less than 48,000. NOTE: For security reasons, events of type "Audit" cannot be deleted as other event types can. They are managed through the retention period setting. Pre-upgrade actions HPE strongly recommends that you perform the following actions immediately prior to starting the software update process to ensure a smooth update process: Back up the system configuration using the StoreOnce CLI command, config save devices and config save keystore. Make sure that you are using one of the supported web browsers for accessing the StoreOnce Management GUI: Internet Explorer 9, 10 and 11 (note that Internet Explorer 8 is not supported and some StoreOnce features will not work) Mozilla Firefox v22 and above and Firefox ESR24 and above Software upgrade installation instructions (all products) IMPORTANT: Verify all prerequisites have been fulfilled, as described in the previous section. 6 Software upgrade installation instructions (all products)
After downloading the software upgrade package 1. To ensure the integrity of your download, HPE recommends verifying your results with this MD5 Checksum value: Checksum value e58f10f87de5bf81b3b554a138c0962a Filename BB943-10504.rpm 2. sftp the upgrade package BB943-10504.rpm to the software repository on the StoreOnce appliance. NOTE: In the following instructions, where the term Management IP address is used, this is the IP address that you normally use to log on to the StoreOnce GUI or CLI. Using Linux sftp Admin@<Management_IP Address> cd repository put BB943-10504.rpm exit sftp Using a Windows sftp client Ensure the File Protocol is set to SFTP, not SCP or FTP. Login to the Management IP address as Admin. Copy BB943-10504.rpm to repository. StoreOnce 3100, 3520, 3540 and 5100 only: Run the StoreOnce CLI software update commands Enter the following StoreOnce CLI commands: 1. system show repository which should list out the rpm file you copied over 2. system load package BB943-10504.rpm to load and unpack the package: 3. system show packages which will show you the packages staged ready for update. NOTE: The name of the package once it is loaded and unpacked is in the following format: Package Version State ---------- ------------- ----- D2D_Master 3.14.1-1607.1 staged 4. system update packages which will begin the process and upgrade and reboot the system 5. Check that update was successful as described in To check that update is successful (all systems) (page 7). To check that update is successful (all systems) Wait for the system to reboot. NOTE: Depending upon the updates, this could take could take 50 minutes or longer for StoreOnce 6600 Systems and 10 minutes or longer for all other products. Once access returns to the Management interface, check that the process has completed successfully, as follows: From the CLI: Use system show packages to check that all packages are now installed, as well as staged. The output should be in the following format: Software upgrade installation instructions (all products) 7
Package Version State ---------- ------------- ----- D2D_Master 3.14.1-1607.1 installed D2D_Master 3.14.1-1607.1 staged From the GUI: Check the System Information details on the StoreOnce screen, to ensure that the software revision number has updated to the 3.14.1 software version. From the GUI: Check the Event log (Event Code : E01070016) for a confirmation message of the software upgrade: Update D2D_Master 3.14.1-1607.1 completed successfully. Run the firmware management tool It is important to check whether firmware updates should be applied after each software update. This is typically necessary for all StoreOnce hardware configurations. We have used the StoreOnce CLI in these release notes to illustrate the firmware upgrade process, but you can also use the StoreOnce GUI to carry out this task, if preferred. See the user guide for your product for information about using the StoreOnce GUI. NOTE: When using the StoreOnce GUI to run firmware management, please note that this tool does not work with the Internet Explorer 8 web browser; you must use a supported browser (Internet Explorer 9, 10 and 11, or Mozilla Firefox v22 and above and Firefox ESR24 and above). Refer to the user guide for your StoreOnce System for more details. 1. Run the StoreOnce CLI command to show the current status of firmware # hardware show firmware all 2. Check the Action column to see if any firmware needs upgrading. IMPORTANT: Do not shutdown or reboot your system or any system component until step 6. Special instructions may apply. See step 6 for details. 3. Use the hardware update firmware command, as required. For example, there may be instances where replacement hardware may need a firmware downgrade to bring it in line with the supported firmware version of the installed StoreOnce software on the system being maintained. The command will be applied across all server components or across all storage components. hardware update firmware <node storage> 4. In some cases, when the firmware update has completed, you will need to perform a reboot to complete the firmware update. A message is displayed in the CLI output after successful completion, if a reboot is required. The message will also advise what type of reboot is required. Reboot the system using the StoreOnce CLI command: system reboot Power down the nodes using the StoreOnce CLI command: system shutdown After the system has completely shut down, wait at least one minute before powering on using the Power On button on the server(s). To complete the update (all models) Clear the browser cache and reopen the browser. Pull a support ticket and save for future reference. 8 Software upgrade installation instructions (all products)
Back up the system configuration using the StoreOnce CLI command, config save devices. If using encrypted VTL, NAS or StoreOnce Catalyst stores, back up the key configuration using the StoreOnce CLI command, config save keystore. Related software The following are available free of charge from the Software Depot: HPE StoreOnce Enterprise Manager (SEM): SEM is a standalone software application that provides basic management capabilities in a replication environment, and provides an easy way for customers to manage up to 400 StoreOnce devices that are being replicated across multiple sites. SEM also provides the ability to monitor disk usage and de-duplication ratios for devices allowing administrators the ability to identify devices that may need additional capacity. HPE StoreOnce OpenStorage Plug-ins (OST for NBU): The plug-in is required by Symantec NetBackup (NBU) applications when using StoreOnce Catalyst and is installed on the host media server(s). HPE StoreOnce Catalyst plug-in for Oracle recovery manager (RMAN): The plug-in is required by Oracle Recovery Manager when using StoreOnce Catalyst and is installed on the host media server(s). HPE StoreOnce Plug-in for Microsoft SQL Server (SQL): This plug in provides functionality to backup and restore a database to different logical devices such as DISK, TAPE, or URL when using StoreOnce Catalyst and is installed on the Windows Server running Microsoft SQL server. HPE StoreOnce Recovery Manager Central (RMC): HPE StoreOnce Recovery Manager Central software integrates HPE 3PAR StoreServ primary storage with HPE StoreOnce Systems to provide a converged availability and backup service that offers an alternative to traditional backup software. HPE StoreOnce Catalyst Plug-in for SAP HANA: The HPE StoreOnce Catalyst Plug-in for SAP HANA enables optimized protection for SAP HANA databases. It enables the Database Administrator to backup/restore directly to/from a Catalyst Store on a StoreOnce Backup appliance. The HPE StoreOnce Catalyst Plug-in for SAP HANA must be installed using the SAP HANA operating system user, not the root user. The plug-in includes guided installation and configuration for fast setup. This software is available free with all StoreOnce Backup systems that have the corresponding Replication and StoreOnce Catalyst LTUs, as appropriate. The software, including release notes and documentation, can be downloaded from: www.hpe.com/support/softwaredepot. Search for StoreOnce in the Search Software Depot search box. The search result includes the StoreOnce System Software for all products, VSA evaluation files, and QR images for all hardware platforms, plus a link to StoreOnce Free Software. Click on StoreOnce Free Software to access SEM and the other software listed above. Documentation feedback Hewlett Packard Enterprise is committed to providing documentation that meets your needs. To help us improve the documentation, send any errors, suggestions, or comments to Documentation Feedback (docsfeedback@hpe.com). When submitting your feedback, include the document title, part number, edition, and publication date located on the front cover of the document. For online help content, include the product name, product version, help edition, and publication date located on the legal notices page. Related software 9