Configuración de una base de datos de Oracle

Configure una base de datos de Oracle para que funcione con Jazz Team Server.

Antes de empezar

Este procedimiento presupone que se han cumplido los siguientes requisitos previos. Consulte la documentación de Oracle o con un administrador de bases de datos (DBA) de Oracle para obtener ayuda.

Oracle está instalado en una máquina que se va a utilizar como el servidor de base de datos. Esta máquina puede ser una máquina diferente de la que ejecuta Jazz Team Server.
Existe una base de datos predeterminada en el servidor de Oracle.
Nota: Cuando instala Oracle tiene la opción de crear una base de datos automáticamente.

Nota: Para garantizar un manejo correcto del contenido Unicode, el conjunto de caracteres de la base de datos debe ser de codificación UTF-8.
El usuario que lleva a cabo estas instrucciones tiene los derechos de administrador en la base de datos de Oracle.

Al ejecutar Jazz Team Server en Oracle, se debe crear un espacio de tabla Oracle con el fin de mejorar el rendimiento. Se debe crear un usuarios vinculado a dicho espacio de tabla.

Nota: El constructor de la base de datos no lleva a cabo ninguna de estas acciones con las herramientas del repositorio.

Por qué y cuándo se efectúa esta tarea

Para configurar una base de datos Oracle:

Cree un espacio de tabla. La ubicación del espacio de tabla debe ser el adecuado para la máquina y la unidad del disco.
Nota: El espacio de tabla puede tener cualquiera de estas propiedades:
- Un nombre distinto a oracle_tbs
- Una ubicación en otro directorio
- Un tamaño mayor que 1 GB. Para instalaciones más grandes, es necesario asignar más espacio.
El siguiente ejemplo ilustra una sentencia de creación ejecutada en una máquina Windows:
```
CREATE BIGFILE TABLESPACE oracle_tbs DATAFILE 'D:\oracle_tbs\oracle_tbs.dbf' SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE
```
Nota: Debe existir la vía de acceso del directorio (en el ejemplo D:\oracle_tbs). No es necesario crear un espacio de tabla especial por separado. Es posible usar el espacio de tabla predeterminado de Oracle USERS, pero Oracle rinde mejor con un espacio preasignado en el disco que gestiona.
Cree un usuario de Oracle.
Tras crear el espacio de tabla, se debe crear un usuario Oracle especial para Jazz para que utilice la base de datos de Oracle.
En este ejemplo, el usuario se llama jazzDBuser y la contraseña (IDENTIFIED BY en nomenclatura Oracle) jazzDBpswd y existe en el espacio de tabla creado en 1.
```
CREATE USER jazzDBuser IDENTIFIED BY jazzDBpswd DEFAULT TABLESPACE oracle_tbs
```
Tras crear el usuario, otorga los permisos necesarios a la base de datos para llevar a cabo las siguientes acciones:
- Crear una sesión.
- Crear, modificar y soltar tablas e índices.
- Insertar, actualizar y eliminar datos de las tablas creadas.
Ubique el archivo teamserver.properties en el directorio JazzInstallDir/server y renómbrelo a teamserver.derby.properties.
Ubique el archivo teamserver.oracle.properties en el directorio JazzInstallDir/server y renómbrelo a teamserver.properties.
Configure el servidor
1. Abra el archivo teamserver.properties en un editor de texto. Ubique las siguientes líneas; y cambie las propiedades de ubicación y contraseña de la configuración:
```
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
```
  Nota: Si está utilizando Oracle Express, cambie ORCL a 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
```
  Especifique la contraseña del usuario en la propiedad com.ibm.team.repository.db.jdbc.password.
  Nota: No cambie el texto password={password} de la propiedad com.ibm.team.repository.db.jdbc.location.
2. En el mismo directorio que los scripts del servidor (JazzInstallDir/server), cree un directorio llamado oracle.
3. Ubique el archivo JAR del controlador JDBC de Oracle llamado ojdbc14.jar. La ubicación varía dependiendo del producto de Oracle y del sistema operativo. Copie este archivo al directorio llamado oracle.
  Nota: Si está utilizando el servidor de aplicaciones WebSphere, configure una propiedad llamada "ORACLE_JDBC"; a continuación, defínala en la vía de acceso absoluta del archivo (no en la dirección URL) de los controladores JDBC de Oracle. Esta tarea se explica en las instrucciones de configuración del servidor de aplicaciones WebSphere. Anote la vía de acceso del archivo para utilizarla después en estas instrucciones.

Resultados

Ha terminado de configurar la base de datos y puede continuar con Creación de las tablas de la base de datos Jazz Team Server.