We use cookies on our website to ensure we provide you with the best experience on our website. By using our website, you agree to the use of cookies for analytics and personalized content.This website uses cookies. More Information
It seems like your browser didn't download the required fonts. Please revise your security settings and try again.

Barracuda Cloud Archiving Service

Barracuda Outlook Add-In Deployment

  • Last updated on

This article refers to the Barracuda Cloud Archiving Service and the Barracuda Outlook Add-In. For best results, download the latest version from the Users > Client Downloads page. The Outlook Add-In supports Outlook versions 2010, 2013, and 2016.

ADMX files require Windows Server 2008 or higher. For details on using ADMX files with earlier versions of Windows Server, see the Microsoft TechNet article Managing Group Policy ADMX Files Step-by-Step Guide.

Download the Barracuda Outlook Add-In

To download the latest version of the Barracuda Outlook Add-In:

  1. Log in to https://login.barracudanetworks.com using your Barracuda Cloud Control credentials, and click Archiver in the left pane.
  2. Go to Users > Client Downloads, and scroll to the Microsoft Outlook Add-In section.
  3. Click Download Now to the right of Outlook Add-In Deployment Kit.

Locale

The language for the Barracuda Outlook Add-In options is determined by your Microsoft Office installation locale. Supported languages for the add-in include:

  • DE - German
  • EN - US English
  • ES - Spanish (Continental)
  • FR - French
  • IT - Italian
  • JP - Japanese
  • NL - Dutch
  • PL - Polish
  • CN - Chinese

Step 1. Install the Deployment Kit

Use the following steps to install the Barracuda Outlook Add-In Deployment Kit.

  1. Log in to the Barracuda Cloud Archiving Service as an administrator.
  2. Navigate to the Users > Client Downloads page, and in the Microsoft Outlook Add-In section, click Download Now to the right of Outlook Add-In Deployment Kit to download the BMAOutlookAddInDeploy.msi file.
  3. Run the.msi file to launch the Barracuda Outlook Add-In Deployment Kit Wizard.
  4. Follow the onscreen instructions to install the deployment kit including the ADMX files and local-specific ADML files.
  5. On the Domain Controller, copy all ADMX files to the C:\Windows\SYSVOL\$Domain\Policies\PolicyDefinitions directory, where $Domain is your domain, and copy all ADMX files to the appropriate sub-directories. For more information, refer to the Microsoft TechNet article Managing Group Policy ADMX Files Step-by-Step Guide.

Step 2. Configure the Outlook Add-In

  1. Start the Group Policy (GPO) Editor for the domain where you will be installing the Add-In. You can edit the default policy or create a new policy object and link it to the desired container, for example, the particular OU containing the computers of users that will be using the Add-In.

  2. In the GPO Editor, navigate to User Configuration > Policies > Administrative Templates, and expand the Outlook Add-In node.

  3. Double-click the Barracuda Message Archiver policy URI, and select Enabled.
  4. In the Options section, enter your region-specific MAS hostname, for example: mas.barracudanetworks.com

    See Data Centers by Region for region-specific MAS hostnames.

     

  5. Turn on Require Users to Use Configured URL.
  6. Click Apply. Configure other settings as required, and then click OK to configure the policy. For an explanation of the available settings, click the Extended tab in the policy.

Step 3. Deploy the MSI File

Windows Server 2003 Deployment
If you are deploying the Outlook Add-In from Windows Server 2003, you must disable User Account Control (UAC) on the client workstations because UAC is not supported in Windows Server Group Policy (GPO) deployments prior to Windows Server 2008. If UAC is not disabled, you will encounter an error similar to the following:

Module C:\Windows\systems32\BmaAddIn40.dll failed to register. HRESULT -2147023782. contact your support personnel

For more information on managing UAC through GPO, refer to the Microsoft Knowledgebase article UAC Group Policy Settings and Registry Key Settings.

  1. If you do not already have a network share for GPO software deployment, you must create one. The share must be accessible from all of the machines on which the software is to be deployed. The permissions for the share must give read access to the Everyone group, and the permissions for the underlying NTFS folder must give read access to the Authenticated Users group.

    The software is installed by the machines themselves rather than by users, and machines are not members of the Everyone group, therefore this modification to the default permissions is required.

  2. Copy the .msi file(s) to the share you created in the previous step.
  3. Open the GPO Editor for the organization that is to use the Barracuda Outlook Add-In, for example, the default domain policy.

  4. Either edit the default policy, or create a new policy object, then link it to the desired container. For example, the particular OU containing the computers on which the add-in is to be installed.

    For Windows Server 2008, in order to create and edit domain-based GPOs with the latest Group Policy settings using ADMX files, you must have a Windows Server 2008 domain name resolvable through a DNS Server.

  5. In the GPO, navigate to Computer Configuration > Policies > Software Settings > Software Installation:
    gpo.png
  6. Right-click Software Installation, point to New, and click Package:
    gpo_new_package.png
  7. Enter the UNC path to the. msi file located in the shared folder. For example, enter: \\fileserver\deploy
  8. Click Open. In the Deploy Software dialog box, click Assigned:
    gpo_assigined.png
  9. Click OK. The policy displays in the GPO Editor window:
    GroupPolicy.png

Deploy the Add-in to Machines with 64-bit Windows and 32-bit Outlook

If any of the machines in your environment have a 64-bit version of Windows installed but are using a 32-bit version of Outlook, you must deploy the 32-bit MSI to these machines. If you are also deploying the 64-bit MSI for machines with both 64-bit Windows and 64-bit Outlook, both software deployment policies will apply to the machines with 32-bit Outlook, which will result in both MSIs being installed on these machines. Since Outlook only loads the add-in that matches its bitness, this should not cause any problems.

  1. In the GPO Editor, navigate to Computer Configuration > Policies > Software Settings, and click Software Installation. 
  2. Right-click the 32-bit Barracuda Outlook Add-In, and click Properties.
  3. Click the Deployment tab, and click Advanced. In the Advanced deployment options section, select Make this 32-bit X86 application available to Win64 machines:
    gpo_advanced.png
  4. Click OK. In the Properties dialog box, click Apply, and click OK to save your settings and close the dialog box.

Step 4. Test the Deployment

Complete the following steps to test the Outlook Add-In deployment.

Group Policy updates can take several minutes to post; run gpupdate /force in PowerShell on both the server and client to perform an immediate update.

  1. Restart a computer that is joined to the domain.
  2. Verify that the Add-In is installed when you log in and that the configured policies are applied.

Step 5. Notify Users

Once the MSI file is successfully deployed, send the Outlook Add-In access details to your users. For additional resources, refer to the following Campus articles:

Troubleshooting

Following is a list of troubleshooting tips:

  • A common cause of failure is that the user and/or the user's computer does not have adequate access to the share location. Verify that all access and network privileges are configured appropriately.
  • Verify you are running the latest version of the Barracuda Outlook Add-In.
  • Verify that the software deployment policy defined in Step 3. Deploy the MSI File was created for computers, not users, and that Assigned was selected in the Deploy Software dialog box.

  • Additional error messages are available in the Event Log on the domain computer; if you do not find the desired information in the Event Log, consider enabling verbose logging and restarting the computer.
  • For additional information on fixing Group Policy issues, see Fixing Group Policy problems by using log files on the Microsoft TechNet website.
Last updated on