Setting Up Integration Server Version 9.0, 9.5.x, or 9.6 for Remotely Debugging a Java Service
When using Designer to debug a Java service that is running in Integration Server version 9.0, 9.5.x, or 9.6 and later, make sure the Integration Server debug port is enabled at start up. You enable the debug port by updating the Integration Server setenv.bat (on Windows) or setenv.sh (on UNIX/Linux) file.
Important: | Before performing the following procedure, make a backup copy of your setenv.bat/sh file. |
To set up Integration Server 9.0, 9.5.x, or 9.6 for remotely debugging a Java service
1. Shut down Integration Server.
2. Open the .bat/sh file in a text editor. You can find the setenv.bat/sh file in the following location:
On versions 9.0 to 9.5.x:
IntegrationServer_directory\bin
On version 9.6:
IntegrationServer_directory\instances\instance_name\bin
3. Locate and change the DEBUG_ENABLED property to true.
4. If you want to change the port number, locate and change the DEBUG_PORT property. The default is 9191.
5. Save your changes and close the setenv.bat/sh file.
6. If Integration Server and Designer are on different machines, if required, open a firewall port for the debug port.
7. If you are running Integration Server as a service, you must update the service for the changes in the setenv.bat file to take effect.
To update the service, open a command window, navigate to the following location:
On versions 9.0 to 9.5.x:
Integration Server_directory \support\win32
On version 9.6:
Integration Server_directory \instances\instance_name\support\win32
8. Run this command:
installSvc.bat update
9. Restart Integration Server.
Integration Server logs the following on your console:
"Debug enabled (portNumber)"
Listening for transport dt_socket at address: portNumber