Configuration d'une base de données Oracle pour Rational Engineering Lifecycle Manager et Lifecycle Query Engine

Configurez une base de données Oracle de façon à la faire fonctionner avec Rational Engineering Lifecycle Manager Jazz Team Server, Rational Engineering Lifecycle Manager et l'application Configuration Management.

Avant de commencer

La création et la configuration d'une base de données Oracle suppose que l'utilisateur qui prépare la base de données dispose de droits d'administration sur la base de données et que cette dernière, ainsi que le stockage de l'espace table et la configuration de stockage appropriée, sont créés par un utilisateur doté de droits d'administration système. L'une des éditions Oracle prises en charge suivantes doit être installée sur un ordinateur afin d'être utilisée en tant que serveur de base de données. Cet ordinateur peut être différent de celui sur lequel Jazz Team Server est exécuté :
Remarque : Le pilote Java™ Database Connectivity (JDBC) requis pour Oracle 10g et 11g doit être au minimum ojdbc6.jar 11.2.0.3. De plus, mettez toujours à jour la base de données vers la version de base de données la plus récente. Par exemple, si le serveur de base de données est 11.2, vous devez exécuter la version 11.2.0.3 ou supérieure.
Important : Les options d'espace table et les paramètres de configuration suivants sont des exemples et risquent de ne pas s'appliquer en totalité à votre environnement. Par exemple, si vous ne pouvez pas utiliser le paramètre AUTOEXTEND, les fichiers doivent être suffisamment volumineux pour autoriser un accroissement. Ou si vous ne pouvez pas utiliser le quota de taille UNLIMITED pour l'utilisateur de base de données Jazz Team Server, affectez suffisamment d'espace pour permettre une croissance rapide.
Important : Si vous installez les applications Rational Engineering Lifecycle Manager sur le même ordinateur ou des plateformes réparties, vous pouvez créer des bases de données distinctes pour chaque application ou utiliser la même base de données pour toutes les applications. Cependant, vous devez créer un espace table distinct et un utilisateur de base de données associé à cet espace table pour chaque application.

Les exemples de cette rubrique correspondent à une base de données Oracle avec des utilisateurs de base de données distincts dédiés pour chaque application.

Remarque : La base de données que vous créez pour Jazz Team Server et toutes les applications Rational Engineering Lifecycle Manager doivent être formatées pour utiliser UTF-8 en tant que jeu de caractères. Par défaut, Oracle ne crée pas les bases de données avec le jeu de caractères UTF-8. Lorsque vous créez une nouvelle base de données, prenez soin de sélectionner AL32UTF8 dans la configuration de base de données Oracle.

