Boomi: How to modify an atom's memory or debug a custom connector?

Have you ever stuck without knowing how you could increase the heap memory size of your Boomi Atom or how you could debug a custom connector which you have developed for integrating your organization specific custom application that is not supported by available Boomi connectors? Then, this post will be handy for you if you were not able to get the advice from the Boomi site directly.

When you install Boomi atom in your local machine, it comes with 512MB configuration by default. The configuration details are captured in a file namely atom.vmoptions. This file can be located at  <atom_install_dir>/bin folder and be opened using a text editor. This is the same place you would want to modify the configuration to enable the debug functionality. The following lines need to be added to the existing configuration.

-Xdebug

-Xnoagent

-Djava.compiler=NONE

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

Please do not forget to stop and start (or alternatively restart) your atom to effect these changes. Then comes the next question - how can you check if the configuration is successful. It is very simple to validate. In AtomSphere portal, please go to Manage -> Atom Management -> Atom startup properties. You can see the modified value for heap memory. Now that the debug port (8000) is enabled and you can connect from your IDE (for example Eclipse) to port number 8000 to start debugging your application.

The above should be very straight forward and you should be able to make it in the first time itself. If at all you face any issue, it could be that you are using Windows 7 and have installed your atom in the default location i.e., c:\Program Files. A simple solution is to install your atom outside 'Program Files' folder.Hope this post is useful