Creating a Server Configuration (for an Existing Database)

The first time you start a new server configuration, StarTeam Server creates all tables in the database you specify. This section explains how to create a StarTeam Server configuration using a previously created PostgreSQL database.

Database names should:

Begin with a letter.
Contain letters and numbers only.
Not contain spaces.
Not be a SQL reserved word such as create, delete, if, then, else, or goto.

Important: The Server Administration database options may fail to run for databases with names that do not follow these guidelines.

Start the Server Administration tool. Click Start > Programs > Micro Focus > StarTeam Server <version> > StarTeam Server. The Server Administration tool opens.
Click Server > New Configuration. The New Configuration dialog box opens.
Enter the new configuration data:
1. Type the name of the configuration in the Configuration Name field. If you want the server configuration to have the same name as the database (a nice convention, especially if you have several server configurations), you must follow the database naming conventions explained at the beginning of this section.
2. Type or click Browse to specify the Repository Path location to be used to store log files and other information. If the repository path that you enter does not exist, the application creates it for you. The Repository Path is also the location for the default hive.
3. Select PostgreSQL from the Database Type list.
4. Uncheck the option to Create new StarTeam database, so that StarTeam Server will not automatically create the database for it.
5. Create an initial hive for the Native-II vault by doing one of the following:
  Accept the default settings
  Leave the Default option selected and proceed to the next step. With the default settings, StarTeam Server:
  - Creates an initial hive named DefaultHive.
  - Creates subfolders on the repository path named Archives and Cache to be used by the DefaultHive.
  - Stipulates that the maximum cache size is 20% of the space currently available on the drive on which the cache is located.
  - Uses the default setting of 600 seconds (10 minutes) between cache cleanups.
  - Uses the default setting of 95% for the storage threshold, the point at which this drive is considered full.
  Specify custom values
  
  Select the Custom option and change any of the hive settings.
6. Click Next, and enter the Database Server name, Database name, Database login name, and password in the appropriate text boxes.
7. Optionally, if you are using a port other than the default, check Edit Database Port and type the port number in the text field.
8. Click Verify Connection to test the connection. If the connection fails, review and change your settings.
9. Click Finish. This action re-displays the Server Administration tool, which shows your new server configuration as a child of the Local node.
  Note: In addition to creating the server configuration, StarTeam Server adds information about the new server configuration to your starteam-server-configs.xml file. For more information about this file, see the Server Administration Tool Help.
10. Optionally, if you are using a port other than the default, check Edit Database Port and type the port number in the text field.
11. Click Verify Connection to test the connection. If the connection fails, review and change your settings.
12. Click Finish. This action re-displays the Server Administration tool, which shows your new server configuration as a child of the Local node.
  Note: In addition to creating the server configuration, StarTeam Server adds information about the new server configuration to your starteam-server-configs.xml file. For more information about this file, see the Server Administration Tool Help.
By default, all server configurations are set to use the TCP/IP endpoint (port) 49201. However, each server configuration on a given computer must have a unique endpoint so it is recommended that you edit the default endpoint. To change the endpoint:
1. Select the server configuration.
2. Click the Start with Override button (or click Actions > Start with Override from the main menu). The Start with Override dialog box opens.
3. Enter the endpoint that you want to use in the TCP/IP Endpoint field, and click OK.
Be sure to configure your new server configuration (for information, see the Server Administration Tool Help) and plan a backup schedule for it.