Troubleshooting Your Veritas Vault Connector

Running the Mailbox Load

No mailboxes appear: One or more of the Connection Connection defines the how Connectivity Hub connects to your Source System (which contains your documents, graphics, etc.,). Your Connection includes identifying elements such as: URL of the BA Insight web service connector you are using, (File Share connector, SharePoint Online connector, etc.), Authentication mode, User Accounts and Credentials, Database information (for database connectors) settings has invalid data.

Solution

  1. Connections > MailBox/Datastore Options.
  2. Check the following fields and ensure they have valid data:
  3. Save: Click Save.
  4. Mailbox Load: Run.

Invalid Type Specified Exception

When I view the log, I see an error like this:

Exception.Thrown:System.ApplicationException: GetAvailableDatastores:An expression of nonboolean type specified in a context where a condition is expected, near&#39;)&#39;. <br>&nbsp;&nbsp;&nbsp;at

SPWorks.Search.Service.MailboxLoadJob.LoadMailboxes(

An invalid Custom SQL Filter was entered on the Connections page.

Solution

  1. Connections > MailBox/Datastore Options.
  2. Custom SQL Filter: Click and update this field with valid data.
  3. Save: Click Save.
  4. Mailbox Load: Run.

Unknown Error Exception

When I run a Mailbox Load task, I get an Exception Loading Mailboxes error.

When I click View Log, I see an error, like this:

Exception Thrown:System.ApplicationException: GetAvailableDatastores:Unknownerror (0x80005000) <br>&nbsp;&nbsp;&nbsp;at SPWorks.Search.Service.MailboxLoadJob.LoadMailboxes()”

An invalid AD Filter was entered on connection page.

Solution

  1. Connections > MailBox/Datastore Options.
  2. AD Filter: Click and update this field with valid data.
  3. Save: Click Save.
  4. Mailbox Load: Run.

Server is not operational Exception

When I run the Mailbox Load task, I get an Exception Loading Mailboxes error.

When I click View Log, I see an error, like this:

Exception Thrown:System.ApplicationException: GetAvailableDatastores:The server isnot operational. <br>&nbsp;&nbsp;&nbsp;at SPWorks.Search.Service.MailboxLoadJob.LoadMailboxes()

An invalid AD Server was entered on the Connections page.

Solution

  1. Connections > MailBox/Datastore Options.
  2. AD Filter: Click and update this field with valid data.
  3. Save: Click Save.
  4. Mailbox Load: Run.

StartIndex cannot be less than zero Exception

When I run the Mailbox Load task, I get an Exception Loading Mailboxes message.

When I click View Log, I see an error, like this:

Exception Thrown:System.ApplicationException: GetAvailableDatastores:StartIndex cannot be less than zero.<br>Parameter name: startIndex <br>&nbsp;&nbsp;&nbsp;at

SPWorks.Search.Service.MailboxLoadJob.LoadMailboxes()

An invalid AD Filter was entered on the Connections page.

Solution

  1. Connections > MailBox/Datastore Options.
  2. AD Filter: Click and update this field with valid data.
  3. Save: Click Save.
  4. Mailbox Load: Run.

Referral was returned from the server Exception

When I run the Mailbox Load task, I get an Exception Loading Mailboxes message.

When I click View Log, I see an error, like this:

Exception Thrown:System.ApplicationException: GetAvailableDatastores:A referral wasreturned from the server <br>&nbsp;&nbsp;&nbsp;at SPWorks.Search.Service.MailboxLoadJob.LoadMailboxes()”

An invalid AD Filter was entered on the Connections page.

Solution

  1. Connections > MailBox/Datastore Options.
  2. AD Filter: Click and update this field with valid data.
  3. Save: Click Save.
  4. Mailbox Load: Run.

No such object on the server Exception

When I run the Mailbox Load task, I get an Exception Loading Mailboxes.

When I click View Log, I see an error, like this:

Exception

Thrown:System.ApplicationException: GetAvailableDatastores:There is no

such object on the server. <br>&nbsp;&nbsp;&nbsp;at

SPWorks.Search.Service.MailboxLoadJob.LoadMailboxes()

An invalid AD Filter (non-existing user or group) was entered on the Connections page.

Solution

  1. Connections > MailBox/Datastore Options.
  2. AD Filter: Click and update this field with valid data.
  3. Save: Click Save.
  4. Mailbox Load: Run.

Test Bench Errors

No items are returned: Mailboxes are not loaded/enabled.

Solution

  1. Connector Framework >Content Sources > <your content source Content Sources do the following: Receive data from the Source System via the Connection, Filter the data it receives, Provide the results to the Target, Define the specific search index that contains the content you wish to index (and later search).> >   >Edit > Mailbox/Datastores.
  2. Check that mailboxes are loaded and enabled.
  3. Run the Test Bench.

No access to the vault store, archive, or item Exception

Text of the error

“GetItemData:Webservice error:System.InvalidOperationException: Unable to retrieve item from Enterprise Vault. ---> System.Runtime.InteropServices.COMException (0x80040303): No access to the vaultstore, archive, or item. at KVS.EnterpriseVault.Interop.IItem.Get(Int32 DetailLevel) at EVTools.EVConnector.GetEnterpriseVaultItem(String itemId, String archiveId, String pathToSaveResult, Int32 maxFileSize, Int32 originalFileSize)

--- End of inner exception stack trace --at EVTools.EVConnector.GetEnterpriseVaultItem(String itemId, String archiveId, String pathToSaveResult, Int32 maxFileSize, Int32 originalFileSize) at SPWorks.Search.Service.eVault.EVaultConnectorBase.DoItemData(ConnectionInfo conn, Hashtable customparams, String id, String subid, String foldersubid, DataStoreInfo datastore, DataStoreTypeFilter typefilters, String sharePath, Int32 maxFileSize, Hashtable allowedExtensions, DateTime lastUpdate, Boolean isIncremental, Int32 crawlID, Int32 contentID, String crawler, Boolean getmetadata, Boolean getsecurity, Boolean getfile)”.

The user who installed the eVault Connector did not have local admin rights.

Solution

  1. BAInsight Vault API: Uninstall.
  2. BAInsight Vault API: Install with the valid login\password.

    Note    : The Domain Service Account for API Webservice must be a local admin
  3. Run Test Bench.

Unable to retrieve item from Enterprise Vault Exception

Text of the error

 “GetItemData:Webservice error:System.InvalidOperationException: Unable to retrieve item from Enterprise Vault. ---> System.Runtime.InteropServices.COMException (0x80040306): An internal failure occurred. Internal Error: '<0x80041a17>'.

at KVS.EnterpriseVault.Interop.IItem.Get(Int32 DetailLevel)

at EVTools.EVConnector.GetEnterpriseVaultItem(String itemId, String archiveId, String pathToSaveResult)

--- End of inner exception stack trace --at EVTools.EVConnector.GetEnterpriseVaultItem(String itemId, String archiveId, String pathToSaveResult) at SPWorks.Search.Service.eVault.EVaultConnectorBase.DoItemData(ConnectionInfo conn, Hashtable customparams, String id, String subid, String foldersubid, DataStoreInfo datastore, DataStoreTypeFilter typefilters, String sharePath, Int32 maxFileSize, Hashtable allowedExtensions, DateTime lastUpdate, Boolean isIncremental, Int32 crawlID, Int32 contentID, String crawler, Boolean getmetadata, Boolean getsecurity, Boolean getfile)”.

Possible Causes

  1. Enterprise Vault Directory Service is not running.
  2. Your firewall is blocking traffic on the port where COM calls usually run (135).
  3. Your firewall is blocking traffic on the port where the Enterprise Vault Directory service is running (dynamic port).
  4. Improper permissions are set for running COM for an impersonated user in the EVault Connector application pool.
  5. Improper schema is on Enterprise Vault Storage Service.

Solutions

  1. Run the Enterprise Vault Directory Service Windows service.
  2. Unblock port 135 for traffic.
  3. Check the port number (using, for example, the TCPView tool) for the port that is used for the Enterprise Vault Directory service.
  4. Improper permissions:
    1. Navigate, using Windows Explorer, to the Enterprise Vault folder (C:\Program Files (x86)\Enterprise Vault) and run the DTrace tool.
    2. View: Type.
    3. Pick a number near w3wp from the list provided by the previous command (<number of w3wp>)
      1. Type set <number of w3wp> v.
      2. Type Filter.
      3. Type clear excludes.
      4. Type quit.
      5. Navigate to the Test Bench and select your Connector.
      6. Type log log.txt.
      7. Click Run to see the same exception.
      8. log: Type and press y when prompted in the DTrace tool.
      9. See the log.txt file in the Enterprise Vault folder (where DTrace is located). You see an entry similar to the following:
            12:05:28.987 [4100] (w3wp) <5956> EV:L
          {VaultCoCreateInstanceEx} Attempt [1] to create COM object failed. CLSID
          [{F4D3EB5B-C7C5-11D1-90DB-0000F879BE6A}] Server Name [SERVER]
          Elapsed [0.016s] Result [Access is denied.
          (0x80070005)]
      10. From the Windows Start Button > Run > enter "Regedit". Click OK.
      11. F4D3EB5B-C7C5-11D1-90DB-0000F879BE6A: Find and note the name of the component, which can be a server-side component such as DirectoryService. For this reason, run this operation on the EVault server.
      12. Click Windows Start Button > Run> enter "component". Click OK.
      13. Select Component Services from above. Right-click it and select Run as administrator.
      14. Navigate to Component Services > Computers > My Computer.
      15. DCom Config; Find the DCOM name located previous step and assign permissions for the app pool user of the EVault Connector to run and activate.
  5. Improper Schema:
    1. Repeat the steps related to DTrace EVaultlogging listed above.
    2. In the created log see a message that is similar to the following example:

      3012:15:02.050 [4048] (w3wp) <5132> EV:M Error accessing SimpleStore.

      Attempt:1

      EntryId:15355A0C451474D4EA73B575085A6B3611110000SERVER|hr=Unspecified error (0x80004005)

      3112:15:02.050 [4048] (w3wp) <5132> EV:M CItem::Get Elapsed time 1099.2ms

      3212:15:02.066 [4048] (w3wp) <5132> EV:H {CItem::Get} HRXEX fn trace : Error [0x80004005], [.\Item.cpp, lines {747,1201}, built Sep 12 21:05:52 2012].

  6. Check the EVault web search to make sure that it is working as expected: http://yourservername/EnterpriseVault/search.asp
    1. If the EVault web search was unable to search and open an item, verify that the schema on the Enterprise Vault Storage service is up-to-date.
    2. If not, upgrade the current schema to the latest schema.

Issues with Executing Large Queries

For example, when using the FOLDER filter with a large number of items in the IN clause, query issues occurr.

Solution

Try breaking the larger query into smaller units, and scale your queries using the steps below:

  1. Navigate to the Connector installation location and open the Web.config file.
  2. Find this node (add it if it is missing):
    <add key="ArchivePortionToProcess" value="200"/> in the <appSettings> section.
    1. Make sure the setting is a positive number and includes a reasonable value.
    2. This setting specifies a limit to how many archives can be processed by one query.
    3. Each folder in the mailbox can correspond to a separate archive.
  3. Save and close the Web.config file.

Please check value of ArchivePortionToProcess Error

Text of error

Please check value of ArchivePortionToProcess in appSettings section of web.config. If should be a positive number

Solution

  1. Navigate to the Connector install location and open the Web.config file.
  2. Find this node:
    <add key="ArchivePortionToProcess" value="200"/> in the <appSettings> section.

Note: Make sure the value is a positive number.
This value specifies a limit to how many archives can be processed by one query.
Each folder in a mailbox can correspond to a separate archive.

  1. Save and close the Web.config file.