Creating and Starting a Server Configuration

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 server configuration and start it for the first time. It assumes that you want the server to automatically create a PostgreSQL database. If that is not the case, see Creating a Database Manually.

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. Check the option to Create new StarTeam database, so that StarTeam Server automatically creates the database.
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 to create the PostgreSQL database.
Enter the server and database information:
1. Enter the name in the Database Server name field.
2. Type or click Browse to specify the names of the computer and the database on your network that should be used.
3. Enter the password for the system administrator in the Database Server name field. The initial default system administrator password is postgres.
4. Click Verify Connection to test the connection. If the connection fails, review and change your settings.
5. Click Next.
Enter the information for creating the data files and transaction logs, and click Finish.
Note: We recommend keeping the data files and transaction log files on different physical drives under their own disk controllers.

The default settings are appropriate for your use if you have fewer than 15 users and expect to store 1GB or less data.
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.