Install Update 3 on your StorSimple 8000 series device

Note

The classic portal for StorSimple is deprecated. Your StorSimple Device Managers will automatically move to the new Azure portal as per the deprecation schedule. You will receive an email and a portal notification for this move. This document will also be retired soon. For any questions regarding the move, see FAQ: Move to Azure portal.

Overview

This tutorial explains how to install Update 3 on a StorSimple device running an earlier software version via the Azure classic portal and using the hotfix method. The hotfix method is used when a gateway is configured on a network interface other than DATA 0 of the StorSimple device and you are trying to update from a pre-Update 1 software version.

Update 3 includes device software, LSI driver and firmware, Storport and Spaceport updates. If updating from Update 2 or an earlier version, you are also required to apply iSCSI, WMI, and in certain cases, disk firmware updates. The device software, WMI, iSCSI, LSI driver, Spaceport, and Storport fixes are non-disruptive updates. These updates can be applied via the Azure classic portal. The disk firmware updates are disruptive updates and can only be applied via the Windows PowerShell interface of the device.

Important

  • A set of manual and automatic pre-checks are done prior to the install to determine the device health in terms of hardware state and network connectivity. These pre-checks are performed only if you apply the updates from the Azure classic portal.
  • We recommend that you install the software and driver updates via the Azure classic portal. Go to the Windows PowerShell interface of the device (to install updates) only if the pre-update gateway check fails in the portal. Depending upon the version you are updating from, the updates may take 1.5-2.5 hours to install. The maintenance mode updates must be installed via the Windows PowerShell interface of the device. As maintenance mode updates are disruptive updates, your device experiences downtime.
  • If running the optional StorSimple Snapshot Manager, ensure that you have upgraded your Snapshot Manager version to Update 2 prior to updating the device.

Preparing for updates

You will need to perform the following steps before you scan and apply the update:

  1. Take a cloud snapshot of the device data.
  2. Ensure that your controller fixed IPs are routable and can connect to the Internet. These fixed IPs will be used to service updates to your device. You can test this by running the following cmdlet on each controller from the Windows PowerShell interface of the device:

    Test-Connection -Source <Fixed IP of your device controller> -Destination <Any IP or computer name outside of datacenter network>

    Sample output for Test-Connection when fixed IPs can connect to the Internet

     Controller0>Test-Connection -Source 10.126.173.91 -Destination bing.com
    
     Source      Destination     IPV4Address      IPV6Address
     ----------------- -----------  -----------
     HCSNODE0  bing.com        204.79.197.200
     HCSNODE0  bing.com        204.79.197.200
     HCSNODE0  bing.com        204.79.197.200
     HCSNODE0  bing.com        204.79.197.200
    
     Controller0>Test-Connection -Source 10.126.173.91 -Destination  204.79.197.200
    
     Source      Destination       IPV4Address    IPV6Address
     ----------------- -----------  -----------
     HCSNODE0  204.79.197.200  204.79.197.200
     HCSNODE0  204.79.197.200  204.79.197.200
     HCSNODE0  204.79.197.200  204.79.197.200
     HCSNODE0  204.79.197.200  204.79.197.200
    

After you have successfully completed these manual pre-checks, you can proceed to scan and install the updates.

Install Update 3 via the Azure classic portal

Perform the following steps to update your device to Update 3.

Note

If you are applying Update 2 or later (including Update 2.1), Microsoft will be able to pull additional diagnostic information from the device. This data helps identify StorSimple devices that are having problems and aids diagnosing issues. By accepting Update 2 or later, you allow us to provide this proactive support.

