Software AG Products 10.7 | Administering Integration Server | Configuring the Server | Configuring Integration Server to Accept a Debug Connection During Startup
 
Configuring Integration Server to Accept a Debug Connection During Startup
Using Integration Server, you can connect a debugging tool to remotely debug Java services running on Integration Server. You can specify the port on which Integration Server listens for the debugger to attach.
For information about using Software AG Designer to debug Java services that run on Integration Server, see Software AG Designer Online Help.
Note:
A JMX port is not enabled by default for Microservices Runtime. To enable a JMX port for Microservices Runtime, modify Integration Server_directory /bin/setenv.bat(sh) to include JMX_ENABLED=true and JMX_PORT=9192.
*To configure Integration Server to accept a debug connection during startup
1. In the top right corner of Integration Server Administrator, click Shut Down and Restart.
2. Click Shut Down.
3. If you need to change the port number, perform the following:
a. Open the startDebugMode.bat file in a text editor. You can find the startDebugMode.bat file in the following location:
Software AG_directory \profiles\IS_instance_name\bin
Note:
For Microservices Runtime, open: Integration Server_directory /bin/startDebugMode.bat(sh)
b. Locate and change the DEBUG_PORT property to specify the port on which the server should listen for the debugger to attach. The default is 10033.
c. Locate SUSPEND_MODE property and set it to y if you want the JVM to wait for a debugger to attach.
d. Save your changes and close the startDebugMode.bat file.
4. If Integration Server and the debugging tool are on different machines and you require a firewall port, open a firewall port for the debug port.
5. Run startDebugMode.bat.
Integration Server logs the following on your console:
"Debug enabled (portNumber)"
Listening for transport dt_socket at address: portNumber
Integration Server restarts.