PROJET : Remarques relatives à la mise à niveau des fonctions de serveur ClearQuest

Avant une mise à niveau ou l'application de groupes de correctifs, vérifiez les informations importantes qui affectent la mise à niveau, la configuration et l'administration pour les fonctions du serveur ClearQuest Web.

Le serveur ClearQuest Web, la recherche en texte intégral et les fonctions de génération de rapports sont installés dans le même profil WebSphere Application Server (WebSphere Application Server). Lorsque vous effectuez une mise à niveau ou un déplacement vers un nouveau profil WebSphere Application Server, toutes ces fonctions doivent être mises à niveau ou déplacées en même temps.
Important : Si l'environnement ClearQuest inclut les fonctions Full Text Search et Report Launcher, vous devez installer l'édition 32 bits de WebSphere Application Server. Ces fonctions ne sont pas prises en charge dans l'édition 64 bits de WebSphere Application Server. Pour plus d'informations, voir la note technique 1512059
Utilisez ces liens ou faites défiler le contenu de la page pour consulter des informations détaillées sur la mise à niveau des fonctions du serveur ClearQuest.

Mise à niveau du serveur Web ClearQuest

Tableau 1 présente une vue d'ensemble du processus de mise à niveau pour le serveur Web ClearQuest en fonction de la version à partir de laquelle vous effectuez une mise à niveau.
Tableau 1. Instructions de mise à niveau du serveur Web ClearQuest par version
Versions du logiciel installées Présentation de la mise à niveau
Version 7.x de ClearQuest Dans ClearQuest 8.x, WebSphere Application Server est installé séparément à partir du serveur Web ClearQuest, connu sous le nom de serveur ClearQuest CM dans ClearQuest version 7.x. L'installation séparée active les environnements WebSphere Application Server et IBM® HTTP Server qui seront gérés indépendamment de l'environnement ClearQuest. Si vous effectuez une mise à niveau de la version 7.x, utilisez IBM Installation Manager pour installer une version prise en charge de WebSphere Application Server et d'IBM HTTP Server avant d'effectuer la mise à niveau des ressources ClearQuest. Voir Préparation de l'environnement WebSphere Application Server pour les serveurs Web ClearCase et ClearQuest.
Restriction : Toutefois, l'architecture du serveur d'applications ClearQuest et le processus d'installation étant différents entre les versions, l'opération d'annulation n'est pas prise en charge si vous effectuez la mise à niveau de la version 7.x de ClearQuest à la version 8.x. Pour restaurer la version précédente, supprimez la nouvelle version et réinstallez la version précédente du produit.
Version 8.0 de ClearQuest avec WebSphere Application Server 7.0
  1. Mettez à niveau WebSphere Application Server vers la version 8.5.
  2. Mettez à niveau ClearQuest vers la version 8.0.1.
Restriction : L'opération d'annulation n'est pas prise en charge si vous mettez à niveau à partir du déploiement ClearQuest 8.0 dans WebSphere Application Server de 7.0 vers un déploiement de la version 8.0.0.x ClearQuest avec WebSphere Application Server 8.0. Pour restaurer la version précédente, supprimez la nouvelle version et réinstallez la version précédente.
Version 8.0.0.x de ClearQuest, avec la version 8.0 de WebSphere Application Server. La version 8.0.1 de ClearQuest est prise en charge sur les versions 8.0 et 8.5 de WebSphere Application Sever. Lorsque vous effectuez une mise à niveau, vous avez deux possibilités :
  • Option 1 : La mise à niveau de Rational ClearQuest vers la version 8.0.1 sans la mise à niveau de WebSphere Application Server.
  • Option 2 : La mise à niveau de WebSphere Application Server vers la version 8.5, puis la mise à niveau de Rational ClearQuest vers la version 8.0.1.

Meilleures pratiques et conseils pour la mise à niveau du serveur Web ClearQuest

  • Avant la mise à niveau, consultez les notes sur l'édition de ClearQuest pour obtenir plus d'informations sur les problèmes connus ou les limitations relatives à l'installation et à la mise à niveau.
  • Soyez vigilant lorsque vous substituez des affectations de numéro de port par défaut au cours du processus de mise à niveau. Pendant les opérations de mise à niveau ou d'installation, les numéros de port par défaut sont affectés pour garantir que chaque port est unique. Par exemple, si le port par défaut pour le profil de la version 7.x de WebSphere Application Server AppSrv01 est le port 9080, lorsque vous effectuez une mise à niveau vers la version 8.0.x, le port par défaut qui est affecté à AppSrv01 est 9081. Si vous substituez le numéro de port par défaut, vous risquez d'introduire des conflits de numéros de port.
  • Vous ne pouvez pas modifier les paramètres de sécurité de profil durant le processus de mise à niveau de ClearQuest. Utilisez la console WebSphere Application Server pour gérer la sécurité administrative de WebSphere Application Server.
  • Redémarrez IBM Installation Manager entre les opérations successives si vous n'êtes pas invité à redémarrer le système.

