Borland StarTeam 2009 - Borland Technical Publications
Borland StarTeam 2009 - Borland Technical Publications Borland StarTeam 2009 - Borland Technical Publications
Installing StarTeam ServerBefore you install StarTeam Server, make sure you read Pre-installation Requirements for a New Installationon page 20. If you are upgrading from a previous release of StarTeam Server, make sure that you also readUpgrading Your Current StarTeam Server Patch Level on page 21.To install StarTeam Server:1. Close all other Windows applications.2. Run the downloaded installer, or if using replacement DVDs, insert the StarTeam 2009 Installation Disk 1DVD into your DVD drive. The Borland StarTeam Launcher window should appear automatically.If the installation menu does not appear automatically from inserting the DVD, display it by performing thefollowing steps:1. From the Windows Start menu, select Start ➤ Run2. At the command prompt, type:x:\setup.exewhere x: is the drive letter of your DVD drive.3. Press Enter. The StarTeam 2009 installation main menu opens.3. Click Install Products.4. Click Server and follow the installation instructions on the screen:1. For non-English versions, select a language from the drop-down list box, and then click OK.2. In the Introduction dialog box, read the information, and click Next.3. In the License Agreement dialog box:a. Read the agreement.b. If you agree with the license agreement, click I accept....If you do not accept the license agreement, you cannot install the product.c. Click Next.4. In the Choose Install Set dialog box:a. Choose either Typical, Compact, or Custom.• Typical - Installs StarTeam Server with the most common options. Recommended for most users.Those options are Program Files, Sample Server Configuration, SQL Server Express, and theserver’s Online Documentation.• Compact - Installs StarTeam Server with the minimum required options. Only the Program Filesand Online Help are installed. Use this if you will not be using SQL Server Express as a databaseand do not want to install the StarDraw Sample server configuration.• Custom - Enables you to choose the options you want to install. Recommended for advancedusers.Be sure to perform a custom installation if you want to:26 | Installing StarTeam Server on Windows
• Enable users to install the StarTeam client over the network from the computer on which StarTeamServer is installed.• Not install the StarDraw sample repository, for example, because it uses SQL Server Expressand you are not installing that database application either.b. For a Custom Install only, select (to install) or clear (to bypass) the available options:• StarTeam Server - If you use the custom installation to install something that was not installedduring a previous installation of StarTeam Server, you may choose to uncheck this check box.For example, suppose that in a previous custom installation, you elected to bypass the installationof SQL Server Express. To add that database without reinstalling all of the server program files,you would clear the StarTeam Server check box.• Client Setup - The client setup files are not automatically part of the server installation. If youselect the Client Setup check box, the StarTeam Cross-Platform Client installer is installed inthe Client Setup folder, a child folder of the StarTeam Server installation folder. Make sure thatthis folder is one that all team members can access.• SSE 2005 - SQL Server Express is a variant of Microsoft SQL 2005 offered by Microsoft at nocharge, as long as you comply with their stipulations. SSE2005_ST is installed as part of a typicalinstallation because it is used as the default database. If you use an enterprise-level databaseexclusively (Microsoft SQL or Oracle), you might not be interested in having the SQL ServerExpress files added to the server’s computer.• Sample server configuration - Clear this check box if you do not want to install StarDraw.Installing the StarDraw sample server configuration for this release will not overwrite an existingStarDraw configuration. However, the StarDraw server configuration in the StarTeam 2009starteam-server-configs.xml file will refer to the new StarDraw server configuration.• StarTeam Toolbar - Installs the StarTeam Toolbar which remembers passwords so that loggingon is easier.c. Click Next.5. In the Choose Install Folder dialog box, click Choose to browse for the location to be used as theinstallation folder. (The default location is C:\Program Files\Borland\ StarTeam Server 2009.)6. Use the MPX Options dialog box to make changes to the MPX profiles used by your server configurations.If this is the first time that the StarTeamMPX Event and File Transmitters have been installed on thiscomputer, the installer creates both Event Transmitter and File Transmitter template files using informationfrom the MPX Options dialog box. These files are stored in a subfolder of the installation folder namedEventServices.The local host name and IP address are provided at the top of this dialog box for reference purposes.By default, the Message Broker connection address uses your local computer’s IP address.a. To specify a different Message Broker for Event Transmitter (and any clients that will use the defaultprofile), change the proposed Message Broker connection address.This address must use the format:tcp:host:porthost is the host name or IP address on which the Message Broker operatesport is the TCP/IP port number (endpoint) with which the Message Broker accepts connections (5101is the default).Important: When installing to a computer that has more than one NIC or multiple IP addresses,do not accept the default server address settings. You must manually enter the correct serverIP address. When the installer detects multiple network addresses on the host computer, it setsInstalling StarTeam Server on Windows | 27
- Page 1 and 2: Borland StarTeam 2009Installation G
- Page 3 and 4: ContentsIntroducing Borland StarTea
- Page 5 and 6: Installing the StarTeam Cross-Platf
- Page 7 and 8: Terminology for Oracle Databases...
- Page 9 and 10: Introducing Borland StarTeam 2009In
- Page 11 and 12: StarTeam IntegrationsThe following
- Page 13 and 14: • Start ➤ Programs ➤ Borland
- Page 15 and 16: Installation RoadmapDepending on yo
- Page 17 and 18: Installing StarTeam Server on Windo
- Page 19 and 20: Note: SQL Server Express is not rec
- Page 21 and 22: 3. You must set video settings on t
- Page 23 and 24: Before upgrading to Borland StarTea
- Page 25: • Create trigger• Create type
- Page 29 and 30: The resolution is to change the sec
- Page 31 and 32: Understanding LicensingLicenses det
- Page 33 and 34: • When a user logs in from a Star
- Page 35 and 36: Installing StarTeam Server on Linux
- Page 37 and 38: Pre-Installation SetupThis section
- Page 39 and 40: StarDrawBorland provides the sample
- Page 41 and 42: Installing StarTeam ClientsThis cha
- Page 43 and 44: 7. Rename this file starteam-client
- Page 45 and 46: Installing on Other PlatformsTo ins
- Page 47 and 48: Installing and Configuring the Star
- Page 49 and 50: Logging on to the StarTeam Web Serv
- Page 51 and 52: 1. Edit the /apache-tomcat-5.5.27/c
- Page 53 and 54: Installing StarTeamMPX on WindowsTh
- Page 55 and 56: Number of Peak Usersmore than 200Re
- Page 57 and 58: 6. In the Choose Install Folder dia
- Page 59 and 60: 3. Install the Root Cache Agent. Yo
- Page 61 and 62: • The Cache Agent installer insta
- Page 63 and 64: Installing a StarTeamMPX Root or Re
- Page 65 and 66: Installing StarTeam Layout Designer
- Page 67 and 68: Installing StarTeam Workflow Extens
- Page 69 and 70: The default installation folder is
- Page 71 and 72: 7. In the Choose Shortcut Folder di
- Page 73 and 74: • Review the settings and click I
- Page 75 and 76: Understanding the Encoding Differen
• Enable users to install the <strong>StarTeam</strong> client over the network from the computer on which <strong>StarTeam</strong>Server is installed.• Not install the StarDraw sample repository, for example, because it uses SQL Server Expressand you are not installing that database application either.b. For a Custom Install only, select (to install) or clear (to bypass) the available options:• <strong>StarTeam</strong> Server - If you use the custom installation to install something that was not installedduring a previous installation of <strong>StarTeam</strong> Server, you may choose to uncheck this check box.For example, suppose that in a previous custom installation, you elected to bypass the installationof SQL Server Express. To add that database without reinstalling all of the server program files,you would clear the <strong>StarTeam</strong> Server check box.• Client Setup - The client setup files are not automatically part of the server installation. If youselect the Client Setup check box, the <strong>StarTeam</strong> Cross-Platform Client installer is installed inthe Client Setup folder, a child folder of the <strong>StarTeam</strong> Server installation folder. Make sure thatthis folder is one that all team members can access.• SSE 2005 - SQL Server Express is a variant of Microsoft SQL 2005 offered by Microsoft at nocharge, as long as you comply with their stipulations. SSE2005_ST is installed as part of a typicalinstallation because it is used as the default database. If you use an enterprise-level databaseexclusively (Microsoft SQL or Oracle), you might not be interested in having the SQL ServerExpress files added to the server’s computer.• Sample server configuration - Clear this check box if you do not want to install StarDraw.Installing the StarDraw sample server configuration for this release will not overwrite an existingStarDraw configuration. However, the StarDraw server configuration in the <strong>StarTeam</strong> <strong>2009</strong>starteam-server-configs.xml file will refer to the new StarDraw server configuration.• <strong>StarTeam</strong> Toolbar - Installs the <strong>StarTeam</strong> Toolbar which remembers passwords so that loggingon is easier.c. Click Next.5. In the Choose Install Folder dialog box, click Choose to browse for the location to be used as theinstallation folder. (The default location is C:\Program Files\<strong>Borland</strong>\ <strong>StarTeam</strong> Server <strong>2009</strong>.)6. Use the MPX Options dialog box to make changes to the MPX profiles used by your server configurations.If this is the first time that the <strong>StarTeam</strong>MPX Event and File Transmitters have been installed on thiscomputer, the installer creates both Event Transmitter and File Transmitter template files using informationfrom the MPX Options dialog box. These files are stored in a subfolder of the installation folder namedEventServices.The local host name and IP address are provided at the top of this dialog box for reference purposes.By default, the Message Broker connection address uses your local computer’s IP address.a. To specify a different Message Broker for Event Transmitter (and any clients that will use the defaultprofile), change the proposed Message Broker connection address.This address must use the format:tcp:host:porthost is the host name or IP address on which the Message Broker operatesport is the TCP/IP port number (endpoint) with which the Message Broker accepts connections (5101is the default).Important: When installing to a computer that has more than one NIC or multiple IP addresses,do not accept the default server address settings. You must manually enter the correct serverIP address. When the installer detects multiple network addresses on the host computer, it setsInstalling <strong>StarTeam</strong> Server on Windows | 27