Veritas Flex Appliance Getting Started and Administration Guide

Last Published:
Product(s): Appliances (5.1, 5.0)
Platform: Flex Appliance OS
  1. Product overview
    1.  
      Introduction to Veritas Flex Appliance
    2.  
      Flex Appliance terminology
    3.  
      About the Flex Appliance documentation
  2. Release notes
    1.  
      Flex Appliance 5.0 new features, enhancements, and changes
    2.  
      Flex Appliance 5.1 new features, enhancements, and changes
    3.  
      Supported update paths to this release
    4.  
      Operational notes
    5.  
      Flex Appliance 5.0 release content
    6.  
      Flex Appliance 5.1 release content
  3. 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.  
      Setting the date and time for appliance nodes
    7.  
      Common tasks in Flex Appliance
  4. Managing network settings for instances
    1.  
      Creating a network bond
    2.  
      Editing a network bond
    3.  
      Deleting a network bond
    4.  
      Configuring or editing a network interface
    5. Managing the appliance Fibre Channel ports
      1.  
        Viewing the devices that are connected to the Fibre Channel ports
  5. 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 a remote user domain to the Flex Appliance Console
      6.  
        Editing a remote user domain in the Flex Appliance Console
      7.  
        Importing a remote user or user group to the Flex Appliance Console
      8.  
        Managing single sign-on (SSO)
      9.  
        Managing identity providers (IDPs)
      10.  
        Importing a single sign-on user or user group to the Flex Appliance Console
      11.  
        Managing user authentication with smart cards or digital certificates
      12.  
        Changing a local user password in the Flex Appliance Console
      13.  
        Expiring local user passwords in the Flex Appliance Console
      14.  
        Unlocking a user account in the Flex Appliance Console
      15.  
        Managing open sessions
      16.  
        Removing user or service accounts from the Flex Appliance Console
    3.  
      Changing the password policy
    4.  
      Changing the hostadmin user password in the Flex Appliance Shell
    5.  
      Changing the sysadmin user password in the Veritas Remote Management Interface
    6. Managing multifactor authentication
      1.  
        Configuring or reconfiguring multifactor authentication
      2.  
        Enforcing multifactor authentication
      3.  
        Resetting multifactor authentication
      4.  
        Disabling multifactor authentication
    7. Using Flex Appliance Console accounts for API automation
      1.  
        Managing personal API tokens
      2.  
        Managing service accounts
  6. Using Flex Appliance
    1. Managing the repository
      1.  
        Adding files to the repository
      2.  
        Removing files from the repository
    2.  
      Creating application instances
    3.  
      Managing application instances from Flex Appliance and NetBackup
    4. Managing application instances from Flex Appliance
      1.  
        Resizing instance storage
      2.  
        Editing instance network settings
      3.  
        Assigning Fibre Channel ports to an instance
      4.  
        Unassigning Fibre Channel ports from an instance
      5. 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.  
          Updating an application add-on to a newer revision
      6.  
        Viewing instance performance metrics
      7.  
        Clearing a configuration error status on an application instance
      8.  
        Deleting an application instance
    5. Upgrading application instances
      1.  
        Warnings and considerations for instance rollbacks
    6.  
      Updating an application instance to a newer revision
    7. About Flex Appliance updates
      1.  
        Updating Flex Appliance
      2.  
        Updating the firmware
  7. Remote replication
    1.  
      About remote replication
    2.  
      Pairing appliances for remote replication
    3.  
      Creating a replica
    4. Managing remote replication
      1.  
        Remote replication best practices
      2.  
        Monitoring remote replication
      3.  
        Editing the replication network
      4.  
        Repairing a lost connection between paired appliances
      5.  
        Pausing and resuming replication
      6.  
        Resolving discrepancies between an active and a replica instance
      7.  
        Changing the replication role of an instance
      8.  
        Unlinking active and replica instances
      9.  
        Forgetting a paired appliance
  8. Appliance security
    1.  
      Security overview
    2. About lockdown mode
      1.  
        Changing the lockdown mode
    3.  
      Using a sign-in banner
    4.  
      Using an external certificate
    5. Using network access control
      1.  
        Changing the SSH port
    6.  
      Recommended settings for the remote management (IPMI) port
  9. Monitoring the appliance
    1.  
      Registering an appliance
    2. Configuring alerts
      1. About AutoSupport and Call Home
        1.  
          Configuring Call Home
      2.  
        Configuring email alerts
      3.  
        Configuring SNMP alerts
      4.  
        Setting the threshold values for disk usage alerts
    3.  
      Monitoring the appliance from the System Health Insights portal
    4. Viewing the hardware status
      1.  
        Viewing node information
      2.  
        Viewing storage shelf information on a Veritas 53xx Appliance
      3.  
        Viewing storage shelf information on a Veritas 52xx Appliance
    5.  
      Viewing hardware faults
    6.  
      Viewing system data
    7.  
      Clearing the hardware status
    8.  
      Forwarding logs
    9.  
      Providing access for external monitoring
    10.  
      Revoking access for external monitoring
  10. Reconfiguring the appliance
    1.  
      Reconfiguring the appliance network
    2.  
      Changing DNS or Hosts file settings
    3.  
      Shutting down the appliance
    4.  
      Performing a factory reset
    5.  
      Performing a reimage
    6.  
      Recovering storage data after a factory reset or a reimage
    7.  
      Performing a storage reset
    8.  
      Removing a node
    9.  
      Viewing or resetting the storage shelf order on a Veritas 52xx Appliance
  11. Troubleshooting guidelines
    1.  
      General troubleshooting steps
    2.  
      Unlocking access in lockdown mode
    3. Gathering logs
      1.  
        Deleting logs

