Veritas Enterprise Vault™ 12.0.2
Installation Instructions

This document provides installation instructions for Enterprise Vault 12.0.2.

Enterprise Vault 12.0.2 is a release update for Enterprise Vault 12. From Enterprise Vault 12, release updates replace cumulative hotfixes, which were used to deliver fixes for earlier releases of Enterprise Vault.

You must install all the Enterprise Vault 12.0.2 components that are applicable to your environment to ensure that they are deployed correctly.

You must reinstall Enterprise Vault 12.0.2 if you install additional Enterprise Vault features or repair the Enterprise Vault installation.

Note that you cannot uninstall Enterprise Vault 12.0.2 from the Enterprise Vault server.

The ReadMeFirst file, which is available with Enterprise Vault 12.0.2 and also at http://www.veritas.com/docs/000108117, gives details of the issues that have been fixed.

• Enterprise Vault server
• File System Archiving
• Enterprise Vault Outlook Add-In
• Compliance Accelerator
• Discovery Accelerator

Enterprise Vault server

Before you install Enterprise Vault 12.0.2:

• Back up all Enterprise Vault data in accordance with your normal backup procedures. See the Backup and Recovery guide.
• Allow the MSMQ queues to empty.
• To allow time to examine the new installation before archiving starts, you may want to disable archiving and expiry before you install this release. You can enable archiving and expiry again when you have checked the installation.

Caution: Do not upgrade to Enterprise Vault 12 and then immediately install Enterprise Vault 12.0.2. After you have upgraded to Enterprise Vault 12, use the PowerShell cmdlet Start-EVDatabaseUpgrade to upgrade all Enterprise Vault databases as described in the Enterprise Vault 12 Upgrade Instructions, and then install Enterprise Vault 12.0.2.

You must install this release on all of the following:

• Enterprise Vault servers
• Servers on which the Enterprise Vault SharePoint components are installed (SharePoint Server 2013 only)
• Servers on which the Enterprise Vault Reporting components are installed
• Enterprise Vault Domino Gateway servers
• Remote computers on which the Enterprise Vault Administration Console is installed

To install Enterprise Vault 12.0.2:

1. Log on to each Enterprise Vault server as the Vault Service account.
2. If the Enterprise Vault server is not part of a cluster, stop the Enterprise Vault Admin service. This stops the Admin service and any other Enterprise Vault services.
3. If the Enterprise Vault server is part of a cluster, use the cluster administration tools to take the Admin service resource offline. This takes all the Enterprise Vault services offline.

   Note the following important points:

   • Do not take the EnterpriseVaultServerInstance offline.
   • You must stop all Enterprise Vault services in the Enterprise Vault site. For example, stop the services on non-clustered servers, such as an Enterprise Vault Domino Gateway.
   • If there are multiple sites that share the Enterprise Vault Directory, you must also stop all Enterprise Vault services in the other sites.
4. Stop any other local or remote services or applications that can lock Enterprise Vault files. For example:
   • Enterprise Vault Administration Console
   • Enterprise Vault Reporting Configuration utility
   • Enterprise Vault Accelerator Manager service
5. Close any other applications that may be running, including the Control Panel, Computer Management, Windows Services, and the Windows Event Viewer.
6. If you are installing on an Enterprise Vault Domino Gateway, make sure that the Domino server on the Enterprise Vault Domino Gateway is shut down and that EVInstall.nsf is not being accessed locally.

7. On each Enterprise Vault server:

   1. Load the Enterprise Vault 12.0.2 media.
   2. Open the \Veritas Enterprise Vault\Server folder and double-click the file setup.exe.
      The installation wizard starts.
   3. Work through the installation wizard to upgrade the Enterprise Vault components.

8. Upgrade the Enterprise Vault databases by using the PowerShell cmdlet Start-EVDatabaseUpgrade:

   1. Log on to any Enterprise Vault server using the Vault Service account.
   2. Run the Enterprise Vault Management Shell.
   3. In the Enterprise Vault Management Shell, run the following command:
      Start-EVDatabaseUpgrade
9. Wait for Start-EVDatabaseUpgrade to complete the upgrade of all the databases, and then start the Enterprise Vault services on all servers.
10. If you use Enterprise Vault Reporting, run the Enterprise Vault Reporting Configuration utility.
11. Domino server archiving only: follow the instructions in Upgrading Domino mailbox archiving.

12. SharePoint server archiving only: if you install a SharePoint update after you have installed Enterprise Vault 12.0.2, you must do the following:

    1. Stop the Enterprise Vault Admin service.
    2. Remove the file EV_versions_BAK.aspx_OLD from the SharePoint layouts folder (typically C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\version_number\TEMPLATE).
    3. Restart the Enterprise Vault Admin service.
13. If you use Enterprise Vault Search, in the Internet Information Services (IIS) Manager on the Enterprise Vault Server, in Application Pools, right-click EVOnlineWebSearch and select Recycle.

Upgrading Domino mailbox archiving

Follow the instructions in this section to upgrade Domino mailbox archiving after you have installed version 12.0.2 on the Enterprise Vault servers.

