Viewing diagnostic output on a proxy connection failure

When the HTTP proxy fails to open a connection to a live system or stub, it dumps the exception message and output from the netstat command (open connections and used ports) to a file on your computer.
You can find the file in the home directory of the user account that is running the proxy, and the filename is in the following format ritproxy-netstat-timestamp.txt. By default, the proxy writes one dump file every ten minutes.
  • To turn the dump collection on or off, set the following JVM argument to true or false respectively: -Dcom.ibm.rational.rit.netstatdump. The default value is true.
  • To configure the file path, update the following JVM system property: com.ibm.rational.rit.netstatdump.dir.
  • To configure the rate at which the proxy writes to a file, update the following system property: com.ibm.rational.rit.netstatdump.mininterval. For example, -Dcom.ibm.rational.rit.netstatdump.mininterval=1 means that the proxy creates a dump file every one minute. To avoid imposing any such limits, set the value to zero. When you try to recreate an issue, use a small value.
  • To include refused connection exceptions in the file dump, update the value of the following JVM argument to true: –Dcom.ibm.rational.rit.netstatdumpconnectionrefused. The default value is false.
Table 1. Adding JVM arguments
If you are running the proxy as a process .. If you are running the proxy as a Windows service ..
  1. Open the startup file of the HTTP/TCP proxy (startup.bat on Windows computers and startup.sh on non-Windows computers) in a text editor.
  2. Add the desired JVM arguments to the active %_RUNJAVA% line.
  3. Save and close the file.
  4. For the changes to take effect, stop the HTTP/TCP proxy and start it again. For instructions, see Starting and stopping the HTTP/TCP proxy.
  1. Run editProxyService.bat from an Administrator command prompt.
  2. Add the desired JVM arguments on the Java page.
  3. Click Apply and close the properties dialog.
  4. For the changes to take effect, stop the HTTP/TCP proxy and start it again. For instructions, see Starting and stopping the HTTP/TCP proxy.
Feedback