Remote Debugging

With Public IPs in the platform, you can use remote debugging. Now you can debug your application running on the platform by connecting it with code in your IDE. First of all, let’s consider the basic aspects of remote debugging.

How does remote debugging work?

Java provides this feature through a listener-binding mechanism. The basic concept is pretty easy and elementary:

• Application to be debugged would attach a socket to itself and then would listen for debug instructions on that socket.
• The debugger would bind itself to that socket and then send instructions over it.

Create Environment

1. Log in to the platform dashboard.

2. Click Create environment to set up a new environment.

3. Choose the instances you want to use (for example, Tomcat application server), set the cloudlets limit, and switch on the external IP. Then type the name of the environment and click Create.

In a minute, the environment will be created.

4. Expand the list of environments and use the ” Additionally button for your instance to see the number of your Public IP.

Deploy an Application

1. Upload your Java package to the Deployment manager.

2. Once the package is in the platform, deploy it to the environment you have just created.

As an example, we use a simple application, which initializes three variables (a, b, c) in turn.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

package com;
public class RemoteDebugger {

   public void start () {
       int a,b,c;
       a = 1;
       System.out.println("a = "+ a);
       b = 2;
       System.out.println("b = "+ b);
       c = 3;
       System.out.println("c = "+ c);
       }
}

Configure Debugging

1. Open the application in your IDE (e.g. NetBeans) and create a new debugger (Debug main project > Attach Debugger).

2. Select the type of connector, insert your Public IP address (host), the number of the port, you would like to listen to and specify timeout settings (optional).

3. Switch back to the platform dashboard and click the Config button for Tomcat.

4. Navigate to variables.conf file and supply two arguments, -Xdebug and -Xrunjdwp.

-Xdebug tells JVM to run the application in debug mode, while -Xrunjdwp is used to supply debug parameters.

1

-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5000

5. Save the changes and restart Tomcat.

6. Put the break point to your code to test remote debugging and start the newly created debugger. In our case the application should initialize only two variables instead of three.

Let’s check Tomcat logs to ensure that debugging works properly.

As you see everything is ok, two variables have been initialized.

7. If we put the break point one row down, three variables will be initialized by our app.

In case you use GlassFish as your application server you have to supply -Xdebug and -Xrunjdwp arguments via the admin panel page.

• When you created the environment, the platform sent you an email with credentials to the GlassFish Admin Console. Log in with these credentials.
  

  

• Navigate to gfcluster-config > JVM Settings and select the General tab > Debug options. Specify your debug mode and debug parameters.
  

  

• Go to JVM options and add two arguments: -Xdebug and -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5000.
  

  

• Save all changes and restart GlassFish.

Hope this instruction will be useful for you.