Pour configurer une base de données Oracle et l'utiliser avec Rational Quality Manager, procédez comme suit :
Avant de commencer
Facteurs à prendre en compte :
- Oracle peut être installé sur un serveur de base de données dédié ou sur la machine sur laquelle Rational Quality Manager est installé.
- Pour que le contenu Unicode soit correctement traité, le jeu de caractères de la base de données doit utiliser le codage UTF-8.
- L'utilisateur qui suit ces instructions doit avoir des droits d'administration système sur la base de données Oracle.
Pourquoi et quand exécuter cette tâche
Remarque : IBM®
Rational Team Concert fournit des informations supplémentaires sur la configuration d'une base de données Oracle. Pour visualiser ces informations,
voir
Setting up an Oracle database.
Pour configurer une base de données Oracle, procédez comme suit :
- Si nécessaire, installez Oracle en suivant les instructions fournies dans le guide d'installation d'Oracle.
- Créez une base de données Oracle.
Sur le serveur Oracle, démarrez Database Configuration Assistant et créez une base de données. Si vous ne savez pas comment procéder, prenez contact avec votre administrateur de base de données.
- Pour améliorer les performances de la base de données, créez un espace table Oracle d'au moins 1 Go à un emplacement approprié sur le serveur Oracle.
L'exemple ci-dessous indique comment créer une instruction exécutée sur une machine Windows® :
CREATE BIGFILE TABLESPACE oracle_tbs DATAFILE 'c:\oracle_tbs\oracle_tbs.dbf' SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE
Remarque : Le chemin du répertoire (c:\oracle_tbs dans le présent exemple) doit déjà exister.
Il n'est pas nécessaire de créer un espace table spécial distinct. Vous pouvez utiliser l'espace table USERS par défaut d'Oracle, mais Oracle fonctionne plus efficacement avec un espace préalloué sur le disque qu'il gère.
- Créez un utilisateur Oracle spécial pour Rational Quality Manager.
CREATE USER RQMDBuser IDENTIFIED BY RQMDBpswd DEFAULT TABLESPACE oracle_tbs
Dans l'exemple précédent, le nom d'utilisateur est RQMDBUser et le mot de passe (IDENTIFIED
BY dans la terminologie Oracle) est RQMDBpswd.
- Après avoir créé l'utilisateur RQMDBUser, affectez-lui les droits système nécessaires à l'exécution des actions suivantes :
- création d'une session,
- création, modification ou suppression de tables et d'index,
- insertion, mise à jour et suppression des tables créées.
- Copiez le fichier ojdbc14.jar Oracle stocké sur la machine sur laquelle Oracle
est installé vers le serveur Rational Quality Manager.
- Accédez à répertoire_installation/server/ et créez un répertoire appelé oracle.
- Copiez le fichier ojdbc14.jar dans ce répertoire.
- Configurez les propriétés de la base de données Rational Quality Manager.
- Accédez à répertoire_installation/server/conf/jazz et recherchez le fichier teamserver.oracle.properties.
- Dans le fichier temporaire teamserver.oracle.properties, modifiez le nom d'hôte (ou l'adresse IP) de la base de données, ainsi que le nom d'utilisateur et le mot de passe Oracle comme indiqué ci-dessous :
Fichier teamserver.oracle.properties par défaut :
com.ibm.team.repository.db.vendor = ORACLE
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@//oracleserver.example.com:1521/ORCL
com.ibm.team.repository.db.jdbc.password=jazzDBpswd
Fichier teamserver.oracle.properties une fois modifié pour Rational Quality Manager :
com.ibm.team.repository.db.vendor = ORACLE
com.ibm.team.repository.db.jdbc.location=thin:RQMuser/{password}@//9.34.23.81:1521/RQMDB
com.ibm.team.repository.db.jdbc.password=password
où
RQMuser est un utilisateur ayant les droits d'accès appropriés à la base de données.
RQMDB est le nom de la base de données Oracle.
9.34.23.81:1521 est l'adresse IP et le numéro de port du serveur Oracle.
password est le mot de passe de l'utilisateur Oracle.
Remarque : Il convient de placer des barres // avant l'adresse IP ci-dessous lorsque le serveur RQM et Oracle sont installés sur des machines différentes.
Ne modifiez pas la chaîne de texte password={password} dans la propriété com.ibm.team.repository.db.jdbc.location.
- Ajoutez les lignes suivantes au fichier “teamserver.oracle.properties”.
#websphere port configuration
com.ibm.team.repository.server.repourl.port.http=9080
com.ibm.team.repository.server.repourl.port.https=9443
Remarque : Il s'agit des numéros de port par défaut. Si vous n'avez pas installé WAS et que vous utilisez d'autres numéros de port, faites-les correspondre aux numéros de port affectés dans WAS.
- Sauvegardez le fichier teamserver.oracle.properties.
- Renommez le fichier teamserver.properties en teamserver.properties.BAK.
- Renommez le fichier teamserver.oracle.properties en teamserver.properties et sauvegardez-le.
- Créez les tables de base de données.
Après avoir modifié le fichier teamserver.properties, exécutez un utilitaire Jazz appelé repotools afin de créer des tables de base de données. Le fichier repotools.bat
réside à l'emplacement répertoire_installation/server/.
Ouvrez une fenêtre d'invite de commande et exécutez repotools avec les arguments suivants :
repotools -createTables logFile=c:/tmp/repotools.log