| # Veritas Compliance Accelerator™ 12.3 Upgrade Instructions | Last updated: 09-Jan-2018

This document describes how to upgrade an existing installation of Compliance Accelerator to the 12.3 version.

See the ReadMeFirst file and Installation Guide for information on the following:

- New features and changes in Compliance Accelerator 12.3
- Prerequisite software
- Guidelines on how to perform a first-time installation
- Known issues and limitations

Both documents are in the Compliance Accelerator media.

For the latest information on supported devices and versions of software, see the Enterprise Vault Compatibility Charts.

## Contents

- Supported upgrade paths
- Supported versions of Enterprise Vault in Compliance Accelerator environments
- Before you begin
- Steps to upgrade your Compliance Accelerator system
- Legal notice

## Supported upgrade paths

You can upgrade to Compliance Accelerator 12.3 from the following versions only:

- Compliance Accelerator 11.0 Original Release or 11.0.1
- Compliance Accelerator 12 Original Release, 12.1, or 12.2

For the latest information on supported upgrade paths, see the technical note called Supported upgrade paths for Enterprise Vault, Compliance Accelerator, and Discovery Accelerator (https://www.veritas.com/docs/100023744).

## Supported versions of Enterprise Vault in Compliance Accelerator environments

As a minimum, you must install an 11.0.1 or later version of one of the following on the Compliance Accelerator server:

- Enterprise Vault Services
- Enterprise Vault API Runtime

Note the following important points:

- All Enterprise Vault servers in all Enterprise Vault sites in a Compliance Accelerator environment must run the same version of Enterprise Vault. For example, when using Compliance Accelerator with two Enterprise Vault installations, you cannot have one site that runs Enterprise Vault 11.0.1 and another that runs Enterprise Vault 12.3.

- The major version of Compliance Accelerator must be the same as, or one later than, the major version of Enterprise Vault. For example, you can run Compliance Accelerator 12.3 with Enterprise Vault 11.0.1 servers, but you cannot run Compliance Accelerator 11.0.1 with Enterprise Vault 12.3 servers.

- If the major version of Compliance Accelerator is the same as the major version of Enterprise Vault, the minor version (Service Pack) of Compliance Accelerator must be the same as, or later than, the minor version of Enterprise Vault. For example, you can run Compliance Accelerator 12.3 with Enterprise Vault 12.2 servers, but you cannot run Compliance Accelerator 12.2 with Enterprise Vault 12.3 servers.

- When upgrading both Compliance Accelerator and Enterprise Vault, you must first upgrade Enterprise Vault on all Enterprise Vault servers, then Enterprise Vault on all Compliance Accelerator servers, and finally Compliance Accelerator itself.

See the Enterprise Vault Compatibility Charts for more information about supported versions.

## Before you begin

Before you upgrade to Compliance Accelerator 12.3, we recommend that you do the following:

- Ensure that you are running a suitable version of SQL Server on your SQL Server computer. Compliance Accelerator 12.3 works only with the following:

  - SQL Server 2012 x64 Edition, Original Release or later
  - SQL Server 2014 x64 Edition, Original Release or later
  - SQL Server 2016 x64 Edition, Original Release or later
  - SQL Server 2017 x64 Edition, Original Release

- Ask all users of the Compliance Accelerator client to exit the program.

- If you have used the facility to revoke the Vault Service account's ownership of the Compliance Accelerator databases, temporarily assign the database role of EVUpgradeRole to the Vault Service account. The following article on the Veritas Support website describes how to do this:

  https://www.veritas.com/content/support/en_US/doc/82102216-120586061-0/

  You can revoke the assignment after you have completed the upgrade.

- Check for and stop any active searches and export runs. The following article on the Veritas Support website provides SQL scripts with which you can check for these operations:

  https://www.veritas.com/docs/100019120

- Check for searches that have a status of either "Pending Acceptance" or "Pending Acceptance (with errors)", and accept or reject them. The above article on the Veritas Support website provides a SQL script with which you can check for these searches. By accepting or rejecting the searches, you can reduce the amount of data that the upgrade procedure must process.

- Check the tblSearchResults table of the Compliance Accelerator customer database for rows that have been left over by searches that you have already accepted or rejected. To do this, run the following SQL query against the customer database:

      SELECT COUNT(*) FROM tblSearchResults

  If the query returns any result other than 0, and no searches are currently running, then you must clear the table of invalid data before you proceed. Contact the Veritas Support team for assistance.

- Use the facilities in SQL Server Management Studio to do the following:

  - Make a backup copy of your Compliance Accelerator database and transaction log.
  - Truncate the transaction log.
  - Enable autogrowth for the database and transaction log in fixed increments of 250 megabytes.

  Consult the documentation that accompanies SQL Server Management Studio for instructions on how to perform these activities.

- If you use Microsoft SQL Server database mirroring with your Compliance Accelerator databases, remove it before you upgrade the Compliance Accelerator server software. Compliance Accelerator fails to upgrade its databases if mirroring is configured. For more information, see the following article on the Veritas Support website:

  http://www.veritas.com/docs/100019439

  Note also that, in an environment where you have implemented SQL Server log shipping as a disaster-recovery solution, the process of upgrading the Compliance Accelerator databases can disrupt the log shipping operations in some circumstances. After you have completed the upgrade, it is important to check that these operations continue as scheduled.

- Ensure that the drive hosting the transaction log has available space that is equal to or greater than four times the size of the database.

- Disable the following features on the Compliance Accelerator server, Enterprise Vault servers, and all SQL Servers that host an Enterprise Vault database or Compliance Accelerator database:

  - Receive-Side Scaling
  - TCP Chimney
  - TCP/IP Offload Engine
  - TCP Segmentation Offloading

  The following article on the Veritas Support website provides instructions on how to disable these features:

  https://www.veritas.com/docs/100019120

- Disable any Network Interface Card (NIC) Teaming that may be present on the Enterprise Vault and Compliance Accelerator servers. For guidelines on how to do this, consult the documentation that your hardware vendor provides.

## Steps to upgrade your Compliance Accelerator system

Upgrading a Compliance Accelerator database that contains millions of items can take several hours to complete. During the upgrade process, there are several pauses that may give you the impression that it has stopped prematurely. We recommend that you perform the upgrade at a quiet time and allow it to run through to completion. Ideally, seek the assistance of Veritas Consulting Services when upgrading.

See the Installation Guide for more information on how to perform the following steps.

To upgrade your system to Compliance Accelerator 12.3:

1. If necessary, upgrade Enterprise Vault on each Enterprise Vault server. See the Enterprise Vault documentation for guidelines.

   Do not uninstall the existing Enterprise Vault components before you install the new ones; simply run the installation program for the required components and follow the on-screen instructions. Uninstalling the Enterprise Vault components can lead to the removal of the Enterprise Vault registry entries, which requires you to reinstall not only Enterprise Vault but also Compliance Accelerator. If you experience this issue, contact Veritas Support for help.

   There is no need to configure Enterprise Vault after you have installed it on your Compliance Accelerator server computer; do not run the Enterprise Vault configuration wizard.

2. On any Enterprise Vault server, run the PowerShell cmdlet called `Start-EVDatabaseUpgrade` to upgrade the Enterprise Vault Directory database and the Storage databases. See the Enterprise Vault documentation for guidelines.
3. Start the Enterprise Vault Admin and Directory services on each Enterprise Vault server.
4. Log on to the Compliance Accelerator server as the Vault Service account.
5. Use the Services snap-in to Microsoft Management Console to do the following:
   - Stop the Enterprise Vault Accelerator Manager service and any Enterprise Vault services that are running on the server. These services can interfere with the upgrade process if you leave them running.
   - Ensure that the Windows Server service is running. When you run the installation program for the Compliance Accelerator server software, it tries to assign a number of user rights to the Vault Service account, such as "Log on as a service". The installation program uses the Windows Server service to assign these rights.

6. Upgrade the Enterprise Vault components on the server. As a minimum, you must install an 11.0.1 or later version of one of the following on the Compliance Accelerator server:

   - Enterprise Vault Services
   - Enterprise Vault API Runtime

7. Start the Compliance Accelerator server installation program (`..\Veritas Enterprise Vault Compliance Accelerator\Server\setup.exe`).

   The `setup.exe` program launches the Windows Installer (`.msi`) package that is in the same folder with elevated privileges. This is necessary to enable the installation to complete all its processes.

8. Follow the on-screen instructions.
9. When the installation process has completed, open the Accelerator Manager website (typically, http://server_name/EVBAAdmin).
10. Click Update to update the configuration database.

11. Follow the on-screen instructions to restart the Enterprise Vault Accelerator Manager service. You can use the Services snap-in to Microsoft Management Console to do this.

    Note: Restarting the service causes Compliance Accelerator to check the security of various temporary folders that the application uses. If this security check fails, an error event with an ID of 585 is recorded in the Veritas Enterprise Vault event log, and the service does not start. For more information and guidelines on how to resolve this issue, see the Installation Guide.

12. In the Accelerator Manager website, click OK.
13. Click Upload License to import your license key file for Compliance Accelerator 12.3.

14. To upgrade each customer database, follow these steps:

    1. In the left pane of the Accelerator Manager website, right-click the name of the customer database and then click Properties.
    2. In the Customer dialog box, click Update.
    3. Monitor the upgrade progress until it has completed and the customer status is Running.

    If you have multiple customer databases, upgrade them one at a time rather than concurrently.

15. If you have implemented SQL Server log shipping as a disaster-recovery solution in your Compliance Accelerator environment, check that the log shipping operations continue as scheduled. The process of upgrading the databases can disrupt these operations in some circumstances. After you have upgraded the databases, you may need to take a manual backup to recover the log shipping functionality.

16. Use the Accelerator Manager website to upload the Compliance Accelerator report templates to your SQL reporting server.

    Compliance Accelerator 12.3 includes some updates to existing report templates. To make the updated templates available, you must upload them to your reporting server.

17. Install the Compliance Accelerator client software on the computer of each user who will be running the client. Note the following:

    - By default, the Windows Installer package performs a per-user installation of the Compliance Accelerator client software. This allows the user account under which the Compliance Accelerator client was installed to run the software, but it does not allow other users of the computer to do so. If you have administrator privileges on the computer and want to permit all users to run the application, you can perform a per-machine installation. See the Installation Guide for instructions on how to do this.
    - For the best results, install the client software as a user with administrator privileges on the computer.
    - The version of the client software on your users' computers must exactly match that of the Compliance Accelerator server software on the Compliance Accelerator server.

18. Start the Enterprise Vault services on each Enterprise Vault server.

## Legal notice

Copyright © 2018 Veritas Technologies LLC. All rights reserved.

Veritas, the Veritas Logo, Enterprise Vault, Compliance Accelerator, and Discovery Accelerator are trademarks or registered trademarks of Veritas Technologies LLC or its affiliates in the U.S. and other countries. Other names may be trademarks of their respective owners.

This product may contain third-party software for which Veritas is required to provide attribution to the third party ("Third-party Programs"). Some of the Third-party Programs are available under open source or free software licenses. The License Agreement accompanying the Software does not alter any rights or obligations you may have under those open source or free software licenses. Refer to the Third-party Legal Notices document accompanying this Veritas product or available at:

https://www.veritas.com/about/legal/license-agreements

The product described in this document is distributed under licenses restricting its use, copying, distribution, and decompilation/reverse engineering. No part of this document may be reproduced in any form by any means without prior written authorization of Veritas Technologies LLC and its licensors, if any.

THE DOCUMENTATION IS PROVIDED "AS IS" AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID. VERITAS TECHNOLOGIES LLC SHALL NOT BE LIABLE FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES IN CONNECTION WITH THE FURNISHING, PERFORMANCE, OR USE OF THIS DOCUMENTATION. THE INFORMATION CONTAINED IN THIS DOCUMENTATION IS SUBJECT TO CHANGE WITHOUT NOTICE.

The Licensed Software and Documentation are deemed to be commercial computer software as defined in FAR 12.212 and subject to restricted rights as defined in FAR Section 52.227-19 "Commercial Computer Software - Restricted Rights" and DFARS 227.7202, et seq. "Commercial Computer Software and Commercial Computer Software Documentation," as applicable, and any successor regulations, whether delivered by Veritas as on-premises or hosted services. Any use, modification, reproduction release, performance, display or disclosure of the Licensed Software and Documentation by the U.S. Government shall be solely in accordance with the terms of this Agreement.

Veritas Technologies LLC
500 E Middlefield Road
Mountain View, CA 94043

https://www.veritas.com