IBM Support

Software Upgrade Test Utility

Downloadable files


Abstract

This utility can be installed on any SAN Volume Controller, Storwize V7000, Storwize V5000, Flex System V7000, Storwize V3500, Storwize V3700, FlashSystem V9000 or FlashSystem V840

Download Description

The utility can be used to check for known issues which may cause problems during a SAN Volume Controller, Storwize V7000, IBM Flex System V7000, Storwize V5000, Storwize V3500, Storwize V3700, FlashSystem V9000 and FlashSystem V840 update.

The utility can be run as many times as necessary at any time before a system update, but it is now required to have at least one run before an update. The utility performs a readiness check in preparation for a software update and we strongly recommend running this utility immediately prior to applying the update, making sure that there have not been any new releases of the utility since it was previously downloaded.

The installation and usage of this utility is non-disruptive and does not require any nodes to be restarted, so there is no interruption to host I/O. The utility will only be installed on the current configuration node / node canister.

When preparing for a software update, system administrators should also review the Flash Alerts relating to the SAN Volume Controller, Storwize V7000, IBM Flex System V7000, Storwize V5000, Storwize V3500, Storwize V3700, FlashSystem V9000 and FlashSystem V840 software version they are intending to install.

Installation Instructions

To use the upgrade test utility, follow these steps:

Download the latest version of the Software Upgrade Test Utility:-

Navigate to Fix Central here, choose your specific product and download from the "Select fixes" page for your product.

Though it is the same utility for SAN Volume Controller, Storwize V7000, IBM Flex System V7000, Storwize V5000, Storwize V3500, Storwize V3700, FlashSystem V9000 and FlashSystem V840, you need to download from the page for your product in order to pass entitlement checking.





When updating systems running releases V7.6.0 and later:


  1. Go to the Settings > System panel in the GUI
  2. Select Update System
  3. You can choose to Update and Test or just run the utility tool from the GUI by selecting Test Only


  4. Press the Update and Test button
  5. When prompted, upload the Test utility package and the Update package file and then press Update as shown in the following screenshot



  6. The following panel will ask you to select the type of update. You can choose between an automatic update or an service assistant manual update. To proceed after your selection press Finish to start uploading the packages




  7. If there are no warning(s) or error(r)s detected the system update will continue and start updating system nodes / node canisters.
  8. If the test upgrade utility detected warning(s) or error(s), you can review the output by selecting Go to Update System and then click Read more to see which actions are required before starting the system update by clicking Resume
  9. Otherwise you can click Cancel to exit the update wizard.



When updating systems running releases between V7.4.0 and the latest V7.5.0 PTF:

Note:
  1. Go to the Settings > System panel in the GUI
  2. Select Update Software
  3. Press the Update button
  4. When prompted, upload the Test utility package and the Update package file and then press Update as shown in the following screenshot



  5. The following panel will ask you to select the type of update. You can choose between an automatic update or an service assistant manual update. To proceed after your selection press Finish to start uploading the packages




  6. If there are no warning(s) or error(r)s detected the system update will continue and start updating system nodes / node canisters.
  7. If the test upgrade utility detected warning(s) or error(s), you can review the output by selecting Go to Update System and then click Read more to see which actions are required before starting the system update by clicking Resume
  8. Otherwise you can click Cancel to exit the update wizard




When updating systems running releases between V6.1.0 and the latest V7.3.0 PTF:

  1. Go to theSettings > General or Configuration > Advanced panel (depending on your code version) in the GUI
  2. Select Upgrade Software
  3. Press the Launch Upgrade Wizard button
  4. When prompted, upload the upgrade test utility package to the system and click Next



  5. When prompted, enter the software version you intend to upgrade to and click Next. This field will be automatically populated with the latest available software version if it is available
  6. The following page will contain the results of the upgrade test. Review the output from the upgrade test utility to see if any actions are required before starting the upgrade





When checking drive firmware levels only:


  1. The utility package can be installed using the standard SVC Console (GUI) or command-line (CLI) software upgrade procedures that are used to install any new software onto the system.

    Notes:
    • An example CLI command to install the package, once uploaded to the system, is
      svctask applysoftware -file IBM2145_INSTALL_upgradetest_X.X

    • If using the CLI to install the package, the return code for the applysoftware command will always be 1, whether the installation has succeeded or failed. The message which is returned when the command completes will report the installation result.

  2. Run the upgrade test utility by logging onto the SVC command line interface and running: 'svcupgradetest -f ',

  3. Review the output to check whether any drives are not at the latest level.

  4. If you wish to view the complete list of dives that are not at the latest level, run the command: 'svcupgradetest -f -d'.



When updating using the Command-line (CLI):
  1. The utility package can be installed using the standard SVC Console (GUI) or command-line (CLI) software update procedures that are used to install any new software onto the system.

    Notes:
    • An example CLI command to install the package, once uploaded to the system, is
      svctask applysoftware -file IBM2145_INSTALL_upgradetest_X.X

    • If using the CLI to install the package, the return code for the applysoftware command will always be 1, whether the installation has succeeded or failed. The message which is returned when the command completes will report the installation result.

  2. Run the upgrade test utility by logging onto the SVC command line interface and running: 'svcupgradetest -v <V.R.M.F>', where V.R.M.F is the version number of the new software being installed.

    For example, if planning to update to SVC 7.5.0.2, the command would be 'svcupgradetest -v 7.5.0.2'

  3. Review the output to check whether there have been any problems found by the utility. The output from the command will either state that there have been no problems found, or will direct you to details about any known issues which have been discovered on the system.




When running the utility using the Graphical user interface (GUI) only:

From V7.6.0 and onwards the utility can be installed and run in the GUI on its own.

  1. Select Test Only from the Update System page and upload the Test utility file and enter the Code level you are planning to update to.





  2. After the file was uploaded and the Update Test Utility completed, you will be presented with the results.

  3. The results will either state that there have been no warnings / problems found, or will direct you to details about any known issues which have been discovered on the system.



Document information

More support for: IBM Storwize V7000 (2076)

Version: 6.3, 6.4, 7.1, 7.2, 7.3, 7.4, 7.5, 7.6

Operating system(s): Platform Independent

Reference #: S4000585

Modified date: 16 December 2014