L'assistant d'installation de ClearQuest Connector configure votre environnement IBM® Rational ClearQuest en appliquant le package JazzInterop à un schéma, puis migre une base de données d'utilisateurs vers la nouvelle version de ce schéma. Toutefois, dans un environnement multisite ClearQuest, vous devez appliquer manuellement le package sur chaque schéma de réplique et mettre à niveau les répliques de la base de données d'utilisateur. Toutefois, l'assistant applique le package uniquement aux répliques connectées à la passerelle ClearQuest.
A propos de cette tâche
Le package JazzInterop ajoute un script Perl global, ChangeHistoryScripts, et
les types d'enregistrement suivants au schéma :
- JazzConnectorChangeEvents
- JazzConnectorQueryInfo
- JazzConnectorSyncHistory
Voir l'aide concernant Rational ClearQuest MultiSite pour obtenir des détails sur la séquence des étapes à suivre lors de l'application des packages et la mise à niveau des bases de données d'utilisateurs.
Appliquez toujours la dernière version (celle dont le
numéro est le plus élevé) du package JazzInterop au schéma. Si vous avez déjà appliqué
une version antérieure du package à votre schéma, migrez de manière incrémentielle vers la
version la plus récente. Par exemple,
si la version 1.06 est la version la plus récente, pour migrer de la version 1.03 vers la version 1.06, effectuez les tâches suivantes :
- Appliquez JazzInterop 1.04 à votre schéma.
- Mettez à niveau la base données d'utilisateurs.
- Appliquez JazzInterop 1.05 à votre schéma.
- Mettez à niveau la base données d'utilisateurs.
- Appliquez JazzInterop 1.06 à votre schéma.
- Mettez à niveau la base données d'utilisateurs.
Pour appliquer le
package JazzInterop à un schéma et mettre à niveau la base de données d'utilisateurs,
procédez comme suit :
- Sur un ordinateur Windows®,
copiez le dossier
répertoire-installation/gateway/cqPackage/JazzInterop dans le dossier
rép-install-cq/packages.
- Accédez au dossier rép-install-cq. Utilisez la commande packageutil
pour enregistrer le package JazzInterop dans ClearQuest. Si vous devez appliquer
plusieurs versions du package à votre schéma pour accéder à la version de package la plus
récente, exécutez cette commande plusieurs fois, en spécifiant une version de package
différente à chaque fois avant de passer à l'étape suivante. Exemple :
packageutil registerpackage JazzInterop version-package "C:\Program
Files\Rational\ClearQuest\packages\JazzInterop\version-package"
- Exécutez la commande ci-après pour permettre au package JazzInterop de mettre à
jour les types d'enregistrement que vous avez pu ajouter à votre schéma en y appliquant
d'autres packages.
packageutil enablepackageediting -dbset nom_dbset
connexion_clearquest motdepasse_clearquest -enable utilisateur
L'utilisateur que vous spécifiez avec le paramètre motdepasse_clearquest doit disposer des
droits de concepteur de schéma. Le compte d'utilisateur admin possède des droits de
super utilisateur, qui incluent les droits de concepteur de schéma. Par exemple :
packageutil enablepackageediting -dbset mon_réf_schéma admin "" -enable admin
- Ouvrez ClearQuest Designer
en cliquant sur . Dans la vue d'explorateur de référentiel de schéma, cliquez avec le bouton droit sur une version du schéma et sélectionnez . Développez le dossier JazzInterop et sélectionnez la version du package à appliquer. Cliquez sur Suivant.
Sélectionnez les types d'enregistrement à activer pour la synchronisation.
Cliquez sur Terminer. Restituez la nouvelle version du schéma.
- Utilisez de nouveau la commande packageutil enablepackageediting avec l'option
–disable pour remettre les types d'enregistrement en lecture seule.
Par exemple :
packageutil enablepackageediting -dbset mon_réf_schéma admin "" -disable admin
- Cliquez sur . Cliquez avec le bouton droit sur la base de données d'utilisateur que vous souhaitez mettre à niveau, puis cliquez sur Mettre à niveau la base de données.
La fenêtre de mise à niveau de la base de données d'utilisateur s'ouvre. Sélectionnez la nouvelle version du schéma dans la liste Versions et cliquez sur OK.
Que faire ensuite
Si vous décidez ultérieurement d'appliquer le package JazzInterop à un autre
type d'enregistrement avec état dans le même schéma, commencez par exécuter de
nouveau la commande packageutil enablepackageediting avec l'option –enable. Ouvrez ClearQuest Designer
et réservez le schéma. Dans la vue d'explorateur de référentiel de schéma,
développez le dossier
Types d'enregistrement. Cliquez sur un type d'enregistrement à l'aide du
bouton droit de la souris et sélectionnez
Paramétrer les types d'enregistrement pour les packages.
Sélectionnez le package JazzInterop et cliquez sur
OK.
Restituez
la nouvelle version du schéma. Exécutez la commande packageutil enablepackageediting
avec l'option –disable. Mettez à niveau la base de données d'utilisateurs avec la nouvelle version du schéma.
Vous
devez utiliser une autre procédure pour appliquer le package JazzInterop
à un autre type d'enregistrement sans état.
Ouvrez ClearQuest Designer
et réservez le schéma. Dans la vue d'explorateur de référentiel de schéma, développez le dossier Types d'enregistrement - Sans état.
Développez le dossier du type d'enregistrement
sans état. Cliquez deux fois sur Actions.
Cliquez sur Nouvelle action. Entrez
Modifier_Historique dans la zone Nom de l'action. Sélectionnez BASE
dans la zone Type. Fermez la boîte de dialogue Action pour
sauvegarder la modification. Cliquez sur la cellule Notification
de l'action Modifier_Historique. Cliquez de nouveau et sélectionnez .
Cliquez
deux fois sur la cellule pour ouvrir l'éditeur de script. Copiez la ligne suivante
dans l'éditeur, après la dernière ligne de commentaire : JazzCQConnector($actionname, $actiontype);. Sauvegardez
vos modifications et fermez l'éditeur. Fermez la matrice Actions. Restituez le schéma. Mettez à niveau la base de données d'utilisateurs avec la nouvelle version du schéma.