Using Profiles with Multiple Connections
In the following figure, a sample
StarTeam Server is shown with two MPX-enabled server configurations (Config1
and
Config2
). Each configuration has its own
MPXEventTransmitter.xml file. There are two
Message Brokers: one is the default for
Config1
and the other is the default for
Config2
. Both XML files could define a profile for each
Message Broker, one as the client and server default, and the other as an optional profile.
When an Event Transmitter for a specific configuration is successfully initialized, one profile is designated as the default client profile. StarTeam clients can open projects in MPX mode using that default profile or by choosing an alternate connection profile:
- When a client first logs onto a server configuration, it queries the server to determine if it is operating in MPX mode. If the server configuration is operating in MPX mode, it returns the list of connection profiles defined in its Event Transmitter XML file.
- If the user has locally chosen a specific connection profile to use for the configuration, the details of the chosen profile are loaded. Otherwise, the details of the client default profile are loaded.
- The client uses the chosen connection profile to connect to the corresponding Message Broker. If a connection cannot be established, the client displays an error message, and continues accessing the configuration as if it were not MPX-enabled.
- When a Message Broker connection is established and a new project is opened on a different, MPX-enabled server configuration, the client opens a new connection to the Message Broker specified in the default or selected profile for that server.
Note: The client can also define custom connection properties that are stored locally on the client workstation. Client configuration options are described in “Configuring Clients.”