Fonctions de génération de rapports et serveur de rapport de ClearQuest

ClearQuest version 8.0 intègre une nouvelle stratégie de génération de rapports susceptible d'affecter votre processus de mise à niveau. Si votre plan de mise à niveau inclut la mise à jour ou l'ajout de la prise en charge pour la génération de rapports Rational ClearQuest, voir Génération de rapports sur les sources de données Rational ClearQuest pour plus d'informations sur ces changements.

Mise à niveau de la recherche en texte intégral

Avant la mise à niveau ou l'application de groupes de correctifs pour l'environnement Web ClearQuest avec la fonction activée de la recherche en texte intégral, sauvegardez la configuration de la recherche en texte intégral et les données afin de pouvoir restaurer l'environnement après la mise à jour du logiciel. Vous devez sauvegarder ces informations avant de mettre à niveau WebSphere Application Server et le serveur Web ClearQuest. Tableau 2 présente une vue d'ensemble du processus de mise à niveau pour des chemins de mise à niveau différents. Pour plus d'informations, consultez Scénarios pour l'installation et la configuration de la recherche en texte intégral.

Tableau 2. Instructions de mise à niveau de la recherche en texte intégral de ClearQuest par version
Version ClearQuest Présentation de la mise à niveau
Version 7.1.x à la version 8.0.x de ClearQuest
  • Si vous avez téléchargé et installé l'outil ClearQuest 7.1.x Full Text Search Administrator à partir du site Web de téléchargement DCF, vous devez supprimer ou renommer le script de recherche en texte intégral cqtsadmin.pl et le répertoire CQTsAdmin se trouvant dans le répertoire de base ClearQuest 7.1.x avant de mettre à niveau cette fonction. Ce sont les emplacements par défaut pour ces ressources :
    • Windows : C:\Program Files\IBM\RationalSDLC\ClearQuest\
    • UNIX/Linux : /opt/ibm/RationalSDLC/clearquest/
    Après avoir renommé le répertoire, poursuivez avec le processus de mise à niveau ClearQuest.
  • Si l'outil Full Search Administrator n'a pas été utilisé pour le déploiement Full-Text Search d'origine, voir la Note technique # 1515900 Mise à niveau et migration de ClearQuest 7.1.x Full-Text Search vers ClearQuest 8.0 lorsque l'outil Full-Text Search Administrator WebSphere pour obtenir des informations sur la mise à niveau de Full Text Search Server.
Version 8.0.0.1 de ClearQuest ou version ultérieure à 8.0.x Au cours du processus d'installation de ClearQuest version 8.x, le logiciel de la fonction du Full Text Search Server est copié dans le profil WebSphere Application Server pour l'application ClearQuest Web. Pour conserver ces informations lorsque vous effectuez une mise à niveau, supprimez la fonction, ou appliquez des groupes de correctifs, utilisez le script cqtsadmin.pl de ClearQuest pour sauvegarder la configuration et les données de la recherche en texte intégral Après la mise à niveau, utilisez cqtsadmin.pl pour restaurer les données. Pour obtenir des instructions, voir Mise à niveau ou réinstallation de ClearQuest dans un déploiement de recherche en texte intégral avec plusieurs profils WebSphere..
Important : Pour exécuter la commande cqtsadmin.pl, la variable d'environnement CQFTS_AppServer_HOME doit être définie sur le répertoire dans lequel WebSphere Application Server est installé.
Dans certains cas, comme lorsque vous installez ClearQuest dans un profil WebSphere existant, ou lorsque vous installez la fonction de recherche en texte intégral sur un système séparé qui accède à distance aux serveurs Web ClearQuest, la variable d'environnement CQFTS_AppServer_HOME n'est pas définie et une erreur semblable à celle-ci s'affiche :
Impossible de déterminer le répertoire de base du serveur d'applications WebSphere. Voir le manuel ClearQuest Full-Text Search Administrator Guide pour savoir comment le définir via la variable d'environnement CQFTS_AppServer_HOME.
Pour résoudre le problème, exécutez la commande suivante pour définir CQFTS_AppServer_HOME
  • Sous Windows : set CQFTS_AppServer_HOME=C:\Program Files\IBM\WebSphere\AppServer
  • Sous Linux : setenv CQFTS_AppServer_HOME /opt/IBM/WebSphere/AppServer

Mise à niveau des environnements configurés pour l'authentification par carte à puce

Si vous effectuez une mise à niveau pour un déploiement ClearQuest Web configuré pour l'authentification par carte à puce et que vous souhaitez inclure des fonctions pour activer l'authentification par carte à puce pour les intégrations OSLC, vous devez mettre à jour et redéployer le fichier de descripteur de déploiement ClearQuest Web web.xml. Effectuez cette tâche après la mise à niveau du logiciel du serveur. Pour obtenir des instructions, voir Configuration de l'authentification par certificats client pour ClearQuest Web.


Commentaires