Server Administration

StarTeam Server Administration

Welcome to StarTeam

Introduction

Installation and Licensing for StarTeam

Products Included with StarTeam Enterprise Licenses

Products Included with StarTeam Enterprise Advantage Licenses

Contacting Support

Standard StarTeam Architecture Overview

About Source Control

Atomic Check-ins

Deployment Guidelines

Performance and Scalability Factors

Configuration Size

Multiple Configurations on the Same Server

Medium Configurations

Large Configurations

Active/Passive Clustering

Server Administration

StarTeam Server Administration Overview

Server Administrator Assumptions

StarTeam Server Configuration Sample Data

Licensing the Server

Setting Up License Servers

Using Evaluation Licenses

Using Native Licenses

Registering a Native License Using the Server Administration Tool

Registering a Native License at the Command Prompt

Saving License (.slip) Files

Assigning Licenses to Users

Assigning Licenses to Existing Users

Assigning a License to a New User

Managing Named User Licenses

Working with Server Configurations

About Server Configurations

Server Configuration Overview

Server Configuration Guidelines

Project Structure

Using a Test Server

Opening the Server Administration Tool

Starting the Server Administration Tool from the Start Menu

Starting the Server Administration Utility from a Command Prompt

Server Administration Tool

Server Configuration Status Icons

Server Administration Keyboard Shortcuts

Creating, Running, and Managing Server Configurations

Creating Server Configurations

Loading Server Configuration Sample Data

Starting and Stopping Server Configurations

Starting and Logging into a Server Configuration Using the Server Administration Tool

Starting a Server Configuration with Different Configuration Options

Starting a Server Configuration Using Defined Values from the Command Line

Shutting Down a Server Configuration Using the Server Admin Tool

Shutting Down a Server Configuration Using the Command Line

Server Configurations and Microsoft Windows Services

Setting a Server Configuration to Run as a Microsoft Windows Service

Shutting Down a Server Configuration that is Running as a Windows Service

Troubleshooting a Server Configuration that is Running as Microsoft Windows Service

Disabling and Enabling Server Configurations

Locking and Unlocking Server Configurations

Managing Users and Groups

User and Group Configuration Overview

Overview of Security Strategies

Component Access Rights

Setting Component-Level Access Rights

Component-level Filter Access Rights

Component-Level Query Access Rights

Configuring Server-level Access Rights

Project Access Rights

Server Access Rights

Setting Up Users

Reviewing a User’s Explicit Group Memberships

Changing Group Memberships

Removing Users from Groups

Removing User Accounts

Checking Account Status for Users

Suspending User Accounts

Reactivating User Accounts

Configuring Privileges

Setting Up Groups

Changing the Parent of a Group

Determining the Members of a Group

Removing an Empty Group

Configuring Group Privileges

Group Privileges

Password Use

LDAP for Password Verification

Enabling Directory Service Support

Changing User Passwords

Configuring Password Constraints

Forcing Password Changes

Forcing Users to Log Off

Reactivating Administrative Accounts

Configuring the Server

Online Purge

Starting and Stopping Online Purge

Customize VCM Tab

Creating a Custom View Compare/Merge Merge Type

Vault Verify for Verifying File Revisions

Verifying File Revisions with Vault Verify

Exporting Database Information

Changing Server Configuration Properties

Setting Security Options

Server Time-Out Options

Changing Server Timeout Options

Changing the Logon Sequence Time

Setting an Inactivity Timeout for Users

Changing the Reconnect Timeout

Configuring the Number of Logon Attempts

Setting an Encryption Level

Setting an Encryption Level for Transferred Data Regardless of IP Address

Setting a Different Encryption Level for a Specific Address or Range of Addresses

Enabling Server Auto-reconnect

Working with Event Handlers

Creating Event Handlers

Reviewing or Modifying Existing Event Handlers

Assigning Default Event Handlers for the Server/Clients

Removing an Event Handler

StarTeam Offline Proxy Utility

Server Message Notification

Email Support Notifications

Email Notifications

Custom Email Notifications

Configuring Email Support and Email Notification

Configuring Per-project and Per-Component Email Notifications

Designating Endpoints

Monitoring Server Statistics

Troubleshooting Server Configuration Problems

Activating Diagnostic Tests

Change Request Configuration File

Change Request Message Template Syntax

Enabling Advanced View Types

StarTeam SDK Connection Control

Configure Server Page

Configure Server Page (General Tab)

Configure Server Page (Audits Tab)

Configure Server Page (Database Tab)

Configure Server Page (Protocol Tab)

Configure Server Page (Event Handlers Tab)

Configure Server Page (Directory Service Tab)

Configure Server Page (Diagnostics Tab)

Upgrade Distribution through StarFlow

Auto Client Update

Search

Search Index Configuration

Customization

Multi-Configuration Search

Filtering Options

Troubleshooting

Custom Components

Custom Component Builder

Creating a Custom Component

Creating Properties for Custom Components

Editing a Custom Component

Cloning a Component Definition

Exporting a Component Definition

Deploying a Custom Component to Clients

Manually Creating Custom Components

Import/Export Manager

Import/Export Manager Business Rules

Exporting

Exporting a Project

Importing

Importing an Export File

Handle Conflicts During Import Dialog Box

Maintenance Task Scheduler

Assigning a Schedule to a Script

Maintenance Task Scheduler Dialog Box

Managing Log and Initialization Files

Initialization Files

ConnectionManager.ini

starteam-client-options.xml

starteam-server-configs.xml

Recommended Configuration Options

StarTeam.Log

Displaying and Customizing StarTeam.Log

Audit Logs

Enabling and Purging the Audit Log

Security Logs

Working with the Security Event Log

Security Event Types

Working with the Server Log

Server Log Error Codes

DbConvert.<local>.log

Analyze Server Log and Analyze Archived Server Logs

Tracing Data from Check-out Operations

Tracing Data from Check-out Operations with the Check-out Trace Utility

Enabling Tracing for Server Configurations Manually

Generating .CSV Files About Check-out Operations

Data Storage Options

Data Storage Overview

Native-II Vaults

Creating New Hives

Customizing the Archives Path

Viewing and Customizing Hive Properties

Migrating Servers

Moving Server Configurations Overview

Migrating Server Configurations

Preparing for Database Migration

Migrating a Database

Completing the Migration

Moving Server Configurations to a New Server

Guidelines for Data Files and Translation Logs

Guidelines for Microsoft SQL Server/Microsoft SQL Server Express Data Files and Transaction Logs

Guidelines for Oracle Schema User Data Files

Splitting Server Configurations