JRebel remote server support troubleshooter

This chapter details the most common problems with JRebel remote server support.

Working with multi-project applications

When working on large applications which are comprised of multiple projects in Eclipse, note that you need to enable JRebel and JRebel remote server support for each project separately. This also means that each and every separate project requires its own rebel.xml and rebel-remote.xml configuration files. In case of WAR modules, these XML files should be located in the WEB-INF/classes and in case of JAR files these XML files should be present in the JAR root.

Modifying the configuration must be followed by a redeploy

Whenever you change the JRebel remote server support configuration, you should redeploy your application to the server. Why? Because your configuration changes need to be reflected on the remote server. Unless your workstation and the remote server are in sync, remote server support will not work properly.

Enabling JRebel remote server support debug level log

When experiencing issues, it would be wise to enable debug level logging for JRebel remote server support. Follow the IDE manual chapters for instructions on how to do this.

Common error messages

The following is a list of the most common error messages encountered when using JRebel remote server support. We have provided the error message as well as the most common solution for resolving it.

  • JRebel remote server did not respond - this error message can occur in multiple situations. For starters, try disabling encryption (where enabled). Disabling encryption allows you to get more information on error states.

  • Encryption not enabled on server side - this can occur when you enable encryption on the client/IDE side and do not redeploy the new configuration to the server. Simply ensure that you have redeployed your fresh configuration to the server.

  • Encryption not enabled on client side - this happens when the server has been configured to encrypt data and the client side hasn’t. Enable JRebel remote server support data encryption in your IDE to resolve this.