Configure Server page

This topic describes the tabs on the Configure Server page. To access the tabs, select Tools > Administration > Configure Server and click the desired tab.

In this topic:

General tab

The General tab allows you to set server time-out options and enable e-mail support.

Server startup log file	Default value is ..\Repository Path\server.log. This field is read-only. The path specified when creating a new server configuration.
Logon sequence timeout	Default value is 60 seconds. Any logon not completed within this amount of time will fail.
Inactivity timeout __ minutes	Default value is off. Automatically logs off users who are inactive for the specified amount of time. Does not apply to users who have set system notification in their client Personal Options dialog box for a shorter period of time, because of the automatic communication between the client and the server. Also does not apply to named users, if the Exclude named users option (shown below) has been selected. Always set the Inactivity timeout to a value greater than the Reconnect timeout. Otherwise, if the Reconnect timeout and the Inactivity timeout are both enabled and the Inactivity timeout is shorter than the Reconnect timeout, the user is logged off before the client can reestablish the connection.
Exclude named users	Default is disabled. Allows named users to remain logged on even if they have exceeded the Inactivity timeout limit. Feature is available only when Inactivity timeout is selected and a value entered.
Enable enhanced links for all projects	Allows users to enable and disable enhanced process links for all projects on the server configuration.
Enable enhanced links for new projects	Allows users to enable and disable enhanced process links for new projects created on the server configuration.

Back to top

Audits tab

The Audits tab allows you to enable audit log generation and to purge audit logs.

Enable audit generation	Default value is on. Audit log data is stored in the database for the server configuration; if data requires too much space, option can be disabled.
Purge audit entries older than __ days	Default value is off. Automatically removes audit entries older than a specified number of days to minimize the amount of log space required. Default is 90 days, if option is enabled. Number of days can be edited. The server configuration must be restarted to purge the audit logs.

Back to top

Database tab

The Database tab allows you to view the database type for the server configuration.

Database Server Name	Disabled. Read only. Database server name can be set only when server configuration is created.
Database type	Disabled. Read only. Database type can be set only when server configuration is created.

Back to top

Protocol tab

The Protocol tab allows you to set the default starting end point and encryption levels for a server configuration.

TCP/IP endpoint	Default value is 49201. Selected during creation of server configuration.
TCP/IP encryption levels	Default is set for No encryption. Used to set a minimum encryption level for data transferred via TCP/IP. Use Add, Remove, and Modify to add additional encryption levels.
TLS (Secure Sockets) endpoint	Default value is 49202.  Disabled by default.
TLS Certificate information	Name of files containing certificate and key. Files should be copied to folder "CACertificates" under Server installation folder. The certificates must be in PEM format. When using a certificate chain all certificates should be in one file, and certificates must be sorted starting with the subject's certificate (actual server certificate), followed by intermediate CA certificates if applicable, and ending at the highest level (root) CA.

Back to top

Event Handlers tab

The Event Handlers tab allows you to assign default event handlers for the server/clients.

Event handler	Default value is none. Allows entry or selection of event handler program.
Event handler description	Default value is on. Allows description of selected event handler program.

Back to top

Directory Service tab

The Directory Service tab allows you to enable directory service support for the server configuration.

StarTeam supports dual directory services. You can configure a secondary directory service after setting up a primary one. After you set up a directory service, you must restart the server in order for the changes to take effect. Administrators can specify which directory service to use for each user, in the User Manager's User Properties > Logon tab. This option is only visible in the User Manager after the secondary directory service was defined and the server restarted.

Enable directory service support	Default value is off. Uses the specified Microsoft Active Directory service to validate user passwords. For a user's password to be validated, the Validate with directory service option must also be selected on the New User Properties or User Properties dialog boxes and the Distinguished name from Microsoft Active Directory service entered for the individual. Restart the server configuration to be sure that the connection to the service can be made before setting up the users. The server log contains the connection information. For example: Connected to Active Directory Server: ldaps://host:port where host and port are the values you enter on this tab.
Host	Host name or IP address of the Microsoft Active Directory service. It is an alphanumeric value of up to 254 characters. Instead of using a host name or IP address in the Host text box, you can use a domain name. When you use a domain name, StarTeam Server can contact any active copy of Active Directory anywhere in the domain so long as that copy uses the specified port. Some companies run more than one copy of Active Directory in case one goes down.
Port	Default value is 389 (secure port). TLS or SSL port of the directory server. It's a numeric value.
SSL or TLS	Select either one of the secure options or leave nothing selected for unsecure.

Back to top

Diagnostics tab

The Diagnostics tab allows you to enable diagnostic tests for your server configuration.

Trace operations that take at least ___ milliseconds	By default, this value is 0 milliseconds. Creates a .trc file that allows commands to be traced. Commands are traced if they have a duration time that equals or exceeds the specified number of milliseconds. If 0 (the default) is used, all commands will be traced.
Enable statistics monitoring. Record every ___ minutes	Enables the server to track server statistics such as memory usage, currently executed commands, locking statistics, and so on.
Unexpected conditions	Default is off. Creates a diagnostic (.dmp) file for asserts (server log entries with code # 8).
Errors	Default is off. Creates a diagnostic (.dmp) file for exceptions (server log entries with code #4).
Diagnostic file type (default is 0)	Use this option only at the direction of the technical support. Clicking Generate Now creates a diagnostic file (.dmp) and places it in the server configuration's log path. It can take several minutes to generate this file, and the server does no other processing while creating this file.

Back to top