Setting up an Oracle database

Set up an Oracle database to work with the Jazz™ Team Server.
This assumes the following prerequisites have been met. Consult your Oracle documentation or an Oracle database administrator (DBA) for help.
  • Oracle is installed 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.
  • A default database exists on the Oracle server.
    Note: When you install Oracle, you have the option to create a database automatically.
    Note: To ensure proper handling of Unicode content, the database character set must be UTF-8 encoding.
  • The user who performs these instructions has system administration authority on the Oracle database.

When running Jazz Team Server on Oracle, create an Oracle tablespace to improve performance. You must create a user linked to that tablespace.

Note: Neither of these steps are performed by the database builder with the repository tools.
To set up an Oracle database:
  1. Create a tablespace. The tablespace location must be appropriate to the machine and disk drive.
    Note: The tablespace can have any of these properties:
    • A name other than oracle_tbs
    • A location in another directory
    • A size larger than 1GB. For large installations, you need to allocate more space.
    The example below shows a create statement executed on a Windows® machine: 
    CREATE BIGFILE TABLESPACE oracle_tbs DATAFILE 'D:\oracle_tbs\oracle_tbs.dbf' SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE
    Note: The directory path (in this example D:\oracle_tbs) must exist. It is not necessary to create a separate special tablespace. You can use the Oracle default USERS tablespace, but Oracle performs better with a pre-allocated space on the disk that it manages.
  2. Create an Oracle user.

    After the tablespace is created, a special Oracle user must be created for Jazz to use the Oracle database.

    In this example, the user has the name jazzDBuser and password (IDENTIFIED BY in Oracle terms) jazzDBpswd and exists in the tablespace created in 1. 
    CREATE USER jazzDBuser IDENTIFIED BY jazzDBpswd DEFAULT TABLESPACE oracle_tbs
    After the user is created, grant the database system permissions necessary to perform these actions:
    • Create a session.
    • Create, alter, and drop tables and indexes.
    • Insert, update, and delete from the tables created.
  3. Locate the file teamserver.properties in the directory JazzInstallDir/server and rename it to teamserver.derby.properties.
  4. Locate the file teamserver.oracle.properties in the directory JazzInstallDir/server and rename it to teamserver.properties.
  5. Configure the server
    1. Open the file teamserver.properties in a text editor. Locate the following lines; and change the location and password properties for your configuration: 
      com.ibm.team.repository.db.vendor = ORACLE
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/ORCL
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@//oracleserver.example.com:1521/ORCL
com.ibm.team.repository.db.jdbc.password=jazzDBpswd
      Note: If you are using Oracle Express, change ORCL to XE.
      com.ibm.team.repository.db.vendor = ORACLE
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/XE
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@//oracleserver.example.com:1521/XE
com.ibm.team.repository.db.jdbc.password=jazzDBpswd
      Specify the user password in the property com.ibm.team.repository.db.jdbc.password.
      Note: Do not change the password={password} text in the property com.ibm.team.repository.db.jdbc.location.
    2. In the same directory as the server scripts (JazzInstallDir/server), create a directory named oracle.
    3. Locate the Oracle JDBC driver JAR file, named ojdbc14.jar. The location can vary depending on the Oracle product and operating system. Copy this file to the directory named oracle.
      Note: If you are using WebSphere® Application Server, configure a property named "ORACLE_JDBC"; then set it to the absolute file path (not URL) to the Oracle JDBC drivers. This task is described in the WebSphere Application Server setup instructions. Make a note of the file path for later use in these instructions.
You are finished setting up your database and can continue with Creating the Jazz Team Server database tables.
Feedback

Did this help? You can provide feedback at Jazz.net (registration required): Comment in the forums or submit a bug