Configuración de una base de datos Oracle para Rational Engineering Lifecycle Manager y Lifecycle Query Engine

Configure una base de datos Oracle para trabajar con Rational Engineering Lifecycle Manager Jazz Team Server, Rational Engineering Lifecycle Manager y la aplicación Gestión de configuración.

Antes de empezar

Para crear y configurar una base de datos Oracle, se asume que un usuario que prepara una base de datos tiene autoridad de administración sobre la base de datos y que la configuración de la base de datos, el almacenamiento del espacio de tabla y el almacenamiento apropiado los crea un usuario con autoridad de administración del sistema. Así, una de las ediciones soportadas de Oracle está instalada en una máquina que se va a utilizar como servidor de la base de datos. Esta máquina puede ser diferente de la máquina en la que se ejecuta Jazz Team Server en:
Nota: El controlador Java™ Database Connectivity (JDBC) necesario para Oracle 10g y 11g es ojdbc6.jar 11.2.0.3 o superior. Además actualice siempre la base de datos a la última versión de base de datos. Por ejemplo, si el servidor de bases de datos es 11.2, debe estar ejecutando 11.2.0.3 o superior.
Importante: Los siguientes parámetros de configuración y las opciones de espacio de tabla son ejemplos y podrían no ser completamente aplicables a su entorno. Por ejemplo, si no puede utilizar el valor AUTOEXTEND, los archivos tienen que ser suficientemente grandes para permitir el crecimiento. O si no puede utilizar la cuota de tamaño UNLIMITED para el usuario de base de datos de Jazz Team Server, asegúrese de destinar suficiente espacio para un crecimiento rápido.
Importante: Si instala las aplicaciones de Rational Engineering Lifecycle Manager en el mismo sistema o en plataformas distribuidas, puede crear bases de datos separadas para cada aplicación o puede utilizar la misma base de datos para todas las aplicaciones. Sin embargo, debe crear un espacio de tabla independiente y un usuario de base de datos asociado con ese espacio de tabla para cada aplicación.

Los ejemplos de este tema son para una base de datos Oracle con usuarios de base de datos independientes dedicados a cada aplicación.

Nota: La base de datos que crea para Jazz Team Server y todas las aplicaciones de Rational Engineering Lifecycle Manager deben formatearse para utilizar UTF-8 como juego de caracteres. De forma predeterminada, Oracle no crea una base de datos con un juego de caracteres UTF-8. Al crear una base de datos nueva, asegúrese de seleccionar AL32UTF8 en la configuración de BD de Oracle.

