Veritas Access Appliance 8.2 Upgrade Guide

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

About the preupgrade check

The preupgrade check determines if the system is ready for an upgrade. The preupgrade check runs automatically when you start the upgrade. The preupgrade check performs tests, which identify any potential problems that might result in an upgrade failure. You must resolve the issues before you upgrade the cluster.

The following tests are performed during the preupgrade check:

  • System self-test to verify the health of system and software services, such as network and system configuration.

  • Certificate check to ensure that the self-signed certificate is configured correctly.

  • Ensure that no previous incomplete upgrade process is ongoing.

  • MongoDB check to ensure that MongoDB works as expected.

  • Version check to ensure that the upgrade path is supported and the current system can be upgraded to the target version.

  • The Docker daemon is configured correctly.

  • Sufficient free space is available for the upgrade.

    To free up space, the /opt/VRTSnas/core/kernel, /opt/VRTSnas/core/use, and /opt/VRTSnas/log files are automatically compressed to old-*.tar files, and these tar files are archived to the /log/VRTSnas/log directory . The original log files are deleted to free up space.

  • No other bootable devices are present that may interfere when restarting the nodes during the upgrade.

  • The administrator password does not expire within seven days.

  • All the cluster nodes are up and healthy with the same software version installed on all the nodes.

  • CIFS server is not configured as a standalone server.

Running the preupgrade check

Starting with version 8.0, you can run a preupgrade check independently after you download the software release update package from the Veritas website or when you upload the software release update package from a local system.

With an independent preupgrade check, you can verify if the appliance is ready for an upgrade without starting the upgrade operation.

Note:

The preupgrade check runs automatically when you upgrade the appliance. Running an independent preupgrade check is optional.

To run a preupgrade check independently on a software release update package:

  1. Open an SSH session and use the admin credentials to log in the appliance.

    The Veritas Appliance Shell menu is displayed.

  2. Check if any upgrade packages are available on SORT server.

    system software available-patch

  3. Download the software release update package:

    system software download-update update-name=update_name

  4. Verify if any software release update package is downloaded:

    system software downloaded

  5. Run the preupgrade check:

    start appliance preupgrade-check patch=update_name

    To check the status, run the show appliance preupgrade-check status command.

    Note:

    Wait for a few seconds before you check the status. If you check the status immediately after running the preupgrade-check command, the status of the preupgrade checks might not be available. If you check the status without running the preupgrade-check command, Operation failed error message is displayed.

For details about the commands, see the Veritas Access Appliance Command Reference Guide.