Performing the upgrade

If you have already upgraded to NAS Bridge version 2.2.1 or 2.3.0, upgrading to NAS Bridge 2.3.1 involves several simple steps.

Before you begin

Steps

  1. Before starting the upgrade procedure, handle cache disks and devices as described in the following choices.
    Attention: After you make changes to a disk through vSphere, scan the host bus to ensure that the Linux operating system recognizes the changes: echo "- - -" | sudo tee /sys/class/scsi_host/host*/scan
    • Use vSphere to remove any unused cache disks (not cache devices or system disks).
      Attention: The upgrade will fail if there are unused cache disks.
    • If you want to add cache, follow the instructions for creating a new cache device.
      Attention: Hard drives must be configured as cache devices before you start the upgrade.
  2. Log into the vCenter for the NAS Bridge instance.
  3. If you are upgrading from NAS Bridge 2.2.0 to 2.3.1, follow these additional steps:
    The NAS Bridge virtual machine will be offline while you perform these reconfiguration steps.
    1. Right click the NAS Bridge virtual machine and select Power > Shut Down Guest OS.
    2. When the virtual machine is powered down, select Edit Settings.
    3. Change the memory value from 32768 MB to 49152 MB.
    4. Expand the Memory section and apply the same value change for Reservation.
    5. Click OK and wait for the reconfiguration of the virtual machine to complete.
    6. Start the NAS Bridge virtual machine by selecting Power > Power On. Or select Start the virtual machine.
  4. Using a secure copy protocol (such as scp), copy the file from your local workstation to the NAS Bridge virtual machine.scp NetApp_StorageGRID_Webscale_NAS_Bridge_version-uniqueID.upgrade pb@ip-of-nas-bridge:~
  5. When prompted, type the current password for the CLI administrator account.
  6. Type the SSH command to log in to the NAS Bridge virtual machine using the CLI administrator account.
    Example
    ssh pb@10.63.65.101
  7. When prompted, type the password for the account.
  8. Move the file you downloaded to /var/local/ on the NAS Bridge, and rename the file as pb-upgrade.run.sudo mv ~/NetApp_StorageGRID_Webscale_NAS_Bridge_version-uniqueID.upgrade /var/local/pb-upgrade.run
  9. From a supported browser, sign in to the NAS Bridge web interface.
  10. Select Maintenance at the top of the web page.
  11. Select Tasks.
  12. Click Start Upgrade.

    A confirmation dialog box appears.

    Attention: In between the time that you click Start Upgrade and Complete Upgrade, do not reboot the NAS Bridge or make any changes to the cache devices.
  13. Select Yes, upgrade to start the upgrade process.


    This image is described by the surrounding text.

  14. Monitor the progress of the upgrade by selecting Maintenance.
    The "Upgrade in progress" message appears during the upgrade process, which could take several minutes.
  15. When the "Successfully upgraded" and "Click Complete Upgrade" messages appear, click Complete Upgrade, then click Yes, complete the upgrade to switch to the upgraded version.
    Example

    The message "Upgrade activation in progress" appears.


    Complete Upgrade


    Yes, Complete Upgrade

    The message "Upgrade activation in progress" is displayed in the Maintenance tab while the upgrade is completed and the NAS Bridge rebooted.

    Attention: When the Debian GNU/Linux boot menu appears, do not make any selections, or you will lose access to your NAS Bridge file systems. Allow the boot process to continue automatically.
  16. Select Alarms to verify the upgrade messages.
    Example

    Upgrade Successful 2.2.1
  17. Select Maintenance, then click the Refresh button for your browser.
    You must refresh your browser to display the new version.
    Note: If you are using Firefox or Internet Explorer, you must clear your browser's cache and then refresh the page.
  18. Confirm that the upgrade succeeded.
    1. From the top right of the page, select Help > System Info.
    2. Confirm that version 2.3.1 is displayed.

      If the System Info window does not contain any values, the upgrade has not completed.

      Contact technical support if the upgrade process does not complete within 5 to 10 minutes or if the correct version is not shown.

  19. When you are finished, download a NAS Bridge recovery package.
    Attention: You should download a NAS Bridge recovery package whenever you make configuration changes or upgrade to a new version of NAS Bridge. Recovery packages from previous versions will not be valid.
    1. Go to Maintenance > Recovery Procedure .
    2. Click Generate Package.
    3. Select the package from the table, and click Download to download the package to your local workstation.
    4. Save the package to a safe location.