Procedimiento

  1. Como administrador del sistema, cree una base de datos con codificación UTF8 para Jazz Team Server y todas las aplicaciones.
  2. Abra una ventana SQL *Plus y cree los espacios de tabla de base de datos:
    CREATE TABLESPACE <espacio tabla usuario relmjts> 
    DATAFILE '<vía acceso y nombre archivo .dbf>' 
    SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
    CREATE TEMPORARY TABLESPACE <espacio tabla temp usuario relmjts> 
    TEMPFILE '<vía acceso y nombre de archivo .dbf temp>' 
    SIZE 20M AUTOEXTEND ON EXTENT MANAGEMENT LOCAL UNIFORM SIZE 1M;
  3. Si está instalando todas las aplicaciones de Rational Engineering Lifecycle Manager, debe repetir el paso 2 anterior 2 veces para crear un espacio de tabla separado para Rational Engineering Lifecycle Manager JTS (relmjts), Rational Engineering Lifecycle Manager (relm) y la aplicación Gestión de configuración (vvc). En Oracle Enterprise Manager Database Control, verifique que los espacios de tabla que ha creado se visualizan y son accesibles.
  4. Cree un usuario de base de datos Oracle para cada nuevo espacio de tabla.

    Tras crear los espacios de tabla, se debe crear un usuario Oracle especial para cada aplicación que va a utilizar la base de datos Oracle. Si hay varios servidores Jazz ejecutándose en una base de datos Oracle, se debe crear una base de datos Oracle para cada aplicación. El usuario de base de datos Oracle debe poder crear los objetos de la base de datos en su espacio de tabla (de forma no limitada o con cuota de espacios) con privilegios para crear la sesión, la tabla, los procedimientos y las vistas.

    En estos ejemplos, sustituya las frases entre corchetes.
    CREATE USER <usuario bd relmjts> IDENTIFIED BY <contraseña> DEFAULT TABLESPACE <espacio tabla usuario relmjts> QUOTA UNLIMITED ON <espacio tabla usuario relmjts> TEMPORARY TABLESPACE <espacio tabla temp usuario relmjts>;
    Una vez creado el usuario, deben otorgársele los permisos necesarios para inicializar la base de datos Jazz. Se pueden utilizar los siguientes mandatos de lenguaje de consulta estructurado (SQL) para otorgar los permisos adecuados:
    GRANT CREATE PROCEDURE, CREATE SESSION, CREATE TABLE, CREATE VIEW TO <usuario bd relmjts>;
    Nota: La creación del almacén en Oracle requiere más permisos en comparación con otras bases de datos. Al especificar el usuario de base de datos en la conexión específica para el almacén de datos, asegúrese que el usuario de base de datos tiene permisos DBA. Para obtener más información, consulte Completar la instalación. Asimismo, se presupone que ya existe un espacio de tablas denominado "USERS". Se trata del espacio de tablas predeterminado de Oracle. Si este espacio de tablas no existe en la base de datos Oracle, utilice el siguiente mandato para crearlo.
    CREATE TABLESPACE USERS 
    DATAFILE '<vía acceso y nombre archivo .dbf>' 
    SIZE <tablespace size> AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
  5. Cree una variable de entorno denominada ORACLE_JDBC_DRIVER_FILE y apunte al controlador JDBC de ojdbc6.jar. La ubicación puede variar en función del producto de Oracle y del sistema operativo. Puede descargar el controlador JDBC de Oracle soportado (ojdbc6.jar 11.2.0.3) de www.oracle.com.
    1. Pulse en Inicio > Panel de control > Sistema.
    2. Pulse el separador Avanzado y, a continuación, pulse Variables de entorno.
    3. En la lista Variables del sistema, pulse Nueva.
    4. En Nombre de variable escriba ORACLE_JDBC_DRIVER_FILE y en el Valor de variable escriba C:\Path_to_JDBC_dirver\ojdbc6.jar.
    1. En sistemas Linux, añada la siguiente declaración de variables de entorno:
      ORACLE_JDBC_DRIVER_FILE =.;Path_to_JDBC_dirver/ojdbc6.jar
      Nota: Rational Engineering Lifecycle Manager no da soporte a JRE 5.0. La versión de los JRE admitidos es 6.0 y 7.0. La biblioteca de clases ojdbc5.jar requiere JRE 5.0 y la biblioteca de clases ojdbc6.jar requiere JRE 6.0 o posterior. Debe utilizar ojdbc6.jar.

      Si está utilizando WebSphere Application Server, también debe añadir una propiedad personalizada que apunte al controlador JDBC ojdbc6.jar. Para obtener más información, consulte el apartado Configuración de WebSphere Application Server para Rational Engineering Lifecycle Manager.

  6. Para configurar la conexión de bases de datos y crear tablas de base de datos, complete uno de los pasos siguientes:
    1. Si está utilizando Tomcat, inicie el servidor y continúe con Ejecución del asistente de configuración de Jazz Team Server para las aplicaciones de Rational Engineering Lifecycle Manager.
    2. Si está desplegando WebSphere Application Server, consulte Ejecución del asistente de configuración de Jazz Team Server para las aplicaciones de Rational Engineering Lifecycle Manager.

Configuración manual de una base de datos Oracle

Acerca de esta tarea

La ejecución del asistente de configuración es el método recomendado para configurar las conexiones de base de datos y para crear las tablas de base de datos. Para ejecutar el asistente de configuración, siga las instrucciones de: Ejecución del asistente de configuración de Jazz Team Server para las aplicaciones de Rational Engineering Lifecycle Manager

Si prefiere realizar este procedimiento manualmente, utilice este tema para editar el archivo teamserver.properties para configurar una conexión de base de datos Oracle y ejecutar el mandato -createTables para crear tablas de bases de datos.

