The Administration Service controls the processes of the local brokers. The brokers are started or stopped. The local brokers connect with the Administration Service and provide it with their status and other information at an interval of 60 seconds. The Administration Service always has information on the current status of all local brokers.

The Administration Service also collates the status and other information of any known remote brokers and provides an interface with which these can be accessed.

The Administration Service is provided in a fully functional state and is started by the installation. It needs access to the local port 57707, and to port 57808 for remote connections. The connections to port 57808 are SSL only. If this port is to be used, the client requires the respective SSL certificate.

The ports of the Administration Service and of the default Broker ETB001 can be changed in the configuration file config/entirex.config.

entirex.default.broker.tcp.port=20071
entirex.default.broker.ssl.port=20051
entirex.etbadm.tcp.port=20007
entirex.etbadm.ssl.port=20008

It is not normally necessary to change the configuration of the Administration Service. The log files and SSL certificates are delivered in the EntireX directory config/etb/ETBADM. If an error occurs, the log files of the Administration Service can provide information on the cause of the error. The log files are called ETBADM.LOG and ETBSRV.LOG.

The Administration Service requires SSL certificates to create brokers with SSL ports. During installation, the Administration Service copies the SSL certificates from the EntireX etc directory to the EntireX config/etb directory if this directory does not already contain any certificates. These certificates are for test purposes only and constitute a security risk. If you want to use SSL, replace the certificates in the config/etb directory with your own SSL certificates.

When a broker is created, the Administration Service copies the required certificates from the EntireX config/etb 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 ETBADM (Administration Service) and ETB001 (Default Broker) in the EntireX directory config/etb.