Enterprise Vault - VSE+ Training

Basic Troubleshooting
 Introduction

2 Copyright © 2019 Veritas Technologies, LLC

Introduction
This training will cover basic troubleshooting on the following topics:
• Troubleshooting Tools
• Indexing
• Storage
• Exchange Archiving
• SMTP Archiving
• File System Archiving

3 Copyright © 2019 Veritas Technologies, LLC.

 Troubleshooting Tools

4 Copyright © 2019 Veritas Technologies, LLC

Troubleshooting tools
There are several ways to troubleshoot issues with Enterprise Vault:
• Dtrace – Dtrace is a command line based tool
• Windows Event Viewer – EV generates events for many operations
• Enterprise Vault Task Reports – Tasks generate text-based reports
• Enterprise Vault Status – an Administration Console container that shows items that
need attention

5 Copyright © 2019 Veritas Technologies, LLC.

Dtrace
• Dtrace.exe is located in the Enterprise
Vault installation directory (e.g.
C:\Program Files (x86)\Enterprise Vault)
• Dtrace can monitor nearly all Enterprise
Vault processes
• Activity can be monitored directly in the
utility with the ability to log the output to
a text file
• The resulting log files can be opened with
a text editor such as notepad.exe.

6 Copyright © 2019 Veritas Technologies, LLC.

Windows Event Viewer
• Enterprise Vault creates its own container in the Windows Event Viewer
• Information, warnings, and errors are logged

7 Copyright © 2019 Veritas Technologies, LLC.

Task Reports
• When an archiving task
completes, it generates a report
file
• These reports are located in the
<installation_directory>\Reports\
<task_type>\<task_name>
• Reports can be opened with a
text editor such as notepad.exe

8 Copyright © 2019 Veritas Technologies, LLC.

Enterprise Vault Status
• Enterprise Vault Status is part of the
Enterprise Vault Administration
Console (VAC)
• Items listed in Status generally require
the attention of the administrator
• Each item listed has a “How to fix” link
that guides the administrator on how
to solve the issue

9 Copyright © 2019 Veritas Technologies, LLC.

 Indexing

10 Copyright © 2019 Veritas Technologies, LLC

Indexing
There are may ways to diagnose indexing issues
• Dtrace – Monitor the following processes:
– EVIndexQueryServer
– EVIndexVolumeProcessor
– IndexBroker
– IndexServer

• Windows Event Viewer – look for the following Task Categories

– Index Query Server
– Index Admin Service
– Index Volumes Processor

11 Copyright © 2019 Veritas Technologies, LLC.

Indexing (cont.)
• Ensure that the Enterprise Vault Indexing
Service is started
• If a search fails on an archive, ensure that
the index volumes for the archive are not
offline or in a failed state. The
“Troubleshoot index volume errors” link
provides additional help (as shown in the
screenshot).
• If an index needs to be repaired or rebuilt,
use the Manage Indexes utility in the VAC
• Ensure Index Locations are online, open,
and not in Backup Mode if writes are failing

12 Copyright © 2019 Veritas Technologies, LLC.

 Storage

13 Copyright © 2019 Veritas Technologies, LLC

Storage – Dtrace
Dtrace can be used to troubleshoot storage issues. Monitor the following processes:
• StorageArchive
• StorageCrawler
• StorageDelete
• StorageFileWatch
• StorageManagement
• StorageOnlineOpns
• StorageRestore
• StorageServer
• Also monitor any associated archiving tasks

14 Copyright © 2019 Veritas Technologies, LLC.

Storage – Windows Event Viewer
For Windows Event Viewer, look for the following Task Categories:
• Storage Crawler
• Storage Delete
• Storage File Watch
• Storage Management
• Storage Server

15 Copyright © 2019 Veritas Technologies, LLC.

Storage – Vault Stores/Vault Store Partitions
• Is there an open partition for the Vault Store?
• Is the partition full?
• If migrating content to secondary storage, is the secondary storage online/accessible?
• Are the Vault Store Group and Vault Store databases online on the Microsoft SQL
Server?

16 Copyright © 2019 Veritas Technologies, LLC.

 Exchange Archiving

17 Copyright © 2019 Veritas Technologies, LLC

Exchange Archiving - Dtrace
• Dtrace – there are numerous processes that can be monitored. Some of the more
critical processes are:
– JournalTask
– ArchiveTask
– PublicFolderTask
– PSTCollectorTask
– PSTLocatorTask
– PSTMigratorTask

18 Copyright © 2019 Veritas Technologies, LLC.