Procedimiento

  1. Para cada aplicación, existe un archivo teamserver.properties independiente que debe abrirse y modificarse. Estos archivos están ubicados en los directorios propios (relmjts, relm y vvc) en el directorio <JazzInstallDir>/server/conf. Abra cada archivo teamserver.properties y especifique los detalles de la base de datos y de la conexión.
    1. Comente las siguientes líneas en la configuración Derby colocando (#) antes de cada línea:
      #com.ibm.team.repository.db.vendor = DERBY
      # com.ibm.team.repository.db.jdbc.location=conf/relmjts/derby/repositoryDB
    2. Elimine el comentario de las siguientes líneas en la configuración de Oracle eliminando (#) de al lado de cada línea:
      Nota: Hay 2 líneas para la ubicación de base de datos que se han proporcionado para cada repositorio. Uno para los sistemas locales y otro para los servidores de bases de datos en sistemas remotos. Descomente solamente una línea que se aplica al entorno. Los ejemplos son para un servidor remoto con 2 barras inclinadas antes del URL del servidor, @//oracleserver.example.com:1521/ORCL.
      com.ibm.team.repository.db.vendor = ORACLE
      com.ibm.team.repository.db.jdbc.location=thin:relmjtsDBuser/{password}@//oracleserver.example.com:1521/ORCL
      com.ibm.team.repository.db.jdbc.password=relmjtsDBpswd
    3. Edite los valores siguientes en las líneas com.ibm.team.repository.db.jdbc.location y com.ibm.team.datawarehouse.db.jdbc.location:
      • //oracleserver.example.com:1521: Escriba el nombre de host completo del servidor de base de datos.
      • jtsDBuser: Escriba el usuario de base de datos.
      • jazzDBuser: Escriba el usuario de base de datos del almacén de datos. Debe ser un DBA.
      • ORCL: Escriba el nombre de servicio de Oracle. Cuando se conecte a una base de datos Oracle, asegúrese de que exista el nombre del servicio ORCL en la máquina del servidor.
      Recuerde: 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.
      Nota: No cambie el texto password={password} en las propiedadescom.ibm.team.repository.db.jdbc.location y com.ibm.team.datawarehouse.db.jdbc.location.
    4. Especifique la contraseña de usuario en las propiedades com.ibm.team.repository.db.jdbc.password y com.ibm.team.datawarehouse.db.jdbc.password.
    5. Cambie el valor de la línea com.ibm.team.fulltext.indexLocation=conf/relmjts/indices/workitemindex a la ubicación de vía de acceso completa del índice de texto completo. Por ejemplo, escriba com.ibm.team.fulltext.indexLocation=c:/Progra~1/IBM/JazzTeamServer/server/conf/relmjts/indices/workitemindex.
    6. Cambie el valor de la línea com.ibm.team.jfs.index.root.directory=indices a la ubicación de vía de acceso completa del directorio raíz de índice de Jazz Foundation Service. Por ejemplo, especifique com.ibm.team.jfs.index.root.directory=c:/Progra~1/IBM/JazzTeamServer/server/conf/relmjts/indices.
  2. Después de crear la base de datos, debe ejecutar un mandato de herramientas de repositorio para crear tablas de base de datos.
    Importante: Ejecute el mandato createTables sólo si se trata de una instalación nueva.
    Nota: El usuario que ejecuta el mandato -createWarehouse debe tener permisos DBA. .
    Nota: Cuando se ejecuta el mandato repotools, se actualizará el archivo teamserver.properties y se guardará el archivo original con el contenido original en el mismo directorio. Es posible que también vea un aviso que indica que el URI público no se ha establecido. Puede pasar por alto este aviso en este momento porque el URI público se establecerá cuando Ejecución del asistente de configuración de Jazz Team Server para las aplicaciones de Rational Engineering Lifecycle Manager.
    1. Para crear las tablas de base de datos para Jazz Team Server, vaya al directorio JazzInstallDir/server y ejecute estos mandatos:
      repotools-relmjts -createTables
    2. Para crear las tablas de base de datos para la aplicación de Rational Engineering Lifecycle Manager, vaya al directorio RELMInstallDir/server y ejecute estos mandatos:
      repotools-relm -createTables
    3. Para crear las tablas de base de datos para la aplicación Gestión de configuración, vaya al directorio VVCInstallDir/server y ejecute estos mandatos:
      repotools-vvc -createTables

Comentarios