Setting up a SQL database

Set up a SQL database to work with the Jazz™ Team Server. You can set up the SQL database by using either a visual tool or a command line tool.

You have SQL server installed
SQL service is started

Setting up a SQL database using a visual tool

If you are using a visual tool, such as SQL Server Management Studio Express™, to set up a SQL database for Jazz, ensure that you complete the steps listed below.

Note: The default login name defined in JazzInstallDir/server/teamserver.properties file for a SQL Server database is jazzDBuser and the default password is jazzDBPswd.

Tip: Rename the teamserver.sqlserver.properties file to teamserver.properties. By default the teamserver.properties file in JazzInstallDir/server directory is not set up for the SQL Server. All settings are contained in the teamserver.sqlserver.properties file in the same directory.

To set up a SQL database using a visual tool:

Create a database called Jazz. Default owner name is jazzDBuser.
Install the JDBC drivers for SQL Server.
Enable TCP protocol, so that Jazz Team Server can connect to SQL Server.
Set the ports for network communication with the SQL Server. In the teamserver.properties file in JazzInstallDir/server directory, the port specified for SQL Server is 1433.

Setting up Jazz manually

If you installed the Jazz database using the command line tool, you can set up a SQL server database for Jazz by following the steps below.

Create a Jazz database. From the command line tool, type:
```
CREATE DATABASE jazz 
GO 
```
Create a user and password and change the ownership of the Jazz database. From the command line tool, type:
```
CREATE LOGIN jazzDBuser
WITH PASSWORD = 'jazzDBPswd';
USE jazz;
exec sp_changedbowner 'jazzDBuser'
GO 
```
Change the collation of the Jazz database. From the command line tool, type:
```
ALTER DATABASE jazz COLLATE SQL_Latin1_General_CP437_CS_AS 
GO
```
Rename the following files:
- Rename the JazzInstallDir/server/ teamserver.properties file to teamserver.OtherDBProvider.properties
- Rename the teamserver.sqlserver.properties file to teamserver.properties
Note: Renaming teamserver .properties files with DB Provider enables you to restore the file to the previous working version. By default the DB Provider is derby.
Specify the jar files location for JDBC by completing one of the following tasks:
- Set up the environment variable SQLSERVER_ABSPATH to point to the directory holding the jar file
- Copy the JDBC drivers jar file into the JazzInstallDir/server/sqlserver directory

If you used a different user name, password, and database name or installed SQL Server on the non-local machine, in the teamserver.properties file in JazzInstallDir/server directory, change the information listed below:

com.ibm.team.repository.db.vendor = SQLSERVER
com.ibm.team.repository.db.jdbc.location=//SQL SERVER MACHINE IP:SQL SERVER TCIP PORT;databaseName=JAZZ DATABASE NAME;user=JAZZ USERNAME;password={password}
com.ibm.team.repository.db.jdbc.password=JAZZ LOGIN PASSWORD

Troubleshooting

If the repotools command does not run properly, check the log file named repotools_createTables.log, located in the JazzInstallDir/server directory.

Also, verify the following:

The SQL Server is using a TCPIP connection, a SQL Server machine host name, and the port is correctly reflected in the teamserver.properties file.
The login name, password, and database name are properly reflected in the teamserver.properties file
Firewall does not prevent you from accessing the SQL Server. Use a telnet command to telnet to the machine using hostname and port from the teamserver.properties file
The created Jazz user has proper permissions in the Jazz database.