Exchange Archiving – Task Reports
There are four main task report folders to examine:
• Exchange Journal
• Exchange Mailbox Archiving
• Exchange Provisioning
• Log files for the PST Collector, PST Locator, and PST Migrator tasks are stored in the
root of the Reports directory

19 Copyright © 2019 Veritas Technologies, LLC.

Exchange Archiving – Windows Event Viewer
The following Task Categories can be examined in Windows Event Viewer:
• Archive Task
• Journal Task
• JournalMailboxManager
• PST Locator Task/PST Collector Task/PST Migrator Task
• Public Folder Task
• Exchange Provisioning Task

20 Copyright © 2019 Veritas Technologies, LLC.

Exchange Targets
• Is the Exchange target set up correctly?
– Domain configured?
– Exchange server(s) defined?
– Public Folder targets defined?
– Have the EV system mailboxes been configured on
the Exchange server(s)?
– Has the target journal mailbox been configured?

• Have provisioning groups been configured?

– Have the correct users been added to at least one
provisioning group?
– Are groups ordered correctly to ensure that users are
receiving the correct archiving settings?

21 Copyright © 2019 Veritas Technologies, LLC.

Exchange Tasks
• Have tasks been created?
• Do mailbox, public folder, and PST archiving tasks have a defined schedule and are
they enabled?
• Is the Exchange Provisioning Task set to run at least once per day?

22 Copyright © 2019 Veritas Technologies, LLC.

Outlook/OWA
• Is Vault Cache set up correctly for the user? Does the user’s system have sufficient
disk space for Vault Cache?
• Does the user have connectivity to the Enterprise Vault server to recall shortcuts in
the mailbox?
• Has the user been enabled for mailbox archiving?
• Have the Enterprise Vault OWA extensions been configured on the Exchange CAS
server(s)?

23 Copyright © 2019 Veritas Technologies, LLC.

 SMTP Archiving

24 Copyright © 2019 Veritas Technologies, LLC

SMTP Archiving – Dtrace/Windows Event Viewer
• For Dtrace, monitor the following process:
– EVSMTPTask

• For Windows Event Viewer, look for the following Task Categories:
– SMTP Archiving Task
– SMTP Provisioning Task
– SMTP Service

25 Copyright © 2019 Veritas Technologies, LLC.

SMTP Archiving – Services and Tasks
• Ensure that the Enterprise Vault SMTP Service is started
• Ensure that the SMTP Archiving and SMTP Provisioning Tasks are running
• Monitor the report folders for the SMTP and SMTP Provisioning tasks
• If changes to SMTP archiving have been made (such as policy changes or adding new
SMTP targets) ensure that the SMTP Service and SMTP tasks have been restarted

26 Copyright © 2019 Veritas Technologies, LLC.

SMTP Targets
• Is the SMTP journaling target email
address routable to the Enterprise Vault
server?
• If performing selective SMTP mailbox
journaling, ensure the Site advanced
setting for Selective Journal Archiving is
configured
• Have SMTP Provisioning groups been
configured correctly?
• Enable SMTP tracking to troubleshoot
mail routing issues

27 Copyright © 2019 Veritas Technologies, LLC.

 File System Archiving

28 Copyright © 2019 Veritas Technologies, LLC

File System Archiving – Dtrace/Windows Event Viewer
• The following Dtrace processes can be monitored:
– EV Server
• FSAUtility – used in conjunction with FSAUtility.exe
• FSARunNow
• FSAReportingService/FSAReporting Utility
– Target
• EvPlaceholderService
• FSAReportingService/FSAReportingUtility

• Monitor the File System Archiving Task category in Windows Event Viewer

29 Copyright © 2019 Veritas Technologies, LLC.

File System Archiving – Task and Logs
• Has an FSA task been created? Does it have a
schedule?
• The File System Archiving task and the FSAUtility
application create logs in the Reports folder on
the Enterprise Vault Server

30 Copyright © 2019 Veritas Technologies, LLC.

File System Archiving Targets
• Have FSA targets been configured properly with volume and folder targets?
• Does the Enterprise Vault Service Account (VSA) have the necessary permissions on
the target file server?
• Have Archive Points been created?
• If placeholders will be used, has the FSA agent been installed on the necessary
servers?

31 Copyright © 2019 Veritas Technologies, LLC.

 Thank you!

Copyright © 2019 Veritas Technologies, LLC. All rights reserved. Veritas and the Veritas Logo are trademarks or registered trademarks of Veritas Technologies or its affiliates
in the U.S. and other countries. Other names may be trademarks of their respective owners.
This document is provided for informational purposes only and is not intended as advertising. All warranties relating to the information in this document, either express or
implied, are disclaimed to the maximum extent allowed by law. The information in this document is subject to change without notice.