Veritas Enterprise Vault™ Classification

Last Published:
Product(s): Enterprise Vault (12.1)
  1. About this guide
    1.  
      Introducing this guide
    2. Where to get more information about Enterprise Vault
      1.  
        Enterprise Vault training modules
  2. Getting started
    1.  
      About classification
    2.  
      Overview of the procedure for setting up classification
    3.  
      Prerequisites for classification
    4.  
      Roles-based administration (RBA) and the classification feature
    5. How Enterprise Vault caches the items that it submits for classification
      1.  
        Limits on the size of classification files
      2.  
        Checking the cache location on the Enterprise Vault storage servers
      3.  
        Configuring Enterprise Vault to keep the classification files in the cache folder
  3. Setting up the classification properties
    1.  
      About the Enterprise Vault classification properties
    2.  
      Setting up the Enterprise Vault classification properties manually
    3.  
      Checking the Folder Usage classification property
    4.  
      How classification property values and retention categories interact
    5.  
      Setting up new values for the Enterprise Vault classification properties
    6.  
      Points to note on setting retention categories
  4. Configuring your classification rules
    1.  
      About classification rules
    2.  
      About the example classification rules
    3.  
      Importing the example rule set
    4.  
      Creating or changing classification rules
    5.  
      Supported configuration parameters for rules that use the Veritas Information Classifier method
  5. Defining and applying classification policies
    1.  
      About classification policies
    2.  
      Defining classification policies
    3.  
      About the PowerShell cmdlets for working with classification policies
    4.  
      Associating classification policies with retention plans
    5.  
      About the PowerShell cmdlets for working with retention plans
    6.  
      Applying retention plans to your Enterprise Vault archives
  6. Running classification in test mode
    1.  
      About classification test mode
    2.  
      Implementing classification test mode
    3.  
      About the PowerShell cmdlets for running classification in test mode
    4.  
      Understanding the classification test mode reports
  7. Publishing classification properties and rules across your site
    1.  
      How to publish the classification properties and rules
  8. Appendix A. Enterprise Vault properties for use in classification rules
    1.  
      About the Enterprise Vault properties
    2.  
      System properties
    3.  
      Attachment properties
    4.  
      Custom Enterprise Vault properties
    5.  
      Custom Enterprise Vault properties for File System Archiving items
    6.  
      Custom Enterprise Vault properties for SharePoint items
    7.  
      Custom Enterprise Vault properties for Compliance Accelerator-processed items
    8.  
      Custom properties for use by policy management software
    9.  
      Custom properties for Enterprise Vault SMTP Archiving
  9. Appendix B. PowerShell cmdlets for use with classification
    1.  
      About the classification cmdlets
    2.  
      Get-EVClassificationPolicy
    3.  
      New-EVClassificationPolicy
    4.  
      Remove-EVClassificationPolicy
    5.  
      Set-EVClassificationPolicy
    6.  
      Import-EVClassificationRules
    7.  
      Publish-EVClassificationRules
    8.  
      Get-EVClassificationTags
    9.  
      Get-EVClassificationTestMode
    10.  
      Set-EVClassificationTestMode
  10. Appendix C. Troubleshooting and performance monitoring
    1.  
      Troubleshooting classification
    2.  
      Checking the classification performance counters

Troubleshooting classification

The following issues may arise when you use the classification feature.

Table: Potential classification issues

Issue

Explanation/solution

Enterprise Vault fails to classify items.

Ensure all of the following:

  • The File Server Resource Manager service is running and correctly configured.

  • You have a valid license for the Enterprise Vault retention feature.

  • The correct classification rules are in place.

  • You have correctly configured the retention plan and classification policy for the target archives. Each archive must have an associated retention plan that has a classification policy.

  • You are running classification in normal mode rather than test mode.

In addition, check the Application event log. If the File Server Resource Manager returns an error when it evaluates a classification rule, an Error event may provide an explanation. For example, event 41620 may indicate an invalid Veritas Information Classifier rule.

You may also want to examine the files in the classification cache folder.

Items are not classified as you expect.

Try the following:

  • Ensure that Enterprise Vault is classifying items (see above).

  • If Enterprise Vault does classify items but the resulting tags do not persist, check whether classification is running in test mode.

  • Run the PowerShell cmdlet Get-EVClassificationTags to identify the rules that each item matches.

  • Configure Enterprise Vault to keep the classification files instead of automatically deleting them.

    Then you can review the file contents for any anomalies that you did not anticipate.

  • If you use the Veritas Information Classifier to classify items, run the DTrace utility against the fsdmhost process to determine why a rule does not match.

    For guidelines on running DTrace, see the Utilities guide.

Classification operates in test mode only.

You have associated one or more classification policies with one or more retention plans, but Enterprise Vault cannot detect a valid license for the retention feature.

Timeouts occur during classification.

In Windows Server 2012 R2, the File Classification Infrastructure has a default timeout of 10 minutes. If a rule is particularly complex, this timeout is reached and Error event 12351 is logged in the Application event log. Enterprise Vault makes four more attempts to classify the item and then records Error event 29075 in the Veritas Enterprise Vault event log ("Failed to classify item content").

To resolve this issue, simplify the rules that are responsible for the timeouts.

Note:

Timeouts do not occur in Windows Server 2012 Original Release, so classifying complex rules can theoretically take many hours to process. This can affect system performance because the process is CPU-intensive. For this reason we recommend that you run Windows Server 2012 R2 on all Enterprise Vault servers.