Adding a StarTeam Server Configuration to the StarTeam Web Server

The StarTeam Web Server can only connect to a StarTeam Server configuration that supports MPX, and MPX must be running.

Perform the following steps to add a server configuration to the Available Servers folder tree and specify the StarTeam Server's item types, projects, and views that will be available to StarTeam Web Client users.

  1. Type a unique, easy-to-remember description in the Description field. It is not case-sensitive and can contain colons (:).
    Note: This description is the name used in the StarTeam Web Client.
  2. Type the server configuration's computer name or IP address in the Address field.
  3. Type the endpoint (TCP/IP port number) associated with the protocol in the Port field.
  4. Type your User name and Password in the appropriate fields.
    Note: The specified user must have administrative rights on the server configuration.
  5. Click Add Server to Selected Servers.

    The server configuration will be added to the Available Servers folder tree with its check box checked by default, as only checked entries can be made available to StarTeam Web Client users.

    Note: StarTeam Web Server Administrators can make a server configuration unavailable to StarTeam Web Client users by clearing its check box.
  6. Under the server configuration's Available Types, check the item types to be made available to StarTeam Web Client users.
  7. Under the server configuration's Available Projects, select the StarTeam projects to be made available to StarTeam Web Client users using one of the following options for each project:
    • Select Allow All Views under a project in the server tree. When selected, all views for the project are allowed to be used and cached and the other view node options are disabled.
    • Under a project's Available Views, select the views to be made available to StarTeam Web Client users.
    Note: The number of available views affects the amount of memory needed for the StarTeam Web Server process. If the StarTeam Web Server is running out of memory, set the disable_sdk_sessions value to true in the file located in \apache-tomcat-[version]\shared\StarTeam in the installation folder. This will enable the StarTeam Web Server to start without loading the available views, and you can then decrease the configuration size.
  8. Optionally: To make all views for a server available, select a server in the server tree and click Allow all Views for Selected Server. All projects for the server will have the Allow all Views check box selected. This is a quick and efficient way to include all project views at once for the selected server.
  9. Click Save, click OK on the confirmation dialog box, then restart the StarTeam Web Server. When changes to the configuration are saved, the changes are applied dynamically. The StarTeam Web Server process monitors the file for changes and applies all changes that are made.