profile image
Abhaysingh Shirke
HCL Notes/Domino Technical Support Team
Posts by Abhaysingh Shirke
article-img
Digital Solutions | November 5, 2020
Remotely Debugging Java Applications with Domino 11
For Domino customers on v9 or 10, you might be familiar with debugging a Java agent remotely on IBM JVM using the following server ini’s and set Port 8000 in Debug Configuration from the Designer client: JavaEnableDebug=1 JavaDebugOptions=transport=dt_socket,server=y,suspend=n,address=8000  This will work up to Domino v10 but not on Domino v11. In fact, doing so will cause it to crash! This article is going to help developers looking for a way to debug Java agents remotely on Domino v11. The pre-requisites are:  Domino v11 or above on Windows Server 2016 / 2019. HCL Domino Console. Notes, Designer and Administrator Client v11 or above. Java agent to be debugged. Any Web Browser to run Java agent.  Domino v11 uses OpenJDK. With the above ini's enabled, both the JVMs would attempt to bind to same port (8000) and the second process that attempts to bind to this port would fail and crash. To overcome this problem, the idea is to remove the Port 8000 from the Debug and attach it to some other random Port.  First, you will need to add the below ini’s to the server’s notes.ini.   JavaEnableDebug=1  JavaDebugOptions=transport=dt_socket,server=y,suspend=n  Note that we are not binding the Debug to Port 8000 by omitting address=8000, as compared to ini which was set on earlier version of Domino.  The JVM will then pick a random port. To know the random Port number, simply quit and load http or run your Java agent from web browser and check the console from HCL Domino Console Program. You will need to restart http task after adding those ini’s to make it work.  Note down this Port number somewhere as you would need it in next step. (The server console in the Administrator Client doesn’t show the Port number information.) With your Port number, you are going to bind to the Debug from the Designer client. Go to Tools menu > Debug Server-side Javascript > Manage Debug Configuration You should land on the Debug Configuration window. Here you need to mention the Port number which you noted down from the HCL Domino Console...
a/icon/common/search Created with Sketch.