Configuration d'une base de données Oracle

Configurez une base de données Oracle pour travailler avec Jazz Team Server.

Avant de commencer

Cette procédure suppose de respecter les conditions préalables ci-dessous. Consultez la documentation Oracle ou un administrateur de base de données Oracle pour obtenir de l'aide.

Oracle est installé sur une machine devant faire office de serveur de base de données. Cette machine peut être différente de celle sur qui héberge Jazz Team Server.
Une base de données par défaut est présente sur le serveur Oracle.
Remarque : Lors de l'installation d'Oracle, vous avez la possibilité de créer automatiquement une base de données.

Remarque : Pour garantir le traitement correct du contenu Unicode, le jeu de caractères de la base de données doit être UTF-8.
L'utilisateur qui se conforme à ces instructions détient les droits d'administration sur la base de données Oracle.

Lors de l'exécution de Jazz Team Server sur Oracle, créez une espace de table Oracle afin d'améliorer les performances. Vous devez créer un utilisateur associé à cet espace de table.

Remarque : Cette procédure n'est en aucun cas réalisée par le générateur de base de données à l'aide des outils de référentiel.

A propos de cette tâche

Pour configurer une base de données Oracle, procédez comme suit :

Créez un espace de table. L'emplacement de l'espace de table doit être approprié à la machine et à l'unité de disque.
Remarque : L'espace de table peut comporter l'une des propriétés suivantes :
- Un nom autre que oracle_tbs
- Un emplacement dans un autre répertoire
- Une taille supérieure à 1 Go. Pour les installations volumineuses, vous devez allouer plus d'espace.
L'exemple ci-dessous illustre une instruction create exécutée sur une machine Windows :
```
CREATE BIGFILE TABLESPACE oracle_tbs DATAFILE 'D:\oracle_tbs\oracle_tbs.dbf' SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE
```
Remarque : Le chemin de répertoire (D:\oracle_tbs, dans cet exemple) doit exister. Il n'est pas nécessaire de créer un espace de table distinct. Vous pouvez utiliser l'espace de table USERS par défaut, mais Oracle se comporte mieux avec un espace préalablement alloué sur le disque qu'il gère.
Créez un utilisateur Oracle.
Une fois créé l'espace de table, un utilisateur Oracle spécial doit être créé pour Jazz afin d'utiliser la base de données Oracle.
Dans cet exemple, l'utilisateur porte le nom jazzDBuser et le mot de passe (IDENTIFIED BY selon la terminologie Oracle) jazzDBpswd et existe dans l'espace de table créé dans la rubrique 1.
```
CREATE USER jazzDBuser IDENTIFIED BY jazzDBpswd DEFAULT TABLESPACE oracle_tbs
```
Une fois créé l'utilisateur, accordez les droits du système de base de données nécessaires à l'exécution de ces actions suivantes :
- Création d'une session.
- Création, modification et suppression des tables et des index.
- Insertion, mise à jour et suppression des tables créées.
Recherchez le fichier teamserver.properties dans le répertoire JazzInstallDir/server te renommez-le teamserver.derby.properties.
Recherchez le fichier teamserver.oracle.properties dans le répertoire JazzInstallDir/server et renommez-le teamserver.properties.
Configurez le serveur
1. Ouvrez le fichier teamserver.properties dans un éditeur de texte. Recherchez les lignes suivantes et modifiez les propriétés d'emplacement et de mot de passe de votre configuration :
```
com.ibm.team.repository.db.vendor = ORACLE
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/ORCL
com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@//oracleserver.example.com:1521/ORCL
com.ibm.team.repository.db.jdbc.password=jazzDBpswd
```
  Remarque : Si vous utilisez Oracle Express, remplacez ORCL par XE.
```
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.location=thin:jazzDBuser/{password}@//oracleserver.example.com:1521/XE
com.ibm.team.repository.db.jdbc.password=jazzDBpswd
```
  Indiquez le mot de passe de l'utilisateur dans la propriété com.ibm.team.repository.db.jdbc.password.
  Remarque : Ne modifiez pas le texte password={password} dans la propriété com.ibm.team.repository.db.jdbc.location.
2. Dans le même répertoire que les scripts de serveur (JazzInstallDir/server), créez un répertoire nommé oracle.
3. Recherchez le fichier JAR du pilote JDBC d'Oracle, nommé ojdbc14.jar. L'emplacement peut varier selon le produit Oracle et le système d'exploitation. Copiez ce fichier dans le répertoire nommé oracle.
  Remarque : Si vous utilisez WebSphere Application Server, configurez une propriété nommée "ORACLE_JDBC", puis attribuez-lui le chemin absolu (pas l'URL) des pilotes JDBC d'Oracle. Cette tâche est décrite dans les instructions de configuration de WebSphere Application Server. Notez le chemin pour une utilisation ultérieure dans ces instructions.

Résultats

La configuration de votre base de données est terminée. Vous pouvez continuer par Création des tables de base de données de Jazz Team Server.