Use the information in this section to troubleshoot problems with cxVerify.
Viewing log files
cxVerify has a log file and an extended log file. These log files might be helpful when troubleshooting system errors.
- From the Portal, navigate to cxVerify.
- Click Configure Tasks.
The list of configured tasks are displayed.
- Right click on the task for which you want to view a log file and select View Log or View Extended Log.
The log file is displayed.
LTS exception error logs
You can troubleshoot LTS exception errors by analyzing the contents of 2 log files.
If the LTSServer fails to fetch the resources it needs to generate a long-term storage (.lts
) file, the web server throws an exception and writes error information to the LTSGenerationErrors.log
file.
The LTSGenerationErrors.log
is contained in the same zip file as the .lts
file and can be linked to from the PDF of the .lts
file.
The same log file is also a part of zipped .lts
file. This approach ensures that the log files are always pinned to the .lts
files, even when they are extracted and saved to the disk.
LTSGenerationErrors.log
that is attached to PDF is generated only when the web server from which LTSServer tries to fetch static resources returns an error (such as HTTP static codes like 404
and 503
. Where as, the LTSServer.log
that is written to \Logs\LTS\LTSServer.log contains ALL LTS application specific exceptions and information errors.Additionally, Tealeaf maintains an LTSServer.log
file in the CX installation folder.
The LTSServer.log
file includes both information and error messages that are thrown by the LTSServer that occur when receiving a request to save the .pdf file or the long-term storage (.lts
) files.
Network interruption causes extractor service to fails
Network interruptions can cause the extractor service to fail.
Typically, tasks fail when there are network interruptions, or the Extractor Service is unable to connect to a canister. When a task fails, cxVerify tries to complete the task a predefined number of times.
- Errors are reported in the Extractor log and the cxVerify Tasks log.
- This number of repeat attempts can be configured through the Extractor Service configuration in TMS.
If the number of failures reaches the limit, then the task is resumed at the next scheduled time.
Handling socket exceptions
You need to determine why a socket exception has occurred.
If the data extraction process receives a socket exception while it is communicating with the Processing Server, it pings the CX Server. It then takes one of the following actions:
- If the server is not reachable for a configurable period, cxVerify stops processing for that server and logs an error. If there is more than one CX Server, it attempts to connect to the next server.
- If the CX Server is reachable, it tries to contact the Search Server service. If the Search Server service is not responding for a configurable period, it stops processing for that server and logs an error. If there are multiple CX Servers, the extractor process attempts to connect to the next server.
Daily tasks fail to start when scheduled
You need to determine why daily tasks fail to start when scheduled.
cxVerify delays the start of a daily task until all sessions to be extracted were indexed into the Long Term Canister. cxVerify inserts an extra time margin to ensure that any idle sessions in the canister expired.
Any cxVerify daily task has an end time of 24:00, and the task cannot begin until one hour after the last session was indexed. This one-hour buffer ensures that all sessions marked as "closed" had time to be indexed. For a daily task that extracts yesterday's data (00:00 - 24:00 of the date before today), the earliest start time is 1:00 am.
In addition to the one-hour buffer, sessions do not close until the canister session idle time expired. If the session idle time is set for 30 minutes, the earliest executable start time is 1:30 am.
Suppose that the Nightly Extract is scheduled to run at 00:01 each morning. At 00:01 the Nightly Extract attempts to run and checks the session indexes.
- The last indexed session time was 23:49:50 from the previous day, so the one hour buffer test that failed and the task is scheduled to run again at 01:01.
- At 00:55, the Nightly Extract attempts to schedule a run at 01:01 and checks the session indexes. Since the last indexed session time was 23:59:43 from the previous day, the one-hour buffer test failed at the time of the test, and the task was scheduled to run again at 02:01.
- At 01:55 the Nightly Extract attempts to schedule a run at 02:01 and checks the session indexes. The index test passes, and the task is scheduled and started at 02:01:01.
Revocation information is not available
You need to determine why the error message, revocation information is not available has occurred.
When cxVerify jobs are failing because RTV is unable to retrieve images, you may receive the following error message about the security certificate:
revocation information is not available
In this case, the issue is caused by CX RTV attempting to access images that are stored in a location that requires a security certificate. Since CX RTV uses an embedded version of Internet Explorer, you can circumvent this issue by making a configuration change in IE.
- Close CX RTV, if it is open.
- Open Internet Explorer.
- In the IE menu, select Tools > Internet Options.
- Click the Advanced tab.
- Scroll to the Security heading.
- Clear
Check for server certificate revocation
. - Click OK.
- Close Internet Explorer.
- Restart CX RTV.
After the above configuration change was performed, CX RTV should be able to capture the images, and the cxVerify task should complete.
Invalid HTTP response status 401
You need to determine why the error message, Search Server, invalid HTTP response status 401 has occurred.
When running cxVerify data extractor jobs, you may see errors similar to the following:
9/29/2009 12:23:36 PM | Reading event definitions ...
9/29/2009 12:23:36 PM | Search server error (HQA:19000):
TeaLeaf.SearchServer.SearchServerException:
SearchServerCS.TalkToRealSearchServer(): Invalid HTTP response status 401
at TeaLeaf.SearchServer.RealSearchServer.RealCommunicate(String command,
ArrayList args, Int32 timeout)
at TeaLeaf.SearchServer.TLSearchServer.GetEventListMS(Boolean log, Int32
timeout)
9/29/2009 12:23:36 PM | Trying to get event list from search server
HQA:19000...
The cxVerify is attempting to run the data extraction task as the local system administrator account. Under NT authentication, it is recommended that the Data Extractor use a local non-system account.
- Review the logs to verify the NT user being used to connect. You should see an entry like the following:
9/29/2009 12:23:35 PM | NtAuthorization server: HQA:19000, user: NT_AUTH\SYSTEM
- The above indicates that a local system admin account user is in use:
NT_AUTH\SYSTEM
. - Change the account to use:
- On the server, open the Windows™ Services Control Panel.
- In the list of services, double-click the Extractor Service.
- Click the Log On tab.
- Click This Account.
- Specify the account to use.
- Click OK.
- In the Domain controller, verify that the above user is part of the Admin group for the domain, which ensures that the user has access to the other servers in the domain.
- In the Portal, add the above account to the cxImpact Admin group.
- In the Portal menu, navigate to Portal Management.
- In the Portal Management page, click the CX User Administration heading.
- Click the Groups link.
- Select Admin Group.
- Click Assign Users.
- Select a check box next to the above user.
- Click Save.
- Restart all Tealeaf services.