Procédure

  1. En tant qu'administrateur système, créez une base de données avec un codage UTF8 pour Jazz Team Server et toutes les applications.
  2. Ouvrez une fenêtre SQL *Plus et créez les espaces table de base de données :
    CREATE TABLESPACE <espace table utilisateur relmjts> 
    DATAFILE '<chemin d'accès et nom du fichier .dbf>' 
    SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
    CREATE TEMPORARY TABLESPACE <espace table utilisateur relmjts> 
    TEMPFILE '<chemin d'accès et nom du fichier temporaire .dbf>' 
    SIZE 20M AUTOEXTEND ON EXTENT MANAGEMENT LOCAL UNIFORM SIZE 1M;
  3. Si vous installez toutes les applications Rational Engineering Lifecycle Manager, vous devez répéter l'étape précédente deux fois pour créer un espace table distinct pour Rational Engineering Lifecycle Manager JTS (relmjts), Rational Engineering Lifecycle Manager (relm) et Configuration Management (vvc). Dans Oracle Enterprise Manager Database Control, vérifiez que les espaces table créés s'affichent et sont accessibles.
  4. Créez un utilisateur de base de données Oracle pour chaque nouvel espace table.

    Une fois les espaces table créés, vous devez créer un utilisateur Oracle spécial pour chaque application afin d'utiliser la base de données Oracle. Si plusieurs serveurs Jazz s'exécutent sur une base de données Oracle, vous devez créer un utilisateur de base de données Oracle pour chaque application. L'utilisateur de base de données Oracle doit pouvoir créer des objets de base de données dans son espace table (illimité ou avec un quota d'espace) avec des droits permettant de créer une session, une table, une procédure et des vues.

    Dans ces exemples, remplacez les expressions entre les signes supérieur et inférieur.
    CREATE USER <utilisateur bd relmjts> IDENTIFIED BY <mot de passe> DEFAULT TABLESPACE <espace table utilisateur relmjts> QUOTA UNLIMITED ON <espace table utilisateur relmjts> TEMPORARY TABLESPACE <espace table utilisateur relmjts>;
    Une fois que l'utilisateur a été créé, vous devez lui octroyer les droits nécessaires pour qu'il puisse initialiser la base de données Jazz. La commande SQL suivante peut être utilisée pour octroyer les droits appropriés :
    GRANT CREATE PROCEDURE, CREATE SESSION, CREATE TABLE, CREATE VIEW TO <utilisateur bd relmjts>;
    Remarque : La création de l'entrepôt de données sur Oracle requiert des droits d'accès supplémentaires comparés à d'autres bases de données. Lorsque vous spécifiez l'utilisateur de base de données dans la spécification de la connexion pour l'entrepôt de données, assurez-vous que l'utilisateur de la base de données dispose des droits d'accès d'administrateur de base de données. Pour plus d'informations, consultez la Procédure d'installation. Par ailleurs, on suppose qu'un espace table nommé "USERS" existe déjà. Il s'agit d'un espace table Oracle par défaut. Si cet espace table n'existe pas dans votre base de données Oracle, utilisez la commande suivante pour le créer.
    CREATE TABLESPACE USERS 
    DATAFILE '<chemin d'accès et nom du fichier .dbf>' 
    SIZE <taille espace table> AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
  5. Créez une variable d'environnement nommée ORACLE_JDBC_DRIVER_FILE et pointez vers le pilote JDBC ojdbc6.jar. L'emplacement peut varier selon le produit Oracle et le système d'exploitation. Vous pouvez télécharger le pilote JDBC Oracle pris en charge (ojdbc6.jar 11.2.0.3) depuis www.oracle.com.
    1. Cliquez sur Démarrer > Panneau de configuration > Système.
    2. Cliquez sur l'onglet Avancé, puis sélectionnez Variables d'environnement.
    3. Dans la liste Variables système, cliquez sur Nouveau.
    4. Dans Nom de variable, entrez ORACLE_JDBC_DRIVER_FILE et dans Valeur de variable, entrez C:\Chemin_pilote_JDBC\ojdbc6.jar.
    1. Sur les systèmes Linux, ajoutez la déclaration de variable d'environnement suivante :
      ORACLE_JDBC_DRIVER_FILE =.;chemin_pilote_JDBC/ojdbc6.jar
      Remarque : Rational Engineering Lifecycle Manager ne supporte pas JRE 5.0. Les versions 6.0 et 7.0 des JRE sont prises en charge. La bibliothèque de classe ojdbc5.jar requiert JRE 5.0 et la bibliothèque de classe ojdbc6.jar requiert JRE 6.0 ou version ultérieure. Vous devez utiliser ojdbc6.jar.

      Si vous utilisez WebSphere Application Server, vous devez également ajouter une propriété personnalisée qui pointe vers le pilote JDBC ojdbc6.jar. Pour plus d'informations, voir Configuration de WebSphere Application Server for Rational Engineering Lifecycle Manager.

  6. Pour configurer la connexion de base de données et créer des tables de bases de données, procédez comme suit :
    1. Si vous utilisez Tomcat, démarrez le serveur et suivez les instructions de la rubrique Exécution de l'assistant de configuration de Jazz Team Server pour les applications Rational Engineering Lifecycle Manager.
    2. Si vous déployez WebSphere Application Server, voir Exécution de l'assistant de configuration de Jazz Team Server pour les applications Rational Engineering Lifecycle Manager.

Configuration manuelle d'une base de données Oracle

Pourquoi et quand exécuter cette tâche

L'exécution de l'assistant de configuration est la méthode recommandée pour configurer les connexions de base de données et créer les tables de base de données. Pour exécuter l'assistant de configuration, suivez les instructions dans Exécution de l'assistant de configuration de Jazz Team Server pour les applications Rational Engineering Lifecycle Manager

Si vous préférez effectuer cette opération manuellement, utilisez cette rubrique pour modifier le fichier teamserver.properties afin de configurer une connexion de base de données Oracle et exécuter la commande -createTables pour créer des tables de base de données.

