StarTeam Installation Guide

StarTeam Installation Guide

Introduction

Included in this Guide

Accessing Products and Installation Instructions

Products Included with StarTeam Enterprise Licenses

Products Included with StarTeam Enterprise Advantage Licenses

Compilation Versions

Accessing Product Updates

Contacting Micro Focus

Installation Roadmap

Roadmap for Upgrading

Roadmap for StarTeam Cross-Platform Client

Roadmap for Server Administrators

StarTeam Server for Microsoft Windows Installation

About StarTeam Server

StarTeam Server System Requirements

Operating Systems

Third Party Software

StarTeam Server and Microsoft SQL Server Express on the Same Computer

StarTeam Server and Database on Different Computers

Database Server System Requirements

Unicode Character Sets

System Requirements for Linux

Pre-installation Requirements for a New Installation

Upgrading StarTeam

Preparing for an Upgrade

Overview of the Upgrade Process

Requirements for an Upgrade

Database Requirements for Upgrading

Microsoft SQL Server Database Upgrade Paths

Addressing Orphaned Users

Granting Oracle Privileges

Setting Database Compatibility Level for Microsoft SQL Server 2008

Upgrading Server Configurations

Changes to Server Files

Installing StarTeam Server

Post-Installation Tasks for a New Installation

Loading Server Configuration Sample Data

Post-Installation Tasks for an Upgrade

Apache Tomcat and Search

Evaluating StarTeam Server

Licensing StarTeam Server

Understanding Licensing

Using StarTeam Licensing

Using a License Server

Uninstalling StarTeam Server on Microsoft Windows

StarTeam Server for Linux Installation

System Requirements for Linux

Pre-Installation Setup

Installing StarTeam Server on Linux

Server Administration for Linux

Migrating from StarTeam 2008 Server for Windows to StarTeam 14.0 Server for Linux

MPX Installation and Configuration

MPX for Microsoft Windows Installation

Generating Transmitter XML Files

MPX System Requirements

MPX Message Broker and MPX Cache Agent Installation

Installing MPX Message Brokers

Upgrading the StarTeamMPX Message Broker to 6.8

MPX Cache Agent Installation

Upgrading the MPX Cache Agent

Before Installing an MPX Cache Agent

Installing an MPX Cache Agent

After Installing an MPX Cache Agent

Uninstalling Message Broker and MPX Cache Agents

MPX for Linux Installation

Installing Message Broker on Linux

Installing an MPX Cache Agent on Linux

Dependencies - Startup Order for MPX Components

Requirements When Using StarTeamMPX and ActiveMQ MPX Together

Requirements When Using ActiveMQ MPX Only

Configuring MPX to use ActiveMQ MPX

Configure MPX to use StarTeamMPX

StarTeam Cross-Platform Client Installation

StarTeam Cross-Platform Client System Requirements

Before Installing the StarTeam Cross-Platform Client

Setting up Default Personal Options

Installing the StarTeam Cross-Platform Client

Installing the StarTeam Cross-Platform Client on Microsoft Windows

Installing the StarTeam Cross-Platform Client on Linux or Solaris

Automating Client Installations

Performing a Silent Install

Additional Customization

Uninstalling the StarTeam Cross-Platform Client on Microsoft Windows

Installing StarTeam Integrations

StarTeam Web Server Installation and Configuration

StarTeam Web Server System Requirements

StarTeam Web Client System Requirements

Performance and Scalability

Dependencies - Startup Order for MPX Components

Installing the StarTeam Web Server

Logging on to the StarTeam Web Server

Changing the StarTeam Web Server Administrator User Name and Password

Configuring Component Access

Adding a StarTeam Server Configuration to the StarTeam Web Server

Removing a StarTeam Server Configuration from the StarTeam Web Server

Setting Up the StarTeam Web Server as a Microsoft Windows Service

Enabling SSL Using a Valid Certificate

Changing the Memory Allocated to the StarTeam Web Server

Setting the Log Output Level

Running Apache Tomcat Native

Specifying Item Details for the StarTeam Web Client

Creating a Custom Details Template

Accessing the StarTeam Web Client

StarTeam Layout Designer Installation

StarTeam Layout Designer System Requirements

Installing the Layout Designer

StarTeam Workflow Extensions Installation

Workflow Extensions

Workflow Designer

Notification Agent

StarTeam Workflow Extensions System Requirements

Extensions Installation Strategies

Installing Extensions

Installing Workflow Designer

Installing the Notification Agent

StarTeam Visual Studio Plugin Installation

Installing StarTeam Visual Studio Plugin

Installing StarTeam Visual Studio Plugin Help in Microsoft Visual Studio 2012

StarTeam Eclipse Plugin Installation

Datamart Installation

StarTeam Quality Center Synchronizer Installation

TeamInspector Installation and Configuration

Installing and Creating a Derby Database

What to Expect During the Installation Process

Installing on Microsoft Windows

Installing on Linux

Upgrading an Installation

Upgrading Your Installation Using the Derby Migration Utility

Configuring TeamInspector

Launching the Dashboard

Uninstallation Instructions

Troubleshooting Tips

Configuring Microsoft SQL Server/Express Databases

Creating a Server Configuration (for an Existing Database)

Using a Microsoft SQL Server Database

Connecting to Microsoft SQL Server Databases

Creating and Starting a Server Configuration

Windows Authentication Support for Microsoft SQL Server

Guidelines for Data Files and Transaction Logs

Running SQL Scripts for Microsoft Databases

SQL Scripts for Microsoft SQL Server and SSE Databases

Microsoft SQL Server Security

Creating a Database Manually

Understanding Collation

How Is the Default Collation Selected?

Backing up Microsoft SQL Server Databases

Configuring Oracle Databases

Using an Oracle Schema User

Verifying Connectivity Between Client and Server

Creating a Server Configuration for an Oracle Schema User

Installing Oracle Client

Using NLS_LANG Correctly

NLS_LANG Definition Overview

Defining NLS_LANG in the Microsoft Windows Registry

Defining the NLS_LANG as an Environment Variable

Database Character Set and StarTeam Server

Creating and Starting a Server Configuration with an Oracle Schema User

Guidelines for Data Files

Running SQL Scripts for Oracle Schema Users

StarTeam Server SQL Scripts for Oracle Schema Users

Oracle 12c Container Databases

Creating the Oracle Schema User Manually

Backing Up Oracle Databases

Oracle Database Tuning

Recommended Initialization Parameters

Tuning Oracle 10gR2 Databases

Tuning Oracle 11g Databases

Configuring PostgreSQL Databases

Creating a Server Configuration (for an Existing Database)

Creating and Starting a Server Configuration

SQL Scripts for PostgreSQL Databases

Creating a Database Manually

Configuring Federated Tracing

StarTeam Backups

Database Backups Overview

Microsoft SQL Server Database Backups

Oracle Database Backups

PostgreSQL Database Backups

Data Locations and Repositories

Native-II Vault Folders

Archive and Cache Path Structure

Log Files and Folders

Installing and Configuring Supporting Software

Synchronizing Workstation Clocks

Adobe Acrobat Reader

Java Runtime Environment