To install an update from the Azure portal

  1. On the StorSimple service page, select your device. Navigate to Devices > Maintenance.
  2. At the bottom of the page, click Scan Updates. A job is created to scan for available updates. You are notified when the job completes successfully.
  3. In the Software Updates section on the same page, the new software updates are available. We recommend that you review the release notes before you apply an update on your device.
  4. At the bottom of the page, click Install Updates, and then OK.
  5. In the Install updates dialog box, make sure that you've followed the recommendations, then select I understand the above requirement and am ready to upgrade my device and click the check button.

    Confirmation message

  6. A set of prerequisite checks starts. These checks include:

    • Controller health checks to verify that both the device controllers are healthy and online.
    • Hardware component health checks to verify that all the hardware components on your StorSimple device are healthy.
    • DATA 0 checks to verify that DATA 0 is enabled on your device. If this interface is not enabled, you must enable it and then retry.
    • DATA 2 and DATA 3 checks to verify that DATA 2 and DATA 3 network interfaces are not enabled. If these interfaces are enabled, then you must disable these and then try to update your device. This check is performed only if you are updating from a device running GA software. Devices running versions 0.1, 0.2, or 0.3 will not need this check.
    • Gateway check on any device running a version prior to Update 1. This check is performed on all the device running pre-update 1 software but fails on the devices that have a gateway configured for a network interface other than DATA 0.

      The update is applied if all checks are successfully completed. You are notified when the checks are in progress.

      Pre-check notification

      The following is an example in which the checks failed. You must verify that both the device controllers are healthy and online. You also need to check the health of the hardware components. In this example, Controller 0 and Controller 1 components need attention. You may need to contact Microsoft Support if you cannot address these issues by yourself.

      Checks failed

  7. After the checks are successfully completed, an update job is created. You are notified when the update job is successfully created.

    Update job creation

    The update is then applied on your device.

  8. To monitor the progress of the update job, click View Job. On the Jobs page, you can see the update progress.

  9. The update takes a few hours to complete. Select the update job and click Details to view the details of the job at any time.
  10. After the job is complete, navigate to the Maintenance page and scroll down to Software Updates.

Verify that your device is running StorSimple 8000 Series Update 3 (6.3.9600.17759). The Last updated date is modified.

  • If you are updating from a version prior to Update 2, you see that the Maintenance mode updates are available. This message might continue to be displayed for up to 24 hours after you install the updates. Maintenance mode updates are disruptive updates that result in device downtime. These updates can only be applied via the Windows PowerShell interface of your device. In some cases when you are running Update 1.2, your disk firmware might already be up-to-date and you don't need to install any maintenance mode updates.
  • If you are updating from Update 2 or later, your device should now be up-to-date. You can skip the next step.

Download the maintenance mode updates by using the steps listed in to download hotfixes to search for and download KB3121899, which installs disk firmware updates (the other updates should already be installed by now). Follow the steps listed in install and verify maintenance mode hotfixes to install the maintenance mode updates.

Install Update 3 as a hotfix

Use this procedure if you fail the gateway check when trying to install the updates through the Azure classic portal. The check fails as you have a gateway assigned to a non-DATA 0 network interface and your device is running a software version prior to Update 1.

The software versions that can be upgraded using the hotfix method are:

  • Update 0.1, 0.2, 0.3
  • Update 1, 1.1, 1.2
  • Update 2, 2.1, 2.2

Important

  • If your device is running Release (GA) version, please contact Microsoft Support to assist you with the update.

The hotfix method involves the following three steps:

  1. Download the hotfixes from the Microsoft Update Catalog.
  2. Install and verify the regular mode hotfixes.
  3. Install and verify the maintenance mode hotfix (only when updating from pre-Update 2 software).

Download updates for your device

If your device is running Update 2.1 or 2.2, you must download and install the following hotfixes in the prescribed order:

Order KB Description Update type Install time
1. KB3186843 Software update * Regular
Non-disruptive
~ 45 mins
2. KB3186859 LSI driver and firmware Regular
Non-disruptive
~ 20 mins
3. KB3121261 Storport and Spaceport fix
Windows Server 2012 R2
Regular
Non-disruptive
~ 20 mins

* Note that the software update consists of two binary files: device software update prefaced with all-hcsmdssoftwareupdate and the Cis and Mds agent prefaced with all-cismdsagentupdatebundle. The device software update must be installed before the Cis and Mds agent. You must also restart the active controller via the Restart-HcsController cmdlet after you apply the Cis and Mds agent update (and before applying the remaining updates).

If your device is running Update 0.1, 0.2, 0.3, 1.0, 1.1, 1.2, or 2.0, you must download and install the following hotfixes in addition to the software, LSI driver and firmware updates (shown in the preceding table), in the prescribed order:

Order KB Description Update type Install time
4. KB3146621 iSCSI package Regular
Non-disruptive
~ 20 mins
5. KB3103616 WMI package Regular
Non-disruptive
~ 12 mins


If your device is running versions 0.2, 0.3, 1.0, 1.1, and 1.2, you may also need to install disk firmware updates on top of all the updates shown in the preceding tables. You can verify whether you need the disk firmware updates by running the Get-HcsFirmwareVersion cmdlet. If you are running these firmware versions: XMGG, XGEG, KZ50, F6C2, VR08, then you do not need to install these updates.

Order KB Description Update type Install time
6. KB3121899 Disk firmware Maintenance
Disruptive
~ 30 mins


Important

  • This procedure needs to be performed only once to apply Update 3. You can use the Azure classic portal to apply subsequent updates.
  • If updating from Update 2.2, the total install time is close to 1.1 hours.
  • Before using this procedure to apply the update, make sure that both the device controllers are online and all the hardware components are healthy.

Perform the following steps to download and install the hotfixes.

To download hotfixes

Perform the following steps to download the software update from the Microsoft Update Catalog.

  1. Start Internet Explorer and navigate to http://catalog.update.microsoft.com.
  2. If this is your first time using the Microsoft Update Catalog on this computer, click Install when prompted to install the Microsoft Update Catalog add-on. Install catalog
  3. In the search box of the Microsoft Update Catalog, enter the Knowledge Base (KB) number of the hotfix you want to download, for example 3186843, and then click Search.

    The hotfix listing appears, for example, Cumulative Software Bundle Update 3.0 for StorSimple 8000 Series.

    Search catalog

  4. Click Add. The update is added to the basket.
  5. Search for any additional hotfixes listed in the table above (3186859), and add each to the basket.
  6. Click View Basket.
  7. Click Download. Specify or Browse to a local location where you want the downloads to appear. The updates are downloaded to the specified location and placed in a sub-folder with the same name as the update. The folder can also be copied to a network share that is reachable from the device.

Note

The hotfixes must be accessible from both controllers to detect any potential error messages from the peer controller.

To install and verify regular mode hotfixes

Perform the following steps to install and verify regular-mode hotfixes. If you already installed them using the Azure Portal, skip ahead to install and verify maintenance mode hotfixes.

  1. To install the hotfixes, access the Windows PowerShell interface on your StorSimple device serial console. Follow the detailed instructions in Use PuTTy to connect to the serial console. At the command prompt, press Enter.
  2. Select Option 1 to log on to the device with full access. We recommend that you install the hotfix on the passive controller first.
  3. To install the hotfix, at the command prompt, type:

    Start-HcsHotfix -Path <path to update file> -Credential <credentials in domain\username format>

    Use IP rather than DNS in share path in the above command. The credential parameter is used only if you are accessing an authenticated share.

    We recommend that you use the credential parameter to access shares. Even shares that are open to “everyone” are typically not open to unauthenticated users.

    Supply the password when prompted.

    A sample output is shown below.

     ````
     Controller0>Start-HcsHotfix -Path \\10.100.100.100\share
     \hcsmdssoftwareupdate.exe -Credential contoso\John
    
     Confirm
    
     This operation starts the hotfix installation and could reboot one or
     both of the controllers. If the device is serving I/Os, these will not
     be disrupted. Are you sure you want to continue?
     [Y] Yes [N] No [?] Help (default is "Y"): Y
    
     ````
    
  4. Type Y when prompted to confirm the hotfix installation.
  5. Monitor the update by using the Get-HcsUpdateStatus cmdlet. The update will first complete on the passive controller. Once the passive controller is updated, there will be a failover and the update will then get applied on the other controller. The update is complete when both the controllers are updated.

    The following sample output shows the update in progress. The RunInprogress will be True when the update is in progress.

    Controller0>Get-HcsUpdateStatus
    RunInprogress       : True
    LastHotfixTimestamp :
    LastUpdateTimestamp : 8/29/2016 2:04:02 AM
    Controller0Events   :
    Controller1Events   :
    

    The following sample output indicates that the update is finished. The RunInProgress will be False when the update has completed.

    Controller0>Get-HcsUpdateStatus
    RunInprogress       : False
    LastHotfixTimestamp : 8/30/2016 9:15:55 AM
    LastUpdateTimestamp : 8/30/2016 9:06:07 AM
    Controller0Events   :
    Controller1Events   :
    

    Note

    Occasionally, the cmdlet reports False when the update is still in progress. To ensure that the hotfix is complete, wait for a few minutes, rerun this command and verify that the RunInProgress is False. If it is, then the hotfix has completed.

  6. After the software update is complete, verify the system software versions. Type:

    Get-HcsSystem

    You should see the following versions:

    • HcsSoftwareVersion: 6.3.9600.17759
    • CisAgentVersion: 1.0.9343.0
    • MdsAgentVersion: 30.0.4698.16

      If the version numbers do not change after applying the update, it indicates that the hotfix has failed to apply. Should you see this, please contact Microsoft Support for further assistance.

      Important

      You must restart the active controller via the Restart-HcsController cmdlet before applying the remaining updates.

  7. Repeat steps 3-5 to install the LSI driver and firmware hotfix KB3186859. After the hotfix is installed, use the Get-HcsSystem cmdlet. The LSI version should be:

    • Lsisas2Version: 2.0.78.00
  8. Repeat steps 3-5 to install the Storport and Spaceport update KB3121261.
  9. If you are updating from Update 2 or earlier version, you will also need to download:

    • iSCSI fix using KB3146621
    • WMI fix using KB3103616

