Installer les logiciels en option

Les logiciels optionnels suivants sont inclus dans l'image d'installation de Rational Performance Tester :

Installation d'Agent Controller

Agent Controller est un démon qui permet aux applications client de lancer et de gérer des applications locales ou distantes et qui fournit aux autres applications des informations sur l'exécution des applications. Vous devez installer Agent Controller séparément pour pouvoir utiliser les outils suivants :

Remarque :

Configuration matérielle requise

Remarque :
Pour Rational Performance Tester, Agent Controller doit être installé sous Windows et Linux avec Installation Manager.

Plateformes prises en charge

Agent Controller v7.0.1 est pris en charge sur les plateformes suivantes :

JVM prises en charge

IBM Java SDK v5 :

Emplacement des fichiers d'installation

Les fichiers d'installation se trouvent sur le disque Agent Controller, dans les répertoires suivants :

Installation d'Agent Controller sur un poste de travail AIX

Remarque :
Pour Rational Performance Tester, Agent Controller doit être installé sous Windows et Linux avec Installation Manager.

Désinstallation des versions précédentes d'Agent Controller

Remarque :
Avant d'installer Agent Controller version 7.0.1, vous devez désinstaller la version précédente d'Agent Controller :

Lorsque vous désinstallez Agent Controller V6.x ou V7.x sur des plateformes AIX, vous devez ensuite supprimer manuellement certains fichiers résiduels. Pour cela, arrêtez Agent Controller, désinstallez-le et supprimez les fichiers suivants, qui peuvent subsister sur le système après la désinstallation :

AIX :

