Enterprise Vault™ Troubleshooting FSA Reporting

Last Published:
Product(s): Enterprise Vault (12.5, 12.4, 12.3, 12.2, 12.1, 12.0, 11.0.1, 11.0)
  1. About this document
    1.  
      About this technical note
    2.  
      About troubleshooting FSA Reporting
  2. Troubleshooting an upgrade of FSA Reporting
    1.  
      About troubleshooting an upgrade of FSA Reporting
    2.  
      'Failed to upgrade FSA Reporting database' event log error message
    3.  
      Archive information is not shown for some volumes
  3. Troubleshooting the configuration of FSA Reporting
    1.  
      About troubleshooting the configuration of FSA Reporting
    2.  
      Error message 'Not able to resolve file server FQDN for this file server'
    3.  
      FSA Reporting scans fail to start, no change in scan status
    4.  
      Error message 'Enterprise Vault cannot enable/disable the FSA Reporting data collection settings now'
    5.  
      Error message: 'Enterprise Vault cannot access the FSA Reporting web service'
    6.  
      Error message: 'Could not connect to FSAReporting virtual server'
    7.  
      File server disk space issues
    8.  
      Warning message 'Total number of file types exceeds one thousand'
    9.  
      Problems after failover in a building blocks environment
    10.  
      Recreating the File Collector service if it is missing
    11.  
      Troubleshooting the FSA Reporting web service
    12.  
      Adding the FSA Reporting web service locations to the Local intranet zone
    13.  
      Configuring the FSA Reporting web service manually
  4. Troubleshooting issues with FSA Reporting reports
    1.  
      About troubleshooting issues with the FSA Reporting reports
    2.  
      Troubleshooting accessing the FSA Reporting reports
    3.  
      'File Group Space Usage on a Server' report shows double the number of files on some target volume shares
  5. Using DTrace to troubleshoot FSA Reporting
    1.  
      About using DTrace to troubleshoot FSA Reporting
    2.  
      Troubleshooting FSA Reporting with DTrace

Troubleshooting FSA Reporting with DTrace

Note:

The following procedure uses the term "FSA Agent computer". For Windows file servers "FSA Agent computer" refers to the file server. For non-Windows file servers, "FSA Agent computer" refers to the FSA Reporting proxy server.

Note:

If you use Microsoft SQL Server 2008 Reporting Services, do not attempt to run DTrace on the Reporting Services Report Manager process, Reporting ServicesService.exe. Report Manager does not render reports correctly if you enable DTrace on it. You can use Microsoft DebugView in place of DTrace in this instance. You can obtain DebugView from the following location:

http://technet.microsoft.com/sysinternals/bb896647.aspx

This restriction does not affect the following procedure.

