Mettre en place une base de données SQL Server pour Rational Engineering Lifecycle Manager

Configurer une base de données SQL Server de façon à la faire fonctionner avec Jazz Team Server, Rational Engineering Lifecycle Manager et l'application de gestion des configurations (Configuration Management).

Avant de commencer

Cette procédure suppose de respecter les conditions préalables suivantes pour SQL Server :

Remarque : Si vous utilisez le serveur SQL dans une langue autre que l'anglais, vous devez remplacer la langue par l'anglais avant de créer l'entrepôt de données :
  1. Dans SQL Server Management Studio, cliquez avec le bouton droit de la souris sur la connexion au serveur de base de données.
  2. Dans la fenêtre en incrustation, sélectionnez Propriétés.
  3. Dans la fenêtre Propriétés du serveur, sélectionnez Avancé et définissez l'entrée Langue par défaut sur Anglais.
  4. Sauvegardez vos modifications.

Procédure

  1. Créez une base de données pour chaque instance de Jazz Team Server, Rational Engineering Lifecycle Manager et de l'application de gestion des configurations. Créez une base de données pour l'entrepôt de données associé au serveur Jazz Team. Par exemple, si vous avez une instance de Rational Engineering Lifecycle Manager, une application de gestion des configurations, une instance de Jazz Team Server et un entrepôt de données, vous devez créer quatre bases de données. Pour créer la base de données de Jazz Team Server, aidez-vous de l'exemple ci-dessous. Pour créer les bases de données de Rational Engineering Lifecycle Manager et de l'application de gestion des configurations, remplacez jts par le nom de votre base de données ; par exemple, relm et vvc :
    CREATE DATABASE jts 
    GO 
  2. Pour chaque base de données, créez un utilisateur et un mot de passe et changez le propriétaire de la base de données.
    Exécutez ces commandes :
    CREATE LOGIN jtsDBuser
    WITH PASSWORD = 'jtsDBpswd';
    USE jts;
    exec sp_changedbowner 'jtsDBuser'
    GO 
  3. Changez le classement des bases de données de Jazz Team Server, Rational Engineering Lifecycle Manager et de l'application de gestion des configurations. A partir de l'outil de ligne de commande, exécutez la commande ci-dessous pour Jazz Team Server. Pour les bases de données de Rational Engineering Lifecycle Manager et de l'application de gestion des configurations, remplacez jts par relm ou vvc.
    ALTER DATABASE jts COLLATE SQL_Latin1_General_CP437_CS_AS 
    GO
  4. Changez le système de version de ligne pour les bases de données de Jazz Team Server, de Rational Engineering Lifecycle Manager et de l'application de gestion des configurations. A partir de l'outil de ligne de commande, exécutez la commande ci-dessous pour Jazz Team Server. Pour les bases de données de Rational Engineering Lifecycle Manager et de l'application de gestion des configurations, remplacez jts par relm ou vvc.
    Remarque : Vérifiez que la connexion à la base de données est ouverte avant d'exécuter la commande.
    ALTER DATABASE jts SET READ_COMMITTED_SNAPSHOT ON
    GO
  5. Changez le classement de la base de données de l'entrepôt de données. A partir la ligne de commande, entrez :
    ALTER DATABASE dw COLLATE SQL_Latin1_General_CP1_CS_AS
    GO
  6. Créez une variable d'environnement nommée SQLSERVER_JDBC_DRIVER_FILE et faites-la pointer vers le pilote JDBC sqljdbc4.jar. L'emplacement du pilote varie en fonction de votre installation.
    Windows
    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 SQLSERVER_JDBC_DRIVER_FILE, et dans Valeur de variable, entrez C:\Chemin_pilote_JDBC\sqljdbc4.jar.
    Linux Sur les systèmes UNIX, ajoutez la déclaration de variable d'environnement suivante :
    SQLSERVER_JDBC_DRIVER_FILE =.:Chemin_pilote_JDBC/sqljdbc4.jar
    Remarque : Rational Engineering Lifecycle Manager ne prend pas en charge JRE 5.0. Les versions prises en charge sont les JRE 6.0 et 7.0.

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

  7. Pour configurer les connexions de bases de données et créer les tables de base de données, effectuez l'une des opérations suivantes :
    1. Si vous utilisez Tomcat ou si vous déployez WebSphere Application Server, 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 préférez modifier manuellement le fichier teamserver.properties pour la connexion à la base de données, exécuter les commandes repotools pour créer les tables de base de données. Pour plus d'informations, lisez la rubrique Configuration manuelle d'une base de données SQL Server.
    3. Si vous effectuez une mise à niveau depuis une version antérieure, continuez à exécuter les scripts de mise à niveau appropriés pour faire migrer vos connexions de base de données existantes. Pour plus d'informations, consultez la rubrique relative à la mise à niveau de Rational Engineering Lifecycle Manager.

Configuration manuelle d'une base de données SQL Server

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. Si vous préférez effectuer cette opération manuellement, éditez le fichier teamserver.properties afin de configurer une connexion de base de données SQL Server et exécutez la commande -createTables pour créer les tables de la base de données.

