Veritas Flex Appliance Getting Started and Administration Guide

Last Published:
Product(s): Appliances (1.3)
Platform: Flex Appliance OS
  1. Product overview
    1.  
      Introduction to Veritas Flex Appliance
    2.  
      About the Flex Appliance documentation
    3.  
      Flex Appliance 1.3 new features, enhancements, and changes
    4.  
      Supported upgrade paths to this release
    5.  
      Operational notes
    6.  
      Flex Appliance 1.3 release content
  2. Getting started
    1.  
      Initial configuration guidelines and checklist
    2.  
      Performing the initial configuration
    3.  
      Adding a node
    4.  
      Accessing and using the Flex Appliance Shell
    5.  
      Accessing and using the Flex Appliance Console
    6.  
      Installing the NetBackup Administration Console and client packages
    7.  
      Common tasks in Flex Appliance
  3. Modifying settings
    1.  
      Creating a network bond
    2.  
      Deleting a network bond
    3.  
      Configuring a network interface
    4.  
      Setting the date and time for appliance nodes
    5.  
      Changing DNS or Hosts file settings
  4. Managing users
    1.  
      Overview of the Flex Appliance default users
    2. Managing Flex Appliance Console users and tenants
      1.  
        Adding a tenant
      2.  
        Editing a tenant
      3.  
        Removing a tenant
      4.  
        Adding a local user to the Flex Appliance Console
      5.  
        Connecting an Active Directory domain to the Flex Appliance Console
      6.  
        Importing an Active Directory user or user group to the Flex Appliance Console
      7.  
        Editing an Active Directory domain in the Flex Appliance Console
      8.  
        Changing a user password in the Flex Appliance Console
      9.  
        Removing a user from the Flex Appliance Console
    3.  
      Changing the hostadmin user password in the Flex Appliance Shell
    4. Managing NetBackup application instance users
      1.  
        Adding and removing local NetBackup instance users
      2.  
        Connecting a remote user domain to a NetBackup instance
      3.  
        Changing a user password on a NetBackup instance
  5. Using Flex Appliance
    1. Managing the repository
      1.  
        Adding files to the repository
      2.  
        Removing the current appliance upgrade or update package from the repository
    2. Creating application instances
      1.  
        Creating a NetBackup master server instance
      2.  
        Creating a NetBackup media server instance
    3. Managing application instances
      1.  
        Resizing instance storage
      2.  
        Editing instance network settings
      3. Managing application add-ons on instances
        1.  
          Installing application add-ons
        2.  
          Uninstalling application add-ons
        3.  
          Changing the application add-on installation order
      4.  
        Viewing instance performance metrics
      5. Running NetBackup commands on an application instance
        1.  
          Creating a NetBackup touch file on an application instance
      6.  
        Setting environment variables on NetBackup instances
      7.  
        Storing custom data on a NetBackup instance
      8.  
        Establishing trust with a NetBackup 7.7.3 master server instance
    4. Upgrading application instances
      1.  
        Warnings and considerations for instance rollbacks
    5. About Flex Appliance upgrades and updates
      1.  
        Upgrading Flex Appliance
      2.  
        Updating Flex Appliance
  6. Monitoring the appliance
    1. About AutoSupport and Call Home
      1.  
        Registering an appliance
      2.  
        Viewing Call Home information
      3.  
        Configuring Call Home settings
      4.  
        Deleting and disabling Call Home settings
    2. Monitoring the hardware from the Flex Appliance Shell
      1.  
        Viewing node information
      2.  
        Viewing Primary Storage Shelf information on a Veritas 5340 Appliance
      3.  
        Viewing Expansion Storage Shelf information on a Veritas 5340 Appliance
    3.  
      Viewing hardware faults
    4.  
      Viewing system data
  7. Reconfiguring the appliance
    1.  
      Performing a factory reset
    2.  
      Recovering storage data after a factory reset
    3.  
      Performing a storage reset
    4.  
      Removing a node
  8. Troubleshooting guidelines
    1.  
      General troubleshooting steps
    2.  
      Gathering device logs on a Flex appliance

Warnings and considerations for instance rollbacks

If you need to roll back an instance upgrade, review the following information before you begin.

  • Instances with Cloud Catalyst storage do not support rollback. If you experience an upgrade failure that you cannot resolve, contact Veritas Technical Support for assistance.

  • Rollback of other instances should only be attempted as a last resort if there were serious problems with the upgrade.

  • A rollback restores the instance to a pre-upgrade checkpoint and reverses all operations that were performed after the upgrade, including backup data. For this reason, backup operations should be kept at a minimum for testing purposes only while the instance upgrade is in a pending state. Do not perform production operations until you commit or roll back the upgrade.

  • Do not resize the instance storage until you commit or roll back the upgrade.

  • If you create or modify more than 100 GB of data on the instance after the upgrade, you can no longer roll back. The 100-GB limitation includes data from running backups, deleting backups, or any other modifications.

    If you surpass 100 GB, the rollback fails, and you must commit to the new version.

  • If a rollback is performed, there is a risk of data loss and data leakage for all operations that are performed after the upgrade. The longer the system was up and running before a rollback, the greater the chance of data loss and leakage. The data loss is not limited to losing backup data for the jobs that ran before the rollback. Future backups can be affected as well.

    The following inconsistencies can occur if you decide to roll back:

    • Incremental or transaction log-based database backups:

      If transaction logs were truncated after the upgrade and before the rollback, the database may not be protected.

      To resolve this issue, perform a full database backup after the rollback.

    • Incremental Windows file system backups:

      If the archive bit is used for incremental backup, it is reset upon completion of an incremental backup. If a rollback occurs, the incremental backup is lost, and subsequent incremental backups do not detect that these files changed. The files are not backed up again until a full backup is performed.

      To resolve this issue, perform a full backup after the rollback. If any files were modified in the lost incremental and then deleted before the next full backup, those files are lost.

    • Backup expiration catalog and storage inconsistency:

      If backup images expire and cleanup begins after the upgrade and before the rollback, backup data may be removed from storage units external to the instance. For example, this behavior can happen with an MSDP media server, Cloud or Cloud Catalyst storage, OST storage, or tape storage. When a rollback of the master server catalog occurs, the catalog indicates that there is a valid backup even though the data was removed from storage. This inconsistency results in backup data that cannot be restored, duplicated, or replicated. It may also affect scheduling of subsequent backups (delaying backups or performing incrementals instead of fulls).

    • Orphaned backups on storage:

      If backup images are created on external storage after the upgrade and before the rollback of the master server, the backup images exist on storage but not in the NetBackup catalog. This discrepancy results in situations where the backups are never removed from storage (data leakage).

      To resolve this issue, import the images from storage or use the consistency check tools.

    • Backup considerations if the instance is a media server:

      • The backups between the upgrade and rollback are not restorable even though NetBackup has them in the catalog.

      • Unfinished SLP jobs fail, causing inconsistencies between the NetBackup master server and the storage.

        If any backups were deleted after the upgrade and before the rollback, those backups come back as storage leak.