Advanced Options - Administrator - Outlook Add-In

Table of Contents

Configure the Active Directory Template

Configuring Message Recalls Over Secure Connections

Configure Restores from a Web Browser/Outlook

Configure the OWA Proxy Enabler

Configure Automatic Java Update Downloads

Download Java Updates Overnight

Download Java Updates at a Specific Time

Use an Alternate Computer for Obtaining Java Updates

Configure Language Options

Configure Unique User Settings for Citrix Environments

Configure the Client for Java Updates During Installation

Configure the Active Directory Template

If you want to change settings to the Active Directory template, you can do so as follows:

1.
  • Start Group Policy Management.
  • Right-click the GPO you want to edit and click Edit.
2. Right-click Administrative Templates and select Add/Remove Templates.
3.
  • Click Add.
  • Select the CVOutlookAddin.adm template and click Open.
4. Click the Outlook Add-In Registry Keys template under Classic Administrative Templates (ADM).
5.
  • In the Setting column, double-click a registry key and change the values.
  • Click OK.

Configuring Message Recalls Over Secure Connections

By default end-users cannot trigger stub recalls if they do not have access to Virtual Private Network (VPN) or Outlook Web Access (OWA).

You can configure to provide the end-user with the capability to trigger stub recalls over a secured connection if they have access to their message mailbox without accessing VPN or OWA as follows:

1. Log on to the client computer, which has IIS server installed as local Administrator or as a member of the Administrators group.  
2. Run Setup.exe from the Software Installation Package.  
3. Select the required language.

Click Next.
4. Select the option to Install Calypso on this computer.
  Your screen may look different from the example shown.
5. Select I accept the terms in the license agreement.

Click Next.
6. Expand Client Modules | Archive Management, and select Exchange WebProxy Archiver Agent.
7. If this computer and the CommServe is separated by a firewall, select the Configure firewall services option and then click Next.

For firewall options and configuration instructions, see Firewall Configuration and continue with the installation.

If firewall configuration is not required, click Next.
8. Enter the fully qualified domain name of the CommServe Host Name.

Click Next.

  Do not use space and the following characters when specifying a new name for the CommServe Host Name:

