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.

Option 1 - ADMX with GPO Deployment

  • Last updated on

This article refers to the Barracuda Message Archiver firmware version 5.1.x; the PST Collector is not available in firmware release 5.2 and newer.

Use this article to configure the Barracuda PST Collector Client using the Administrative template (ADMX) and deploying through Group Policy (GPO). This is the recommended method for deploying the PST Collector. For additional deployment options, refer to the Barracuda PST Collector Deployment Options.

In Barracuda Message Archiver version 4.0 and higher, ADMX files replace ADM files. ADMX files are divided into a language-neutral ADMX template and locale-specific ADML resources, and are incorporated when editing Administrative Template policy settings. For a thorough understanding of administering ADMX files, review the Microsoft Developer Network article Managing Group Policy ADMX Files Step-by-Step Guide.

The Barracuda Message Archiver can enable a local SMB/CIFS share called BarracudaMessageArchiverPstDrop to use for uploading .pst files for archiving. You must open ports 139 and 445 to the Barracuda Message Archiver to use PST Import via a SMB/CIFS share.

When the Barracuda PST Collector submits a PST file to the Barracuda Message Archiver, the user's security identifier (SID), obtained from the Windows User Profile, is collected and stored. If no user SID is available at the time the PST is sent to the PST Server, automatic user assignment is not performed. However, if PST auto-assignment is unavailable, the administrator can manually assign a PST to an active AD user by right-clicking on the PST file in the BASIC > Search page in the PSTs & Tags tab. Note that auto-assignment occurs only if:

  • The PST file is owned by a domain user at the file system level
  • The PST file is located somewhere in a profile directory of a domain user

Important
All new installations require some initial synchronization tasks to be performed between the Microsoft Exchange Server and the Barracuda Message Archiver. These tasks, including the direct import of messages, stubbing, and folder synchronization, can take a fair amount of time to complete. The Barracuda Message Archiver prioritizes these tasks over processing collected PST files. Therefore, to reduce network traffic as well as potential load on the Barracuda Message Archiver, and to ensure that even the newest PST files are imported, it is highly recommended that PST collection begin after all such initial integration tasks are complete.

There is a 100MB limit per mail item when importing from a PST file.

Enable PST Collection on the Barracuda Message Archiver

Use the following steps to enable PST collection on the Barracuda Message Archiver:

  1. Log in to your Barracuda Message Archiver as the administrator, and go to MAIL SOURCES > PST Import.
  2. In the PST Import Options section, set Enable PST Collector to Yes. Note that this feature does not require Enable Local SMB Share for PST imports to be enabled as the PST Collector uses a separate import directory.
  3. Click Save.

Install the Barracuda PST Collector Server

Use the following steps to install and configure the Barracuda PST Collector Server:

  1. Log in to your Barracuda Message Archiver as the administrator, and go to USERS > Client Downloads from a Microsoft Windows-based system in your environment that can be reached by all the systems on which the client application is to be deployed.

    Note that this does not need to be an actual server and needs no special configuration; you can even use a virtual machine (VM) to function as the server.

  2. In the PST Collector section, click Download Now to download the BarPstColelctor.msi file to your system.
  3. Double-click the .msi file, and click run launch the Barracuda PST Collector Server Setup Wizard:
    LaunchWizard.png
  4. Click Next, and follow the onscreen instructions to install the deployment kit which includes:
    • 64-bit Outlook Installer (BarPstColClient-version_x64.msi)
    • 32-bit Outlook Installer (BarPstColClient-version_x86.msi)
    • Administrator module (includes ADMX files and locale-specific ADML files)
  5. In the final Wizard page, verify Configure Barracuda PST Collector Now is turned on:
    FinishWizard.png
  6. Click Finish. The Initial Configuration dialog displays.
  7. Enter the hostname (not the URI) of your Barracuda Message Archiver, for example, archiver.company.com, and select the desired import policy for PSTs:
    • Automatic – All PSTs are approved for transfer without any further interaction from a system administrator. Recommended.
    • Manual – A PST is approved for transfer only if that PST has been manually marked for transfer using the Admin Console. This setting always requires administrative input as each discovered PST file must be explicitly marked for import. This setting is typically used for importing only specific PST files, manually prioritizing specific PST files over others, or during testing of the Barracuda PST Collector in your environment.
    • Scheduled – A PST is approved for transfer only if the request occurs within a configured time window. This setting is typically used to restrict PST transfers to a specified time period when there is less traffic, such as after business hours.
      configuration.png 
  8. To collect only PST files that are owned by domain users, select Collect only owned PST files. Click OK to save your configuration. 

