Sign In
Forgot Password

Don’t have an account? Create One.

VRTSaccess-app-EEB-ET4117288-8.1.0.0-4.x86_64.rpm

HotFix

Abstract

The EEB 4117288 (version 4) removes the system memory requirement for Veritas Data Deduplication (VDD) and addresses multiple issues with VDD reconfiguration on Access Appliance 8.1

Description

Access Appliance 8.1 requires at least 0.5GB of RAM to be available on each node for every 1TB of Veritas Data Deduplication (VDD) storage pool. Operations such as configuring or increasing storage for VDD and reconfiguring VDD are not allowed if sufficient RAM is not available on the appliance. These operations will fail with an error message similar to the following error message:

"Failed to configure the Veritas Data Deduplication server because of insufficient system memory. 1 TB of Veritas Data Deduplication pool requires 0.5 GB of system memory. Install additional system memory as per your requirement."

 

Fix #1:

This EEB removes the memory requirement check and allows the following operations even when sufficient RAM is not available:

  • Configuration of new storage pool for VDD.
  • Growing the VDD storage pool.
  • Reconfiguration of the VDD.

 

The VDD without WORM is automatically unconfigured when you upgrade to 8.1 and you are required to reconfigure it post upgrade. This reconfiguration will be allowed.

 

 

After upgrade to Access 8.1, the host-based VDD is unconfigured and the user is required to reconfigure the VDD. The reconfiguration configures container-based VDD.

 

Fix #2:

This EEB fixes following issues related to VDD reconfiguration:

a) VDD reconfiguration failing due to failure in stopping spoold/spad

b) VDD reconfiguration triggers ‘chown -R’ of all VDD filesystems multiple times which results in reconfiguration taking a significantly large amount of time. The EEB removes the duplicate chown operation.

c) VDD reconfiguration failing while running the chown -R on the VDD filesystems with error 'too many open files'

d) Reconfiguration of a containerized VDD will fail if it is configured without a separate catalog filesystem

e) Dedupe stop and then dedupe start, or failover VDD from one node to another does image pull from the docker repository, even though the container image exists on the setup. This unnecessary image pull is removed which speeds up dedupe start and failover.

 

Installation instructions for the EEB: 4117288 (version 4)

Veritas has provided EEB 4117288 that allows VDD to be configured or grown, which was not permitted earlier if insufficient system memory was installed on the system. The EEB also address multiple issues with VDD reconfiguration.

This EEB is for version 8.1 only. A separate EEB will be provided for later security patches. Access 8.1.100 will have updated functionality and not require an EEB.

 

To install the EEB, complete the following steps:

  1. Download the EEB file: VRTSaccess-app-EEB-ET4117288-8.1.0.0-4.x86_64.rpm from trencher.
  2. Open an SSH session and log on to the appliance as an admin using the Access Appliance Shell Menu.
  3. To open an NFS or a CIFS share, enter the following command:
    system software share open
    For example:
    [access-8.1] va810.xxxx.veritas.com > system software share open
    - [Info] Created an NFS share for sharing the patches.
    - [Info] You can access the NFS share at va810.xxxx.veritas.com:/inst/patch/appliance/available. To ensure appliance security, use the 'system software share close' command to remove the share after downloading the required patches.
    - [Info] Created a CIFS share for sharing the patches.
    - [Info] You can access the CIFS share at \\va810.xxxx.veritas.com\incoming_patches. To ensure appliance security, use the Share Close command to remove the share after downloading the required patches.
  4. Mount the appliance share directory as follows.
    For a Linux NFS share:
    mkdir -p /mount/Node_management_IP
    mount Node_management_IP:/inst/patch/appliance/available /mount/Node_management_IP
    where Node_management_IP is the IP address that is assigned to eth1 of each node.

    For a Windows CIFS share:
    \\Node_management_IP\incoming_patches
    where Node_management_IP is the IP address that is assigned to eth1 of each node.
    Note: Use the appliance admin [<Access Cluster Name>\admin] user credentials to map a share directory for CIFS.
  5. Copy the Hot fix EEB to the mounted share.
  6. Close the NFS and the CIFS shares by using the command:
    system software share close
    For exmaple:
    [access-8.1] va810.xxxx.veritas.com > system software share close
    - [Info] Revoked access to the NFS share that was created for sharing the patches.
    - [Info] Revoked access to the CIFS share that was created for sharing the patches.
  7. List the downloaded files by using the command:
    system software downloaded
  8. Install the EEB on the node
    system software install-update update-name=VRTSaccess-app-EEB-ET4117288-8.1.0.0-4.x86_64.rpm

 

Note:

  1. Following the installation instruction on one node of Access Appliance, the EEB is installed automatically on both nodes.
  2. Rollback older version of EEB (version 2 was previously released) before installing the latest version (version 4) of the EEB.
    1. How to check if version 2 is installed? Run following:
      system software installed-eebs  (check in the output if the version 2 of the EEB : VRTSaccess-app-EEB-ET4117288-8.1.0.0-2.x86_64 is listed or not)
    2. If version 2 is installed, rollback the version 2 of the EEB.
    3. How to rollback? Run following:
      system software rollback-update update-name=VRTSaccess-app-EEB-ET4117288-8.1.0.0-2.x86_64.rpm  on any one node of Access Appliance. It will rollback the EEB from both the nodes.

Applies to the following product releases

Update files

File name Description Version Platform Size