Procédure

  1. Pour chaque application, ouvrez et modifiez un fichier teamserver.properties distinct. Ces fichiers se trouvent dans leur répertoire respectif (jts, relm et vvc) dans le répertoire <JazzInstallDir>/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. L'exemple concerne le fichier JTS teamserver.properties :
      #com.ibm.team.repository.db.vendor = DERBY
      # com.ibm.team.repository.db.jdbc.location=conf/jts/derby/repositoryDB
    2. Annulez la mise en commentaire des lignes suivantes sous SQL Server Configuration en supprimant le signe dièse (#) qui les précède :
      com.ibm.team.repository.db.vendor = SQLSERVER
      com.ibm.team.repository.db.jdbc.location=//localhost:1433;databaseName=jazz;user=jazzDBuser;password={password}
      com.ibm.team.repository.db.jdbc.password=jazzDBpswd
    3. Modifiez les valeurs suivantes dans les propriétés com.ibm.team.repository.db.jdbc.location et com.ibm.team.datawarehouse.db.jdbc.location :
      • //localhost:1433 : Entrez le nom d'hôte qualifié complet du serveur de base de données.
        Remarque : Vous devez associer manuellement le port statique à la valeur 1433 à l'aide l'outil de configuration de SQL Server.
      • jazz : Entrez le nom de la base de données.
      • jazzDBuser : Entrez le nom de l'utilisateur.
      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 propriétés com.ibm.team.repository.db.jdbc.password et com.ibm.team.datawarehouse.db.jdbc.password.
    5. Modifiez la valeur de la ligne com.ibm.team.fulltext.indexLocation=conf/jts/indices/workitemindex en indiquant le chemin d'accès complet de l'index de recherche en texte intégral. Par exemple, entrez com.ibm.team.fulltext.indexLocation=c:/Progra~1/IBM/JazzTeamServer/server/conf/jts/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, entrez com.ibm.team.jfs.index.root.directory=c:/Progra~1/IBM/JazzTeamServer/server/conf/jts/indices.
  2. Après la création de chaque base de données, créez ses tables en exécutant une commande repotools.
    Important : N'exécutez la commande createTables que dans le cas d'une nouvelle installation.
    Remarque : Lorsque vous exécutez la commande repotools, le fichier teamserver.properties est mis à jour et le fichier initial est sauvegardé avec son contenu d'origine 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. N'en tenez pas compte, car l'URI public sera défini lors de l'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/server et exécutez cette commande :
      repotools-jts -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 cette commande :
      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 cette commande :
      repotools-vvc -createTables 

Identification et résolution des problèmes

Procédure

  • Si la commande repotools n'aboutit pas, vérifiez les fichiers journaux appropriés, qui sont situés dans le répertoire RépInstallJazz/server.
  • Vérifiez que les conditions suivantes sont correctes :
    • Le serveur SQL est configuré de manière à autoriser les connexions utilisant le protocole TCP/IP. Si nécessaire, redémarrez le service SQL.
    • Le nom d'hôte de l'ordinateur SQL Server et le port apparaissent correctement dans les fichiers teamserver.properties.
    • Le nom de connexion, le mot de passe et le nom de la base de données apparaissent correctement dans les fichiers teamserver.properties.
    • Un pare-feu ne vous empêche pas d'accéder au serveur SQL. Utilisez une commande Telnet pour vous connecter au serveur. Entrez le nom d'hôte et le port figurant dans le fichier teamserver.properties.
    • L'utilisateur créé a les autorisations appropriées pour accéder à la base de données Jazz Team Server.
    • Les variables d'environnement du pilote JDBC sont configurées correctement pour votre environnement.
    Remarque : Jazz Team Server fonctionne sur différentes plateformes de bases de données ; cependant, les bases de données d'entreprises présentent des différences dans leur syntaxe, leurs stratégies d'optimisation et leur sémantique de verrouillage. Le serveur a été testé sur SQL Server avec une combinaison de tests automatisés et de simulations de charges de travail normales et extrêmes (tests de charge). La simulation de charges de travail normales a montré une performance acceptable. Dans certains cas, des interblocages des bases de données se sont produits au cours des tests d'accès concurrents automatisés ; cependant, ils n'ont pas été observés systématiquement sur les différentes machines serveur utilisées.

    Le serveur est conçu pour traiter un grand nombre de requêtes simultanées. Exceptionnellement, des interblocages se produisent dans la base de données du référentiel, car des objets identiques ou similaires sont mis à jour simultanément lors de transactions associées aux requêtes. Ces interblocages restent rares et reflètent un comportement normal. Le système se protège des interblocages et l'intégrité des données est préservée ; il n'y a pas de perte de données. Occasionnellement, des interblocages affectent les tâches telles que l'exécution du moteur de génération. En règle générale, ils sont détectés et la tâche concernée est relancée.

    Tous les interblocages sont consignés sur le serveur. Vous disposez ainsi d'informations sur les circonstances dans lesquelles un interblocage s'est produit. L'entrée du journal contient des informations telles que : com.ibm.team.repository.common.RetryableDatabaseException: Serialization failure.

    Si votre système rencontre des interblocages, reportez-vous au journal des erreurs à l'adresse suivante : https://nomserveur:9443/jts/service/com.ibm.team.repository.common.internal.IFeedService?category=SystemLog.

    Si vous rencontrez de fréquents interblocages, contactez le service de support du produit ou consultez les dernières informations, mises à niveau ou techniques de contournement sur les forums sur jazz.net.


Commentaires