Setting up Default Personal Options

If, during a custom installation of the StarTeam Server for Microsoft Windows, you choose the Client Setup option, the installation files for StarTeam Cross-Platform Client were copied to a location designated by you and accessible to all users. Users can install from that location. One of the benefits of this arrangement is that each new user can be given a set of initial personal options, selected by you, instead of using the usual default StarTeam Cross-Platform Client personal options. For example, if these users use Change Requests more often than any other Micro Focus tab, you can make the Change Requests tab the first, or only, tab that the client displays.

To customize default personal options, create a file named starteam-client-options.xml and place it in the Client Setup folder. During the StarTeam Cross-Platform Client installation, the default personal options file you created is copied to C:\Users\User_ID\AppData\Roaming\Borland\StarTeam where it becomes a template for the starteam-client-options.xml file created by the StarTeam Cross-Platform Client when a user starts it for the first time. Existing client users can use your personal options before starting the client. The client will not overwrite the existing starteam-client-options.xml.

To provide all new users of the StarTeam Cross-Platform Client with the same initial set of personal options:

  1. Perform a custom installation of StarTeam Server while selecting the Client Setup check box, so that the disk image for StarTeam Cross-Platform Client is installed in the Client Setup folder, a child folder of the StarTeam Server installation folder.
  2. Make sure that this folder is one that all team members can access.
  3. Install the StarTeam Cross-Platform Client on only one computer.
  4. Set the personal options. See the StarTeam online help for details.
  5. Notice that you now have a file named starteam-client-options.xml in the user profile folder. On Microsoft Windows, this is usually in the C:\Users\User_ID\AppData\Roaming\Borland\StarTeam folder.
  6. Copy this file to the Client Setup folder.
  7. Rename this file starteam-client-options.xml.
  8. Instruct users to install the StarTeam Cross-Platform Client from the Client Setup folder.