Upgrade the DataArchiver Outlook Add-In


Click on a link below to go to a specific section:

The procedure on this page describes the steps involved in upgrading the DataArchiver Outlook Add-In in a non-clustered environment. This procedure provides steps for upgrading the DataArchiver Outlook Add-In only.

If multiple components are installed on a computer, then ensure that all applicable components are selected for upgrade. In such a situation, the upgrade sequence may vary. Refer to the appropriate procedures for upgrade requirements and steps specific to the component.

Verify that the computer in which you wish to install the software satisfies the minimum requirements specified in the DataArchiver Outlook Add-In Client section of System Requirements - Exchange Mailbox Archiver Agent.

We strongly recommend upgrading the Outlook Add-In, and any agents that support it, to the same release version as the CommServe. Otherwise, the Outlook Add-In functionality will be limited or unavailable. For more information, see Backward Compatibility - DataArchiver Outlook Add-In.

Supported Upgrade Paths

The following table provides a list of supported upgrade paths for the current software version. If the version currently installed on your computer is not listed here, contact your software provider for more information.

Installed Version

Upgrade to Version 8.0.0

Information

     
6.1.0 Supported Perform a direct upgrade to Version 8.0.0.
     
7.0.0 Supported Perform a direct upgrade to Version 8.0.0.

Upgrade Requirements

Review the following before upgrading the software:

General

  • Review the Upgrade Strategy before upgrading the software.
  • Verify that no jobs are in progress or scheduled to occur while the software is being upgraded on the client. If jobs are scheduled, either perform the upgrade at another time or disable all jobs in the client using the Activity Control tab from the Client Computer Properties dialog box in the CommCell Console.

    Once the upgrade is completed, you can enable the jobs from this dialog box.

  • Verify that the CommServe computer is accessible and all services on the CommServe and the MediaAgent in which you wish to perform the upgrade are running.
  • Verify that the SQL Server instance used by the CommServe is running on the CommServe computer.
  • Verify that all applications (CommCell Console, Service Control Manager) are closed.
  • Close all applications and disable any programs that run automatically, including antivirus, screen savers and system utilities. Some programs, including antivirus software, may be running as a service. Stop and disable all non-essential services before you begin. You can re-enable them after the upgrade.
  • The files and folders associated with CommCell components should not be opened by other applications (for example, Windows Explorer, FTP, etc.) on this computer or from other computers during the upgrade.
  • Verify that you have the software installation disc that is appropriate to the destination computer’s operating system.

    Make sure that you have the latest software installation disc before you start to install the software. If you are not sure, contact your software provider.

Agent Specific

  • If you have previously installed an MSI package from a disc, you must upgrade the software using the software installation disc from the current release. Conversely, if you have previously installed an MSI package remotely, you must upgrade the software remotely using the MSI package for the current release.

  • Note that during the the Outlook Add-In upgrade process, the software automatically installs the Visual C++ Redistributable and JRE packages. For more information, see System Requirements - Exchange Mailbox Archiver Agent.

Before You Begin

  • Ensure that you are logged on to the computer as a local Administrator or as a member of the local Administrators group on that computer.

Upgrade Procedure

1. In this screen, you choose the language you want to use during installation. Click the down arrow, select the desired language from the pull-down list, and click Next to continue.  
2. Select the option to install software.

NOTES

 
3. Select the option to install software on this computer.

NOTES

  • The options that appear on this screen depend on the computer in which the software is being installed.
 
4. Read the Welcome screen.

Click Next to continue, if no other applications are running.

5. Read the virus scanning software warning.

Click OK to continue, if virus scanning software is disabled.

6. Read the license agreement, then select I accept the terms in the license agreement.

Click Next to continue.

7. Click Next to continue with the upgrade.

NOTES

  • New components from this version can only be installed after upgrading the existing components.
  • The older version number depends on the version in the computer and may look different from the example shown.
8. Click Yes to continue. This will not save any files (such as command line scripts) or folders from the <software installation path> folder.

NOTES

  • The upgrade process deletes and replaces this folder with newer files.

    To preserve files or folders within the <software installation path> folder, move them to another location before clicking Yes.

  • Clicking No will exit the upgrade program.
9. Select Download Pack(s) and Install to download and install the latest service packs and post packs from the software provider.

NOTES

  • Internet connectivity is required to download updates.
  • This step is applicable when installing on the first instance.
  • Updates are downloaded to the following directory: 
    <software installation>/Base/Temp/DownloadedPacks
    .
    They are launched silently and installed automatically for the first instance.

Click Next to continue.

10. Verify the summary and Click Next to continue.

NOTES

  • The Summary on your screen will reflect the components installed on the computer, and may look different from the example shown.

The upgrade program now starts the upgrade process. This step may take several minutes to complete.

11. Click Finish to complete the upgrade.

NOTES

  • The Completion Report will reflect the components upgraded on the computer, and may look different from the example shown.

The upgrade is now complete.

Post-Upgrade Considerations

General

  • Install post-release updates or Service Packs that may have been released after the release of the software. If you are installing a Service Pack, verify and ensure that it is the same version as the one installed in the CommServe Server. Alternatively, you can enable Automatic Updates for quick and easy installation of updates in the CommCell component.
  • If Activity Control was disabled on the client prior to the upgrade, enable it after the upgrade using the Activity Control tab from the Client Computer Properties dialog box in the CommCell Console.

Agent Specific

  • Before using the Outlook Add-In, ensure that the Organizational Forms Library has been set up and configured for special forms. See OFL Configuration for more information.
  • Before using the Outlook Add-In, ensure that the port number used by the Client Event Manager Service is properly configured. Typically, the install program configures this automatically; however, when using custom port numbers you will need to make sure that the port number configured on the Exchange Server under the nEVMGRCPORT registry key matches the port number configured on the Outlook client under registry key nEvMgrCPortNumber. This requirement also applies to multi-instance installs, in which case, you will need to locate the nEVMGRCPORT registry key under the appropriate instance on the Exchange Server. For general information on port number requirements, see Network TCP Port Requirements.