Configure the Barracuda PST Collector Client

Use the following steps to configure the Barracuda PST Collector Client.

  1. While still logged in to your Barracuda Message Archiver as an administrator, navigate to the USERS > Client Downloads page, and download the PST Collector. The Server MSI installs both the 32-bit and 64-bit client installers and the Barracuda PST Collector.ADMX file into a subdirectory of the application directory in a folder Clients. For example, C:\Program Files\Barracuda\Message Archiver\PST Collector\Clients. This directory is linked from the Start menu.
  2. Move (or copy) the Barracuda PST Collector.ADMX file and folder with necessary language files, for example EN-US, to the C:\Windows\SYSVOL\domain\Policies\PolicyDefinitions directory.
  3. Start the Group Policy (GPO) Editor, and navigate to Configuration > Administrative Templates > Barracuda > Message Archiver > PST Collector.
  4. Expand Message Archiver, and click PST Collector:
    newphotoforcollectordeploy.png
  5. In the center pane, double-click Barracuda PST Collector Server; the Properties window displays.
  6. In the Server Hostname field, enter the hostname (not the URI) of the system where the Barracuda PST Collector Server is installed; this is not the hostname of the Barracuda Message Archiver. Note that the hostname must be resolvable and the system must be accessible by all machines on which the Barracuda PST Collector Client is to be deployed.
    For example, enter: pstcolserver.domain.local

Create the Software Deployment Policy

  1. Copy the .msi file(s) to a location or file share accessible to users.
  2. Open the Group Policy Management Editor for the organizational unit (OU) that is to use the Barracuda PST Collector, e.g., the default domain policy.
  3. Either 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 on which the Barracuda PST Collector Client is to be installed.
  4. In the Group Policy Management Editor, expand Computer Configuration > Software Settings > Software Installation.
  5. Right-click Software Installation, and click New > Package.
  6. Enter the UNC path to the .msi file located in the shared folder. For example, enter: \\fileserver\deploy
  7. Click OK.

32- and 64-Bit Mixed Deployment Only
If you are deploying the Barracuda PST Collector to both 32- and 64-bit systems running in your environment, you must install both the 32- and 64-bit client MSIs and configure the 32-bit MSI to be unavailable to 64-bit systems using the following steps:

  1. While in the Group Policy Management Editor, navigate to Computer Configuration > Policies > Software Settings, and click Software Installation.
  2. Right-click Barracuda PST Collector, and click Properties:
    ServerSetup01.png
  3. Click the Deployment tab, and click Advanced. In the Advanced deployment options section, turn off Make this 32-bit X86 application available to Win64 machines:
    adv deployment.jpg
  4. Click OK to save your settings, and click OK to close the Properties window.

Verify Barracuda PST Collector Client Installation

Use the following steps to verify that the Barracuda PST Collector Client is installed and registered on all clients.

  1. Restart the client system and verify the software installation policy has taken effect. The Barracuda PST Collector Client should be installed when you log in, with the import policies configured on the Barracuda PST Collector Server already in place, as well as the group policy created via the ADMX file in place.
  2. Group policies can take several minutes to post; if a system is not listed and you have used the Group Policy Management Editor to install the Barracuda PST Collector Client, run the following command to perform an immediate update:
    gpupdate /force
    Run this command on both the GPO Management and client side. Once you run the command, restart the client system.
  3. On the system where the Barracuda PST Collector Server is installed, go to Start > Programs > Barracuda > Message Archiver > PST Collector to open the PST Collector Admin Console.
  4. From the Reports menu, click Registered Clients; a window displays a list of all systems currently running a Barracuda PST Collector Client configured to connect to the PST Collection Server:
    RegisteredClients.png
  5. Restart the client system and verify the software installation policy has taken effect. The Barracuda PST Collector Client should be installed when you log in, with policies as configured on the Barracuda PST Collector Server already in place.
  6. Group policies can take several minutes to post; if a system is not listed and you have used the Group Policy Management Editor to install the Barracuda PST Collector Client, run the following command to perform an immediate update:
    gpupdate /force
  7. Once you run the command, restart the client system.
    Refresh the Registered Clients display on the Barracuda PST Collector Server, and verify the restarted system is registering correctly.

    Additional information on fixing GPO issues is available from the Microsoft TechNet article Fixing Group Policy problems by using log files.

Monitor and Verify PST Collection

