Setting up a DB2 database

Set up a supported DB2® or the bundled DB2 Workgroup Server database to work with the Jazz™ Team Server.

Before you begin

This procedure assumes that the following prerequisites have been met. Consult your DB2 documentation or a DB2 database administrator (DBA) for help.

You have the password for db2inst1 user.
Review the DB2 documentation to verify that your system meets the requirements and is configured correctly.
Confirm that DB2 is installed and running on a machine to be used as the database server. This machine can be a different one from that on which the Jazz Team Server runs.
Review Special DB2 instructions.
Confirm that the user specified in teamserver.properties has DBADM authority over the database.
Learn more about DB2 commands
On Linux®, to get system admin authority on the DB2 database, sudo to the DB2 user db2inst1 and run bash. Note db2inst1 is the default instance user. You can use the following commands to check and maintain your database:
db2start: Starts DB2 (on UNIX, the instance owner must run this command).

db2stop: Stops DB2.

db2sysc process: Use this command to check if DB2 processes are running. For an average database usage, make sure that you have 2 GB RAM available for DB2 processes.

reorg indexes/table: The index option reorganizes all indexes defined on a table by rebuilding the index data into unfragmented, physically contiguous pages. The table option reorganizes a table by reconstructing the rows to eliminate fragmented data, and by compacting information.

runstats: Updates statistics about the physical characteristics of a table and the associated indexes. These characteristics include number of records, number of pages, and average record length. The optimizer uses these statistics when determining access paths to the data. This utility should be called when a table has had many updates, or after reorganizing a table.

db2 backup: Use this command to back up your database. If the command completes successfully, you will have acquired a new backup image that is located in the path or the directory from which the command was issued.

Procedure

The following commands run in the DB2 Command Window. The Command window can be opened from the application Start menu under the DB2 Command Line Tools menu. To connect to a remote server, you can use Telnet or SSH. Ensure you connect as db2inst1 user by running su -db2inst1.

Start by creating a database called JAZZ with 16K pages and UTF-8 code set.
```
db2 create database JAZZ on <path to storage> using codeset UTF-8 territory en PAGESIZE 16384
```
Tip: If the database is not running, the command db2start starts DB2.
Locate the file teamserver.properties in the directory JazzInstallDir/server/conf/jazz and rename it to teamserver.derby.properties.
Locate the file teamserver.db2.properties in the directory JazzInstallDir/server/conf/jazz and rename it to teamserver.properties.
Specify the database and connection details in the file teamserver.properties.
The default connection specification connects to a DB2 database that runs on localhost on port 50000. The database is called JAZZ, and both the user name and password are db2admin. If the default values were used when setting up your database, the teamserver.properties file might already be configured correctly. If not, change this information to match your configuration.
1. Open the file teamserver.properties in a text editor.
2. Locate the following lines:
```
com.ibm.team.repository.db.vendor = DB2
com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
com.ibm.team.repository.db.jdbc.password=db2admin
```
3. Edit the value of com.ibm.team.repository.db.jdbc.location for your DB2 server and database.
4. Edit the value of com.ibm.team.repository.db.jdbc.location for your DB2 user name.
  Note: The DB2 user must have permissions to create tables, table spaces, and modify the database configuration. DB2 users are created by the operating system.
5. Specify the user password in the property com.ibm.team.repository.db.jdbc.password.
  Note: Do not change the password={password} text in the com.ibm.team.repository.db.jdbc.location property.
6. If necessary, change the property com.ibm.team.repository.db.db2.content.tablespace.location to a path on your Jazz Team Server where the main table space can be created.
  Note: If this value is not changed from the default of content_tablespace, the table space is created under the database storage location. On Windows®, if a new path is specified, it must be specified by using double backslashes, for example: com.ibm.team.repository.db.db2.content.tablespace.location=c:\\db2\\jazz\\content_tablespace.
  
  Latest entries in the jazz.net library on installation