Borland StarTeam 2009 - Borland Technical Publications
Borland StarTeam 2009 - Borland Technical Publications Borland StarTeam 2009 - Borland Technical Publications
Using StarTeam with Microsoft SQL Serverand SQL Server Express DatabasesThis chapter explains how to create a new server configuration to use Microsoft SQL Server or SQL ServerExpress databases with StarTeam Server. StarTeam Server stores everything except for file archives andserver startup information in the database of your choice.You can use the Windows version of StarTeam Server with the following Microsoft databases:• Microsoft SQL Server 2005 Express (SSE 2005), installed for you by StarTeam Server 2009.• Microsoft SQL Server 2005 R2Microsoft SQL Server 2005 Express is the StarTeam default database. We advise users to read the SQLServer Express license agreement provided by Microsoft Corporation.StarTeam Server completely automates the process of creating SQL Server and SQL Server Express databasesfor use with StarTeam server configurations. However, if you prefer, you can create your own database. SeeCreating a Database Manually: Overview on page 83 for more information.This chapter also provides an overview of the tuning and maintenance SQL scripts that are provided withStarTeam Server and explains how to use them. For detailed information on Microsoft SQL Server performancetuning, consult your Microsoft SQL Server documentation.Terminology for Microsoft DatabasesThis chapter uses Microsoft terminology for the terms instance and database. When you install Microsoft SQLServer 2005 on a computer, you can install up to 16 instances of it. Each instance can manage a number ofdifferent databases. Each StarTeam server configuration uses its own database.When you perform a typical installation of StarTeam Server, you install one instance of SQL Server Express.More instances come in the download package at the web site and are included on the StarTeam installationDVD because SQL Server Express instances are numbered. This is because you may already have SQLServer Express on the computer, and StarTeam must use a different number than any instance that you alreadyhave.Logging Onto DatabasesIt is highly recommended that you use a dedicated StarTeam user account to run or log onto the databasesused with StarTeam server configurations. System administrator accounts usually have unlimited privileges.Any anomalies or errors that occur while you are logged in as the system administrator may result inunrecoverable damage to StarTeam databases and other databases managed by the same database server.74 | Using StarTeam with Microsoft SQL Server and SQL Server Express Databases
Understanding the Encoding DifferencesStarTeam Server sends data encoded as UTF-8. Microsoft SQL Server and SQL Server Express do not supportUTF-8 at the database level. They support nchar, nvarchar, and ntext to store fixed format Unicode data(UTF-16).• UTF-8 is a variable length character set in which the characters can expand from one to six bytes dependingon the language.• UTF-16 is a fixed length encoding mechanism in which every character expands to two bytes. UTF-16tends to use up more space than UTF-8 when applied to character sets in which one character alwaystranslates to one byte.Because of the way StarTeam encodes data, non-English StarTeam data is human-readable from StarTeamclients, but not from Microsoft SQL Server and SQL Server Express.This is also why it is critical that the ODBC drivers used by the Microsoft SQL Server and SQL Server Expressdatabases do no translation of the data. When StarTeam Server creates a DSN to be used with a serverconfiguration’s database, it turns off the ODBC autotranslation feature. Similarly, if you create your owndatabase, you must manually turn off the autotranslation feature. The SQL Server ODBC Data Source Testfor the Microsoft ODBC driver will fail because this feature is turned off, but that is correct behavior for DSNscreated for use with StarTeam server configurations.Overview of Using a Microsoft SQL Server DatabaseIf you will be using a Microsoft SQL Server database, you must complete the following tasks:1. Install Microsoft SQL Server.Important: When you install a Microsoft SQL Server database instance, it defaults to the collation forthe locale set for the operating system. This locale setting should be used so long as it is correct foryour team. Otherwise, when you automatically create a database from StarTeam Server, you cannotprovide a database name, user name, or password in your language.2. Install StarTeam Server. For more information, see Installing StarTeam Server on page 26.3. Create and start a StarTeam server configuration.• If you want StarTeam to automatically create the database, see Creating and Starting a ServerConfiguration on page 76.• Otherwise, see Creating a Database Manually: Overview on page 83.If you plan to use Microsoft SQL Server 2005, see Connecting to Microsoft SQL Server 2005 Databaseson page 76 for more information.Caution: After you have started using StarTeam with Microsoft SQL Server:• Never modify the database contents other than through a StarTeam client or Server Administrationtool. Direct database manipulation is unsupported.• Never modify vault files other than through a StarTeam client or a Server Administration tool.Using StarTeam with Microsoft SQL Server and SQL Server Express Databases | 75
- Page 23 and 24: Before upgrading to Borland StarTea
- Page 25 and 26: • Create trigger• Create type
- Page 27 and 28: • Enable users to install the Sta
- 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: • Review the settings and click I
- Page 77 and 78: 5. Create an initial hive for the N
- Page 79 and 80: Running SQL Scripts for Microsoft D
- Page 81 and 82: • starteam_sqlserver_get_dbinfo.s
- Page 83 and 84: select * from s011. Verify that at
- Page 85 and 86: Important: The SQL Server ODBC Data
- Page 87 and 88: characters such as !, @, #, or %. E
- Page 89 and 90: 1. Install Oracle Server. Most cust
- Page 91 and 92: After setting NLS_LANG correctly, O
- Page 93 and 94: Creating and Starting a Server Conf
- Page 95 and 96: Number of UsersBetween 15 and 50Bet
- Page 97 and 98: Run: weekly.• starteam_oracle_cre
- Page 99 and 100: • The Oracle database’s net ser
- Page 101 and 102: Native-II Vault FoldersFor server c
- Page 103 and 104: A new server log file is created ea
- Page 105 and 106: Savings Time) information for Easte
- Page 107 and 108: The data is critical and must be re
- Page 109 and 110: Export backups are cross-platform a
- Page 111 and 112: Oracle 10g has introduced a new fea
- Page 113 and 114: Total MemoryRecommended 10gR2 Setti
- Page 115 and 116: AMM is implemented using Memory_Tar
- Page 117 and 118: Microsoft SQL Server (continued)def
Understanding the Encoding Differences<strong>StarTeam</strong> Server sends data encoded as UTF-8. Microsoft SQL Server and SQL Server Express do not supportUTF-8 at the database level. They support nchar, nvarchar, and ntext to store fixed format Unicode data(UTF-16).• UTF-8 is a variable length character set in which the characters can expand from one to six bytes dependingon the language.• UTF-16 is a fixed length encoding mechanism in which every character expands to two bytes. UTF-16tends to use up more space than UTF-8 when applied to character sets in which one character alwaystranslates to one byte.Because of the way <strong>StarTeam</strong> encodes data, non-English <strong>StarTeam</strong> data is human-readable from <strong>StarTeam</strong>clients, but not from Microsoft SQL Server and SQL Server Express.This is also why it is critical that the ODBC drivers used by the Microsoft SQL Server and SQL Server Expressdatabases do no translation of the data. When <strong>StarTeam</strong> Server creates a DSN to be used with a serverconfiguration’s database, it turns off the ODBC autotranslation feature. Similarly, if you create your owndatabase, you must manually turn off the autotranslation feature. The SQL Server ODBC Data Source Testfor the Microsoft ODBC driver will fail because this feature is turned off, but that is correct behavior for DSNscreated for use with <strong>StarTeam</strong> server configurations.Overview of Using a Microsoft SQL Server DatabaseIf you will be using a Microsoft SQL Server database, you must complete the following tasks:1. Install Microsoft SQL Server.Important: When you install a Microsoft SQL Server database instance, it defaults to the collation forthe locale set for the operating system. This locale setting should be used so long as it is correct foryour team. Otherwise, when you automatically create a database from <strong>StarTeam</strong> Server, you cannotprovide a database name, user name, or password in your language.2. Install <strong>StarTeam</strong> Server. For more information, see Installing <strong>StarTeam</strong> Server on page 26.3. Create and start a <strong>StarTeam</strong> server configuration.• If you want <strong>StarTeam</strong> to automatically create the database, see Creating and Starting a ServerConfiguration on page 76.• Otherwise, see Creating a Database Manually: Overview on page 83.If you plan to use Microsoft SQL Server 2005, see Connecting to Microsoft SQL Server 2005 Databaseson page 76 for more information.Caution: After you have started using <strong>StarTeam</strong> with Microsoft SQL Server:• Never modify the database contents other than through a <strong>StarTeam</strong> client or Server Administrationtool. Direct database manipulation is unsupported.• Never modify vault files other than through a <strong>StarTeam</strong> client or a Server Administration tool.Using <strong>StarTeam</strong> with Microsoft SQL Server and SQL Server Express Databases | 75