Configuring the Broker Administration Service

The Broker Administration Service allows you to start, stop, and retrieve the status of a local broker.

It is provided in a fully functional state and is started by the installation. It needs access to local port 57909 with restriction to local users.

The port of the Administration Service can be changed in the configuration file etc/brokeradminwrapper.conf. If you change the port you need to restart the administration service. This is the line to change:

wrapper.java.additional.101=-Dcom.sun.management.jmxremote.port=57909

In most cases you will not need to change the configuration file. The log files provide more information about the service and can help you analyze the cause of any error that occurs. The log file is called wrapper.log and is located in config/etb.

The Administration Service requires SSL certificates to create brokers with SSL ports. These certificates are for test purposes only and constitute a security risk. If you want to use SSL, replace the certificates in the etc directory with your own SSL certificates.

When a broker is created, the Administration Service copies the required certificates from the EntireX etc directory to the working directory of the newly created broker.

If the certificates are to be replaced after the installation, you also need to replace the certificates in the working directories ETB001 (Default Broker) and in the EntireX directory etc.