Install Update 1.2 on your StorSimple 8000 series device

Overview

This tutorial explains how to install Update 1.2 on a StorSimple device that is running a software version prior to Update 1. The tutorial also covers the additional steps required for the update when a gateway is configured on a network interface other than DATA 0 of the StorSimple device.

Update 1.2 includes device software updates, LSI driver updates and disk firmware updates. The software and LSI driver updates are non-disruptive updates and 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.

Depending upon which version your device is running, you can determine if Update 1.2 will be applied. You can check the software version of your device by navigating to the quick glance section of your device Dashboard.


If running software version … What happens in the portal?
Release - GA If you are running Release version (GA), do not apply this update. Please contact Microsoft Support to update your device.
Update 0.1 Portal applies Update 1.2.
Update 0.2 Portal applies Update 1.2.
Update 0.3 Portal applies Update 1.2.
Update 1 This update will not be available.
Update 1.1 This update will not be available.


Important
  • You may not see Update 1.2 immediately because we do a phased rollout of the updates. Scan for updates in a few days again as this Update will become available soon.
  • This update includes a set of manual and automatic pre-checks 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. You should only go to the Windows PowerShell interface of the device (to install updates) if the pre-update gateway check fails in the portal. The updates may take 5-10 hours to install (including the Windows Updates). The maintenance mode updates must be installed via the Windows PowerShell interface of the device. As maintenance mode updates are disruptive updates, these will result in a down time for your 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 1.2 via the Azure classic portal

Perform the following steps to update your device to Update 1.2. Use this procedure only if you have a gateway configured on DATA 0 network interface on your device.

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.
  1. Verify that your device is running StorSimple 8000 Series Update 1.2 (6.3.9600.17584). The Last updated date should also be modified. You'll also see that 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 and can only be applied via the Windows PowerShell interface of your device.

    Maintenance page

  2. Download the maintenance mode updates by using the steps listed in To download hotfixes to search for and download KB3063416, which installs disk firmware updates (the other updates should already be installed by now).
  3. Follow the steps listed in Install and verify maintenance mode hotfixes to install the maintenance mode updates.
  4. In the Azure classic portal, navigate to the Maintenance page and at the bottom of the page, click Scan Updates to check for any Windows Updates and then click Install Updates. You're finished after all of the updates are successfully installed.

Install Update 1.2 on a device that has a gateway configured for a non-DATA 0 network interface

You should use this procedure only 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. If your device does not have a gateway on a non-DATA 0 network interface, you can update your device directly from the Azure classic portal. See Install update 1.2 via the Azure classic portal.

The software versions that can be upgraded using this method are Update 0.1, Update 0.2, and Update 0.3.

Important
  • If your device is running Release (GA) version, please contact Microsoft Support to assist you with the update.
  • This procedure needs to be performed only once to apply Update 1.2. You can use the Azure classic portal to apply subsequent updates.

If your device is running pre-Update 1 software and it has a gateway set for a network interface other than DATA 0, you can apply Update 1.2 in the following two ways:

  • Option 1: Download the update and apply it by using the Start-HcsHotfix cmdlet from the Windows PowerShell interface of the device. This is the recommended method. Do not use this method to apply Update 1.2 if your device is running Update 1.0 or Update 1.1.
  • Option 2: Remove the gateway configuration and install the update directly from the Azure classic portal.

Detailed instructions for each of these are provided in the following sections.

Option 1: Use Windows PowerShell for StorSimple to apply Update 1.2 as a hotfix

You should use this procedure only if you are running Update 0.1, 0.2, 0.3 and if your gateway check has failed when trying to install updates from the Azure classic portal. If you are running Release (GA) software, please Microsoft Support to update your device.

To install Update 1.2 as a hotfix, you must download and install the following hotfixes:

Order KB Description Update type
1 KB3063418 Software update Regular
2 KB3043005 LSI SAS controller update Regular
3 KB3063416 Disk firmware Maintenance

Before using this procedure to apply the update, make sure that:

  • Both device controllers are online.

Perform the following steps to apply Update 1.2. The updates could take around 2 hours to complete (approximately 30 minutes for software, 30 minutes for driver, 45 minutes for disk firmware).

To download hotfixes

Perform the following steps to download the software update.

  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 3063418, and then click Search.
  4. You will see the StorSimple Update 1.2 Appliance Update bundle. Click Add. The update will be added to the basket.
  5. Search for any additional hotfixes listed in the table above (3043005 and 3063416), and add each the basket.
  6. Click View Basket.

    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 subfolder 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 the 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 software update, 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.
  3. To install the update package, 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.

    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 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 : 9/02/2015 10:36:13 PM
    LastUpdateTimestamp : 9/02/2015 10:35:25 PM
    Controller0Events   :
    Controller1Events   :
    

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

    Controller1>Get-HcsUpdateStatus
    
    RunInprogress       : False
    LastHotfixTimestamp : 9/02/2015 10:56:13 PM
    LastUpdateTimestamp : 9/02/2015 10:35:25 PM
    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 the following command:

    Get-HcsSystem

    You should see the following versions:

    • HcsSoftwareVersion: 6.3.9600.17584
    • CisAgentVersion: 1.0.9049.0
    • MdsAgentVersion: 26.0.4696.1433

      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.

  7. Repeat steps 3-5 to install the remaining regular-mode hotfix (KB3043005).

To install and verify maintenance mode hotfixes

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

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

  1. Place the device in Maintenance mode. Note that you should not use Windows PowerShell remoting when connecting to a device in Maintenance mode. You will need to 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: Update1-8100-SHG0997879L76YD
     Software Version: 6.3.9600.17584
     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. 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 will be rebooted. Log in as option 1 with full access and verify the disk firmware version. Type:

    Get-HcsFirmwareVersion

    The expected disk firmware versions are:

    XMGG, XGEE, KZ50, F6C2, VR08

    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. 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.

Option 2: Use the Azure classic portal to apply Update 1.2 after removing the gateway configuration

This procedure applies only to StorSimple devices that are running a software version prior to Update 1 and have a gateway set on a network interface other than DATA 0. You will need to clear the gateway setting prior to applying the update.

The update may take a few hours to complete. If your hosts are in different subnets, removing the gateway configuration on the iSCSI interfaces could result in downtime. We recommend that you configure DATA 0 for iSCSI traffic to reduce the downtime.

Perform the following steps to disable the network interface with the gateway and then apply the update.

To install Update 1.2 from the Azure classic portal

  1. In the Azure classic portal, go to the Devices page and select your device.
  2. Navigate to Devices > Configure.
  3. Under Network Interfaces, first verify that you have at least one network interface that is iSCSI-enabled. Then locate the network interface (other than DATA 0) that has a gateway assigned.
  4. Disable the network interface that has an assigned gateway and save the modified configuration. Note the network interface settings are retained and so when you re-enable this network interface later, the portal will revert to the original settings.
  5. You can now use the Azure classic portal to install Update 1.2. Follow the instructions starting from step 3 of this procedure. After you have installed all the updates, you can re-enable the network interface that you disabled.

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 1.2 release.