Troubleshooting Distributed Server Option

Important

The Distributed Server Option (DSO) is available only for on-premises deployments.


This section describes procedures to troubleshoot the following Distributed Server Option (DSO)  issues.

Related topics

Distributed-Server-Option-logging

Configuring-Distributed-Server-Option-logging

Contacting Support

Errors encountered by DSO

Perform the following steps to investigate errors in DSO:

  1. Identify unique errors.
  2. Enable logs to capture more information about the errors.
  3. Analyze DSO, Filter, API, and SQL logs.
  4. Analyze logs, characterize issues, and identify errors and steps to correct the error.

Enabling logs to capture

To capture more information about the errors, enable the following logs on both the source and destination AR System servers:

  • DSO
  • Filter
  • API
  • SQL

Perform the following steps:

  • Set the log level to Info for the DSO logs.
  • Make sure that the API log and SQL log write to the same log name and location.
  • To capture the the issue, leave the logs enabled till the problem is reproduced.

Locating errors in DSO operations

  • Search the DSO log for *ERROR* to identify issues. For each unique error, identify a test case to analyze from the logs.
  • In the Filter, API, and SQL logs, grep the lines with <USER:Distributed Server> to a separate file to identify operations initiated by Distributed Server.
  • Search for ARERR in the API log, or **** in the Filter log to find error messages.
  • Identify the value of RPC ID on the line with the error.
    For example: <RPC ID: 0000012345> and grep the lines with the string <RPC ID: 0000012345> from the API, SQL, and Filter logs to separate files. These files provide the flow of operations for a single operation and failure.

DSO files

The DSOfiles are available in the AR_INSTALL_DIR\DSOJ directory after a successful installation or upgrade.

DSO files available after a fresh installation

  • ardsojversionNumber_buildNumber.jar
    For example, ardsoj81_build001.jar
  • arcmnappversionNumber_buildNumber.jar 
    For example, arcmnapp81_build001.jar
  • dsojstartup.bat

DSO files available after an upgrade installation

After you upgrade DSO, the files from fresh installation are also available along with the following files:

  • Serverds.exe
  • arapiversionNumber_buildNumber.dll
    For example, arapi81_build001.dll
  • arutilversionNumber_buildNumber.dll 
    For example, arutil81_build001.dll

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*