\|`~!@#$%^&*()+=<>/?,[]{}:;'"
9. Click Next.
10. Select Add programs to the Windows Firewall Exclusion List, to add CommCell programs and services to the Windows Firewall Exclusion List.

Click Next.

  This option enables CommCell operations across Windows firewall by adding CommCell programs and services to Windows firewall exclusion list.

It is recommended to select this option even if Windows firewall is disabled. This will allow the CommCell programs and services to function if the Windows firewall is enabled at a later time.
11. Verify the default location for software installation.

Click Browse to change the default location.

Click Next.
 
  • Do not install the software to a mapped network drive.
  • Do not use the following characters when specifying the destination path:

     / : * ? " < > | #

    It is recommended that you use alphanumeric characters only.
12. Click Next.
13. Click Next.
14. Click Finish.
15. Create ConnectOverHttp registry keys on to the computers where Outlook Add-In is installed to set the connectivity mode.

To mass deploy ConnectOverHttp registry key on all the computers where Outlook Add-In is installed, see Install Using AD Group Policies.
  1. Start the Registry Editor (Regedit.exe or Redegt32.exe)
  2. Locate the directory under which you want to create a key, e.g., HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\Outlook\Addins\
  3. Right click the SOFTWARE and click New -> Key. Name the key as Galaxy.Ex2KMBDM.CVEAAddin.
  4. Right click the Galaxy.Ex2KMBDM.CVEAAddin and select New -> DWORD value, name it as ConnectOverHttp.
  5. Double click ConnectOverHttp key modify the Value data to 1.
16. Create URL registry key on to the computers where Outlook Add-In is installed.

To mass deploy URL registry key on all the computers where Outlook Add-In is installed, see Install Using AD Group Policies.
  1. Start the Registry Editor (Regedit.exe or Redegt32.exe)
  2. Locate the directory under which you want to create a key, e.g., HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\Outlook\Addins\
  3. Right click the SOFTWARE and click New -> Key. Name the key as Galaxy.Ex2KMBDM.CVEAAddin.
  4. Right click the Galaxy.Ex2KMBDM.CVEAAddin and select New -> Sting value, name it as URL.
  5. Double click URL key modify the Value data to URL of the DMProxy address configured on the client where WebProxy iDA is installed.

Configure Restores from a Web Browser/Outlook

In cases where Outlook is not installed on a client computer, users can be given the ability to use the Outlook Add-In Find and Recover capability from a web browser. To provide this ability, you need to:

Once this is configured, users can access the Find and Recover functionality by typing the web URL of the CommCell Console into a supported web browser. For example, a user can access the Find and Recover functionality by typing the following URL into a web browser: http://<commserve_name/<commcell_console_alias>.

1. When installing the CommCell Console, ensure that Yes was selected when prompted for web administration.
      To support web administration, the Internet Information Server (IIS) must be installed on the computer.
2. Grant End User Search capability as follows:
  • From the CommCell Browser, click Security.
  • Right-click CommCell User Groups | New User Group.
3.
  • Type the name you want to assign to the user group (up to 32 characters; do not include trailing spaces) and some descriptive information that characterizes the user group.
  • Click Enabled.
4.
  • Click the Capabilities tab.
  • From the Available Capabilities pane, select End User Search and click > to move it under the Assigned Capabilities pane.
  • Click OK.
5.

If you want the user group to be associated with specific objects (e.g., client computer group, client computers, libraries, MediaAgents, Storage Policies), click Associated Entities.

6.

To assign users to a users group, click Users, and then assign users to the group, as necessary. You can click Create New User to create a user to be associated with this user group.

Click OK.

In order for the end-user to use Find and Recover from Outlook or a Web Browse, a Commcell Console must be configured for web based administration. By default the CommCell Console on the Commserve is used. In case an alternate server has to be used for the web application configure the following:

  1. Ensure the alternate computer contains the following:
    • The CommCell Console software installed and configured for web administration.
    • Internet Information Services (IIS) installed and enabled.
  2. From the Tools menu in the CommServe's CommCell Console, click Control Panel.
  3. From the Control Panel window, click E-Mail & IIS Configuration.
  4. Click the IIS Server tab.
  5. Click the Use Alternate IIS Web URL for Add-in checkbox.
  6. Type the path to the alternate computer's web alias. The path should be entered as follows:

    http://<alternate_computer_iis_server_name>/<web_alias>

  7. Click OK to save the information.

Configure owa proxy enabler

If you did not configure the OWA Proxy Enabler after installation, you can do so as follows:

  1. From the CommCell Browser, right-click the client computer hosting the Exchange Server.
  2. Click Properties.
  3. From the Advanced tab, select the name of the proxy client from the Proxy for Exchange list.
  4. Click OK.

Configure automatic Java Update Downloads

There are several ways to keep Outlook Add-In clients up-to-date with Java software updates as described in the following sections.

Download Java Updates Overnight

Java updates can be downloaded from the CommServe computer between 12:00AM and 6:00AM as follows:
  1. From the CommCell Browser, right-click the client computer that has Exchange Mailbox iDataAgent installed.
  2. Click Properties.
  3. Select Registry Key Settings.
  4. Click Add.
  5. Enter nGuiUpdateCheck in the Name field.
  6. Enter HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Instance<xxx>\ in the Location filed.
  7. Enter REG_DWORD in the Type filed.
  8. Enter 1 in the Value field.
  9. Click OK.

Download Java Updates at a Specific Time

Java updates can be downloaded from the CommServe computer at a specific hour and minute of the hour each day. Note, however, that if you have configured Java updates to download overnight as described above, these configurations will automatically override that setting.

Specify the Hour of the Day

  1. From the CommCell Browser, right-click the client computer that has Exchange Mailbox iDataAgent installed.
  2. Click Properties.
  3. Select Registry Key Settings.
  4. Click Add.
  5. Enter dJavaUpdateTimeHour in the Name field.
  6. Enter HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Instance<xxx>\ in the Location filed.
  7. Enter REG_DWORD in the Type filed.
  8. Enter a number between 0 and 23 in the Value field.

    For example:

    • Enter 0 to download Java updates at 12:00AM every morning.
    • Enter 13 to download Java updates at 1:00PM every afternoon.
    • Enter 23 to download Java updates at 11:00PM every evening.
  9. Click OK.

Specify the Minute of the Hour

  1. Ensure the dJavaUpdateTimeHour registry key has been configured.
  2. From the CommCell Browser, right-click the client computer that has Exchange Mailbox iDataAgent installed.
  3. Click Properties.
  4. Select Registry Key Settings.
  5. Click Add.
  6. Enter dJavaUpdateTimeMin in the Name field.
  7. Enter HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Instance<xxx>\in the Location filed.
  8. Enter REG_DWORD in the Type filed.
  9. Enter a number between 0 and 59 in the Value field.

    For example:

    • Enter 0 to download Java updates on the hour (such as 12:00AM)
    • Enter 15 to download Java updates at 15 minutes past the hour (such as 1:15PM)
    • Enter 45 to download Java updates at 45 minutes past the hour (such as 11:45PM)
  10. Click OK.

use an alternate computer for downloading java updates

If it is not desirable to obtain Java updates directly from the CommServe computer, you can configure an alternate computer to facilitate these downloads. Doing so offsets the network traffic and resources required of the CommServe to obtain the updates.

  1. Ensure the alternate computer contains the following:
    • The CommCell Console software installed and configured for web administration.
    • Internet Information Services (IIS) installed and enabled.
  2. From the Tools menu in the CommServe's CommCell Console, click Control Panel.
  3. From the Control Panel window, click E-Mail & IIS Configuration.
  4. Click the IIS Server tab.
  5. Click the Use Alternate IIS Web URL for Add-in checkbox.
  6. Type the path to the alternate computer's web alias. The path should be entered as follows:

    http://<alternate_computer_iis_server_name>/<web_alias>

  7. Click OK to save the information.

configure language options

By default, Outlook Add-In uses the language setting of Outlook. This can be changed by configuring a registry key as follows:

  1. From the CommCell Browser, right-click the client computer that has Exchange Mailbox iDataAgent installed.
  2. Click Properties.
  3. Select Registry Key Settings.
  4. Click Add.
  5. Enter UseOSLocale in the Name field.
  6. Enter iDataAgent in the Location filed.
  7. Enter REG_DWORD in the Type field.
  8. Enter 0 or 1 in the Value field as explained below:

Value

Use OS Language Setting

Use Outlook Language Setting

none No Yes
0 No Yes
1 Yes No
  1. Click OK.

configure Unique User Settings for Citrix Environments

You can configure unique settings for users in Citrix environments as described in the following sections.

Enable User Settings on the Citrix Server

The AllowPerUserSettings registry key is configured first to enable the overall functionality. Once this key is created, additional keys can then be created to provide individualized settings. All keys are created under:

[Registry_Key_Area]\SOFTWARE\Microsoft\Office\Outlook\Addins\Galaxy.Ex2KMBDM.CVEAAddin

Configure Settings for All Users

The following settings can be configured for all users on the Citrix Server. These keys are configured in the HKEY_LOCAL_MACHINE area and apply to all users logged in to the Citrix Server.

Registry Key Description
nSearchRangeDays Specifies the default number of days to search for protected messages.

Configure Settings for Individual Users

You can create customized settings for individual users logged in to the Citrix Server. These settings are configured in one of the following areas:

By default, users logged into the Citrix sever with the AllowPerUserSettings configured are assigned the registry key values that exist in HKEY_CURRENT_USER.

The following settings can be configured for individual users logged on to the Citrix Server.

Registry Key Description
UIOptions Allows changes to the current settings for the Outlook Add-In user interface options.
nEvMgrCPortNumber Specifies the network port to be used during restore operations.

Configure the Client for Java Updates During Installation

The client computer can be configured to automatically download Java updates from the CommCell Console during the software installation.

  1. From the CommCell Browser, right-click the client computer that has Exchange Mailbox iDataAgent installed.
  2. Click Properties.
  3. Select Registry Key Settings.
  4. Click Add.
  5. Enter sGUIUpdateURL in the Name field.
  6. Enter HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Instance<xxx>\ in the Location filed.
  7. Enter REG_SZ in the Type filed.
  8. Type the path to the alternate computer's web alias. The path should be entered as follows:

    http://<alternate_computer_iis_server_name>/<web_alias>

  9. Click OK.