Note: The following procedure requires you to replace the forms files with the original Domino versions. When you replace the forms files you lose any non-Enterprise Vault customizations that you made to them. If you made any non-Enterprise Vault customizations to the forms files, you must reapply these changes to the files after you have upgraded.

Before you upgrade, complete the following procedure on all Enterprise Vault Domino Gateway servers and on all Domino mail servers on which you have updated Forms9.nsf, Forms85.nsf, or Forms8.nsf to include the Enterprise Vault customizations:

1. Stop the HTTP task.

2. Skip these steps for Domino 9:

   1. Delete Forms85_x.nsf if it exists on the server.
   2. Replace the Forms85.nsf and Forms8.nsf files with the original Domino versions that you backed up before you installed the previous version of Enterprise Vault.
3. If the forms databases have replication enabled, the changes that EVInstall makes are replicated to all Domino mail servers. If you want to prevent the replication to other mail servers, disable the replication of Forms9.nsf, Forms85.nsf, and Forms8.nsf.
4. Update the ACLs on the original Domino .nsf files to give Manager access to the ID of the user that will run EVInstall.

To upgrade Domino mailbox archiving:

1. Use the Domino Administrator to sign the Veritas Enterprise Vault 12 - Domino Installer (EVInstall.nsf) on the Enterprise Vault Domino Gateway with the ID of the user that will be used to run it.
2. Make sure that the version of the Notes client on the workstation from which you run EVInstall.nsf is no older than the newest version of the Domino Server that is installed on the Enterprise Vault Domino Gateway and the Domino mail servers.

3. Do the following:

   1. From your chosen workstation, connect to the Enterprise Vault Domino Gateway server and run EVInstall.nsf.
   2. In the application page, select the Enterprise Vault Domino Gateway and a target Domino mail server.
   3. If you use Enterprise Vault Search or you require iNotes (DWA), select Modify Domino Web Access Forms Files.
   4. Click Install Veritas Enterprise Vault 12 database design templates to start the process.
      The application takes several minutes to create the new Enterprise Vault templates.
4. Deploy the templates created on the Domino mail server to each target Domino mail server that has the same Domino Server version. For example, if you ran EVInstall.nsf against a Domino Server 8.5.3 target server, deploy the templates to all Domino Server 8.5.3 mail servers.

   Deploy the templates by creating replicas of the Enterprise Vault mail templates and running Load Design on each mail server.

   It is important that you copy the templates created on the Domino mail server and not those created on the Enterprise Vault Domino Gateway.

   Note that the Load Design command updates all databases on the server. It may be quicker to restrict the scope of the command so that it updates just those databases that need changing. In this case, use the command's -I or -d or -f switches to update all Enterprise Vault mail databases that have had any of the following templates applied to them:

   • ev_dwa*.ntf
   • ev_iNotes*.ntf
   • ev_Mail*.ntf

   See the Domino Help for more information about Load Design switches.

5. If you have other target mail servers with different Domino Server versions (for example, 8.5.2), do the following until you have deployed the templates to all mail server targets:

   1. Run EVInstall.nsf again.
   2. In the application page, clear the Enterprise Vault Domino Gateway selection.
   3. Select a target Domino mail server.
   4. If you require iNotes (DWA), select Modify Domino Web Access Forms Files.
   5. Click Install Veritas Enterprise Vault 12 database design templates to start the process.
      The application takes several minutes to create the new Enterprise Vault templates.
   6. Deploy the templates and run Load Design as before, on each mail server.

File System Archiving

To install the Enterprise Vault 12.0.2 version of the FSA Agent, after you have installed Enterprise Vault 12.0.2 on the Enterprise Vault servers:

1. If you are running FSA Agent on a file server cluster, remove the FSA Resource from the cluster group.
2. In the Administration Console, expand the Enterprise Vault site until the Targets > File Servers container is visible. Right-click the server on which you want to install the FSA Agent and, on the shortcut menu, click Install FSA Agent.
3. If you are running FSA Agent on a file server cluster, install the FSA Agent on all the cluster nodes, and then add the FSA resource to the cluster group.

To uninstall the Enterprise Vault 12.0.2 version of the FSA Agent:

1. If you are running FSA Agent on a file server cluster, remove the FSA Resource from the cluster group.
2. On all file servers, from the Windows Control Panel, select Uninstall a program and uninstall the FSA Agent.
3. If you are running FSA Agent on a file server cluster, uninstall the FSA Agent from all the nodes in the cluster.

Note: You may install or uninstall the FSA Agent manually on the target file servers. For more information about installing the FSA Agent, see the Setting up File Server Archiving guide.

Enterprise Vault Outlook Add-In

To install the Enterprise Vault 12.0.2 version of the Outlook Add-In, deploy the MSI kit to desktop computers through your normal software distribution process.

Alternatively, you can allow users to install an Outlook Add-In themselves. The users must have local administrator permissions to install the Outlook Add-In. In some cases the users can launch the MSI directly, but for some users you also need to provide a setup.exe file. The setup.exe file is included in Enterprise Vault 12.0.2 with the associated MSI file.

For more information on deploying the Outlook Add-Ins, see the section "Setting up users' desktops" in the Setting up Exchange Server Archiving guide.

