Accessing StarTeam through a browser

This topic describes how to connect and configure your browser to access StarTeam over the web.

Log on to the StarTeam Web Server

To view StarTeamyour browser:

  1. Click Start > Programs > Micro Focus > StarTeam <version> Web Server > Start Web Server. The Tomcat Console opens and starts the StarTeam Web Server.
  2. Open a supported browser and enter the following URL in the address bar:
    http://<hostname>:<port>/StarTeam/StarTeamAdmin.jsp
    <hostname> Name of the computer where the StarTeam Web Server is running.
    <port> TCP/IP port number used by the StarTeam Web Server.

    The StarTeam Web Server is localized for several regions. If it does not detect your locale, try one of the following:

    http://yourserver/StarTeam/StarTeamAdmin_de.jsp
    http://yourserver/StarTeam/StarTeamAdmin_fr.jsp
    http://yourserver/StarTeam/StarTeamAdmin_ja.jsp
    http://yourserver/StarTeam/StarTeamAdmin_pt.jsp
    http://yourserver/StarTeam/StarTeamAdmin_zh.jsp

    The StarTeam Web Server logon page opens.

  3. When logging on for the first time, type Administrator in both the User name and Password fields. The password is case sensitive.
  4. Click OK.

Back to top

Changing the StarTeam Web Server Administrator User Name and Password

The StarTeam Web Server has one user account for web server administration. It is recommended to change the user name and password instead of using the default values for these two properties. Even though the StarTeam Web Server Administrator has the same default user name and password as the StarTeam Server Administrator, these are unrelated user accounts.
  1. In the Administration panel, type the new user name in the User name field.
  2. Type the new password in the Password field and again in the Confirm Password field.
  3. In Dynamic Cache Timeout, enter the length of time (in minutes) when a view will remain in memory before being removed. The default value is 15 minutes. The view is removed only if no one accesses it within the timeout period defined.
  4. Click Save. 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.

Back to top

Configuring component access

To choose the components that you want to make accessible to web client users:

  1. Open a supported browser and enter the following URL in the address bar:
    http://<hostname>:<port>/StarTeam/StarTeamAdmin.jsp
    <hostname> Name of the computer where the StarTeam Web Server is running.
    <port> TCP/IP port number used by the StarTeam Web Server.

    The StarTeam Web Server is localized for several regions. If it does not detect your locale, try one of the following:

    The StarTeam Web Server logon page opens

    http://yourserver/StarTeam/StarTeamAdmin_de.jsp
    http://yourserver/StarTeam/StarTeamAdmin_fr.jsp
    http://yourserver/StarTeam/StarTeamAdmin_ja.jsp
    http://yourserver/StarTeam/StarTeamAdmin_pt.jsp
    http://yourserver/StarTeam/StarTeamAdmin_zh.jsp
  2. When logging on for the first time, type Administrator in both the User name and Password fields. The password is case sensitive.
  3. On the Administration Panel, go to the Selected Servers group.
  4. Navigate down into the server that you want to configure and then under Available Types, select the components that you want to make accessible to web client users.
  5. Click Save.

Back to top

Adding a StarTeam Server configuration

This section describes how to add 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.

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

To add a server configuration:

  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.

Back to top

Removing a StarTeam Server configuration

This section describes how to remove a StarTeam Server configuration from the StarTeam Web Server.

To remove a server configuration:

  1. In the Available Servers folder tree, highlight the server configuration you want to remove.
  2. Click Remove Selected Server.
  3. Click Save.
  4. Click OK on the confirmation dialog box, then restart StarTeam Web Server.

Back to top

Accessing the StarTeam Web Client

To access the StarTeam Web Client, open a supported browser and enter the following URL in the address bar:

http://hostname:port/StarTeam
hostname Name of the computer where the StarTeam Web Server is running.
port TCP/IP port number used by the StarTeam Web Server.
The StarTeam Web Client is localized for several regions. If it does not detect your locale, try one of the following:
http://yourserver/StarTeam?locale=de
http://yourserver/StarTeam?locale=fr
http://yourserver/StarTeam?locale=ja
http://yourserver/StarTeam?locale=pt
http://yourserver/StarTeam?locale=zh

Back to top