Troubleshooting the Installation

When running Mule ESB server and the console in a Tomcat environment you may have a problem registering the Mule server instance with the console agent. This problem occurs when you try to register the server through the console screen. After entering the server name and the URL for the Mule agent, the console displays a message indicating that the console could not register the Mule server you specified, and that the server host system did not send a valid HTTP response. This problem usually occurs if you had previously unregistered the same server instance, but for some reason the unregistration process did not complete properly. There may be other reasons why the Mule server instance may internally be still registered.

When this occurs, you need to do the following to fix the problem:

Getting this exception when trying to register Mule Server using MMC Could not register server <serverName>: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

Solution: Try deleting truststore.jks from the <MULE_HOME>/.mule/.agent folder, or delete the .mule/.agent folder completely. It is not necessary to stop the Mule server to delete this file.

You may want to configure a different default port for agent communication, or a different server ID before running Mule.

You can change the agent configuration from that of the default URL, which is displayed when registering a new server instance. The agent configuration determines the bind port for the server instance. You may wish to change the agent URL if you want to start multiple instances of Mule ESB within the same box and connect the console to these different instances, or if you want to connect to remote server instances.

Unless a port is specified, the console will look in the 7777-7877 port range and bind to the first free port by default. When you start Mule from a command line, you can change the port to which the server binds. You specify the new port as a switch or option in the command used to start Mule, as follows:

For example:

You may also specify a custom port range, as follows:

This will force the agent to bind on the first available port starting from 7783 until 7883.

You can also specify these arguments in the wrapper.conf file. For organizations with strict policies on available ports, this option should be used.

In addition, when you change the agent bind port to accommodate multiple Mule instances, you also must start Mule from the bin directory that corresponds to the particular Mule instance. For example, you might run a second instance of Mule as follows, where this second instance is installed at /opt/second_mule:

You can start more than one Mule agent instance, but you have to bind each agent to its own port and start a separate listener for each agent.

For example, if you start two Mule agent instances, one instance uses the default bind port of 7777, as described in the above section. For the second agent instance, you set up the port to which the agent binds as port 7778. You also must specify a listener class for this second agent instance. Add the following code to the web.xml file:

Note that the same two properties, the bind port and listener class, are supported for standalone Mule ESB servers and those servers configured via the web.xml file.

For the management console to work with a Tcat server, you need to modify the value of the variable PermGenSize from 128 to 256. You should increase the size of PermGenSize to 256 before you deploy the management console WAR file to Tcat. After modifying PermGenSize, start Tcat and then deploy the management console WAR file. Both Tcat and the management console should now work together with no problems.

If after changing PermGenSize and starting Tcat, you get an OutOfMemoryError message when deploying the console WAR file, then you need to take the following steps. These steps walk you through registering the Tcat local agent, deploying the management console WAR file, logging into the console and registering the console agent.

Edit the batch file for starting Tcat, catalina.bat. You want to move the line referencing JAVA_OPTS at the top of the file to line 126 in the file. Then, change the setting for `PermGenSize`within that line from 126m to 256m. When you’re done, line 126 should look as follows: