Could not connect to RTServer



When running StarTeam on a notebook for demo purposes or on a machine with a DHCP assigned IP address, when the IP address changes the server will fail to connect to the root message broker with the error "Could not connect to RTServer"

The root message broker is installed on the StarTeam Server machine.


This can be resolved by installing a virtual loopback adapter for StarTeam to use.
  1. Click Start | Run
  2. Type "hdwwiz.exe" and press RETURN
  3. Click "Install the hardware that I manually select from a list"

  4. Click Next
  5. Scroll down and select "Network adapters"

  6. Click Next
  7. In the "Manufacturer" pane select "Microsoft"
  8. In the "Network adapter pane select "Microsoft Loopback Adapter"

  9. Click Next 
  10. Click Next 
  11. Click Finish

The loopback adapter will now be installed and should be configured with a loopback IP address.

  1. Browse to "Network Connections" in control panel or run "ncpa.cpl"
  2. Right click the adapter of type "Microsoft Loopback Adapter" and click Properties
  3. Click "Use the following IP address" in the first radio box
  4. In the IP address field enter an IP address valid only locally, which is not valid on your wider corporate network. For example - 
  5. Press tab to populate the subnet entry
  6. Leave default gateway blank and click OK

The loopback adapter will now be configured. Take note of the IP address entered above.

  1. Browse to the "EventServices" subfolder of the StarTeam Server installation directory
  2. Enter the subfolder which has the name of your configuration, such as "Demo" or "StarDraw"
  3. Backup MPXEventTransmitter.xml and open it for editing
  4. Locate the attribute <server_names> and edit it to specify the IP address used when configuring the loopback adapter, such as follows


    The :5101 notation specifies the port, if your message broker runs on a non standard port, ensure this port is specified correctly.

  5. Save the file
  6. Shut down the StarTeam Server
  7. Start the StarTeam Server

The StarTeam Server will now connect to the root message broker successfully.

When the IP address is changed due to DHCP renewal or connection to a new external network, the message broker connection will continue to function.


Comment List