Accessing StarTeam Servers

To access data under source control, users must create a connection to a server configuration from within their development environment. The connection information is then stored in a file named starteam-servers.xml. If you accidentally lose the connection to the server while working in an application, the Integration automatically re-establishes the connection.

For existing server configurations, the Integration uses the MPX profile defined for the configuration. If you add a new server configuration using the Integration, this configuration will use the StarTeamMPX default profile. If you want to view or change this profile, you must use the client. To do this, log onto StarTeam, select Project > New or Open > Server Properties and click on the MPX button.

Depending upon the Integration you use, the procedure for creating a connection varies. The following section explains how to enter the connection information in the Existing StarTeam Servers dialog.

Tip: When more than one person accesses the development environment files within a project, all team members should use the same description for the server configuration that stores that project.

To create or modify a connection to a server configuration:

From the Create New StarTeam Project dialog or Open Existing StarTeam Project dialog, click Servers.
In the Existing StarTeam Servers dialog, click New or Modify. The StarTeam ServerStarTeam Server dialog appears.
In the Server Description field, enter a unique descriptive name for the server. It is case-insensitive and cannot contain colons (:). It can be any name, but a common choice is the name of the computer on which the server is running. This name should match the description used by others to access this server.
In the Server Address field, enter the computer name or IP address.
In the TCP/IP Endpoint field, enter the appropriate information.
Click OK.
Click OK to return to the Create New StarTeam Project dialog or Open Existing StarTeam Project dialog, which should now preselect the server description in the StarTeam list.