Running the StarTeamMPX Message Broker on Linux

On Linux platforms, the Message Broker runs as a daemon and is incorporated into the init.d initialization and termination process. This means that the following file is placed in the /etc/init.d/ directory by the installer:

STMB68
This file is the initialization/termination script for the Message Broker.

These script files are linked to the run level 3 multi-user state by placing the following files in the /etc/rc3.d/ directory:

S98stmb68
This file is a symbolic link to /etc/init.d/STMB68, which is the Message Broker script. Because the file prefix is S, the operating system calls this script with the parameter start when the system is entering run level 3. When called with this parameter, the script will start the Message Broker. The number “98” is the startup sequence number, which controls the order in which scripts are executed. (The sequence number can be changed to another value by renaming the file. See the man pages for init.d for more information.)
K98stmb68
This file is a symbolic link to /etc/init.d/STMB68, which is the Message Broker script. Because the file prefix is K, the operating system calls this script with the parameter stop when the system is exiting run level 3. When called with this parameter, the script will terminate the Message Broker.

As a result of these scripts, the Message Broker is normally started and stopped automatically as the system initializes and shuts down. If you need to manually start or stop the Message Broker, you can do so by performing the following steps:

  1. Log onto an account with root privileges.
  2. Change directories to the folder containing the initialization/termination scripts. For example: cd /etc/init.d.
  3. Run the appropriate script with the parameter start to start the corresponding daemon, or stop to stop an existing daemon:
    • To start the Message Broker: STMB68 start
    • To stop the Message Broker: STMB68 stop