To uninstall the Enterprise Vault 12.0.2 version of the Outlook Add-In, uninstall the Outlook Add-In and then reinstall the previous version.

Compliance Accelerator

To install Compliance Accelerator 12.0.2:

1. Log on to the Compliance Accelerator server as the Vault Service account.
2. Ensure that the installation program for the Compliance Accelerator 12 original release (Veritas Enterprise Vault Compliance Accelerator Server.msi) is available. This is required to install Compliance Accelerator 12.0.2.
3. Take a backup copy of the Compliance Accelerator configuration database and customer databases.

4. Start the Compliance Accelerator 12.0.2 installation program as follows:

   • If User Account Control is turned off, run Veritas Enterprise Vault Compliance Accelerator Server 12.0.2.msp.
   • If User Account Control is turned on, run setup.exe to launch the installation program with the required, elevated privileges.
5. Follow the on-screen instructions.
6. When the installation process has completed, open the Accelerator Manager website (typically, http://server_name/EVBAAdmin).
7. Click Update to update the configuration database.
8. 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.
9. In the Accelerator Manager website, click OK.

10. Upgrade each customer database as follows:

    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.

11. On the computer of each user who runs the Compliance Accelerator client, install the version of the client software that comes with Enterprise Vault 12.0.2.

    Caution: The version of the client software that you install on your users' computers must exactly match that of the Compliance Accelerator server software on the Compliance Accelerator server.

To uninstall Compliance Accelerator 12.0.2:

1. Log on to the Compliance Accelerator server as the Vault Service account.
2. If User Account Control is turned on, turn it off temporarily.
3. Ensure that the installation program for the Compliance Accelerator 12 original release (Veritas Enterprise Vault Compliance Accelerator Server.msi) is available. This is required to uninstall Compliance Accelerator 12.0.2.
4. In Control Panel, click Programs and then, under Programs and Features, click View installed updates.
5. Click the Veritas Enterprise Vault Compliance Accelerator Server 12.0.2 entry and then click Uninstall.
6. Open the Accelerator Manager website (typically, http://server_name/EVBAAdmin).
7. Click Update to update the configuration database.
8. 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.
9. In the Accelerator Manager website, click OK.

10. Upgrade each customer database as follows:

    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.
11. Turn User Account Control back on, if you turned it off earlier.

12. On the computer of each user who runs the Compliance Accelerator client, uninstall the Compliance Accelerator 12.0.2 version of the client and then install the version that came with the Compliance Accelerator original release.

    Caution: The version of the client software that you install on your users' computers must exactly match that of the Compliance Accelerator server software on the Compliance Accelerator server.

Discovery Accelerator

To install Discovery Accelerator 12.0.2:

1. Log on to the Discovery Accelerator server as the Vault Service account.
2. Ensure that the installation program for the Discovery Accelerator 12 original release (Veritas Enterprise Vault Discovery Accelerator Server.msi) is available. This is required to install Discovery Accelerator 12.0.2.
3. Take a backup copy of the Discovery Accelerator configuration database and customer databases.

4. Start the Discovery Accelerator 12.0.2 installation program as follows:

   • If User Account Control is turned off, run Veritas Enterprise Vault Discovery Accelerator Server 12.0.2.msp.
   • If User Account Control is turned on, run setup.exe to launch the installation program with the required, elevated privileges.
5. Follow the on-screen instructions.
6. When the installation process has completed, open the Accelerator Manager website (typically, http://server_name/EVBAAdmin).
7. Click Update to update the configuration database.
8. 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.
9. In the Accelerator Manager website, click OK.

10. Upgrade each customer database as follows:

    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.

11. On the computer of each user who runs the Discovery Accelerator client, install the version of the client software that comes with Enterprise Vault 12.0.2.

    Caution: The version of the client software that you install on your users' computers must exactly match that of the Discovery Accelerator server software on the Discovery Accelerator server.

To uninstall Discovery Accelerator 12.0.2:

1. Log on to the Discovery Accelerator server as the Vault Service account.
2. If User Account Control is turned on, turn it off temporarily.
3. Ensure that the installation program for the Discovery Accelerator 12 original release (Veritas Enterprise Vault Discovery Accelerator Server.msi) is available. This is required to uninstall Discovery Accelerator 12.0.2.
4. In Control Panel, click Programs and then, under Programs and Features, click View installed updates.
5. Click the Veritas Enterprise Vault Discovery Accelerator Server 12.0.2 entry and then click Uninstall.
6. Open the Accelerator Manager website (typically, http://server_name/EVBAAdmin).
7. Click Update to update the configuration database.
8. 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.
9. In the Accelerator Manager website, click OK.

10. Upgrade each customer database as follows:

    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.
11. Turn User Account Control back on, if you turned it off earlier.

12. On the computer of each user who runs the Discovery Accelerator client, uninstall the Discovery Accelerator 12.0.2 version of the client and then install the version that came with the Discovery Accelerator original release.

    Caution: The version of the client software that you install on your users' computers must exactly match that of the Discovery Accelerator server software on the Discovery Accelerator server.

Legal notice