How to get a thread dump

Last modified by colinw on 2021/09/10 22:40

In some circumstances, getting a thread dump of iSymphony is required, or can greatly assist troubleshooting efforts. A thread dump contains information about what tasks iSymphony is currently doing, and whether any of those tasks have stalled. 

Step-by-step guide

To get a thread dump, you'll need an SSH connection to the iSymphony server. Then, follow these steps:

  1. Determine the process id of iSymphony:

    # cat /opt/isymphony3/server/iSymphonyServer.pid

    This will print the process id of iSymphony, if it is running. For example:

    # cat /opt/isymphony3/server/iSymphonyServer.pid
    12435
  2. Run the following command to instruct iSymphony to print a thread dump. Note that this will not shut down or restart iSymphony. 

    # kill -QUIT <pid_from_step_1>

    Be sure to replace <pid_from_step_1> with the actual value that was returned from the command in step 1. This command will cause iSymphony to log the current thread dump into its log files. 

  3. Package your log files as described at Reporting Issues, and send them to the iSymphony support team. 

Related articles

Related articles appear here based on the labels you select. Click to edit the macro and add or change labels.

Unknown macro: contentbylabel. Click on this message for details.

Unknown macro: details. Click on this message for details.

   
iSymphony