Enterprise Vault™ Improving the Archiving Throughput of the SMTP Archiving Task

Last Published:
Product(s): Enterprise Vault (14.1, 14.0, 12.5, 12.4, 12.3, 12.2, 12.1, 12.0)

Increasing the item processor threads for the Enterprise Vault SMTP Archiving task

Currently you change the number of item processor threads by modifying a setting in the Enterprise Vault Directory database. Ensure that the Enterprise Vault configuration and data is backed up before making the changes that are described in this section.

The number of SMTP Archiving task threads must be an integer multiple of the number of CPU cores on the Enterprise Vault SMTP server. Setting the number to higher than four task threads per CPU core may slow down the interaction with the Windows GUI on the Enterprise Vault SMTP server.

In the Task table, the initial value shown for the number of threads is 0. However the default number of item processor threads created for the Enterprise Vault SMTP Archiving task is calculated as follows:

  • At Enterprise Vault 11.0.1 - Twice the number of CPU cores available on the Enterprise Vault SMTP server; so for a server with an 8-core CPU, the default number of item processor threads created is 16.

  • From Enterprise Vault 12 - Three times the number of CPU cores available on the Enterprise Vault SMTP server; so for a server with an 8-core CPU, the default number of item processor threads created is 24.

Note that these default values may change in subsequent hot fixes and releases.

To increase the item processor threads for the Enterprise Vault SMTP Archiving task

  1. On the SQL Server hosting the Enterprise Vault databases, navigate to the Directory Database > Task table.
  2. In the Task table locate the SMTP Archiving task that you want to modify.
  3. Modify the value in the column entitled "Number of Threads" to the total number of threads required. The number you enter should be a multiple of the number of CPU cores available. For example, if the SMTP server has an 8-core CPU, and 4 times the number of threads is required, change the value in the Task table to 32. If the value entered is greater than 50, the value is ignored, and the default number of item processor threads are created.
  4. Verify that the SQL table is modified.
  5. Restart the SMTP Archiving task in the Enterprise Vault site. Changes do not take effect until the task is restarted.
  6. To check that the change is applied, run DTrace on the SMTP Archiving task. In the DTrace log, look for the line "Number of processing threads created are …". Verify that the number of threads specified reflects the required number that you entered in the Directory database.