Debugging a PolicyCenter server using a shared memory connection

About this task

Use a shared memory connection to connect Studio to a PolicyCenter server running on the same computer. You must manually start the server in the proper debug mode, and create the proper debug configuration in Studio.

Procedure

  1. Start the PolicyCenter server.
    1. Start the server using the following command:

      gwb runServer --debug-shmem --no-suspend

    2. Towards the beginning of the server console message output, look for the label debug-shmem:, and then the text that is similar to the following:

      Listening for transport dt_shmem at address: javaAddress

    3. Make a note of the string provided for javaAddress.
  2. Create the debug configuration in Studio.
    1. In Studio, click Run > Edit Configurations.
    2. In the Run/Debug Configurations dialog, click Add New Configuration , and then click Remote.
    3. In the Name text box, type a name for the debug configuration. For example, server-shmem.
    4. Next to Transport, click Shared memory.
    5. Next to Debugger mode, click Attach.
    6. In the Shared Memory Address text box, type the javaAddress that you noted when you started the server.
    7. Click OK.
  3. Connect the Studio debugger to the PolicyCenter server using the shared memory connection.
    1. In Studio, in the Select Run/Debug Configuration drop-down list, select the debug configuration that you created.
    2. Click Run > Debug ‘configName’, where configName is the name of the debug configuration that you created.

Results

The debugger connects to the PolicyCenter server, and debug messages appear in the Debug tool window in Studio.