Operational notes

This topic explains important aspects of Flex Appliance 5.x operations that may not be documented elsewhere in the documentation.

The following list contains the notes and the known issues that apply for the Flex Appliance 5.x software:

  • When you edit the roles for a user and select a base role, some of the extended roles are grayed out. These extended roles are included as part of the selected base role.

  • During a factory reset, error messages similar to the following may display before the node is restarted:

    err: Cannot open Packages using index using db5 - Permission denied (13)

    err: Cannot open Packages in database /var/lib/rpm

    These messages display in error and can be ignored.

  • If you shut down both nodes of a multi-node appliance after an update but before you have committed or rolled back, an issue can occur that causes the appliance to be in an unusable state.

    This issue is fixed in version 5.1.

    To avoid this issue on version 5.0, do not shut down both nodes until you have committed or rolled back. If you were not aware of this issue and have encountered it, contact Veritas Technical Support for assistance. Ask your representative to reference article 100068050.

  • If you generate a Data Collect log package with data masking enabled, the private_map file that is included uses the same key value for multiple entries.

  • After a new installation or an upgrade to version 5.x, SAN client (Fibre Transport Media Server) backups do not work on NetBackup application instances earlier than version 10.3. To use SAN client on an earlier supported version, you must install an EEB. Versions earlier than 10.1.1 must be upgraded before you can install the EEB.

    You can find the EEBs at the following locations:

    Note:

    Update the appliance before you upgrade the instance or install the EEB.

  • When you restart the appliance, the network interfaces temporarily go down and then come back up. Due to this behavior, a failed "Clear state" task sometimes displays in the Activity Monitor, indicating that the network interface is down. If you see this failed task, check the Network interfaces page. If the interface shows as UP, you can ignore the failed task.

  • To use universal shares on NetBackup 10.1, you must install an EEB on the instance.

    You can find the EEB at the following location: Version 10.1

  • For this release, the Performance graphs on the Flex Appliance Console Home page show data only in the UTC time zone.

  • On a multi-node appliance, an issue can occur if you remove a node while that node is powered off. If the node comes back online before you have restarted the appliance, the removed node is added back to the appliance. If you experience this issue, remove the node again and then immediately restart the appliance.

  • When you run the following commands, messages that include the text avc: denied and comm='iptables' or comm='ip6tables' may appear in the logs at /var/log/audit/audit.log:

    • setup configure-console

    • system restart

    • system appliance-recover

    • systemctl restart system-hostnamed

    • hostnamectl

    The messages look similar to the following:

    node=localhost.localdomain type=AVC msg=audit(1668166429.323:16048): avc: denied { ioctl } for pid=612229 comm="iptables"

    These messages can be ignored.

  • Alerts are not currently sent for the metrics that can be set with the set alerts hardware-threshold command.

  • The support data-collect command may show the following error:

    "*** Error in `qaucli': double free or corruption"

    This error can be safely disregarded. The command still generates a Data Collect package.

  • During a firmware update, an issue can occur with the storage shelf controller that causes an update failure message to appear. If you see a failure message, it may have appeared in error, and the update may still have worked. Run the following command to confirm the firmware version:

    show hardware-health primaryshelf component=controller

  • For this release, while an update is in progress, do not perform any other operations in the Flex Appliance Shell or the Flex Appliance Console.

  • When you install application add-ons on an instance, the Flex Appliance Console lets you select different versions of the same OST plug-in. However, this configuration is not supported, and if you select more than one version of the same plug-in, the Install add-ons page shows duplicate entries. Only install one version of each OST plug-in on an instance. If you need to change the version of an OST plug-in that is already installed, first uninstall it, and then install the new version.

  • If the host0 or host1 port is not connected to the appliance node during initial configuration, the following error message appears that does not provide complete information:

    "Network card for <interface name> is missing. Make sure that all network interfaces are connected to the appliance."

    If you encounter this message, verify that all ports are connected according to the initial configuration guidelines. See Initial configuration guidelines and checklist. Then restart the node to continue the configuration.

  • When you create a new application instance, the Application instances section of the System topology page may show the instance status as Deleted while the creation is in progress. The Deleted status displays in error and can be safely ignored. You can track the instance creation progress from the Activity Monitor, and the instance status changes to Online when the instance creation has completed successfully.