Veritas Access Appliance Upgrade Guide

Last Published:
Product(s): Appliances (8.1)
Platform: Veritas 3340,Veritas 3350

Installing an appliance software update on the Access Appliance

Use the following procedure to upgrade the appliance.

You can view the log files for the upgrade process at the following location:

/log/upgrade/upgrade_8.1.log

Warning:

Do not restart any of the nodes manually while the upgrade is in progress.

Installing on appliance version 7.4.3 and 7.4.3.x

Use the following procedure to install the software release update if your appliance version is 7.4.3 or 7.4.3.x.

To install the downloaded software release update, complete the following steps:

  1. Connect to the Intelligent Platform Management Interface (IPMI) console of the node where you downloaded the software update package.

    Note:

    Veritas recommends that you log in using the Access Appliance shell menu from the IPMI console instead of an SSH session. The IPMI console is also known as the Veritas Remote Management Console. For details about how to access and use the Veritas Remote Management Console, refer to the Veritas Access Appliance Initial Configuration and Administration Guide.

  2. Log in to the Access Appliance shell menu.
  3. To install the software release update, run the following command:

    Main_Menu > Manage > Software > Install update_name

    where update_name is the name of the software release update that you want to install.

    A summary of the upgrade changes is displayed and you are prompted for confirmation. Review the details and type yes to continue.

  4. When the following message is displayed and you are promoted for confirmation, type yes to continue:
    This software update requires a reboot of the appliance after the 
installation process completes. Do you want to continue? (yes/no)
  5. If your system is at 7.4.3.200 or a later version, the following message is displayed where you can specify if you want to perform a rolling upgrade or a parallel upgrade: 
    You can upgrade the cluster by performing a parallel or a rolling upgrade. In a parallel upgrade, all the nodes in the cluster are upgraded and restarted simultaneously and cluster services are not available for the entire duration. In a rolling upgrade, each node in the cluster is upgraded successively and restarted without shutting down the cluster. The services are not available for a very limited period.

Enter the upgrade method to use when installing the software update [parallel, rolling](rolling)
  6. To check the upgrade status, run the following command:

    Main_Menu > Manage > Software > UpgradeStatus

    The details about the completed tasks and the completion status are displayed.

    If the upgrade fails at any point in time, error messages and the details about possible solutions are displayed and a rollback operation is initiated automatically.

    After the rollback is completed successfully, the Completed the rollback successfully message is displayed.

    If the software update is installed successfully, the following message is displayed:

    Upgrade completed successfully.

    The following example shows the displayed details:

    [access-8.1] nbapp914 > system software upgrade-status

The target version is: 8.1
Current upgrade status: COMPLETED. The upgrade is 100% completed.
Latest operations:
 -[2023-01-17 19:01:58] [INFO] Running selftest.
 -[2023-01-17 19:02:47] [INFO] V-409-777-30046: Running upgrade cleanup...
 -[2023-01-17 19:03:23] [INFO] V-409-777-1517: Upgrade completed successfully.

    To ensure that the appliance was upgraded successfully, run the show appliance status command and verify the Access version and the appliance version.

  7. After upgrading the appliance, if the Access GUI becomes unresponsive complete the following steps:

    • Determine the node that hosts the ManagementConsole service by using the following commands: 

      [access-8.1] nbapp914 >support elevate
<!-- Maintenance Mode --!>
maintenance's password:
nbapp914>hagrp -state ManagementConsole

    • In an elevated maintenance prompt from the determined node, run the following command:

      # /opt/VRTSnas/pysnas/bin/isaconfig

Installing on appliance version 8.0 and later

Use the following procedure to install the software release update if your appliance version is 8.0 and later.

To install the downloaded software release update, complete the following steps:

  1. Connect to the Intelligent Platform Management Interface (IPMI) console of the node where you downloaded the software update package.

    Note:

    Veritas recommends that you log in using the Access Appliance shell menu from the IPMI console instead of an SSH session. The IPMI console is also known as the Veritas Remote Management Console. For details about how to access and use the Veritas Remote Management Console, refer to the Veritas Access Appliance Initial Configuration and Administration Guide.

  2. Log in to the Access Appliance shell menu.
  3. To install the software release update, run the following command:

    system software install-update update-name=

    where update-name is the name of the software release update that you want to install.

    A summary of the upgrade changes is displayed and you are prompted for confirmation. Review the details and type yes to continue.

  4. When the following message is displayed and you are promoted for confirmation, type yes to continue:
    This software update requires a reboot of the appliance after the 
installation process completes. Do you want to continue? (yes/no)
  5. Specify if you want to perform a rolling upgrade or a parallel upgrade: 
    You can upgrade the cluster by performing a parallel or a rolling upgrade. 
In a parallel upgrade, all the nodes in the cluster are upgraded and restarted simultaneously
and  cluster services are not available for the entire duration. In a rolling upgrade,
each node in the cluster is upgraded successively and restarted without shutting down
the cluster. The services are not available for a very limited period.

Enter the upgrade method to use when installing the software update [parallel, rolling](rolling)
  6. To check the upgrade status, run the following command:

    system software upgrade-status

    The details about the completed tasks and the completion status are displayed.

    Note:

    After restarting run the system software upgrade-status command to check the upgrade status.

    If the upgrade fails at any point in time, error messages and the details about possible solutions are displayed and a rollback operation is initiated automatically.

    After the rollback is completed successfully, the Completed the rollback successfully message is displayed.

    If the software update is installed successfully, the following message is displayed:

    Upgrade completed successfully.

    The following example shows the displayed details:

    [access-8.1] nbapp914 > system software upgrade-status

The target version is: 8.1
Current upgrade status: COMPLETED. The upgrade is 100% completed.
Latest operations:
 -[2023-01-17 19:01:58] [INFO] Running selftest.
 -[2023-01-17 19:02:47] [INFO] V-409-777-30046: Running upgrade cleanup...
 -[2023-01-17 19:03:23] [INFO] V-409-777-1517: Upgrade completed successfully.

    To ensure that the appliance was upgraded successfully, run the show appliance status command and verify the Access version and the appliance version.

  7. After upgrading the appliance, if the Access GUI becomes unresponsive complete the following steps:

    • Determine the node that hosts the ManagementConsole service by using the following commands: 

      [access-8.1] nbapp914 >support elevate
<!-- Maintenance Mode --!>
maintenance's password:
aaapp914>hagrp -state ManagementConsole

    • In an elevated maintenance prompt from the determined node, run the following command:

      # /opt/VRTSnas/pysnas/bin/isaconfig