MPX Message Broker installation

In this topic:

Installing MPX Message Broker on Windows

The root Message Broker can be installed on the same computer where the StarTeam Server is installed, or it can be installed on a network-near computer. At least one Message Broker must be installed in your environment to provide messaging services for an MPX-enabled Server. As described in Understanding Clouds, you may want to install more than one Message Broker to meet your needs.

To install the Message Broker on Microsoft Windows:

1. Log on to the computer as the administrator or as a user with administrative privileges.
   
2. Navigate to the directory that contains the downloaded files.
   
3. Run the installation file for the ActiveMQ MPX Message Broker.
4. Walk through the installer and select the configuration options specific to your environment. For example, are you upgrading or freshly installing? Are you are installing the ActiveMQ MPX Message Broker? Do you want the service to start automatically or manually.

Back to top

Uninstalling Message Broker and MPX Cache Agents - Windows

Each time you install a Message Broker or MPX Cache Agent, an uninstall program shortcut is created for that component. The uninstall programs enable you to remove the Message Broker/MPX Cache Agent from your computer. Your StarTeam Server installation, server configurations, and repositories are unaffected.

The uninstall program for StarTeam Server leaves the transmitter template files and each configuration's transmitter XML files intact. A subsequent installation will not overwrite these files.

The MPX Services Uninstall program leaves the STMessageBroker68.ini file intact. If you later reinstall these services, this file will not be replaced by the new installation.

You may encounter the following Uninstall errors:

• Can't launch executable. Could not find a suitable Java Virtual machine on your system.
• Windows error 3 occurred while loading the Java VM.

Back to top

Installing MPX Message Broker on Linux

This section describes how to install Message Broker on a Linux machine.

To install Message Broker:

1. Close all applications.
   
2. Navigate to the directory that contains the downloaded files.
   
3. Run the downloaded installer.
   
4. Run the binary file using the command ./mpxservices.bin.

   Note: When installing or uninstalling on a non-Microsoft Windows platform, specify the installed Java VM to use as a parameter when running the installer. This step is necessary because Java VMs for non-Microsoft Windows operating systems are not bundled with the installers. If you experience any difficulties when running the command ./mpxservices.bin, add the parameter LAX_VM and specify the path to your VM. For example: ./mpxservices.bin LAX_VM /usr/java/latest/jre/bin/java.

   Note: If the OpenSSL toolkit (openssl097a-0.9.7a-9.i386.rpm) and the Compatibility standard C++ libraries (compat-libstdc++-33-3.2.3-61.i386.rpm) are not installed, the MPX Services installer will prompt you to install them before continuing with the installation of StarTeam Message Broker.

5. On the Introduction page, read the information, and click Next.
   
6. On the License Agreement page, read the agreement. If you agree with the license agreement, click I accept.... If you do not accept the license agreement, you cannot install the product.
   
7. On the Choose Install Folder page, browse for the location to be used as the installation folder.
   

   The default location is /opt/messagebroker68.

8. Click Next.
   
9. On the Choose Link Folder page, specify whether to create links in your home folder, to create them in another location, or to not create them at all.
   
10. Click Next.
    
11. On the Pre-installation Summary page, review the settings and click Previous one or more times if you want to change the installation options. Then return to the Pre-installation Summary page, and click Next or Install.
    
12. On the Install Complete page, click Done.
    

Back to top