To troubleshoot FSA Reporting with DTrace

  1. On the FSA Agent computer, enable DTrace for the FSAReportingService process and start logging the results. Specify a monitoring level of at least medium. For example, enter the following two commands at the DTrace command prompt:
    set FSAReportingService verbose 
    log c:\temp\dtracelog.log
  2. Check whether there are problems with obtaining the FSA configuration parameters. Do as follows:

    • For Windows file servers, restart the Enterprise Vault File Collector Service on the file server. For non-Windows file servers with an FSA Reporting proxy server that is not an Enterprise Vault server, restart the Enterprise Vault File Collector Service on the proxy server. For non-Windows file servers with an Enterprise Vault server as the FSA Reporting proxy server, restart the Admin Service on the Enterprise Vault server.

    • Check the results of the fetch operation. To do this, look in the DTrace log for entries containing the following string:

      {Client.GetConfigurationInformation}

      The detail level of these entries is Medium.

    • Check that the FSA Agent computer can access the computer that runs the FSA Reporting web service.

    • Check that both a forward DNS lookup and a reverse DNS lookup succeed for the file server. The following DTrace entry indicates that a reverse DNS lookup is failing:

      FSAReportingUtil::GetFullyQualifiedDomainName, server name passed to this function = (NetBIOS name instead of FQDN) |

    • Open the Event Viewer and look in the Enterprise Vault event log for information event 24576 with the following description:

      Parsing of configuration XML is successful; Schedules 
      service started.

      If you cannot see this event, open SQL Server Enterprise Manager and go to the EnterpriseVaultFSAReporting database. Examine the FileServerConfiguration table as follows:

      • Check whether the table contains a row for each file server that is configured for FSA Reporting.

      • Check whether the DomainName column in each row contains the fully qualified domain name of the domain where the file server is located. If it does not, edit the entry to specify the fully qualified domain name.

      • If any rows are missing, the most likely reason is that you are using versions of FSA Agent and Enterprise Vault Reporting that are incompatible with FSA Reporting.

        See the following technical note on the Veritas Support website: https://www.veritas.com/docs/100030221.

      If you are using compatible versions of FSA Agent and Enterprise Vault Reporting then another issue must have caused the database problem.

  3. Verify that FSA Reporting scans are running successfully. Look for the relevant entries in the DTrace log, depending on how the scan was initiated:
    • If a user initiated the scan using the Run FSA Reporting Scan option in the Administration Console, look for entries containing the following:

      CServer::ScanNow

    • For a scheduled scan, look for entries containing the following:

      Call back timerproc

    Then look for an entry containing the following, which indicates that the scan is being prepared:

    CAgentParams::GetObject

    The detail level of these entries is Low.

  4. Verify that a scan has started, by looking for the entry:

    CScan::ScanMain

    The detail level of this entry is Low.

  5. Check whether the list of archive points is being obtained correctly. The FSA Agent requires the list of archive points present under the volume that is currently being scanned. To verify that this archive point information is obtained properly, look for entries containing the following:
    • ArchivePointThread

    • {Client.GetArchivePointDetails}

    The detail level of this entry is Medium.

    Note that there will be several entries that contain these strings. The entries may not necessarily be found together, as there are other operations occurring simultaneously. If these entries indicate any failure, do as follows:

    • Check that the FSA Agent computer can access the computer that runs the FSA Reporting web service.

    • Then run GetArchivePointDetails from the ReportingServer web page. Specify the following parameters:

      fileServerName

      The fully qualified domain name of the file server, for example blackbird.demo.local.

      For non-Windows file servers, specify the file server name, not the FSA Agent computer name.

      volumeName

      The name of the volume for which to obtain information.

    A web browser window should open and list all the archive points. If no archive points are listed, run the same function but use the IP address of the file server.

  6. Check whether the archive information is being obtained correctly. Look for entries containing the following:
    • ArchiveThread

    • {Client.GetArchiveInformationByArchivePoint}

    The detail level of these entries is Medium.

    If these entries indicate any failure, do as follows:

    • Check that the FSA Agent computer can access the computer that runs the FSA Reporting web service.

    • Then run GetArchiveInformationByArchivePoint from the ReportingServer web page. Enterprise Vault invokes this function for every archive point in a target volume. You must specify the following:

      fileServerName

      The fully qualified domain name of the file server, for example fileserver.demo.local.

      For non-Windows file servers, specify the file server name, not the FSA Agent computer name.

      volumeName

      The name of the volume for which to obtain information.

      archivePointVEID

      The id of the archive point for which to obtain information. This is specified by the GetArchivePointDetails method you used earlier.

      knownFileTypes

      Do not enter a value for this parameter.

      Verify that archive data is shown for the specified archive point and file types. If no archive data is listed, run the same function but use the IP address of the file server.

  7. Check the progress of the scanning of live files. To do this, check all the entries reported at the Medium detail level containing the string:

    CRDScan

  8. Check that the FSAReportingService is sending scanned data to the FSA Reporting database. Enterprise Vault sends the scanned data and metadata per archive point, using the functions SendAndUpdateDataForArchivePoint and SendAndUpdateMetaData. For example, if a volume has two archive points, Enterprise Vault calls both functions three times: once for each archive point, to send the data and metadata for the archive point, and a third time to send the data and metadata for the volume.
    • To verify the scanned data transfers, look for entries containing the string

      {Client.SendAndUpdateDataforArchivePoint}

    • To verify the metadata transfers, look for entries containing the string:

      {Client.SendAndUpdateMetaData}

      The detail of these entries is Medium.