Procédure

  1. Pour chaque application, il existe un fichier teamserver.properties distinct, que vous devez ouvrir et modifier. Ces fichiers se trouvent dans leur répertoire respectif (relmjts, relm et vvc) dans le répertoire <rép_install_Jazz>/server/conf. Ouvrez chaque fichier teamserver.properties et indiquez les détails de base de données et de connexion.
    1. Mettez en commentaire les lignes ci-après sous Derby Configuration en plaçant un signe dièse (#) au début de chaque ligne :
      #com.ibm.team.repository.db.vendor = DERBY
      # com.ibm.team.repository.db.jdbc.location=conf/relmjts/derby/repositoryDB
    2. Annulez la mise en commentaire des lignes suivantes sous Oracle Configuration en supprimant le signe dièse (#) qui les précède :
      Remarque : Il existe deux lignes pour l'emplacement de base de données fourni pour chaque référentiel. Une pour les systèmes locaux et l'autre pour les serveurs de base de données sur les systèmes distants. Supprimez uniquement la mise en commentaire de la ligne qui s'applique à votre environnement. Les exemples ci-dessous s'appliquent à un serveur distant dont l'adresse URL est précédée par une double barre oblique, @//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. Modifiez les valeurs suivantes sur les lignes com.ibm.team.repository.db.jdbc.location et com.ibm.team.datawarehouse.db.jdbc.location :
      • //oracleserver.example.com:1521 : entrez le nom d'hôte qualifié complet du serveur de base de données.
      • jtsDBuser : indiquez l'utilisateur de la base de données.
      • jazzDBuser : indiquez l'utilisateur de l'entrepôt de base de données Il doit s'agir d'un administrateur de la base de données.
      • ORCL : entrez le nom du service Oracle. Lors de la connexion à une base de données Oracle, vérifiez que le nom de service ORCL existe sur le système serveur.
      A faire : Les URL d'emplacement Oracle ont divers formats. Les exemples de cette section fonctionnent dans la plupart des cas. Consultez la documentation JDBC Oracle pour plus d'informations.
      Remarque : Ne modifiez pas le texte password={password} dans les propriétés com.ibm.team.repository.db.jdbc.location et com.ibm.team.datawarehouse.db.jdbc.location.
    4. Indiquez le mot de passe de l'utilisateur dans les fichiers com.ibm.team.repository.db.jdbc.password et com.ibm.team.datawarehouse.db.jdbc.password properties.
    5. Remplacez la valeur de la ligne com.ibm.team.fulltext.indexLocation=conf/relmjts/indices/workitemindex par le chemin complet de l'index de texte intégral. Par exemple, tapez com.ibm.team.fulltext.indexLocation=c:/Progra~1/IBM/JazzTeamServer/server/conf/relmjts/indices/workitemindex.
    6. Remplacez la valeur de la ligne com.ibm.team.jfs.index.root.directory=indices par le chemin complet du répertoire racine de l'index Jazz Foundation Service. Par exemple, tapez com.ibm.team.jfs.index.root.directory=c:/Progra~1/IBM/JazzTeamServer/server/conf/relmjts/indices.
  2. Après la création de la base de données, exécutez une commande d'outils de référentiel pour créer ses tables.
    Important : Exécutez la commande createTables uniquement s'il s'agit d'une nouvelle installation.
    Remarque : L'utilisateur qui exécute la commande -createWarehouse doit disposer des droits d'administrateur de base de données. .
    Remarque : Lorsque vous exécutez la commande repotools, le fichier teamserver.properties est mis à jour et le fichier d'origine avec le contenu d'origine est enregistré dans le même répertoire. Il est possible que le système affiche un avertissement indiquant que l'URI public n'a pas été défini. Vous pouvez ignorer cet avertissement à ce stade car l'URI public est défini lors de l'opération Exécution de l'assistant de configuration de Jazz Team Server pour les applications Rational Engineering Lifecycle Manager.
    1. Pour créer les tables de bases de données pour Jazz Team Server, accédez au répertoire rép_install_Jazz/serveret exécutez les commandes suivantes :
      repotools-relmjts -createTables
    2. Pour créer les tables de bases de données de l'application Rational Engineering Lifecycle Manager, accédez au répertoire rép_install_RELM/server et exécutez les commandes suivantes :
      repotools-relm -createTables
    3. Pour créer les tables de bases de données de l'application de gestion de configuration Configuration Management, accédez au répertoire rép_install_VVC/server et exécutez les commandes suivantes :
      repotools-vvc -createTables

Commentaires