Multi-Configuration Search

StarTeam allows users of the StarTeam Cross-Platform Client to search across multiple server configurations that may be running on different machines. Each UI provides the user an option to select from a list of available servers from which to search. Appropriate access rights checks are performed on all servers containing matching artifacts.

The search service is a web server process (StarteamSearchWebService15) which handles search requests and indexing of artifacts of all the servers located in the same machine. If there are multiple search services running on different machines, a network of search services needs to be defined in starteam-search-configs.xml. You do this by (1) defining one as the Master Broker and referencing all other search services from there, and (2) pointing to the Master Broker from each search service. To do this:

Choose the server that will be the Master Broker.
Open the <server installation folder>/Search/config/starteam-search-configs.xml file for editing.
Locate <SearchServiceNetwork>.

Enter an item in the following format for each search service that the Master Broker should reference:

<SearchService host="01.02.03.04" port="9090"/>
<SearchService host="05.06.07.08" port="9090"/>
<SearchService host="09.10.11.12" port="9090"/>

For each search service machine referenced by the Master Broker, open its starteam-server-configs.xml file to configure the Master Broker.
```
<AllConfigurations>
……………………………………………………………………………………………………
……………………………………………………………………………………………………
<option name="SearchServiceBrokerHost" value="##.###.##.###"/>
<option name="SearchServiceBrokerPort" value="9090"/>
</AllConfigurations>
```
Note: If there is only one search service process handling multiple servers on the same machine, the network is not required to be defined. All servers handled by the search service are automatically available for the multi-configuration search.