To install and verify maintenance mode hotfixes

Use KB3121899 to install disk firmware updates. These are disruptive updates and take around 30 minutes to complete. You can choose to install these in a planned maintenance window by connecting to the device serial console.

Note that if your disk firmware is already up-to-date, you won't need to install these updates. Run the Get-HcsUpdateAvailability cmdlet from the device serial console to check if updates are available and whether the updates are disruptive (maintenance mode) or non-disruptive (regular mode) updates.

To install the disk firmware updates, follow the instructions below.

  1. Place the device in the Maintenance mode. Note that you should not use Windows PowerShell remoting when connecting to a device in Maintenance mode. Instead run this cmdlet on the device controller when connected through the device serial console. Type:

    Enter-HcsMaintenanceMode

    A sample output is shown below.

     Controller0>Enter-HcsMaintenanceMode
     Checking device state...
    
     In maintenance mode, your device will not service IOs and will be disconnected from the Microsoft Azure StorSimple Manager service. Entering maintenance mode will end the current session and reboot both controllers, which takes a few minutes to complete. Are you sure you want to enter maintenance mode?
     [Y] Yes [N] No (Default is "Y"): Y
    
     -----------------------MAINTENANCE MODE------------------------
     Microsoft Azure StorSimple Appliance Model 8100
     Name: Update2-8100-SHG0997879L76673
     Copyright (C) 2014 Microsoft Corporation. All rights reserved.
     You are connected to Controller0 - Passive
     ---------------------------------------------------------------
    
     Serial Console Menu
     [1] Log in with full access
     [2] Log into peer controller with full access
     [3] Connect with limited access
     [4] Change language
     Please enter your choice>
    

    Both the controllers then restart into Maintenance mode.

  2. To install the disk firmware update, type:

    Start-HcsHotfix -Path <path to update file> -Credential <credentials in domain\username format>

    A sample output is shown below.

     Controller1>Start-HcsHotfix -Path \\10.100.100.100\share\DiskFirmwarePackage.exe -Credential contoso\john
     Enter Password:
     WARNING: In maintenance mode, hotfixes should be installed on each controller sequentially. After the hotfix is installed on this controller, install it on the peer controller.
     Confirm
     This operation starts a hotfix installation and could reboot one or both of the controllers. By installing new updates you agree to, and accept any additional terms associated with, the new functionality listed in the release notes (https://go.microsoft.com/fwLink/?LinkID=613790). Are you sure you want to continue?
     [Y] Yes [N] No (Default is "Y"): Y
     WARNING: Installation is currently in progress. This operation can take several minutes to complete.
    
  3. Monitor the install progress using Get-HcsUpdateStatus command. The update is complete when the RunInProgress changes to False.
  4. After the installation is complete, the controller on which the maintenance mode hotfix was installed restarts. Log in as option 1 with full access and verify the disk firmware version. Type:

    Get-HcsFirmwareVersion

    The expected disk firmware versions are:

    XMGG, XGEG, KZ50, F6C2, VR08

    A sample output is shown below.

    -----------------------MAINTENANCE MODE------------------------
    Microsoft Azure StorSimple Appliance Model 8100
    Name: Update2-8100-SHG0997879L76YD
    Software Version: 6.3.9600.17705
    Copyright (C) 2014 Microsoft Corporation. All rights reserved.
    You are connected to Controller1
    ---------------------------------------------------------------
    
    Controller1>Get-HcsFirmwareVersion
    
    Controller0 : TalladegaFirmware
      ActiveBIOS:0.45.0006
      BackupBIOS:0.45.0008
      MainCPLD:17.0.0005
      ActiveBMCRoot:2.0.000E
      BackupBMCRoot:2.0.000E
      BMCBoot:2.0.0001
      LsiFirmware:19.00.00.00
      LsiBios:07.37.00.00
      Battery1Firmware:06.29
      Battery2Firmware:06.29
      DomFirmware:X231600
      CanisterFirmware:3.5.0.32
      CanisterBootloader:5.03
      CanisterConfigCRC:0xD1B030A4
      CanisterVPDStructure:0x06
      CanisterGEMCPLD:0x17
      CanisterVPDCRC:0xEE3504B4
      MidplaneVPDStructure:0x0C
      MidplaneVPDCRC:0xA6BD4F64
      MidplaneCPLD:0x10
      PCM1Firmware:1.00|1.05
      PCM1VPDStructure:0x05
      PCM1VPDCRC:0x41BEF99C
      PCM2Firmware:1.00|1.05
      PCM2VPDStructure:0x05
      PCM2VPDCRC:0x41BEF99C
    
      DisksFirmware
      SEAGATE:ST400FM0073:XGEG
      SEAGATE:ST400FM0073:XGEG
      SEAGATE:ST400FM0073:XGEG
      SEAGATE:ST400FM0073:XGEG
      SEAGATE:ST4000NM0023:XMGG
      SEAGATE:ST4000NM0023:XMGG
      SEAGATE:ST4000NM0023:XMGG
      SEAGATE:ST4000NM0023:XMGG
      SEAGATE:ST4000NM0023:XMGG
      SEAGATE:ST4000NM0023:XMGG
      SEAGATE:ST4000NM0023:XMGG
      SEAGATE:ST4000NM0023:XMGG
    

    Run the Get-HcsFirmwareVersion command on the second controller to verify that the software version has been updated. You can then exit the maintenance mode. To do so, type the following command for each device controller:

    Exit-HcsMaintenanceMode

  5. The controllers restart when you exit Maintenance mode. After the disk firmware updates are successfully applied and the device has exited maintenance mode, return to the Azure classic portal. Note that the portal might not show that you installed the Maintenance mode updates for 24 hours.

Troubleshooting update failures

What if you see a notification that the pre-upgrade checks have failed?

If a pre-check fails, make sure that you have looked at the detailed notification bar at the bottom of the page. This provides guidance as to which pre-check has failed. The following illustration shows an instance in which such a notification appears. In this case, the controller health check and hardware component health check have failed. Under the Hardware Status section, you can see that both Controller 0 and Controller 1 components need attention.

Pre-check failure

You will need to make sure that both controllers are healthy and online. You will also need to make sure that all the hardware components in the StorSimple device are shown to be healthy on the Maintenance page. You can then try to install updates. If you are not able to fix the hardware component issues, then you will need to contact Microsoft Support for next steps.

What if you receive a "Could not install updates" error message, and the recommendation is to refer to the update troubleshooting guide to determine the cause of the failure?

One likely cause for this could be that you do not have connectivity to the Microsoft Update servers. This is a manual check that needs to be performed. If you lose connectivity to the update server, your update job would fail. You can check the connectivity by running the following cmdlet from the Windows PowerShell interface of your StorSimple device:

Test-Connection -Source <Fixed IP of your device controller> -Destination <Any IP or computer name outside of datacenter>

Run the cmdlet on both controllers.

If you have verified the connectivity exists, and you continue to see this issue, please contact Microsoft Support for next steps.

What if you see an update failure when updating your device to Update 4 and both the controllers are running Update 4?

Starting Update 4, if both the controllers are running the same software version and if there is an update failure, the controllers do not go into recovery mode. This situation can arise if the device software hotfix (1st order update) is applied to both the controllers successfully but other hotfixes (2nd order and 3rd order) are yet to be applied. Starting Update 4, the controllers will go into recovery mode only if the two controllers are running different software versions.

If the user sees an update failure when both controllers are running Update 4, we recommend that they wait a few minutes and then retry updating. If the retry does not succeed, then they should contact Microsoft Support.

Next steps

Learn more about the Update 3 release.