Enterprise Vault™ Setting up File System Archiving (FSA)

To configure file system filter registry settings

1. On the Enterprise Vault server, start Regedit and navigate to the following location in the registry:

   HKEY_LOCAL_MACHINE
    \SOFTWARE
     \Wow6432Node
      \KVS
       \Enterprise Vault
        \External Filtering
         \File System

   If either External Filtering or File System keys do not exist, then create them.

2. Create a new string entry for each custom filter under the File System key. Filter names must be an unbroken numbered sequence starting at 1.

   For the value of a custom filter setting enter a string value that contains the name of the .NET assembly, and the fully-qualified filter class name of the new external filter:

   PathToFilterAssembly!FilterClassName

   A fully-qualified class name includes the namespace. For example, if the class name is CustomFilter, the namespace is Veritas.EnterpriseVault.FileSystem, and the filter is implemented in Veritas.EnterpriseVault.FileSystemCustomFilter.dll assembly, then the value of the registry setting should be as follows:

   Veritas.EnterpriseVault.FileSystemCustomFilter.dll!
   Veritas.EnterpriseVault.FileSystem.CustomFilter

   Note that the class name is case-sensitive.

3. If you change the registry settings during an archiving run, you need to restart the associated File System Archiving task to implement the changes.

To configure entries in EVFSAArchivingTask.exe.config

1. Take a back-up copy of the file, Enterprise Vault\EVFSAArchivingTask.exe.config, and then open the file for editing.
2. Add a section called <FSAFilter> to hold the settings. This section must also be declared in the <configSections> element. For example,

   <configSections>
      <section name="FSAFilter" 
         type="System.Configuration.DictionarySectionHandler"/>
   </configSections>
   <FSAFilter> 
   </FSAFilter> 
   

3. Add one or both of the entries, MoveOnFilterFailure and MaxFilterError, as required. The entries must be in the form:

   <add key="name" value = "value"/>

   Entries can take the following values:

   • MoveOnFilterFailure. "0" (default), or "1". If the setting value is "0", then the archiving task stops if it cannot load a filter. If the setting value is "1", then the archiving task loads the next filter, or continues to archive.

   • MaxFilterError. Integer (default 100). The maximum number of filter errors permitted before the archiving task stops.

   The following example shows the file with the settings added:

   <?xml version="1.0" encoding="utf-8"?>
   <configuration>
      <configSections>
         <section name="FSAFilter" 
         type="System.Configuration.DictionarySectionHandler"/>
      </configSections>
      <FSAFilter> 
         <add key="MaxFilterError" value = "150"/>
         <add key="MoveOnfilterFailure" value = "1"/>
      </FSAFilter> 
      <runtime>
         <generatePublisherEvidence enabled="false"/>
      </runtime>
   </configuration>
   

   The settings in this example file have the following effect:

   • key="MaxFilterError" value = "150" - The archiving task will stop if more than 150 filtering errors are reported.

   • key="MoveOnfilterFailure" value = "1" - If the archiving task cannot load a filter, it will try to load the next filter, or continue to archive.