Configure una base de datos 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.
Consejo: Cuando instala
Oracle tiene la opción de crear una base de datos automáticamente.
Importante: 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 usuario vinculado a dicho espacio de tabla.
Recuerde: 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.
Este paso debe realizarse por un usuario con derechos DBA.
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 1GB. 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®:
Importante: 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;
Una vez creado
el usuario, deben otorgársele los permisos necesarios para
inicializar la base de datos de Jazz. Se pueden utilizar los siguientes mandatos de Jazz
para otorgar los permisos adecuados:
GRANT CREATE SESSION TO jazzDBuser;
GRANT CREATE TABLE, ALTER ANY TABLE, DROP ANY TABLE, CREATE ANY INDEX, ALTER ANY INDEX, DROP ANY INDEX TO jazzDBuser;
GRANT INSERT ANY TABLE, UPDATE ANY TABLE, DELETE ANY TABLE TO jazzDBuser;
GRANT CREATE PROCEDURE TO jazzDBuser;
GRANT CREATE VIEW TO jazzDBuser;
- Localice el archivo teamserver.properties en
el directorio JazzInstallDir/server/conf/jazz y
renómbrelo como teamserver.OtherDBProvider.properties.
- Localice el archivo teamserver.oracle.properties en el directorio JazzInstallDir/server/conf/jazz
y renómbrelo como teamserver.properties.
Consejo: Al cambiar el nombre del archivo teamserver.properties original,
podrá restaurar el archivo a la versión activa anterior. De forma predeterminada,
el proveedor de la base de datos es derby.
- Configure el servidor
- Edite la configuración de servidor si ha utilizado un nombre de usuario, una contraseña
o un nombre de base de datos diferente, si ha instalado un servidor Oracle en una máquina distinta de Jazz Team Server
o está utilizando un puerto que no sea el predeterminado. Abra el archivo teamserver.properties en el directorio JazzInstallDir/server/conf/jazz y cambie la información
que figura a continuación para que se ajuste a su configuración.
com.ibm.team.repository.db.vendor = ORACLE
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/ORCL
Cambie
jazzDBuser por el usuario creado para Jazz para
que utilice la base de datos Oracle. Si utiliza un sistema principal local, para descomentar esta
línea, elimine # del comienzo de la línea y comente la siguiente
línea de ubicación. Las series de conexión del sistema principal local no deben ir
precedidas de //. Cambie 1521 por el puerto TCIP de la máquina del servidor Oracle. Cambie ORCL por el nombre de la base de datos Oracle.
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@//oracleserver.example.com:1521/ORCLRecuerde: Las URL de ubicación Oracle pueden adquirir varias formas. Los ejemplos funcionan en la mayoría de los casos. Consulte la documentación JDBC de Oracle para obtener más información.
Si va
a utilizar una conexión que no sea de sistema principal, para descomentar esta línea
elimine # del comienzo de la línea y comente la línea de ubicación
anterior. Las series de conexión que no sean de sistema principal local deben ir
precedidas de //.
com.ibm.team.repository.db.jdbc.password=jazzDBpswd
Cambie
jazzDBpswd por la contraseña del usuario creado para Jazz para
que utilice la base de datos Oracle.
Importante: No cambie el texto {password}
de la propiedad com.ibm.team.repository.db.jdbc.location.
La contraseña de usuario debe especificarse en la propiedad com.ibm.team.repository.db.jdbc.password.
Si
va a usar Oracle Express, utilice 1521 para el puerto TCIP y XE para el nombre de la
base de datos Oracle:
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.password=jazzDBpswd
- En el mismo directorio que los scripts del servidor
(JazzInstallDir/server),
cree un directorio llamado oracle.
- 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 utiliza un servidor de aplicaciones WebSphere, configure una propiedad llamada "ORACLE_JDBC"; a continuación configúrela a la vía de acceso del directorio absoluto (no la URL) que contiene las unidades JDBD de Oracle, por ejemplo, si su ojdbc14.jar se encuentra en JazzInstallDir/server/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.
- Abra una ventana SQL plus e introduzca el siguiente mandato:
GRANT DBA TO jazzDBuser;