Install or Update the Quantum Unified User Interface (UUI) Software

This topic describes how to install or update the Quantum Unified User Interface (UUI) software.

Note: If your system is a Quantum appliance, see Update the Quantum UUI Software.

Prerequisites

  • You must have your own customer-supplied hardware (non-Quantum appliance).

  • You must have StorNext 7.0.2 (or later) installed on your system.

Do the following to install the Quantum UUI on your system.

  1. Navigate to the myStorNext web site at: https://mystornext.quantum.com/ and log in using your myStorNext email and password.

  2. In the left navigation, click UUI Downloads.

  3. The Release Build Downloads section describes the file available for download. See the image below as an example:

    • If you are performing an upgrade of the UUI package on a StorNext appliance, then click on a link labeled Combined Package...Updates Only that corresponds with the version of StorNext installed on your system.

    • If you are performing a new install of the UUI on your own hardware (non-StorNext appliance), then click on a link labeled RYO Install Package...New Install that corresponds with the version of StorNext installed on your system.

    • If you are performing an upgrade of the UUI on your own hardware (non-StorNext appliance), then click on a link labeled RYO Install Package...New Install/Upgrade that corresponds with the version of StorNext installed on your system.

    Example (for a download link called):

    The downloaded file name will be similar to:

    uuiryo-install-pkgs-v702RC1-2021-12-07.tar.gz

    (where: green indicates the StorNext version, and blue is the build date)

  1. Use scp or sftp to copy the .tar.gz file to the /home/stornext directory using the IP address for Xcellis server node 2.

    2. Note: Use either a drag-and-drop SCP or FTP utility (like Transmit or Filezilla for MacOS, or WinSCP or Filezilla for Windows), or a command-line utility (like Terminal for MacOS, or the Windows 10 or later command prompt or PuTTYSCP.exe for Windows) to manually copy the files.

    Note: If you install the UUI on your own hardware and your environment consists of a high-availability (HA) configuration, then you must install the UUI package on the secondary node.

  2. Log in to the command line of Xcellis server node 2 as the stornext user and the password for the stornext user account.
  1. Log in as the rootsh user. Enter:
    2. sudo rootsh
  2. Enter the password for the stornext user account again.
  3. Move the .tar.gz file to the /scratch/ directory:

    4. Example:

    mv /home/stornext/uuiryo-install-pkgs-v702RC1-2021-12-07.tar.gz /scratch/
  4. Extract the file in /scratch/:

    5. Example:

    tar xvzf /scratch/uuiryo-install-pkgs-v702RC1-2021-12-07.tar.gz
  5. Change to the extracted directory:

    6. Example:

    cd /scratch/uuiryo-install-pkgs-v702RC1-2021-12-07
  6. Review the system requirements and the installation procedure in the UUI-README.txt file.
  7. Log in to the Quantum UUI, if needed. See Access the Quantum Unified User Interface (UUI).

Do the following to update the Quantum UUI on your system.

  1. Log in to the Quantum UUI, if needed.

    Keep in mind the myStorNext website (mystornext.quantum.com) is a separate interface from the Quantum UUI. See Overview of myStorNext for information about the myStorNext website.

    The Quantum UUI provides access to various services. The Quantum UUI is browser-based and can be accessed by any machine with access to the management network.

    Prerequisites

    • You must have JavaScript installed and enabled on your system.

    1. Open a Web browser.

    2. In the browser's address field, enter the IP address (or hostname) and the port number of the Quantum appliance that is hosting StorNext. On dual-node systems, this is the IP address (or hostname) of server Node 2. For example:

      https://<machine name>:<port number>

      Note: You can access the Quantum UUI on the default HTTPS port 8445.

      When you first use this address to launch the UUI, you might receive a notification in your browser about a missing local web site security certificate. The notification is benign and does not pose a security risk within your environment. Accept the notification and continue to the UUI.

      1. On this dialog, click Advanced.

        (click image to enlarge)

      2. Click Proceed to <IP address> (unsafe).

        (click image to enlarge)

      3. You see that the site is Not secure. Again, the local web server does not have a security certificate, and the UUI is safe to use.

      1. On this dialog, click Show Details.

        (click image to enlarge)

      2. Click visit this website.

        (click image to enlarge)

      Also, depending on your browser configuration, you might receive a warning message informing you to accept the SSL certificates at a link that is displayed. Contact your local System Administrator for assistance on how to accept the SSL certificates.

      (click image to enlarge)

    3. On the UUI Login page, enter your credentials.
    4. Click Login. The Dashboard appears.

  2. If a new update is available, click the cloud icon (). The Current Versions Installed and New Versions Available sections appear on a new page.

    (click image to enlarge)

  3. In the New Versions Available section, click Update. The Confirm Upgrade dialog appears.

    (click image to enlarge)

  4. Caution: Before you proceed, be aware this operation stops the Quantum UUI services and then performs the upgrade process.

    To proceed with the software upgrade, click Upgrade. To abort the operation and return to the previous page, click Cancel.

    If you click Upgrade, the Quantum Unified UI Software Upgrade page appears and displays the status of the upgrade process.

  5. When the upgrade process completes, click Quantum StorNext. The UUI login page appears.

    (click image to enlarge)

  6. On the UUI Login page, enter your credentials.
  7. Click Login. The Dashboard appears.