Remote Debugging Java packages in WSO2 Carbon using IntelliJ IDEA

Here I'm going to tell you an easy way of debugging java packages deployed under any WSO2 product. So, you don't need to go wondering and go through thousands of lines looking what the bug was in your package.
What you need:

• IntelliJ IDEA

•  Download the latest version from http://www.jetbrains.com/idea/download/index.html#linux
•  Installation instructions can be found here.
• The WSO2 Product you are deploying the package in. All WSO2 Products are listed here.

Thats it. Now, open your Java package/bundle from IDEA.
Then, go to Run -> Edit Configurations
Add a remote debug configuration by clicking on '+' sign (at top left corner) and then remote.
It comes with a default set of settings. Keep them intact. get to know the port number(generally it's 5005)

Now, start the WSO2 Product you are using with the parameter of debug followed by the port number.

sh wso2server.sh debug 5005

It waits and listens on port 5005 until remote debugging client is started. Start the client by, (in IDEA)

Run -> Debug

All done. Now you can do normal debugging by putting break-points in your .java files.

That's how I got it done. Does this help you to succeed in remote debugging?

Install IntelliJ IDEA on Linux

Here's a simple way to install IntelliJ IDEA on Ubuntu. I've done this on all Ubuntu Karmic Koala, Lucid Lynx and Maverick Meerkat. This worked just fine on Gentoo Linux too.

1). Install Java (Use Sun JDK. OpenJDK is NOT recommended as the JDK.)
sudo apt-get install sun-java5-jdk
It seems sun-java5-jdk is no longer available now. Refer Oracle Java SE Downloads for Linux and it's installation instructions. Keep the path in your memory; you'll need it when setting up $JDK_HOME path variable.

Then, to make sure that it is installed properly, type
java -version
if the version shows, then it is installed successfully.

2) Now, install IDEA
Download IntelliJ IDEA from the below link
 http://www.jetbrains.com/idea/download/index.html#linux
 Unpack the downloaded archive (ideaIU-9.0.3.tar.gz) by,
     tar xfz ideaIU-9.0.3.tar.gz
(match the file name to your version!)

 Move the extracted archive to /usr/lib
     sudo mv idea-IU-95.429 /usr/lib

3) Configure PATH variables for JDK_HOME and IDEA
     sudo gedit ~/.bashrc
Add following for JDK_HOME to the file, make sure to change the path to reflect your java installation directory.

export JDK_HOME=/usr/lib/jvm/java-6-sun

Append the line for PATH variable with this, /usr/lib/idea-IU-95.429/bin . Finally, it should look like this.

export PATH=$PATH:/usr/lib/idea-IU-95.429/bin
Now, run `source ~/.bashrc` to take effect the changes.

4) Run IDEA  by entering following in the terminal
   idea.sh (or sh idea.sh)

NOTE: If you get permission denied error, then you will have to set the correct permissions to idea.sh file by `sudo chmod 755 /usr/lib/idea-IU-95.429/bin/idea.sh` 

For easier execution, create a "Custom Application Launcher" at top panel. Access it via; right-click the top Panel -> "Add  to Panel" -> double click "Custom Application Launcher". Browse and give an icon if you like. Then, use a command similar to,
sh /usr/share/idea-IU-95.66/bin/idea.sh

Custom Application Launcher Properties

If you have any problem in setting up this, drop a comment below. Well, even if you got right, just tell me so. Love to hear that too! :). Good Luck!