Use the following steps to monitor and verify PST collection.

  1. On the system where the Barracuda PST Collector Server is installed, open the Admin Console (Start > Programs > Barracuda > Message Archiver > PST Collector).
  2. From the Reports menu click Import Progress:
    ImportProgress.png
  3. A window displays the number and size of the PST files that:
    • were discovered;
    • have completed transfer to the Barracuda Message Archiver;
    • are in the midst of a transfer;
    • are awaiting transfer;
    • are in some way corrupted.
  4. Once imports are no longer in progress, verify that the number and size of the completed PST files are as expected in the PST Collector Admin Console:
    console.png
  5. If there are PST files that failed to complete due to corruption or other errors, return to the main Admin Console window. From the View menu select Filter, and click Show Corrupt. A list of all such PST files displays in the main window along with detailed information including the owner, the originating client system, and creation and last modification dates. Independent investigation may be necessary for each PST file that failed to import as there can be a variety of reasons for the failure including (but not limited to):
    • the client system does not have, or does not allow, adequate access to the PST file location;
    • the PST file is too large for transfer;

    • the PST file is still in use.

      Error messages are found in various logs on the client system including those in the installation directory. If you are unable to find a cause for the PST import errors, contact Barracuda Networks Technical Support for further assistance.

Assigned and Unassigned PST Files

When the Barracuda PST Collector submits a PST file to the Barracuda Message Archiver, the user's security identifier (SID), obtained from the Windows User Profile, is collected and stored.

If no user SID is available at the time the PST is sent to the PST Server, automatic user assignment is not performed. However, if auto-assignment cannot be made, the administrator can manually assign a PST to an active AD user by right-clicking on the PST file in the BASIC > Search page in the PSTs & Tags tab.

The Administrator can assign a PST to a local user. Note that PST assignment allows visibility of the PST and access to folder names. Visibility of individual emails within the PST is still governed by the local user's email address and configured mail aliases, and email access is governed by these items being present in the mail headers.

Once a PST file is assigned to a user, the user can select and search PST folders and search inside PST files one at a time.

Once a PST file is enabled for processing, if the SID is resolvable via the configured LDAP source, the PST file is assigned to the appropriate user based on the LDAP lookup, and displays in the Assigned PSTs folder in the BASIC > Search page in the PSTs & Tags tab. If the SID cannot be resolved through LDAP lookup, the PST file is processed but is not assigned to a user. The PST file displays in the Unassigned PSTs folder in the BASIC > Search page in the PSTs & Tags tab.

Emails processed from an 'unassigned' PST file are available in the Search page and are available to both the Message Archiver administrator and to any user whose email address or aliases are included in the email headers.

Manually Assign PST Files

To manually assign an unassigned PST file to a user already displayed in the Assigned PSTs folder, use the following steps:

  1. Log in to the Barracuda Message Archiver as the administrator, and go to the BASIC > Search page.
  2. Click the PSTs & Tags tab, and open the Unassigned PSTs folder.
  3. Click on the unassigned PST and drag it to a user name listed in the Assigned PSTs folder.

To manually assign the PST file to a user not displayed in the Assigned PSTs folder, use the following steps:

  1. Log in to the Barracuda Message Archiver as the administrator, and go to the BASIC > Search page.
  2. Click the PSTs & Tags tab, navigate to and right-click the PST file to assign, and then click Assign PST.
  3. In the Assign PST dialog box, enter at least three characters of the email address to which to assign the PST.
  4. The Search for User field populates with all matching users; click on the user to which to assign the PST file, and click OK.

Verify Import of all Transferred PST Files

Use the following steps to confirm that all PST files are correctly transferred to the Barracuda Message Archiver, and verify that the contents of each PST file has been extracted and imported into the archive.

  1. Log into the Barracuda Message Archiver, and navigate to the MAIL SOURCES > PST Import page.
  2. In the Recent PST Imports section, verify the status for all listed PST files displays as Completed:
    recent imports36.png 
  3. For any listed file, including files that did not complete, click the View Log link to display a log of what transpired during the import, or click the Report link to view a summary of the imported data.

Generate and Save a PST Collection Activity Report

  1. On the system where the Barracuda PST Collector Server is installed, and go to Start > Programs > Barracuda > Message Archiver > PST Collector to open the PST Collector Admin Console.
  2. From the File menu, click Export Discovered PST Data.
  3. Select the name and location where you want to store the data displayed in the main window. The file is saved in CSV format, suitable for reading by Microsoft Excel or similar program.

Uninstall the Barracuda PST Collector

Use the following steps to uninstall the Barracuda PST Collector from the client systems and server:

  1. Using the Group Policy Management Editor, uninstall the Barracuda PST Collector Client from all systems to which it was deployed.
  2. Uninstall the Barracuda PST Collector Server from the system where it was installed, typically via the Add or Remove Programs utility.
Last updated on