Configurar una base de datos de Oracle
para que funcione con Jazz Team Server.
Antes de empezar
Se asume que se cumplen los requisitos previos siguientes. Consulte la documentación de
Oracle o un administrador de base de datos (DBA) de Oracle para obtener ayuda.
- Oracle está instalado en una máquina para ser utilizado como
el servidor de bases de datos. Esta máquina puede ser distinta de la
máquina en la que se ejecuta Jazz Team Server.
- Existe una base de datos predeterminada en el servidor de Oracle.
Consejo: Cuando
instale Oracle, tiene la opción de crear una base de datos automáticamente.
Importante: Para un correcto manejo del contenido Unicode, el conjunto de caracteres de base de datos debe ser decodificación UTF-8.
- El usuario que lleve a cabo estas instrucciones tiene autoridad para la administración del sistema con respecto a la base de datos de Oracle.
Al ejecutar Jazz Team Server en
Oracle, cree un espacio de tablas de Oracle para mejorar el rendimiento. Debe crear un usuario enlazado a dicho espacio de tablas.
Recuerde: Ninguno de estos pasos los realiza el compilador de la base de datos 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 tablas. La ubicación del espacio de tablas debe ser adecuado a la máquina y a la unidad de disco.
Este paso debe realizarlo un usuario con privilegios DBA.
Nota: El espacio de tablas 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 grandes, tiene que asignar más espacio.
El ejemplo a continuación muestra una sentencia crear ejecutada en una máquina con Windows®:
CREATE BIGFILE TABLESPACE oracle_tbs DATAFILE 'D:\oracle_tbs\oracle_tbs.dbf' SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
Importante: La vía de acceso del directorio (en este ejemplo, D:\oracle_tbs)
debe existir. No es necesario crear un espacio de tabla especial por separado.
Puede utilizar el espacio de tablas USERS predeterminado de Oracle, pero Oracle rendirá mejor con un espacio preasignado en el disco que gestiona.
- Crear un usuario de Oracle.
Una vez que el espacio de tablas está creado, debe crearse un usuario de Oracle especial para que Jazz utilice la base de datos de Oracle.
En este ejemplo, el usuario tiene el nombre jazzDBuser y la contraseña (IDENTIFIED
BY en términos de Oracle) jazzDBpswd y existe en el espacio de tablas creado en 1.
CREATE USER jazzDBuser IDENTIFIED BY jazzDBpswd DEFAULT TABLESPACE oracle_tbs;
Una vez que el usuario está creado, se deben dar al usuario los permisos necesarios para inicializar la base de datos de Jazz. Los mandatos de SQL siguientes pueden utilizarse 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;
- Ubique el archivo teamserver.properties en
el directorio JazzInstallDir/server/conf/jazz y
renómbrelo a teamserver.OtherDBProvider.properties.
- Ubique el archivo teamserver.oracle.properties en
el directorio JazzInstallDir/server/conf/jazz y
renómbrelo a teamserver.properties.
Consejo: El renombrar
el archivo teamserver.properties original
le permite restaurar el archivo a la última versión funcional. De forma predeterminada, el Proveedor de base de datos es derby.
- Configurar el servidor
- Edite
el archivo de configuración del servidor si ha utilizado un nombre de usuario,
contraseña onombre de base de datos distintos, si ha instalado el servidor de Oracle en una máquina distinta que Jazz Team Server,
o si utiliza un puerto distinto al predeterminado. Abra el archivo teamserver.properties en el directorio JazzInstallDir/server/conf/jazz
y cambie la información enumerada a continuación para que coincida con 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 por Jazz para utilizar la base de datos de Oracle. Si está utilizando localhost, elimine el comentario de esta línea eliminando # del inicio de la línea y añada un comentario en la línea de la próxima ubicación. Las series de conexión de localhost no deberían incluir los // anteriores. Cambie 1521 por su puerto TCIP de la máquina del servidor de Oracle. Cambie ORCL por el nombre de la base de datos de Oracle.
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@//oracleserver.example.com:1521/ORCLRecuerde: Los URL de la ubicación de Oracle pueden tomar varios formatos. Los ejemplos aquí mostrados funcionan bajo la mayoría de las circunstancias. Consulte la documentación de JDBC de Oracle
para obtener más detalles.
Si está utilizando una conexión que no sea localhost, elimine el comentario de esta línea eliminando el signo # del inicio de la línea y añada un comentario en la línea de la anterior ubicación. Las series de conexión que no sean localhost deben incluir los // anteriores.
com.ibm.team.repository.db.jdbc.password=jazzDBpswd
Cambie
jazzDBpswd por la contraseña del usuario creada por Jazz para
utilizar la base de datos de Oracle.
Importante: No cambie el texto {password}
en 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 está utilizando Oracle Express, utilice 1521 para el puerto TCIP y XE para el nombre de la base de datos de 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 denominado oracle.
- Ubique el archivo JAR controlador JDBC de Oracle, denominado ojdbc14.jar.
La ubicación puede variar en función del producto de Oracle y del sistema operativo. Copie este archivo al directorio denominado oracle.
Nota: Si está utilizando WebSphere Application Server,
configure una propiedad denominada "ORACLE_JDBC"; a continuación, configúrela hacia la vía de acceso del directorio absoluta (no URL) que contenga los controladores JDBC de Oracle, por ejemplo, si su ojdbc14.jar está ubicado en JazzInstallDir/server/oracle.
Esta tarea se describe en las instrucciones de configuración de WebSphere Application Server. Tome nota de la vía de acceso al archivo para su uso posterior en estas instrucciones.
- Abra una ventana de SQL plus y escriba el mandato siguiente:
GRANT DBA TO jazzDBuser;