$RASERVER_HOME/* (répertoire d'installation d'Agent Controller
/usr/lib/libLogAgent.so
/usr/lib/libhcbnd.so
/usr/lib/libhcclco.so
/usr/lib/libhccldt.so
/usr/lib/libhccls.so
/usr/lib/libhcclserc.so
/usr/lib/libhcclsert.so
/usr/lib/libhcclsm.so
/usr/lib/libhcjbnd.so
/usr/lib/libhclaunch.so
/usr/lib/libhcthread.so

Configuration de l'environnement du système d'exploitation

Exécutez les commandes suivantes pour définir les variables d'environnement requises :

PATH={chemin de l'installation Java}/jre/bin:$PATH
export PATH
LIBPATH={chemin de l'installation Java}/jre/bin: {chemin de l'installation Java}/jre/bin/
    classic:$LIBPATH
export LIBPATH
Remarque :
Une fois les variables d'environnement définies, vous pouvez utiliser la commande "java -fullversion" pour vérifier la version Java.

Installation d'Agent Controller

  1. Connectez-vous en tant qu'administrateur (ou utilisateur root).
  2. Placez-vous dans le répertoire où vous avez décompressé les fichiers d'installation correspondant à votre plateforme.
  3. Avant de continuer l'installation, fermez toutes les plateformes Eclipse.
  4. Exécutez setup.bin.
  5. Cliquez sur Suivant dans l'écran de bienvenue pour continuer.
  6. Lisez le contrat de licence.
  7. Sélectionnez J'accepte les dispositions du contrat de licence et cliquez sur Suivant.
  8. Spécifiez le chemin où vous souhaitez installer Agent Controller et cliquez sur Suivant pour continuer.
  9. Spécifiez le chemin de l'exécutable (java.exe ou java) de l'environnement d'exécution Java (JRE) à utiliser par Agent Controller. Cet environnement sera utilisé par Agent Controller pour lancer les applications Java. Vous pouvez donc, si vous le souhaitez, changer le chemin prédéfini par le programme d'installation.
    Remarque :
    Le JRE que vous indiquez ici sera utilisé à la fois pour l'exécution d'Agent Controller lui-même et pour l'exécution des applications Java lancées par Agent Controller. Vous pourrez ultérieurement configurer Agent Controller afin qu'il utilise un JRE différent pour chacune de ces fonctions. Pour plus de détails, consultez la section Configuration des applications à lancer par Agent Controller, dans l'aide en ligne d'Agent Controller.

    Cliquez sur Suivant pour continuer.

  10. Facultatif : Spécifiez la version d'IBM WebSphere Application Server si vous avez sélectionné l'option "Support à distance pour WebSphere Application Server" à l'étape 9 ci-dessus. Cliquez sur Suivant pour continuer.
  11. Facultatif : Spécifiez les chemins respectifs d'IBM WebSphere Application Server version 5.0 (Windows uniquement) et version 5.1 si vous avez sélectionné l'option "Support à distance pour WebSphere Application Server" à l'étape 9 ci-dessus. Cliquez sur Suivant pour continuer.
  12. Spécifiez les hôtes pouvant accéder à Agent Controller. Pour Rational Performance Tester, vous devez sélectionner Ordinateurs spécifiques. Cliquez sur Suivant pour continuer.
  13. Acceptez la valeur par défaut (Désactivé) du paramètre de sécurité. Cliquez sur Suivant pour continuer.
  14. Cliquez sur Suivant dans la fenêtre récapitulative pour lancer l'installation d'Agent Controller.
  15. Une fois l'installation terminée, cliquez sur Terminer.

Installation d'Agent Controller en mode silencieux

Vous pouvez exécuter l'installation en mode silencieux en spécifiant les paramètres suivants dans la commande setup :

Paramètre Description

-silent

Cette variable est requise si l'option silent est utilisée :

-V licenseAccepted=true
Facultatif : indique au programme d'installation de s'exécuter en mode silencieux. Sinon, il se lance sous forme d'assistant d'installation prérempli avec les autres valeurs entrées sur la ligne de commande.

-P installLocation
Facultatif :  spécifie le chemin d'installation. Le chemin d'installation par défaut est '$D(install)/IBM/AgentController'.

Exemples :

pour Windows : C:\Program Files\IBM\AgentController

pour UNIX/Linux : /opt/IBM/AgentController

-V VJavaPath
Obligatoire : spécifie le chemin complet de l'exécutable Java 

-V VAccessLocal

-V VAccessCustom

-V VAccessAll

Facultatif : indique comment les clients pourront se connecter à Agent Controller (ALL, LOCAL, CUSTOM). Une seule de ces variables doit être associée à la valeur "true" ; les autres doivent être associées à "false". Par défaut, VAccessAll="true"

  • Tout ordinateur :        VAccessAll="true"           : autorise tous les clients
  • Cet ordinateur uniquement :   VAccessLocal="true"       : autorise seulement localhost (valeur par défaut)
  • Ordinateurs spécifiques :    VAccessCustom="true"    : autorise une liste de clients spécifiques (le paramètre -V VHosts doit alors être spécifié)

-V VHosts
Obligatoire si VAccessCustom="true"

spécifie les noms d'hôte client, séparés par des virgules

Les deux variables suivantes doivent être spécifiées et associées à des valeurs opposées :

-V VSecurity="true" ou "false"
-V VSecurityDisable="false"
 ou "true"
Facultatif : (true, false)

par défaut :

VSecurity=true 
VSecurityDisable=false

-V VUsers
Obligatoire : si VSecurity="true"

indique quels utilisateurs pourront se connecter à Agent Controller

-V VWAS6

-V VWAS5
Facultatif :

-V VWAS6="true" (default) : si WAS V6 est utilisé

-V VWAS5="true" : si WAS V5.x est utilisé

-V VWAS_HOME_V50

-V VWAS_HOME_V51
Facultatif : si -V VWAS5="true"

spécifie l'emplacement d'installation d'IBM WebSphere Application Server 5.1 et 5.0

Exemples :

Installation à partir de la ligne de commande :

-P installLocation="D:\IBM\AgentController"

-V VJavaPath=" D:\jdk1.4.2\jre\bin\java.exe "

-V VAccessLocal="false"

-V VAccessCustom="true"

-V VAccessAll="false"

-V VHosts="host1,host2"

-V VSecurity="true"

-V VSecurityDisable="false"

-V VUsers="user1,user2"

-V VWAS5="true"

-V VWAS_HOME_V51="D:\WebSphere5.1\AppServer"

-V VWAS_HOME_V50="D:\WebSphere5.0\AppServer"

Installation à l'aide d'un fichier de réponses :

Vous pouvez créer un fichier de réponse (par exemple, setup.rsp) pour y stocker tous les paramètres au lieu de les spécifier sur la ligne de commande. Voici un exemple Windows (pour les plateformes Linux/UNIX, le contenu du fichier serait similaire) :

setup.exe -silent -options setup.rsp

Contenu du fichier de réponse :

      # Début du fichier de réponse

-P installLocation="D:\IBM\AgentController"

-V licenseAccepted="true"

-V VJavaPath=" D:\jdk1.4.2\jre\bin\java.exe "

-V VAccessLocal="false"

-V VAccessCustom="true"

-V VAccessAll="false"

-V VHosts="host1,host2"

-V VSecurity="true"

-V VSecurityDisable="false"

-V VUsers="user1,user2"

-V VWAS5="true"

-V VWAS_HOME_V51="D:\WebSphere5.1\AppServer"

-V VWAS_HOME_V50="D:\WebSphere5.0\AppServer"

 
      # Fin du fichier de réponse

Démarrage et arrêt d'Agent Controller

Désinstallation d'Agent Controller

  1. Exécutez le programme uninstall.bin à partir du sous-répertoire _uninst du répertoire d'installation d'Agent Controller (par exemple, /opt/IBM/AgentController/_uninst).
  2. Suivez les instructions qui s'affichent à l'écran.
  3. Pour une désinstallation en mode silencieux, utilisez la commande uninstall.bin -silent.

Désinstallation d'Agent Controller lorsqu'il a plusieurs références sur un même poste de travail

La version 7.0.1 d'Agent Controller empêche l'installation de plusieurs instances du produit sur un même poste de travail. Lorsqu'une nouvelle installation est effectuée (soit sous forme d'installation séparée, soit sous forme d'installation intégrée dans un produit), Agent Controller enregistre une référence au nom du produit qui déclenche la nouvelle installation.

Si Agent Controller a été installé plusieurs fois (autrement dit, s'il est référencé par plusieurs produits), il ne peut être désinstallé qu'une fois que tous les produits qui y font référence ont eux-mêmes été désinstallés. Tant qu'il subsiste un produit, ce dernier a besoin d'Agent Controller.

Si vous tentez de désinstaller Agent Controller alors qu'il est encore nécessaire à un autre produit, la désinstallation n'a pas lieu et vous recevez le message "Ce produit ne peut pas être désinstallé car il est requis par un autre produit."

Installation d'Agent Controller sur z/OS (OS/390)

Désinstallation des versions précédentes d'Agent Controller

Si vous avez une version précédente d'Agent Controller, arrêtez-la et désinstallez-la avant d'installer la présente version.

Configuration de l'environnement du système d'exploitation

  1. Créez le répertoire d'installation de RAC. Par exemple : mkdir /u/rpt/IBM/RAC.
  2. Définissez ASSIZEMAX=2147483647. Vous aurez peut-être besoin de l'aide du programmeur système.
  3. Ajoutez les commandes d'exportation suivantes au fichier .profile de l'ID utilisateur qui démarrera RAC :
    export RASERVER_HOME={emplacement
    de l'installation}
    export LIBPATH=$LIBPATH:{emplacement de l'installation}/lib:{chemin de l'installation Java}/bin:
        {chemin de l'installation Java}/bin/classic
    export PATH=$PATH:{emplacement de l'installation}/bin:{chemin de l'installation Java}/bin
    export _BPX_SHAREAS="NO"
Remarque :
Une fois les variables d'environnement définies, vous pouvez utiliser la commande "java -fullversion" pour vérifier la version Java.

Installation d'Agent Controller

  1. Dans un shell de services système UNIX accédez au répertoire dans lequel vous souhaitez installer Agent Controller. Il est recommandé d'installer ce dernier dans le répertoire /usr/lpp/.
  2. Transférez les images d'installation ibmrac.os390.pax et tptpdc.os390.pax dans le répertoire d'installation.
  3. Pour extraire les fichiers d'Agent Controller, lancez la commande suivante :

    pax -ppx -rvf ibmrac.os390.pax
  4. Entrez la commande suivante pour extraire les fichiers des outils de test et de performances (TPTP) :

    pax -ppx -rvf tptpdc.os390.pax
  5. Placez sous contrôle les fichiers .so (objets partagés) d'Agent Controller en lançant les commandes suivantes dans un shell de services système UNIX :

    extattr +p /usr/lpp/IBM/AgentController/lib/*.so

    Si vous souhaitez installer les modules de langues nationales (NL), effectuez les étapes 7 et 8 ci-après. Sinon, passez à l'étape 9.

  6. Transférez les images d'installation NL tptpdc.nl1.os390.pax, tptpdc.nl2.os390.pax, ibmrac.os390.nl1.pax et ibmrac.os390.nl2.pax dans le répertoire d'installation.
  7. Pour extraire les fichiers d'Agent Controller, lancez la commande suivante :

    	pax -ppx -rf tptpdc.nl1.os390.pax
    	pax -ppx -rf tptpdc.nl2.os390.pax
    	pax -ppx -rf ibmrac.os390.nl1.pax
    	pax -ppx -rf ibmrac.os390.nl2.pax
  8. Après avoir installé Agent Controller, passez dans le sous-répertoire bin du répertoire d'installation (/usr/lpp/IBM/AgentController/bin) et exécutez le script de configuration en entrant :

    ./SetConfig.sh
  9. Pour configurer Agent Controller, suivez l'invite qui s'affiche à l'écran.

Démarrage et arrêt d'Agent Controller sur z/OS (OS/390)

Remarque : Pour le processus RAServer, les répertoires de JRE qui contiennent les bibliothèques d'exécutables, telles que libjvm.so, doivent être ajoutés à la variable d'environnement LIBPATH. Par exemple, si vous utilisez IBM JRE 1.4.1, la variable LIBPATH doit être définie comme suit :

export LIBPATH=/usr/lpp/java/IBM/J1.4/bin/classic:
/usr/lpp/java/IBM/J1.4/bin:$LIBPATH

Désinstallation d'Agent Controller sur z/OS (OS/390)

Utilisation de la fonction de sécurité d'Agent Controller

Vous trouverez ci-après des conseils relatifs à l'utilisation de la fonction de sécurité d'Agent Controller sur toutes les plateformes :

Récapitulatif de la compatibilité contrôleur d'agent/plan de travail

Compatibilité amont (utilisation d'un plan de travail plus ancien avec Agent Controller version 6.0.1) : Oui, ils sont compatibles car la nouvelle version d'Agent Controller reprend toutes les fonctions des précédentes versions (par exemple, la sécurité sur le canal de contrôle). Cependant, vous ne pourrez pas utiliser les nouvelles fonctions, notamment le multiplexage (retour des données collectées par l'agent via le canal de contrôle afin qu'elles puissent être sécurisées).

Compatibilité aval (utilisation d'un plan de travail version 6.0.1 avec une version plus ancienne d'Agent Controller) : Non, en général, ce cas de figure n'est pas pris en charge.

Compatibilité entre instances d'Agent Controller de versions différentes : Certains produits ou outils (tels qu'IBM Performance Optimization Toolkit) nécessitent que les instances d'Agent Controller installées sur différents hôtes (excepté celui qui héberge le plan de travail) se "reconnaissent" et communiquent entre elles. Cette fonction de reconnaissance ayant été modifiée entre les versions d'Agent Controller, cela signifie que si vous êtes dans une situation où elle est nécessaire, vous devez utiliser des agents de la même version (soit 6.0.0.1, soit 6.0.1) sur tous les hôtes concernés. Vous ne pouvez pas mélanger les versions en cas d'utilisation de la reconnaissance dynamique entre les instances d'Agent Controller.

Problèmes et limitations connus

La présente section traite des problèmes et limitations connus, liés à l'installation et à la désinstallation d'Agent Controller. Sauf indication contraire, les informations suivantes sont valables pour tous les systèmes d'exploitation pris en charge par Agent Controller.

Le démarrage d'Agent Controller peut échouer sur les plateformes autres que Windows

Agent Controller peut ne pas démarrer sur des plateformes autres que Windows en générant le message suivant :

Le démarrage de RAServer a échoué.

Cet incident se produit généralement lorsque le port TCP/IP 10002 n'est pas disponible. Par défaut, c'est sur ce port qu'Agent Controller est à l'écoute. Il se peut que ce port soit utilisé par un autre processus en cours d'exécution sur le système lors du démarrage du composant Agent Controller, ou que ce dernier vienne juste d'être arrêté puis redémarré avant que le port n'ait pu être libéré.

Si Agent Controller n'a pas démarré, suivez la procédure ci-dessous :

Autres erreurs susceptibles de se produire au cours de l'installation ou de la désinstallation

Si des erreurs se produisent lors de l'installation ou de la désinstallation, cela peut être dû au fait que les fichiers objet d'Agent Controller sont chargés par des processus en cours d'exécution. Pour vérifier que les fichiers objet peuvent être modifiés, procédez comme suit :

  1. Arrêtez votre plan de travail Eclipse.
  2. Terminez tous les processus java.exe qui contiennent soit Java Profiling Agent, soit J2EE Request Profiler.

Installer ClearCase LT

Rational ClearCase LT est un outil de gestion de configuration destiné aux petites équipes projet. ClearCase LT fait partie de la gamme de produits IBM Rational ClearCase qui s'adresse aussi bien à de petits groupes de travail qu'à une entreprise dont les sites sont disséminés dans le monde entier.

Votre support d'installation inclut Rational ClearCase LT Version 7.0.1. Il est installé séparément de Rational Performance Tester.

Si ClearCase est déjà installé sur votre ordinateur, il est possible que vous puissiez le mettre au niveau de la version actuelle. Pour toute information sur la mise à niveau de versions précédentes, reportez-vous à la documentation d'installation de ClearCase LT.

Pour permettre à Rational Performance Tester de fonctionner avec ClearCase LT, vous devez installer la fonction Rational ClearCase SCM Adapter. Par défaut, cette fonction est sélectionnée lorsque vous installez Rational Performance Tester. Si toutefois vous ne l'avez pas inclus dans votre installation, vous pouvez l'installer plus tard en utilisant l'assistant Modifier des packages de l'outil IBM Installation Manager. Pour plus de détails, voir Modifier des installations.

Vous devez activer la fonction Rational ClearCase SCM Adapter avant de pouvoir l'utiliser. Consultez l'aide en ligne pour les détails relatifs à l'activation et à l'utilisation de cet adaptateur.

Emplacement des instructions d'installation et des notes sur l'édition de ClearCase LT

Pour les instructions complètes d'installation de Rational ClearCase LT, reportez-vous à la documentation d'installation fournie sur le support d'installation de ClearCase LT. Nous vous conseillons vivement de lire également les notes sur l'édition de ClearCase LT avant d'installer le produit.

Certaines documentations sont fournies sous forme de fichiers Acrobat PDF. Pour ouvrir ces fichiers, vous devez disposer du logiciel Adobe Reader, que vous pouvez télécharger à partir du site http://www.adobe.com/products/acrobat/readstep2.html.

Pour Windows. Les instructions d'installation et les notes sur l'édition (Release Notes) peuvent être consultées à partir du tableau de bord d'installation de ClearCase LT. Voir Démarrer une installation de Rational ClearCase LT.

Pour ouvrir les instructions d'installation :

Se procurer la documentation sur le site IBM Publications Center

Vous pouvez également télécharger les instructions d'installation et les notes sur l'édition (Release Notes) de Rational ClearCase LT à partir du site IBM Publications Center.

  1. Rendez-vous sur le site http://www.ibm.com/shop/publications/order.
  2. Sélectionnez votre pays/région sur la page d'accueil du centre de publications.
  3. Cliquez sur Search for Publications.
  4. Entrez le titre du document ou le numéro de publication dans la zone appropriée.
    Tableau 2. Numéros de publication ClearCase
    Document Numéro de publication
    IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT Installation and Upgrade Guide (Windows) GI11-6365-00
    IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT Installation and Upgrade Guide (UNIX) GI11-6366-00
    IBM Rational ClearCase LT Release Notes GI11-6369-01

Démarrer une installation de Rational ClearCase LT

Les instructions présentées dans cette section ont pour but de vous aider à démarrer le processus d'installation de Rational ClearCase LT. Lors de l'installation, reportez-vous aux instructions complètes fournies dans le manuel Rational ClearCase LT Installation Guide. Nous vous conseillons vivement de lire les notes sur l'édition (Release Notes) avant d'installer ce produit.

Démarrer une installation de Rational ClearCase LT sous Windows

  1. Lancez le programme du tableau de bord d'installation de Rational ClearCase LT en appliquant l'une des méthodes suivantes :
  2. Lisez les notes sur l'édition (Release Notes) si ce n'est déjà fait.
  3. Cliquez sur Installer IBM Rational ClearCase LT. L'assistant d'installation de Rational ClearCase LT s'ouvre.

Suivez les instructions de l'assistant pour effectuer l'installation.

Installer Rational ClearCase LT sous Linux

Vous trouverez les informations complètes d'installation de Rational ClearCase LT version 7.0 sur un poste de travail Linux dans le manuel IBM Rational ClearCase, ClearCase MultiSite, and ClearCase LT Installation Guide, 7.0, Linux and UNIX, que vous pouvez télécharger à partir de 600.

Configurer la gestion des licences de Rational ClearCase LT

Si Rational Performance Tester est installé sur le même ordinateur que Rational ClearCase LT, vous n'avez pas besoin de configurer la gestion des licences de ce dernier. En revanche, si vous installez Rational ClearCase LT sans Rational Performance Tester, vous devez configurer la gestion des licences de ClearCase LT.

Consultez le guide d'installation de ClearCase LT pour plus d'informations sur la configuration de la gestion des licences.