IBM Rational Application Developer pour Windows et Linux, Version 6.0 Guide d'installation


Table des matières

Chapitre 1. Introduction

Chapitre 2. Conditions d'installation requises pour Rational Application Developer

  • Eléments matériels requis
  • Conditions logicielles requises
  • Systèmes d'exploitation
  • Autres configurations logicielles requises
  • Chapitre 3. IBM Rational Software Development Platform

    Chapitre 4. Installation et désinstallation de Rational Application Developer pour Windows

  • Considérations liées à la migration, la mise à niveau et la coexistence
  • Installation à partir du CD-ROM
  • Installation à partir des images électroniques
  • Création d'une image d'installation réseau
  • Exécution d'une installation en mode silencieux
  • Installation des images locales
  • Installation en mode silencieux des fonctions par défaut dans le répertoire par défaut
  • Installation en mode silencieux dans un autre répertoire
  • Installation en mode silencieux d'autres fonctions Rational Application Developer
  • Démarrage de Rational Application Developer
  • Désinstallation de Rational Application Developer
  • Désinstallation de Rational Application Developer en mode silencieux
  • Incidents et restrictions connus
  • Reprise en cas d'échec de l'installation
  • Echec de l'installation de l'environnement de test WebSphere Application Server V6.0
  • Echec de la désinstallation de WebSphere Application Server V6.0 sous Windows Server 2003
  • L'annulation de l'installation d'un produit puis la tentative de nouvelle installation du produit peuvent ne pas aboutir à une installation correcte du produit.
  • Chapitre 5. Installation et désinstallation de Rational Application Developer pour Linux

  • Considérations liées à la migration, la mise à niveau et la coexistence
  • Installation à partir du CD-ROM
  • Installation à partir des images électroniques
  • Création d'une image d'installation réseau
  • Exécution d'une installation en mode silencieux
  • Installation des images locales
  • Installation en mode silencieux des fonctions par défaut dans le répertoire par défaut
  • Installation en mode silencieux dans un autre répertoire
  • Installation en mode silencieux d'autres fonctions Rational Application Developer
  • Augmentation du nombre de descripteurs de fichier disponibles
  • Démarrage de Rational Application Developer
  • Désinstallation de Rational Application Developer
  • Désinstallation de Rational Application Developer en mode silencieux
  • Incidents et restrictions connus
  • Restrictions liées à l'espace disque
  • Echec de l'installation de l'environnement de test WebSphere Application Server V6.0
  • L'annulation de l'installation d'un produit puis la tentative de nouvelle installation du produit peuvent ne pas aboutir à une installation correcte du produit.
  • Chapitre 6. Installation d'Agent Controller

  • Conditions matérielles requises
  • Plateformes prises en charge
  • Machines JVM prises en charge
  • Emplacement des fichiers d'installation
  • Installation d'Agent Controller sur un poste de travail (AIX, HP-UX, Linux, Windows, Solaris)
  • Désinstallation des versions précédentes d'Agent Controller
  • Installation d'Agent Controller
  • Installation d'Agent Controller en mode silencieux
  • Démarrage et arrêt d'Agent Controller sur un poste de travail Windows
  • Démarrage et arrêt d'Agent Controller sur un poste de travail non Windows
  • Désinstallation d'Agent Controller sur un poste de travail Windows
  • Désinstallation d'Agent Controller sur un poste de travail non Windows
  • Installation d'Agent Controller sous OS/400 (iSeries)
  • Désinstallation des versions précédentes d'Agent Controller
  • Installation d'Agent Controller
  • Démarrage et arrêt d'Agent Controller sous OS/400 (iSeries)
  • Désinstallation d'Agent Controller sous OS/400 (iSeries)
  • Installation d'Agent Controller sous OS/390 (z/OS)
  • Désinstallation des versions précédentes d'Agent Controller
  • Installation d'Agent Controller
  • Démarrage et arrêt d'Agent Controller sous OS/390 (z/OS)
  • Désinstallation d'Agent Controller sous OS/390 (z/OS)
  • Utilisation de la fonction de sécurité d'Agent Controller
  • Incidents et restrictions connus
  • Le démarrage d'Agent Controller peut échouer sur des plateformes non Windows
  • Autres erreurs susceptibles de se produire au cours de l'installation ou de la désinstallation
  • Chapitre 7. Configuration de Rational Application Developer pour une utilisation en environnement coopératif

  • Logiciels pris en charge
  • IBM Rational ClearCase
  • IBM Rational ClearQuest
  • Installation de Rational ClearCase LT
  • Téléchargement de Rational ClearCase LT
  • Emplacement des notes sur l'édition et des instructions d'installation
  • Installation de Rational ClearCase LT
  • Configuration de la licence de Rational ClearCase LT
  • Utilisation de Rational ClearCase avec Rational Application Developer
  • Correction des types d'élément de diagramme pré-existants
  • Désinstallation de Rational ClearCase LT
  • Chapitre 8. Installation de WebSphere Application Server 5.x en tant qu'environnement de test intégré

    Chapitre 9. Installation du support de messagerie et de mise en file d'attente pour les environnements de testWebSphere version 5.x

  • Installation et désinstallation du support de messagerie et de mise en file d'attente sous Windows
  • Installation à partir d'un CD-ROM
  • Désinstallation du support de messagerie et de mise en file d'attente
  • Installation et désinstallation du support de messagerie et de mise en file d'attente sous Linux
  • Installation du support de messagerie et de mise en file d'attente
  • Désinstallation du support de messagerie et de mise en file d'attente
  • Chapitre 10. Installation de l'environnement de test WebSphere Portal version 5.0

    Chapitre 11. Installation de l'environnement de test WebSphere Portal version 5.1

    Chapitre 12. Installation de Crystal Enterprise

    Chapitre 13. Installation des mises à jour

    Chapitre 14. Notice de copyright


    Chapitre 1. Introduction

    Le présent guide d'installation fournit les instructions nécessaires pour installer et désinstaller Rational Application Developer, les fonctionnalités optionnelles et les produits supplémentaires fournis avec Rational Application Developer.

    Pour obtenir des informations sur la migration de WebSphere Studio, voir le Guide de migration.

    Pour obtenir des informations sur les incidents et restrictions, reportez-vous au fichier readme.

    Pour obtenir une documentation et des informations d'identification et de résolution des incidents à jour, consultez le site http://www.ibm.com/developerworks/rational.


    Chapitre 2. Conditions d'installation requises pour Rational Application Developer


    Eléments matériels requis

    Les éléments matériels suivants doivent être installés avant d'installer Rational Application Developer:


    Conditions logicielles requises

    Systèmes d'exploitation

    Les éléments logiciels ci-dessous doivent être installés avant d'installer Rational Application Developer.

    Autres configurations logicielles requises


    Chapitre 3. IBM Rational Software Development Platform

    IBM Rational Software Development Platform est un environnement de développement commun partagé par les produits suivants :

    Si vous installez l'un de ces produits, Rational Software Development Platform est installé automatiquement en tant que composant du produit. Si vous en installez d'autres, la plateforme de développement n'est installée qu'une fois. Tous ces produits possèdent la même interface utilisateur, appelée plan de travail. Ce dernier s'enrichit des fonctionnalités offertes par ces produits sous la forme de plug-ins. Un plug-in est un module logiciel qui ajoute des fonctionnalités à une application ou à un programme existant.

    Lancement des produits Rational installés conjointement sous Windows

    Lorsque vous ouvrez le menu Démarrer, IBM Rational est toujours le menu de niveau supérieur, quel que soit le produit que vous avez installé.

    Selon le nombre de produits installés, un ou plusieurs sous-dossiers (un par produit) seront disponibles à partir du menu de niveau supérieur. Si Rational Functional Tester et Rational Application Developer sont installés conjointement, un sous-dossier sera créé pour chacun d'eux. Ces sous-dossiers contiendront des liens permettant d'accéder à des informations spécifiques sur les produits (telles que des fichiers readme), ainsi qu'un point de lancement pour l'interface utilisateur. Ce point de lancement portera le nom du produit(Rational Application Developer, par exemple) mais il permettra en réalité de lancer l'interface utilisateur commune.

    Vous pouvez également lancer l'interface utilisateur commune en cliquant sur l'option Rational Software Development Platform, sous le menu IBM Rational.

    Lancement des logiciels Rational installés conjointement sous Linux

    Lorsque vous utilisez Red Hat Enterprise Linux, les points de lancement du produit se trouvent dans le menu principal, sous Programming. Le point de lancement portant le nom du produit (tel que Rational Application Developer) et le point de lancement Rational Software Development Platform lancent l'interface utilisateur commune. Pour localiser des informations propres au produit (les fichiers readme, par exemple), accédez au répertoire du produit (racine_rad pour Rational Application Developer) dans le répertoire dans lequel vous avez installé Rational Software Development Platform.

    Lorsque vous utilisez SuSE Linux Enterprise Server (SLES), les points de lancement du produit se trouvent dans le menu principal sous IBM Rational. Le point de lancement portant le nom du produit (tel que Rational Application Developer) et le point de lancement Rational Software Development Platform lancent l'interface utilisateur commune. Pour localiser des informations spécifiques au produit (les fichiers readme, par exemple), accédez au répertoire du produit (répertoire rad_prod pour Rational Application Developer) dans le répertoire dans lequel vous avez installé Rational Software Development Platform.

    Migration et coexistence

    Le tableau suivant indique ce qui se passe lorsque vous tentez d'installer plusieurs produits, communs à Rational Software Development Platform, sur la même machine. (Dans ce tableau, l'axe vertical représente les produits déjà installés et l'axe horizontal représente les produits que vous tentez d'installer) :

    Tentative d'installation Rational Software Modeler Rational Web Developer Rational Application Developer Rational Software Architect Rational Functional Tester Rational Performance Tester
    Rational Software Modeler N/A Partage Partage Mise à niveau Partage Partage
    Rational Web Developer Partage N/A Mise à niveau Mise à niveau Partage Partage
    Rational Application Developer Partage Blocage N/A Mise à niveau Partage Partage
    Rational Software Architect Blocage Blocage Blocage N/A Partage Partage
    Rational Functional Tester Partage Partage Partage Partage N/A Partage
    Rational Performance Tester Partage Partage Partage Partage Partage N/A

    Définitions :

    Désinstallation

    Remarque :
    L'interface utilisateur est installée dans le répertoire d'installation du premier produit installé reposant sur Rational Software Development Platform. Elle n'est pas réinstallée lors de l'installation d'autres produits. Ainsi, si vous mettez à niveau votre premier produit, ne supprimez pas le premier répertoire d'installation une fois la mise à niveau terminée. Ce répertoire contient en effet l'interface utilisateur.

    Chapitre 4. Installation et désinstallation de Rational Application Developer pour Windows

    La présente section comporte des informations relatives à l'installation de Rational Application Developer sous Windows. Vous pouvez installer Rational Application Developer à partir du CD-ROM ou des images électroniques que vous téléchargez. Un assistant d'installation est fourni mais vous pouvez également installer Rational Application Developer à partir d'une invite de commande ou en mode silencieux, comme indiqué plus loin dans la documentation.

    Le programme d'installation peut également être exécuté en mode console interactif, ce qui est particulièrement indiqué pour les personnes souhaitant bénéficier des fonctions d'accessibilité. L'option de ligne de commande du mode d'accessibilité :

    -accessibility

    rend l'assistant du mode console d'exécution plus convivial pour les programmes de lecture d'écran. Pour utiliser le mode console, exécutez cette commande à partir du répertoire \setup du premier CD-ROM d'installation de Rational Application Developer :

    setup.exe -is:javaconsole -log @NONE -accessibility
    

    Suivez les instructions pour effectuer l'installation. L'option -is:javaconsole est essentielle lorsque vous spécifiez l'option -accessibility. Si vous ne la spécifiez pas, le programme d'installation se bloque. L'option -log @NONE désactive la journalisation afin d'éliminer les informations de journal répertoriées dans la fenêtre d'invite de commande. En cas d'incident pendant l'installation, vous devrez peut-être supprimer cette option afin de collecter des renseignements de journal.


    Considérations liées à la migration, la mise à niveau et la coexistence

    Vous ne pouvez pas migrer de WebSphere Studio Site Developer ou WebSphere Studio Application Developer, v4.x.x. ou 5.0.x vers Rational Application Developer. Rational Application Developer peut cependant coexister avec l'un ou l'autre des ces produits. Vous pouvez, le cas échéant, migrer manuellement les espaces de travail, les artefacts et les projets à partir de Rational ClearCase, ClearCase LT et CVS vers Rational Application Developer.

    Vous pouvez migrer WebSphere Studio 5.1.x vers Rational Application Developer ou faire coexister ces deux produits. Pour plus d'informations sur la migration, voir le Guide de migration de Rational Application Developer.

    Pour plus d'informations sur IBM Rational Software Development Platform et sur la coexistence avec les autres produits fondés sur cette plateforme de développement, voir Chapitre 3, "IBM Rational Software Development Platform".

    Si une version antérieure d'Agent Controller ou de tout logiciel dérivé de la fonction Hyades Data Collection Engine est installée, vous devez l'arrêter, la désinstaller et nettoyer tous les fichiers qui n'ont pas été supprimés avant d'installer la présente version d'Agent Controller. Pour plus d'informations, voir Chapitre 6, "Installation d'Agent Controller"


    Installation à partir du CD-ROM

    Avant d'installer le produit, vérifiez les points suivants :

    Pour installer Rational Application Developer à partir du premier CD-ROM d'installation du produit, procédez comme suit :

    1. Consultez "Considérations liées à la migration, la mise à niveau et la coexistence" avant de procéder à l'installation.
    2. Vérifiez que l'ID utilisateur utilisé ne contient pas de caractères double octet.
    3. Insérez le CD-ROM dans l'unité.
    4. Si l'exécution automatique est activée sur le système, le programme de lancement de l'installation s'affiche automatiquement. Si l'exécution automatique est désactivée sur votre système, exécutez launchpad.exe à partir du premier CD-ROM d'installation afin d'afficher la fenêtre de lancement de l'installation de Rational Application Developer.

      Conseils :

    5. A partir du programme de lancement de l'installation de Rational Application Developer, sélectionnez Installation d'IBM Rational Application Developer V6.0.
    6. Lorsque l'assistant d'installation s'affiche, cliquez sur Suivant pour continuer l'installation.
    7. Suivez les instructions qui s'affichent à l'écran pour exécuter certaines tâches, telles que la lecture de l'accord de licence et la spécification du répertoire d'installation cible.
    8. Dans la fenêtre Fonctions, vous pouvez sélectionner les fonctions Rational Application Developer que vous souhaitez installer. Vous pourrez ultérieurement revenir à l'assistant d'installation afin installer les fonctions facultatives.
      1. Par défaut, le programme d'installation installe l'environnement IDE (Integrated Development Environment) et, en option, WebSphere Application Server version 6.0 en tant qu'environnement d'exécution de test.
      2. Pour installer l'interface utilisateur et la documentation dans les langues supportées autres que l'anglais, choisissez d'installer le Module de langues. Par défaut, cette fonction n'est pas activée lorsque l'environnement local sélectionné est l'anglais. Elle est activée lorsque l'environnement local est l'une des langues nationales prises en charge.

        Les langues nationales prises en charge sont le portugais, le français, l'allemand, l'italien, le japonais, le coréen, le chinois simplifié, le chinois traditionnel et l'espagnol.

        Remarque : Si vous avez choisi d'installer le Module de langues (facultatif) et annulez ensuite l'installation peu après le début de la copie des fichiers, les installations suivantes comporteront des anomalies. Lors d'une installation suivante, le Module de langues aura le statut (installé) dans le panneau Fonction même si ses fichiers ne sont pas installés. Vous pouvez choisir de réinstaller la fonction Module de langue et les fichiers corrects seront copiés sur votre disque. Dans ce cas, à la fin de l'installation, un message indiquant qu'une ou plusieurs erreurs se sont produites lors du remplacement de fichiers s'affiche. Vous pouvez ignorer ce message d'erreur en toute sécurité.

      3. Par défaut, la fonction EGL (Enterprise Generation Language) n'est pas installée. EGL est un langage évolué et puissant qui permet de créer des applications métier complexes. Il gère la complexité des technologies sous-jacentes (telles l'accès aux bases de données, les files d'attente de messages et J2EE) afin que les développeurs d'applications puissent se concentrer sur la logique métier. Pour installer le plug-in EGL, sélectionnez la case à cocher Langage EGL (Enterprise Generation Language).
      4. Par défaut, la fonction Portal Tools n'est pas installée. Pour l'installer, cochez la case Portal Tools.
      5. Par défaut, les exemples disponibles pour le développement de plug-in Eclipse ne sont pas installés. Ces exemples s'adressent aux développeurs qui souhaitent étendre le plan de travail en créant leurs propres outils de plug-in. Pour installer les exemples pour le développement de plug-in Eclipse, cochez la case Exemples pour le développement de plug-in Eclipse.
    9. Cliquez sur Suivant pour afficher des informations récapitulatives sur l'installation de Rational Application Developer.

      Remarque :
      L'espace disque requis affiché correspond au nombre total d'octets nécessaire pour l'ensemble des fichiers. L'espace disque réellement requis peut être considérablement plus important. En particulier, si votre disque est formaté en tant que FAT32, le grand nombre de petits fichiers peut utiliser l'espace disque de manière inefficace en raison de la structure de blocage de fichiers utilisée par FAT32.
    10. Cliquez sur Suivant pour installer Rational Application Developer.
    11. Si vous recevez un avertissement signalant un incident d'enregistrement de la licence lors de la phase finale de l'installation, procédez comme suit :
      1. Accédez au sous-répertoire \logs du répertoire d'installation.
      2. Ouvrez license.log avec un éditeur de texte.
      3. Si license.log contient l'une des lignes suivantes :
        486604803  The requested license has expired
        486604805 The start dates for all licenses have not yet occurred
        
        vérifiez que votre horloge système est correctement paramétrée, puis lancez Rational Application Developer.
    12. Le programme d'installation prend un certain temps pour installer l'environnement de développement et initialiser Eclipse. Un message s'affiche pour confirmer que l'installation est terminée. Cliquez sur Suivant pour terminer l'installation.
    13. Une fenêtre permettant de lancer l'installation d'Agent Controller s'affiche alors. Vous devez installer ce produit pour pouvoir utiliser les fonctions de profilage, d'analyse d'exécution et de journalisation de Rational Application Developer. Pour plus de détails, voir Chapitre 6, "Installation d'Agent Controller". Désélectionnez cette option si vous ne souhaitez pas installer Agent Controller dès maintenant.

      Cette fenêtre contient également un message vous conseillant de vérifier si des mises à jour sont disponibles pour les fonctions installées à l'aide du programme de mise à jour des produits Rational. (Pour plus d'informations, voir Chapitre 13, "Installation des mises à jour".) Cliquez sur Terminer pour fermer la fenêtre d'installation.

    14. Si vous envisagez de développer des applications qui seront exécutées sur d'autres serveurs d'applications, vous pouvez également choisir d'installer des environnements de test d'exécution supplémentaires avec Rational Application Developer. Pour plus d'informations, voir Chapitre 8, "Installation de WebSphere Application Server 5.x en tant qu'environnement de test intégré"
    15. Avant d'utiliser les fonctions de profilage, d'analyse d'exécution et de journalisation de Rational Application Developer pour collecter les données à distance, vous devez installer Agent Controller à la fois sur l'h"te local et sur l'h"te distant. Pour plus de détails, voir Chapitre 6, "Installation d'Agent Controller".
    16. Si vous souhaitez tester les applications de messagerie et de services Web en utilisant WebSphere Application Server Version 6.0, le fournisseur de messagerie par défaut est pris en charge automatiquement et il n'est pas nécessaire d'installer le support client et serveur de messagerie intégrée. Toutefois, si vous souhaitez utiliser l'environnement de test WebSphere version 5.x, vous devez installer séparément la fonction client et serveur de messagerie intégrée. Pour plus d'informations, voir Chapitre 9, "Installation du support de messagerie et de mise en file d'attente pour les environnements de testWebSphere version 5.x".

      Important : Si MQSeries est déjà installé, n'installez pas le client et le serveur de messagerie intégrée car il s'agit d'un sous-ensemble des fonctions MQSeries.

    17. Si vous envisagez d'utiliser Rational ClearCase comme système de gestion de la configuration logicielle (SCM), vous pouvez installer la fonction Rational ClearCase LT dès maintenant ou ultérieurement. Pour plus d'informations sur Rational ClearCase, voir Chapitre 7, "Configuration de Rational Application Developer pour une utilisation en environnement coopératif".
    18. Si vous prévoyez d'installer l'environnement de test Portal V5.0, procédez à l'opération après avoir installé Rational Application Developer. Pour plus d'informations, voir Chapitre 10, "Installation de l'environnement de test WebSphere Portal version 5.0".
    19. Crystal Enterprise est une infrastructure d'accès aux données et de création de rapports conçue pour s'intégrer à vos données, solutions Web et applications existantes. Elle est fondée sur Crystal Reports. Rational Application Developer inclut à la fois Crystal Enterprise Embedded Edition et Crystal Enterprise Professional Edition, qui constitue une extension d'Embedded Edition. Pour plus d'informations sur la procédure à suivre pour les installer, voir Chapitre 12, "Installation de Crystal Enterprise".

    Remarque :

    Installation à partir des images électroniques

    Reportez-vous au fichier readme du produit pour obtenir une description des images électroniques à télécharger.

    Avant d'installer le produit, vérifiez les points suivants :

    Pour télécharger et créer l'image d'installation électronique, suivez la procédure décrite ci-après.

    1. Téléchargez tous les éléments requis ainsi que les éléments facultatifs choisis dans le même répertoire temporaire. Si vous avez besoin ultérieurement d'autres éléments facultatifs, téléchargez-les et exécutez à nouveau l'outil d'extraction avant d'effectuer l'installation.
      Remarque :
      Lorsque vous mettez à niveau un produit Rational Software Development Platform vers un autre produit à l'aide des images électroniques, veillez à télécharger et à extraire le même ensemble d'images que celui que vous avez téléchargé et extrait pour le produit d'origine. Les mêmes composants que ceux installés dans le produit d'origine seront installés automatiquement dans le produit mis à niveau.

      Par exemple, si le Module de langues a été installé initialement, ce produit devra être téléchargé et extrait dans l'image d'installation du nouveau produit au cours de la mise à niveau.

    2. Lancez le fichier extractor.exe situé dans votre répertoire temporaire. Cette opération lance l'assistant qui crée l'image d'installation.
    3. Suivez les instructions de l'assistant pour indiquer l'emplacement de création de l'image ainsi que les fonctions à inclure.
    4. Une fois l'image créée, si vous souhaitez installer le produit immédiatement, cliquez sur Terminer. Vous pouvez également désélectionner la case à cocher permettant de lancer l'assistant d'installation et exécuter le programme d'installation ultérieurement en lançant disk1/launchpad.exe à partir du répertoire dans lequel vous avez créé l'image d'installation.
    5. Suivez les instructions décrites dans "Installation à partir du CD-ROM".

    Création d'une image d'installation réseau

    Vous pouvez placer une copie de l'image d'installation sur une unité réseau afin que les utilisateurs puissent effectuer l'installation à partir d'un réseau.

    Pour exécuter le programme d'installation à partir d'une unité réseau, vous devez soit utiliser une image électronique téléchargée de Rational Application Developer, soit copier le contenu des CD-ROM, comme il est décrit ci-dessus.

    Vous devez disposer d'environ 6 Go d'espace disque pour stocker le contenu du CD-ROM sur disque. Pour copier les fichiers à partir des CD-ROM :

    1. Insérez le premierRational Application Developer CD-ROM d'installation dans l'unité.
    2. Créez un répertoire temporaire sur une unité réseau sur laquelle vous souhaitez stocker l'image (par exemple, unité_réseau:\install_image).
    3. Sous ce répertoire, créez un sous-répertoire disk1. Ce sous-répertoire doit être appelé disk1 et être spécifié en minuscules.
    4. Copiez tous les fichiers et les répertoires du premier CD-ROM d'installation dans le sous-répertoire disk1 du répertoire temporaire.
    5. Répétez les étapes 3 et 4 pour copier le contenu des deux autres CD-ROM vers les sous-répertoires disk2 et disk3.

    Il s'agit des fichiers d'installation principaux. Pour obtenir les fichiers d'installation pour l'une des fonctions facultatives :

    1. Agent Controller
    2. Client et serveur de messagerie intégrée
    3. Rational ClearCase LT
    4. Environnements de test WebSphere V5.x
    5. Environnements de test WebSphere Portal V5.0
    6. Crystal Enterprise V10 Professional Edition
    7. Crystal Enterprise V10 Embedded Edition

    copiez le contenu des CD-ROM appropriés dans votre répertoire temporaire.

    Remarques :


    Exécution d'une installation en mode silencieux

    Le programme d'installation de Rational Application Developer peut être exécuté en mode silencieux si vous ne voulez pas utiliser l'assistant d'installation.

    Installation des images locales

    Avant d'installer Rational Application Developer en mode silencieux, vous devez installer vos images locales :

    1. Consultez "Considérations liées à la migration, la mise à niveau et la coexistence" avant de procéder à l'installation.
    2. Vérifiez que l'ID utilisateur utilisé ne contient pas de caractères double octet.
    3. Créez une image d'installation locale ou réseau comme indiqué dans "Création d'une image d'installation réseau". Si vous souhaitez installer Rational Application Developer uniquement, il suffit de copier les informations contenues sur les trois premiers CD-ROM.

    Installation en mode silencieux des fonctions par défaut dans le répertoire par défaut

    Les fonctions suivantes sont installées par défaut lors de l'installation silencieuse de Rational Application Developer :

    Pour installer Rational Application Developer en mode silencieux en utilisant uniquement les fonctions sélectionnées par défaut dans le répertoire par défaut unité_système:\Program Files\IBM\Rational\SDP\6.0 :

    1. Copiez vos images en suivant les instructions fournies dans "Installation des images locales", si vous n'avez pas déjà effectué cette opération.
    2. A partir de la ligne de commande, accédez au répertoire \disk1\setup dans le répertoire temporaire (par exemple, unité_réseau:\install_image\disk1\setup) que vous avez créé dans une précédente section.
    3. Exécutez la commande suivante :
      setup.exe -silent 
      
    4. L'installation en mode silencieux de Rational Application Developer peut prendre un certain temps. Pour savoir si l'installation est terminée, vous pouvez contr"ler régulièrement le répertoire /logs du répertoire d'installation par défaut. Si le fichier license.log s'affiche, l'installation en mode silencieux a abouti.

    Installation en mode silencieux dans un autre répertoire

    Si vous modifiez le paramètre installLocation, vous pouvez installer Rational Application Developer dans un autre répertoire. Par exemple, si vous souhaitez que "/my softdev" soit dans votre répertoire d'installation, suivez la même procédure que celle décrite plus haut mais en lançant cette fois la commande suivante :

    setup.exe -silent -P installLocation="d:\my softdev"
    

    (Dans cet exemple, seules les fonctions par défaut sont installées.)

    Installation en mode silencieux d'autres fonctions Rational Application Developer

    Rational Application Developer fournit un exemple de fichier de réponses qui installe en mode silencieux toutes les fonctions par défaut. Ce fichier de réponses s'intitule responsefile.txt et se trouve dans le répertoire \disk1\util. Si vous souhaitez modifier le fichier de réponses pour installer d'autres fonctions, il est recommandé d'effectuer au préalable une copie de sauvegarde de responsefile.txt.

    Vous pouvez mettre à jour le fichier de réponses pour installer une ou plusieurs fonctions Rational Application Developer facultatives. Le tableau suivant indique les options du fichier de réponses et les entrées correspondantes dans le fichier de réponses.

    Tableau 1. Liste des options du fichier de réponses.

    Fonction Entrée du fichier de réponses
    Répertoire d'installation du produit installLocation
    WebSphere Application Server version 6.0 feature_was6_win32.active
    Module de langue feature_lang_pack_rad_win32.active
    Langage EGL (Enterprise Generation Language) feature_egl_win32.active
    Portal Tools feature_portal_win32.active
    Exemples pour le développement de plug-in Eclipse feature_examples_win32.active

    Pour installer en mode silencieux l'une des fonctions facultatives suivantes, suivez la procédure ci-dessous.

    1. Copiez responsefile.txt dans un nouveau fichier, par exemple myresponsefile.txt.
    2. Editez la copie du fichier de réponses.
    3. Localisez la ligne contenant le nom de la fonction d'installation indiquée dans le tableau ci-dessus. Par exemple, si vous souhaitez installer les exemples pour le développement de plug-ins Eclipse, recherchez la ligne suivante :# -P feature_examples_win32.active=<valeur> dans le fichier de réponses.
    4. Apportez les modifications suivantes à cette ligne :
      1. Supprimez le # dans la première colonne.
      2. Remplacez <value> par true.

      Dans cet exemple, cette ligne deviendrait :

         -P feature_examples_win32.active=true
      
    5. Sauvegardez vos modifications.
    6. Copiez vos images en suivant les instructions fournies dans "Installation des images locales", si vous n'avez pas déjà effectué cette opération.
    7. A partir de la ligne de commande, accédez au répertoire \disk1\setup dans le répertoire temporaire (par exemple, unité_réseau:\install_image\disk1\setup) que vous avez créé dans une précédente section.
    8. Lors de l'exécution du fichier de réponses, ajoutez le paramètre -options et le nom complet de votre fichier de réponses comme indiqué ci-dessous :
      setup.exe -silent -options "votre_répertoire\mon_fichier_réponses.txt"
      

      o- votre_répertoire est le nom complet du répertoire dans lequel se trouve le fichier de réponses.

      Remarque :
      Pour vérifier que le fichier de réponses est en cours d'utilisation, lancez d'abord cette commande (c'est-à-dire avant d'exécuter une installation en mode silencieux) sans l'option -silent et vérifiez que vos paramètres sont enregistrés dans l'assistant d'installation. Si ce n'est pas le cas, les paramètres du fichier de réponses ou la syntaxe de la commande comportent des erreurs.
    9. L'installation en mode silencieux de Rational Application Developer peut prendre un certain temps. Pour savoir si l'installation est terminée, vous pouvez contr"ler régulièrement le sous-répertoire \logs du répertoire d'installation. Si le fichier license.log s'affiche, l'installation en mode silencieux a abouti.

    Démarrage de Rational Application Developer

    Pour lancer Rational Application Developer :

    1. Sélectionnez Démarrer > Programmes > IBM Rational >IBM Rational Application Developer 6.0 > Rational Application Developer. Vous pouvez également sélectionner Démarrer > Programmes > IBM Rational > Rational Software Development Platform pour démarrer le produit.
    2. Lorsque vous lancez Rational Application Developer pour la première fois, une boîte de dialogue dans laquelle le répertoire de l'espace de travail par défaut est spécifié, s'affiche. Par défaut, le travail est enregistré dans un répertoire workspace, situé dans C:\Documents and Settings\votreidutilisateur\IBM\rationalsdp6.0. Si vous souhaitez sauvegarder votre travail à un autre emplacement, vous pouvez indiquer un nom et un emplacement différents pour l'espace de travail.
    3. Par défaut, la case à cocher Utiliser par défaut et ne plus poser la question est désélectionnée. Si vous conservez le réglage par défaut, une boîte de dialogue s'affiche à chaque fois que vous démarrez Rational Application Developer pour vous permettre de changer d'espace de travail. Cela peut s'avérer utile si vous souhaitez conserver des espaces de travail différents pour des projets différents.

      Conseil : Si la case Utiliser par défaut et ne plus poser la question est cochée, la boîte de dialogue ne s'affiche plus et Rational Application Developer démarre en utilisant l'espace de travail de la session précédente. Vous pouvez modifier la valeur par défaut après avoir démarré le produit dans la page Fenêtre > Préférences > Plan de travail > Démarrage et arrêt.

    4. Cliquez sur OK. Il existe un délai lors de la création de la structure.

    Le plan de travail s'ouvre d'abord sur une série de pages de bienvenue qui présentent le produit, fournissent des informations sur les nouveautés, ainsi que des liens permettant d'accéder à des tutoriels, des exemples et des ressources Web externes. Consacrez quelque temps à ces options. Des sources d'information sont également disponibles à partir du menu Aide.


    Désinstallation de Rational Application Developer

    Pour désinstaller Rational Application Developer :

    1. Fermez Rational Application Developer.
    2. Ouvrez le panneau de configuration, puis affichez la fenêtre Ajouter ou supprimer des programmes. Sélectionnez IBM Rational Application Developer 6.0 et cliquez sur Modifier/Supprimer pour effectuer la désinstallation.
    3. Tous les fichiers situés dans n'importe quel répertoire de plug-ins ou de fonctions sont supprimés automatiquement, conjointement avec les données utilisateur et les plug-ins tiers installés dans l'un de ces répertoires. Votre répertoire workspace, qui contient votre travail, n'est pas supprimé. D'autres répertoires ne sont pas supprimés :

    Si vous tentez de désinstaller partiellement une ou plusieurs fonctions requises par Rational Application Developer, un message d'erreur similaire à celui-ci s'affiche :

    Invalid selection:
    Unable to uninstall ide_required: root is not set for uninstall
    

    Pour éviter cette erreur, sélectionnez la case à cocher de désinstallation du produit. Le panneau de désinstallation est réinitialisé afin de vous permettre de désinstaller entièrement Rational Application Developer ou d'annuler la sélection des fonctions que vous ne souhaitez pas désinstaller.

    Désinstallation de Rational Application Developer en mode silencieux

    Pour désinstaller Rational Application Developer en mode silencieux, ouvrez une invite de commande, accédez au répertoire d'installation et entrez :

    rad_prod\_uninst\uninstall.exe -silent
    

    Incidents et restrictions connus

    La présente section décrit les incidents et restrictions connus liés à l'installation et à la désinstallation de Rational Application Developer sous Windows. Pour obtenir plus d'informations sur les incidents et les restrictions affectant l'utilisation effective du produit, reportez-vous au fichier readme ou à l'aide en ligne.

    Reprise en cas d'échec de l'installation

    En cas d'échec de votre installation, vous devez supprimer tous les fichiers de Rational Application Developer qui ont été installés. Si le répertoire que vous destiniez à l'installation de Rational Application Developer est vide, cela signifie que le processus d'installation a déjà supprimé les fichiers qui ont été installés et que vous pouvez supprimer le répertoire vide.

    Echec de l'installation de l'environnement de test WebSphere Application Server V6.0

    Si vous avez choisi d'installer l'environnement de test intégré WebSphere Application Server V6.0 lors de l'installation de Rational Application Developer et que le processus échoue, le message suivant s'affiche :

    The installation of WebSphere Application Server V6.0 Integrated Test Environment has failed.
    IBM Rational Software Development Platform will still run, but WebSphere Application Server V6.0 Integrated Test Environment may not be available.
    

    Pour obtenir des informations sur l'identification et la résolution des incidents susceptibles de se produire lors de l'installation de WebSphere Application Server V6.0, consultez le site http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp?topic=/com.ibm.websphere.base.doc/info/aes/ae/tins_trouble.html.

    Par défaut, l'environnement de test intégré WebSphere Application Server V6.0 est installé dans le sous-répertoire \runtimes\base_v6 dans lequel Rational Application Developer est installé.

    Echec de la désinstallation de WebSphere Application Server V6.0 sous Windows Server 2003

    Si Terminal Server est installé et configuré sous Windows Server 2003, il est possible que l'environnement de test intégré WebSphere Application Server V6.0 ne soit pas supprimé lors de la désinstallation de Rational Application Developer. Pour le supprimer, lancez la commande suivante à partir du répertoire dans lequel vous avez installé le produit (par exemple, C:\Program Files\IBM\Rational\SDP\6.0) :

    \runtimes\base_v6\_uninst\uninstall.exe -silent
    

    L'annulation de l'installation d'un produit puis la tentative de nouvelle installation du produit peuvent ne pas aboutir à une installation correcte du produit.

    Si vous annulez l'installation une fois la copie des fichiers dans le système commencée et que vous effectuez une installation sur la même machine o- il existe déjà un produit Software Development Platform, l'installation suivante peut ne pas abouti. Des erreurs peuvent être générées et le produit nouvellement installé peut ne pas être utilisable. L'aide et les menus du produit peuvent ne pas être présents même si l'option de démarrage du produit est disponible. A l'intérieur du produit, des plug-ins peuvent être enregistrés mais le nouveau produit n'est pas disponible.

    Si des incidents surviennent après l'annulation d'une installation fusionnée, il peut être nécessaire de suivre une des procédures ci-après en fonction de la situation.

    1. Si vous avez annulé l'installation avant le début de la copie des fichiers, vous pouvez redémarrer l'installation sans suivre les solution proposées ci-dessous.
    2. La réponse à cette situation dépend de votre progression dans le processus d'installation Si vous n'avez pas démarré l'installation une deuxième fois, vous pouvez modifier le fichier correspondant à votre système dans la liste suivante :

      Supprimez tout élément comportant un code à trois lettre après le signe égal pour l'installation du produit. Ces codes sont les suivants :

      Une fois que vous avez modifié le fichier, redémarrez l'installation et ne l'annulez pas tant que la copie des fichiers n'a pas commencé.

    3. Si vous avez commencé l'installation du produit, vous devez d'abord désinstallé le produit puis l'installer à nouveau sans annuler l'installation une fois la copie des fichiers commencée.

    Chapitre 5. Installation et désinstallation de Rational Application Developer pour Linux

    La présente section contient des informations relatives à l'installation de Rational Application Developer sous Linux. Vous pouvez installer Rational Application Developer à partir du CD-ROM ou des images électroniques que vous téléchargez. Un assistant d'installation est fourni mais vous pouvez également installer Rational Application Developer à partir d'une invite de commande ou en mode silencieux, comme indiqué plus loin dans la documentation.

    Remarque concernant l'installation :

    Important -- avant d'utiliser ce produit :


    Considérations liées à la migration, la mise à niveau et la coexistence

    Vous pouvez migrer WebSphere Studio v5.1.x vers Rational Application Developer ou faire coexister ces deux produits. Pour plus d'informations sur la migration, voir le Guide de migration de Rational Application Developer.

    Vous ne pouvez pas migrer de WebSphere Studio Site Developer ou WebSphere Studio Application Developer, v4.x.x. ou 5.0.x vers Rational Application Developer. Rational Application Developer peut cependant coexister avec l'un ou l'autre des ces produits. Vous pouvez, le cas échéant, migrer manuellement les espaces de travail, les artefacts et les projets à partir de Rational ClearCase, ClearCase LT et CVS vers Rational Application Developer.

    Pour plus d'informations sur IBM Rational Software Development Platform et sur la coexistence avec les autres produits fondés sur cette plateforme de développement, voir Chapitre 3, "IBM Rational Software Development Platform".

    Si une version antérieure d'Agent Controller ou de tout logiciel dérivé de la fonction Hyades Data Collection Engine est installée, vous devez l'arrêter, la désinstaller et nettoyer tous les fichiers qui n'ont pas été supprimés avant d'installer la présente version d'Agent Controller. Pour plus d'informations, voir Chapitre 6, "Installation d'Agent Controller".


    Installation à partir du CD-ROM

    Avant d'installer le produit, vérifiez les points suivants :

    Pour installer Rational Application Developer à partir du CD-ROM d'installation du produit, procédez comme suit :

    1. Consultez "Considérations liées à la migration, la mise à niveau et la coexistence" avant de procéder à l'installation.
    2. Connectez-vous en tant qu'utilisateur root.
    3. Démarrez une session de terminal.
    4. Entrez umask 0022 afin que le produit puisse être utilisé par d'autres utilisateurs que l'utilisateur root.
    5. Insérez le CD-ROM dans l'unité.

      Vous devrez insérer le CD-ROM suivant au cours de l'installation. Si vous ne pouvez pas ouvrir l'unité pour insérer le CD-ROM suivant, procédez aux vérifications ci-dessous.

      Si vous ne parvenez toujours pas à insérer le CD-ROM, procédez comme suit :

      1. Si le programme d'installation fonctionne toujours, cliquez sur Annuler.
      2. Connectez-vous en tant qu'utilisateur root.
      3. Si cela n'a pas encore été fait, installez le package psmisc RPM, disponible sur le CD-ROM de distribution Linux.
      4. Lancez le programme d'installation.
      5. Si l'incident persiste, entrez /sbin/fuser unité_CD à partir d'un autre terminal pour afficher le processus à l'aide du CD-ROM.
      6. Pour connaître les détails de ce processus, entrez : ps <id_processus>
    6. Si le CD-ROM n'est pas monté, entrez :
      mount unité_CD
      
    7. Entrez : unité_CD/launchpad.bin pour afficher la fenêtre Rational Application Developer du programme de lancement de l'installation.

      Conseils :

    8. A partir du programme de lancement de l'installation de Rational Application Developer, sélectionnez Installation d'IBM Rational Application Developer v6.0.
    9. Lorsque l'assistant d'installation s'affiche, cliquez sur Suivant pour continuer l'installation.
    10. Suivez les instructions qui s'affichent à l'écran pour exécuter certaines tâches, telles que la lecture de l'accord de licence et la spécification du répertoire d'installation cible.
    11. Dans la fenêtre Fonctions, vous pouvez sélectionner les fonctions Rational Application Developer que vous souhaitez installer.
      1. Par défaut, le programme d'installation installe l'environnement IDE (Integrated Development Environment) et, en option, WebSphere Application Server version 6.0 en tant qu'environnement d'exécution de test.
      2. Pour installer l'interface utilisateur et la documentation dans les langues supportées autres que l'anglais, choisissez d'installer le Module de langues. Par défaut, cette fonction n'est pas activée lorsque l'environnement local sélectionné est l'anglais. Elle est activée lorsque l'environnement local est l'une des langues nationales prises en charge.

        Les langues nationales prises en charge sont le portugais, le français, l'allemand, l'italien, le japonais, le coréen, le chinois simplifié, le chinois traditionnel et l'espagnol.

        Remarque : Si vous avez choisi d'installer le Module de langues (facultatif) et annulez ensuite l'installation peu après le début de la copie des fichiers, les installations suivantes comporteront des anomalies. Lors d'une installation suivante, le Module de langues aura le statut installé dans le panneau Fonction même si ses fichiers ne sont pas installés. Vous pouvez choisir de réinstaller la fonction Module de langues et les fichiers corrects seront copiés sur votre disque. Dans cette situation, vous pouvez recevoir un message à la fin de l'installation indiquant qu'un ou plusieurs erreurs sont survenues lors du remplacement des fichiers. Vous pouvez ignorer ce message d'erreur en toute sécurité.

      3. Par défaut, la fonction EGL (Enterprise Generation Language) n'est pas installée. EGL est un langage évolué et puissant qui permet de créer des applications métier complexes. Il gère la complexité des technologies sous-jacentes (telles l'accès aux bases de données, les files d'attente de messages et J2EE) afin que les développeurs d'applications puissent se concentrer sur la logique métier. Pour installer le plug-in EGL, sélectionnez la case à cocher Langage EGL (Enterprise Generation Language).
      4. Par défaut, la fonction Portal Tools n'est pas installée. Pour l'installer, cochez la case Portal Tools.
      5. Par défaut, les exemples pour le développement de plug-in Eclipse ne sont pas installés. Ces exemples s'adressent aux développeurs qui souhaitent étendre le plan de travail en créant leurs propres outils de plug-in. Pour installer les exemples pour le développement de plug-in Eclipse, cochez la case Exemples pour le développement de plug-in Eclipse.
    12. Cliquez sur Suivant pour afficher des informations récapitulatives sur l'installation de Rational Application Developer.
    13. Cliquez sur Suivant pour continuer l'installation de Rational Application Developer.
    14. Lorsque vous êtes invité à insérer le CD-ROM suivant, procédez comme suit :
      1. Pour ouvrir l'unité de CD-ROM, entrez : eject unité_CD
      2. Insérez le CD-ROM suivant dans l'unité.
      3. Si l'insertion automatique n'est pas activée, insérez le CD-ROM en tapant : mount unité_CD
      4. Cliquez sur OK pour poursuivre l'installation.
    15. Si vous recevez un avertissement signalant un incident d'enregistrement de la licence lors de la phase finale de l'installation, procédez comme suit :
      1. Accédez au sous-répertoire /logs du répertoire d'installation.
      2. Ouvrez license.log avec un éditeur de texte.
      3. Si license.log contient l'une des lignes suivantes :
        486604803  The requested license has expired
        486604805 The start dates for all licenses have not yet occurred
        
        vérifiez que l'horloge système est configurée correctement et démarrez Rational Application Developer.
    16. Lorsque Rational Application Developer est installé, cliquez sur Suivant pour terminer l'installation.
    17. Une fenêtre permettant de lancer l'installation d'Agent Controller s'affiche alors. Vous devez installer ce produit pour pouvoir utiliser les fonctions de profilage, d'analyse d'exécution et de journalisation de Rational Application Developer. Pour plus de détails, voir Chapitre 6, "Installation d'Agent Controller". Désélectionnez cette option si vous ne souhaitez pas installer Agent Controller dès maintenant.

      Cette fenêtre contient également un message vous conseillant de vérifier si des mises à jour sont disponibles pour les fonctions installées à l'aide du programme de mise à jour des produits Rational. (Pour plus d'informations, voir Chapitre 13, "Installation des mises à jour".) Cliquez sur Terminer pour fermer la fenêtre d'installation.

    18. Si vous envisagez de développer des applications qui seront exécutées sur d'autres serveurs d'applications, vous pouvez également choisir d'installer des environnements de test d'exécution supplémentaires avec Rational Application Developer.Pour plus d'informations, voir Chapitre 8, "Installation de WebSphere Application Server 5.x en tant qu'environnement de test intégré"
    19. Avant d'utiliser les fonctions de profilage, d'analyse d'exécution et de journalisation de Rational Application Developer pour collecter les données à distance, vous devez installer Agent Controller à la fois sur l'hôte local et sur l'hôte distant. Pour plus de détails, voir Chapitre 6, "Installation d'Agent Controller".
    20. Si vous voulez tester les applications de services Web et de messagerie dans WebSphere Application Server Version 6.0, la prise en charge du fournisseur de messagerie par défaut est automatiquement disponible et il n'est pas nécessaire d'installer le support serveur et client de messagerie intégrée. Toutefois, si vous souhaitez utiliser l'environnement de test WebSphere version 5.x, vous devez installer séparément la fonction client et serveur de messagerie intégrée. Pour plus d'informations, voir Chapitre 9, "Installation du support de messagerie et de mise en file d'attente pour les environnements de testWebSphere version 5.x".

      Important : Si MQSeries est déjà installé, n'installez pas le client et le serveur de messagerie intégrée car il s'agit d'un sous-ensemble des fonctions MQSeries.

    21. Si vous envisagez d'utiliser Rational ClearCase comme système de gestion de la configuration logicielle (SCM), vous pouvez installer la fonction Rational ClearCase LT dès maintenant ou ultérieurement. Pour plus d'informations sur Rational ClearCase, voir Chapitre 7, "Configuration de Rational Application Developer pour une utilisation en environnement coopératif".
    22. Crystal Enterprise est une infrastructure d'accès aux données et de création de rapports conçue pour s'intégrer à vos données, solutions Web et applications existantes. Elle est fondée sur Crystal Reports. Pour plus d'informations sur l'installation de ce produit, voir Chapitre 12, "Installation de Crystal Enterprise".

    Remarque :

    Installation à partir des images électroniques

    Reportez-vous au fichier readme du produit pour obtenir une description des images électroniques à télécharger.

    Avant d'installer le produit, vérifiez les points suivants :

    Pour télécharger et créer l'image d'installation électronique, suivez la procédure décrite ci-après.

    1. Téléchargez tous les éléments requis ainsi que les éléments facultatifs choisis dans le même répertoire temporaire. Si vous avez besoin ultérieurement d'autres éléments facultatifs, téléchargez-les et exécutez à nouveau l'outil d'extraction avant d'effectuer l'installation.
      Remarque :
      Lorsque vous mettez à niveau un produit Rational Software Development Platform vers un autre produit à l'aide des images électroniques, veillez à télécharger et à extraire le même ensemble d'images que celui que vous avez téléchargé et extrait pour le produit d'origine. Les mêmes composants que ceux installés dans le produit d'origine seront installés automatiquement dans le produit mis à niveau.

      Par exemple, si le Module de langues a été installé initialement, ce produit devra être téléchargé et extrait dans l'image d'installation du nouveau produit au cours de la mise à niveau.

    2. Modifiez les droits d'accès au fichier extractor.bin qui se trouve dans ce répertoire temporaire en entrant :
      chmod +x extractor.bin
      
    3. Exécutez le fichier en tapant ./extractor.bin
    4. Suivez les instructions de l'assistant pour indiquer l'emplacement de création de l'image ainsi que les fonctions à inclure.
    5. Une fois l'image créée, si vous souhaitez installer le produit immédiatement, cliquez sur Terminer. Vous pouvez également déselectionner la case à cocher permettant de lancer l'assistant d'installation et exécuter le programme d'installation ultérieurement en lançant disk1/launchpad.bin à partir du répertoire dans lequel vous avez créé l'image d'installation.
    6. Suivez les instructions décrites dans "Installation à partir du CD-ROM".

    Création d'une image d'installation réseau

    Vous pouvez placer une copie de l'image d'installation sur une unité réseau afin que les utilisateurs puissent effectuer l'installation à partir du réseau.

    Pour exécuter le programme d'installation à partir d'une unité réseau, vous devez soit utiliser une image électronique téléchargée de Rational Application Developer, soit copier le contenu des CD-ROM, comme il est décrit ci-dessus.

    Vous devez disposer d'environ 6 Go d'espace disque pour stocker le contenu du CD-ROM sur disque. Pour copier les fichiers à partir des CD-ROM :

    1. Connectez-vous en tant qu'utilisateur root.
    2. Créez un répertoire (install_image, par exemple) sur l'unité réseau sur laquelle vous souhaitez stocker l'image.
    3. Insérez le premier Rational Application Developer CD-ROM d'installation dans l'unité.
    4. Sous ce répertoire temporaire, créez un sous-répertoire disk1. Ce sous-répertoire doit obligatoirement s'appeler disk1 et être spécifié en minuscules.
    5. Copiez tous les fichiers et les répertoires du premier CD-ROM d'installation dans le sous-répertoire disk1 du répertoire temporaire.
    6. Répétez les 3, 4 et 5 pour copier le contenu des deux autres CD-ROM dans des sous-répertoires appelés disk2 et disk3.

    Il s'agit des fichiers d'installation principaux. Pour obtenir les fichiers d'installation pour l'une des fonctions facultatives suivantes :

    1. Agent Controller
    2. Client et serveur de messagerie intégrée
    3. Rational ClearCase LT
    4. Environnements de test WebSphere V5.x
    5. Environnements de test WebSphere Portal V5.0
    6. Crystal Enterprise V10 Professional Edition
    7. Crystal Enterprise V10 Embedded Edition

    copiez le contenu des CD-ROM appropriés dans votre répertoire temporaire.

    Remarque :
    Si votre machine passe en mode pause lors d'une installation à partir d'une image réseau, l'installation peut ne pas aboutir.

    Exécution d'une installation en mode silencieux

    Le programme d'installation de Rational Application Developer peut être exécuté en mode silencieux si vous ne voulez pas utiliser l'assistant d'installation.

    Installation des images locales

    Avant d'installer Rational Application Developer en mode silencieux, vous devez copier vos images locales :

    1. Consultez "Considérations liées à la migration, la mise à niveau et la coexistence" avant de procéder à l'installation.
    2. Créez une image d'installation locale ou réseau comme indiqué dans "Création d'une image d'installation réseau". Si vous souhaitez installer Rational Application Developer uniquement, il suffit de copier les informations contenues sur les trois premiers CD-ROM.

    Installation en mode silencieux des fonctions par défaut dans le répertoire par défaut

    Les fonctions suivantes sont installées par défaut lors de l'installation silencieuse de Rational Application Developer :

    Pour installer Rational Application Developer en mode silencieux en utilisant uniquement les fonctions sélectionnées par défaut dans le répertoire par défaut /opt/IBM/Rational/SDP/6.0, suivez la procédure ci-dessous.

    1. Connectez-vous en tant qu'utilisateur root.
    2. Copiez vos images en suivant les instructions fournies dans "Installation des images locales", si vous n'avez pas déjà effectué cette opération.
    3. A partir de la ligne de commande, sélectionnez le répertoire /disk1/setup dans le répertoire temporaire (par exemple, /tmp/install_image/disk1/setup) créé dans une précédente section.
    4. Exécutez la commande suivante :
      ./setup.bin -silent 
      
    5. L'installation en mode silencieux de Rational Application Developer peut prendre un certain temps. Pour savoir si l'installation est terminée, vous pouvez contrôler régulièrement le sous-répertoire /logs du répertoire d'installation. Si le fichier license.log s'affiche, l'installation en mode silencieux a abouti.

    Installation en mode silencieux dans un autre répertoire

    Si vous modifiez le paramètre installLocation, vous pouvez installer Rational Application Developer dans un autre répertoire. Par exemple, si vous souhaitez que "/my_softdev" soit dans votre répertoire d'installation, suivez la même procédure que celle décrite plus haut mais en lançant cette fois la commande suivante :

    ./setup.bin -silent -P installLocation="/my_softdev"
    

    Dans cet exemple, seules les fonctions par défaut sont installées.

    Installation en mode silencieux d'autres fonctions Rational Application Developer

    Rational Application Developer fournit un exemple de fichier de réponses. Ce fichier de réponses s'intitule responsefile.txt et se trouve dans le répertoire /disk1/util. Si vous souhaitez modifier le fichier de réponses pour installer d'autres fonctions, il est recommandé d'effectuer au préalable une copie de sauvegarde de responsefile.txt.

    Vous pouvez mettre à jour le fichier de réponses pour installer une ou plusieurs fonctions Rational Application Developer facultatives. Le tableau suivant indique les options du fichier de réponses et les entrées correspondantes dans le fichier de réponses.

    Tableau 2. Liste des options du fichier de réponses.

    Fonction Entrée du fichier de réponses
    Répertoire d'installation du produit installLocation
    WebSphere Application Server version 6.0 feature_was6_linux.active
    Module de langues feature_lang_pack_rad_linux.active
    Langage EGL (Enterprise Generation Language) feature_egl_linux.active
    Portal Tools feature_portal_linux.active
    Exemples pour le développement de plug-in Eclipse feature_examples_linux.active

    Pour installer en mode silencieux l'une des fonctions facultatives suivantes, suivez la procédure ci-dessous.

    1. Copiez responsefile.txt dans un nouveau fichier, par exemple myresponsefile.txt.
    2. Editez la copie du fichier de réponses.
    3. Localisez la ligne contenant le nom de la fonction d'installation indiquée dans le tableau ci-dessus. Par exemple, si vous souhaitez installer les exemples pour le développement de plug-ins Eclipse, recherchez la ligne suivante dans le fichier de réponses :

      # -P feature_examples_linux.active=<valeur>

    4. Apportez les modifications suivantes à cette ligne :
      1. Supprimez le # dans la première colonne.
      2. Remplacez <value> par true.

      Dans cet exemple, cette ligne deviendrait :

         -P feature_examples_linux.active=true
      
    5. Sauvegardez vos modifications.
    6. Connectez-vous en tant qu'utilisateur root.
    7. Copiez vos images en suivant les instructions fournies dans "Installation des images locales", si vous n'avez pas déjà effectué cette opération.
    8. A partir de la ligne de commande, sélectionnez le répertoire /disk1/setup dans le répertoire temporaire (par exemple, /tmp/install_image/disk1/setup) créé dans une précédente section.
    9. Lors de l'exécution du fichier de réponses, ajoutez le paramètre -options et le nom complet de votre fichier de réponses comme indiqué dans l'exemple ci-dessous :
      ./setup.bin -silent -options "votre_répertoire/mon_fichier_réponses.txt"
      

      votre_répertoire est le nom complet du répertoire dans lequel se trouve le fichier de réponses.

      Remarque :
      Pour vérifier que le fichier de réponses est en cours d'utilisation, lancez d'abord cette commande (c'est-à-dire avant d'exécuter une installation en mode silencieux) sans l'option -silent et vérifiez que vos paramètres sont enregistrés dans l'assistant d'installation. Si ce n'est pas le cas, les paramètres du fichier de réponses ou la syntaxe de la commande comportent des erreurs.
    10. L'installation en mode silencieux de Rational Application Developer peut prendre un certain temps. Pour savoir si l'installation est terminée, vous pouvez contrôler régulièrement le sous-répertoire /logs du répertoire d'installation. Si le fichier license.log s'affiche, l'installation en mode silencieux a abouti.

    Augmentation du nombre de descripteurs de fichier disponibles

    Avant d'utiliser le produit, les utilisateurs sont invités à demander à leur administrateur système d'augmenter le nombre des descripteurs de fichiers disponibles pour les utilisateurs Rational Application Developer au-delà de la limite par défaut de 1024 descripteurs de fichier par processus.

    Vous devez suivre à la lettre les instructions présentées ci-dessous pour augmenter le nombre des descripteurs de fichiers sous Linux. Sinon, la machine risque de ne plus démarrer correctement. Il est préférable de confier cette tâche à votre administrateur système.

    Pour augmenter le nombre des descripteurs de fichier :

    1. Connectez-vous en tant qu'utilisateur root. Si vous ne disposez pas des droits root, vous devez les obtenir pour pouvoir continuer.
    2. Accédez au répertoire etc.
    3. Utilisez l'éditeur vi pour modifier le fichier initscript dans le répertoire etc. Si ce fichier n'existe pas, tapez vi initscript pour le créer.
      Remarque :
      Si vous choisissez d'augmenter le nombre des descripteurs de fichier, le fichier initscript créé sur votre machine ne doit PAS être vide car cela pourrait empêcher cette dernière de démarrer.
    4. Sur la première ligne, entrez ulimit -n 4096 (la valeur indiquée ici est sensiblement supérieure à 1024, qui est la valeur par défaut pour la plupart des machines Linux). Attention : cette valeur ne doit pas être trop élevée car cela pourrait avoir des conséquences graves sur les performances générales du système.
    5. Sur la deuxième ligne, tapez eval exec "$4".
    6. Sauvegardez le fichier et fermez-le après avoir vérifié que vous avez bien exécuté les étapes 4 et 5.
      Remarque :
      Cette procédure doit être exécutée correctement ; dans le cas contraire, votre machine ne pourra plus démarrer.
    7. (Facultatif) Restreignez les utilisateurs ou les groupes en modifiant le fichier limits.conf dans le répertoire etc/security. Ce fichier existe par défaut à la fois sous SuSE Linux Enterprise Server (SLES) version 9 et Red Hat Enterprise Linux version 3.0. Si pour une raison quelconque, ce fichier n'existe pas, envisagez de spécifier une valeur plus modérée à l'étape 4 (2048, par exemple). La limite fixée pour le nombre maximal autorisé de fichiers ouverts par processus sera ainsi relativement faible pour la plupart des utilisateurs. Si vous avez indiqué une valeur relativement faible à l'étape 4, cette opération n'est plus aussi importante. Si vous n'exécutez pas cette opération alors que vous avez spécifié une valeur élevée à l'étape 4, cela risque d'avoir des conséquences graves sur les performances de votre machine.

      Voici à quoi ressemble un fichier limits.conf qui restreint tous les utilisateurs et définit ultérieurement des limites différentes pour d'autres utilisateurs. Cet exemple suppose que vous avez spécifié la valeur 8192 à l'étape 4 présentée plus haut.
      * soft nofile 1024
      * hard nofile 2048
      root soft nofile 4096
      root hard nofile 8192
      user1 soft nofile 2048
      user1 hard nofile 2048

      Dans l'exemple ci-dessus, le signe * correspond aux limites définies d'abord pour tous les utilisateurs. Ces limites sont plus faibles que les suivantes. Pour l'utilisateur root, le nombre de descripteurs ouverts autorisé est plus élevé et pour l'utilisateur root, il est à un niveau intermédiaire entre les deux. Prenez soin de bien lire la documentation contenue dans le fichier limits.conf avant d'effectuer des modifications.

    Pour plus d'informations sur la commande ulimit, voir la page man correspondante.


    Démarrage de Rational Application Developer

    Pour lancer Rational Application Developer, procédez comme suit :

    1. Pour démarrer Rational Application Developer à partir d'une ligne de commande, accédez au répertoire d'installation et lancez la commande suivante :./rationalsdp.bin.
    2. Si vous utilisez Gnome (par défaut sous Red Hat), le raccourci du produit se trouve dans le menu principal, sous Programming > Rational Software Development Platform. Si vous utilisez KDE (par défaut sous SuSE), le raccourci du produit est IBM Rational > Rational Software Development Platform.
    3. Lorsque vous lancez Rational Application Developer pour la première fois, une boîte de dialogue dans laquelle le répertoire de l'espace de travail par défaut est spécifié, s'affiche. Par défaut, le travail est enregistré dans un répertoire workspace, situé dans le répertoire $HOME/IBM/rationalsdp6.0.
    4. Par défaut, la case à cocher Utiliser par défaut et ne plus poser la question est désélectionnée. Si vous conservez le réglage par défaut, une boîte de dialogue s'affiche à chaque fois que vous démarrez Rational Application Developer pour vous permettre de changer d'espace de travail. Cela peut s'avérer utile si vous souhaitez conserver des espaces de travail différents pour des projets différents.

      Conseil : Si la case Utiliser par défaut et ne plus poser la question est cochée, la boîte de dialogue ne s'affiche plus et Rational Application Developer démarre en utilisant l'espace de travail de la session précédente. Vous pouvez modifier la valeur par défaut après avoir démarré le produit dans la page Fenêtre > Préférences > Plan de travail > Démarrage et arrêt.

    Le plan de travail s'ouvre d'abord sur une série de pages de bienvenue qui présentent le produit, fournissent des informations sur les nouveautés, ainsi que des liens permettant d'accéder à des tutoriels, des exemples et des ressources Web externes. Consacrez quelque temps à ces options. Des sources d'information sont également disponibles à partir du menu Aide.


    Désinstallation de Rational Application Developer

    Pour désinstaller Rational Application Developer sous Linux, procédez comme suit.

    1. Connectez-vous en tant qu'utilisateur root.
    2. Accédez au sous-répertoire rad_prod/_uninst/ du répertoire d'installation.
    3. Désinstallez Rational Application Developer en entrant la commande suivante : ./uninstall.bin. Si vous utilisez un gestionnaire de fichiers, vous pouvez cliquer sur le fichier pour lancer le programme de désinstallation.
    4. Tous les fichiers ou fonctions situés dans n'importe quel répertoire de plug-ins ou de fonctions sont supprimés automatiquement, conjointement avec les données utilisateur et les plug-ins tiers installés dans l'un de ces répertoires. Votre répertoire workspace, qui contient votre travail, n'est pas supprimé. D'autres répertoires ne sont pas supprimés :

    Si vous tentez de désinstaller partiellement une ou plusieurs fonctions requises par Rational Application Developer, un message d'erreur similaire à celui-ci s'affiche :

    Invalid selection:
    Unable to uninstall ide_required: root is not set for uninstall
    

    Pour éviter cette erreur, sélectionnez la case à cocher de désinstallation du produit. Le panneau de désinstallation est réinitialisé afin de vous permettre de désinstaller entièrement Rational Application Developer ou d'annuler la sélection des fonctions que vous ne souhaitez pas désinstaller.

    Désinstallation de Rational Application Developer en mode silencieux

    Pour désinstaller Rational Application Developer en mode silencieux, ouvrez une invite de commande, accédez au répertoire d'installation et entrez :

    rad_prod\_uninst\uninstall.bin -silent
    

    Incidents et restrictions connus

    La présente section décrit les incidents et restrictions connus liés à l'installation et à la désinstallation de Rational Application Developer sous Linux. Pour obtenir plus d'informations sur les incidents et les restrictions affectant l'utilisation effective du produit, voir le fichier readme.

    Restrictions liées à l'espace disque

    Echec de l'installation de l'environnement de test WebSphere Application Server V6.0

    Si vous avez choisi d'installer l'environnement de test intégré WebSphere Application Server V6.0 lors de l'installation de Rational Application Developer et que le processus échoue, le message suivant s'affiche :

    The installation of WebSphere Application Server V6.0 Integrated Test Environment has failed.
    IBM Rational Software Development Platform will still run, but WebSphere Application Server V6.0 Integrated Test Environment may not be available.
    

    Pour obtenir des informations sur l'identification et la résolution des incidents susceptibles de se produire lors de l'installation de WebSphere Application Server V6.0, consultez le site http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp?topic=/com.ibm.websphere.base.doc/info/aes/ae/tins_trouble.html.

    Par défaut, l'environnement de test intégré WebSphere Application Server V6.0 est installé dans le sous-répertoire /runtimes/base_v6 dans lequel Rational Application Developer est installé.

    L'annulation de l'installation d'un produit puis la tentative de nouvelle installation du produit peuvent ne pas aboutir à une installation correcte du produit.

    Voir "L'annulation de l'installation d'un produit puis la tentative de nouvelle installation du produit peuvent ne pas aboutir à une installation correcte du produit." .


    Chapitre 6. Installation d'Agent Controller

    Agent Controller est un démon qui permet aux clients d'application 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 ci-dessous.

    Remarques :


    Conditions matérielles requises


    Plateformes prises en charge

    Note for Remarques relatives à Linux : La fonction Hyades Data Collection Engine d'Agent Controller est compilée à l'aide de la bibliothèque partagée libstdc++-libc6.2-2.so.3. Vérifiez que cette dernière se trouve dans le répertoire /usr/lib. Si ce n'est pas le cas, vous devez installer le package RPM compat-libstdc++ livré avec le support d'installation du système d'exploitation.

    Agent Controller a été testé sur les plateformes suivantes :

    Agent Controller n'a pas été testé sur les plateformes suivantes mais celles-ci sont compatibles avec le produit :

    Agent Controller n'est pas disponible pour les plateformes suivantes :


    Machines JVM prises en charge

    En général, Agent Controller est exécuté avec la machine JVM version 1.4 et suivante. Il a été testé avec les versions de machine JVM (java -fullversion) suivantes :


    Emplacement des fichiers d'installation

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


    Installation d'Agent Controller sur un poste de travail (AIX, HP-UX, Linux, Windows, Solaris)

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

    Si une version antérieure d'Agent Controller ou de tout logiciel dérivé de la fonction Hyades Data Collection Engine est installée, vous devez l'arrêter, la désinstaller et nettoyer tous les fichiers qui n'ont pas été supprimés avant d'installer la présente version d'Agent Controller. Les fichiers suivants n'ont peut-être pas été supprimés lors de la désinstallation :

    Windows :

    %RASERVER_HOME%\*.* (répertoire d'installation d'Agent Controller)
    %SystemRoot%\system32\piAgent.dll (répertoire system32 de Windows)
    %SystemRoot%\system32\LogAgent.dll
    %SystemRoot%\system32\hcbnd.dll
    %SystemRoot%\system32\hcclco.dll
    %SystemRoot%\system32\hccldt.dll
    %SystemRoot%\system32\hccls.dll
    %SystemRoot%\system32\hcclserc.dll
    %SystemRoot%\system32\hcclsert.dll
    %SystemRoot%\system32\hcclsm.dll
    %SystemRoot%\system32\hcjbnd.dll
    %SystemRoot%\system32\hclaunch.dll
    %SystemRoot%\system32\hcthread.dll
    %SystemRoot%\system32\piAgent.dll
    %SystemRoot%\system32\rac.dll
    %SystemRoot%\system32\sysperf.dll
    

    Linux, AIX, HP-UX, Solaris :

    $RASERVER_HOME/* (répertoire d'installation d'Agent Controller
    /usr/lib/libpiAgent.so (ou .sl sous HP-UX)
    /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
    

    Installation d'Agent Controller

    1. Connectez-vous en tant qu'administrateur (ou utilisateur root).
    2. A partir du support d'installation, accédez au répertoire correspondant à votre plateforme.
    3. Exécutez le programme setup.exe. Pour une plateforme non Windows, exécutez setup.bin.
    4. Cliquez sur Suivant dans l'écran de bienvenue pour continuer.
    5. Avant de continuer l'installation, fermez toutes les plateformes Eclipse. Cliquez sur Suivant pour continuer.
    6. Lisez le contrat de licence.
    7. Sélectionnez Approuver et cliquez sur Suivant pour continuer.
    8. Un message vous informe que toute installation existante d'Agent Controller sera supprimée. Cliquez sur Suivant pour continuer.
    9. Spécifiez le chemin d'installation d'Agent Controller et cliquez sur Suivant pour continuer.
    10. Sélectionnez les fonctionnalités Agent Controller que vous voulez installer :

      Cliquez sur Suivant pour continuer.

    11. Spécifiez le chemin du programme exécutable de l'environnement JRE java.exe ou java devant être utilisé par Agent Controller. C'est à partir de l'environnement JRE indiqué ici qu'Agent Controller pourra lancer des applications Java. Vous pouvez donc, si vous le souhaitez, modifier le chemin JRE prédéfini par le programme d'installation.
      Remarque :
      L'environnement JRE que vous indiquez à présent permet à la fois d'exécuter Agent Controller et de lancer des applications Java à partir de ce dernier. 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, voir Configuration des applications à lancer par Agent Controller dans l'aide sur Agent Controller.
    12. Facultatif : Spécifiez les chemins d'installation d'IBM WebSphere Application Server version 5.0 (Windows uniquement) et 5.1 si l'option "Remote Support for WebSphere Application Server" a été sélectionnée.
    13. Spécifiez les hôtes pouvant accéder à Agent Controller. Les options disponibles sont les suivantes :

      Cliquez sur Suivant pour continuer.

    14. Si l'option de sécurité a été sélectionnée précédemment, à l'étape 9 : configurez la sécurité.

      Cliquez sur Suivant pour continuer.

    15. Cliquez sur Suivant dans la fenêtre récapitulative pour continuer.
    16. Une fois le transfert de fichiers terminé, 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
    Paramètres obligatoires  
    -silent
    
    indique au programme d'installation de s'exécuter en mode silencieux
    -P installLocation
    
    indique le chemin d'installation
    -W javaHome_win.path
    
    (Windows) indique le chemin complet du programme exécutable java.exe
    -W javaHome_unix.path
    
    (Non Windows) indique le chemin complet du programme exécutable java
    -W hostList.type
    
    indique les modes de connexion possibles des clients à Agent Controller (ALL, LOCAL, CUSTOM)
    • ALL : n'importe quel client peut se connecter
    • LOCAL : seul l'hôte local peut se connecter
    • CUSTOM : seuls les clients répertoriés peuvent se connecter (requiert également le paramètre -W hostList.hosts)
    -W security.type
    
    indique si la sécurité doit être activée (true, false)
    • true : active la sécurité (requiert également le paramètre facultatif "-W security.users")
    • false : désactive la sécurité
       
    Paramètres facultatifs  
    -W wasHome_win.was510path
    
    (Windows) indique l'emplacement d'installation d'IBM WebSphere Application Server 5.1
    -W wasHome_unix.was510path
    
    (Non Windows) indique l'emplacement d'installation d'IBM WebSphere Application Server 5.1
    -W wasHome_win.was500path
    
    (Windows) indique l'emplacement d'installation d'IBM WebSphere Application Server 5.0
    -W wasHome_unix.was500path
    
    (Non Windows) indique l'emplacement d'installation d'IBM WebSphere Application Server 5.0
    -W hostList.hosts
    
    indique les noms d'hôte client, séparés par une virgule (si hostList.type="CUSTOM")
    -W security.users
    
    indique les utilisateurs pouvant se connecter à Agent Controller (si "security.type = "true")
    -P hyadesdc_ibm_runtimeAnalysis_feature.active=false
    
    indique que la fonction Runtime Analysis ne doit pas être installée (par défaut, cette fonction est installée lors de l'installation en mode silencieux)
    Remarque :
    Si vous installez Agent Controller en mode silencieux via une connexion non sécurisée, utilisez le paramètre security.type.="false".

    Exemples pour Windows :

    setup.exe
      -silent
      -P installLocation="D:\IBM\AgentController"
      -W javaHome_win.path="d:\jdk1.4.1\jre\bin\java.exe"
      -W wasHome_win.was510path="d:\WebSphere5.1\AppServer"
      -W wasHome_win.was500path="d:\WebSphere5.0\AppServer"
      -W hostList.type="CUSTOM"
      -W hostList.hosts="host1,host2"
      -W security.type="true"
      -W security.users="user1,user2"
     
    

    Exemples pour des plateformes autres que Windows :

    setup.bin
      -silent
      -P installLocation="/opt/IBM/AgentController"
      -W javaHome_unix.path="/opt/java1.4.1/jre/bin/java"
      -W wasHome_unix.was510path="/opt/WebSphere5.1/AppServer"
      -W wasHome_unix.was500path="/opt/WebSphere5.1/AppServer"
      -W hostList.type="CUSTOM"
      -W hostList.hosts="host1,host2"
      -W security.type="true"
      -W security.users="user1,user2"
     
    

    Utilisation d'un fichier de réponses

    Vous pouvez créer un fichier de réponses (setup.rsp, par exemple) devant contenir tous les paramètres ci-dessus, au lieu de spécifier ces derniers sur la ligne de commande :

    # Début du fichier de réponses
    -P installLocation="D:\IBM\AgentController"
    -W javaHome_win.path="d:\jdk1.4.1\jre\bin\java.exe"
    -W wasHome_win.was510path="d:\WebSphere5.1\AppServer"
    -W wasHome_win.was500path="d:\WebSphere5.0\AppServer"
    -W hostList.type="CUSTOM"
    -W hostList.hosts="host1,host2"
    -W security.type="true"
    -W security.users="user1,user2"
    # Fin du fichier de réponses
    

    Pour effectuer l'installation à l'aide du fichier de réponses :

    Windows : setup.exe -silent -options d:\temp\setup.rsp

    Non Windows : setup.bin -silent -options /tmp/setup.rsp

    Démarrage et arrêt d'Agent Controller sur un poste de travail Windows

    Démarrage et arrêt d'Agent Controller sur un poste de travail non Windows

    Désinstallation d'Agent Controller sur un poste de travail Windows

    Désinstallation d'Agent Controller sur un poste de travail non Windows

    1. Exécutez le programme uninstall.bin à partir du répertoire _uninst du répertoire d'installation (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.

    Installation d'Agent Controller sous OS/400 (iSeries)

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

    Si une version antérieure d'Agent Controller ou de tout autre logiciel dérivé de Hyades Data Collection Engine est installée, vous devez l'arrêter et la désinstaller avant d'installer la présente version.

    Installation d'Agent Controller

    1. Pour l'hôte iSeries, créez une bibliothèque appelée HYADESDC et une autre appelée IBMRAC :
      CRTLIB HYADESDC
      CRTLIB IBMRAC
      
    2. Pour l'hôte iSeries, dans la bibliothèque HYADESDC, créez un fichier de sauvegarde vide appelé HYADESDC.SAVF :
      CRTSAVF HYADESDC/HYADESDC
      
    3. Pour l'hôte iSeries, dans la bibliothèque IBMRAC, créez un fichier de sauvegarde vide appelé IBMRAC.SAVF :
      CRTSAVF IBMRAC/IBMRAC
      
    4. Pour l'hôte iSeries, dans la bibliothèque IBMRAC, créez un fichier de sauvegarde vide appelé IBMRTA.SAVF :
      CRTSAVF IBMRAC/IBMRTA
      
    5. Utilisez le protocole FTP pour transférer le fichier IBMRAC.SAVF du CD-ROM d'installation vers la bibliothèque IBMRAC située sur l'hôte iSeries à l'aide du mode de transfert binaire.
    6. Utilisez le protocole FTP pour transférer le fichier HYADESDC.SAVF du CD-ROM d'installation vers la bibliothèque HYADESDC située sur l'hôte iSeries à l'aide du mode de transfert binaire.
    7. Utilisez le protocole FTP pour transférer le fichier IBMRTA.SAVF du CD-ROM d'installation vers la bibliothèque IBMRAC située sur l'hôte iSeries à l'aide du mode de transfert binaire.
    8. Restaurez le fichier de sauvegarde HYADESDC.SAVF, situé sur l'hôte iSeries, dans la bibliothèque HYADESDC en entrant :

      RSTOBJ OBJ(*ALL) SAVLIB(HYADESDC) DEV(*SAVF) SAVF(HYADESDC/HYADESDC)
      
    9. Restaurez le fichier de sauvegarde IBMRAC.SAVF, situé sur l'hôte iSeries, dans la bibliothèque IBMRAC en entrant :

      RSTOBJ OBJ(*ALL) SAVLIB(IBMRAC) DEV(*SAVF) SAVF(IBMRAC/IBMRAC)
      
    10. Restaurez le fichier de sauvegarde IBMRTA.SAVF, situé sur l'hôte iSeries, dans la bibliothèque IBMRAC en entrant :

      RSTOBJ OBJ(*ALL) SAVLIB(IBMRAC) DEV(*SAVF) SAVF(IBMRAC/IBMRTA)
      
    11. Démarrez QShell et créez le répertoire /opt/hyadesdc dans le système de fichiers intégré (IFS).
    12. Restaurez le fichier de sauvegarde HYADESIFS.SAVF de la bibliothèque HYADESDC dans le répertoire IFS /opt/hyadesdc. Par exemple :

      RST DEV('/QSYS.LIB/HYADESDC.LIB/HYADESIFS.FILE') OBJ('/opt/hyadesdc/*')
      
    13. Restaurez le fichier de sauvegarde IBMRACIFS.SAVF de la bibliothèque IBMRAC dans le répertoire IFS /opt/hyadesdc. Par exemple, entrez la commande suivante sur une seule ligne :

      RST DEV('/QSYS.LIB/IBMRAC.LIB/IBMRACIFS.FILE') OBJ('/opt/hyadesdc/*') ALWOBJDIF(*ALL)
      
    14. Restaurez le fichier de sauvegarde IBMRTAIFS.SAVF de la bibliothèque IBMRAC dans le répertoire IFS /opt/hyadesdc. Par exemple, entrez la commande suivante sur une seule ligne :

      RST DEV('/QSYS.LIB/IBMRAC.LIB/IBMRTAIFS.FILE') OBJ('/opt/hyadesdc/*') ALWOBJDIF(*ALL)
      
    15. Après avoir installé Agent Controller, accédez au répertoire bin du répertoire de l'installation /opt/hyades/bin et exécutez le script de configuration en entrant :

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

    Démarrage et arrêt d'Agent Controller sous OS/400 (iSeries)

    1. Pour démarrer Agent Controller, ajoutez les bibliothèques HYADESDC et IBMRAC à la liste des bibliothèques :
      ADDLIBLE HYADESDC
      ADDLIBLE IBMRAC
      
    2. Soumettez le travail RAStart en entrant :

      SBMJOB CMD(CALL RASERVER) JOBD(RASTART)
      
    3. Pour arrêter Agent Controller, arrêtez le travail RAStart en entrant :

      ENDJOB JOB(RASTART)
      

    Désinstallation d'Agent Controller sous OS/400 (iSeries)

    1. Supprimez les bibliothèques HYADESDC et IBMRAC.
    2. Supprimez le répertoire IFS /opt/hyadesdc (sous-répertoires et fichiers compris).

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

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

    Si une version antérieure d'Agent Controller ou de tout autre logiciel dérivé de Hyades Data Collection Engine est installée, vous devez l'arrêter et la désinstaller avant d'installer la présente version.

    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 ibmrta.os390.pax vers le répertoire d'installation.
    3. Pour extraire les fichiers d'Agent Controller, lancez la commande suivante :

      pax -ppx -rf ibmrac.os390.pax
      
    4. Accédez au répertoire d'installation /usr/lpp/IBM/AgentController et entrez la commande suivante pour extraire les extensions d'analyse d'exécution :

      pax -ppx -rf ../../ibmrta.os390.pax
      
    5. Accédez au répertoire bin de l'installation /usr/lpp/IBM/AgentController/bin, et exécutez le script makelinks en entrant :

      ./createLinks.sh
      
    6. Faites en sorte que les fichiers d'objet partagés d'Agent Controller soient contrôlés en émettant les commandes suivantes dans un shell de services système UNIX :

      extattr +p /usr/lpp/IBM/AgentController/lib/*.so
       
      
      extattr +p /usr/lpp/IBM/AgentController/plugins/com.ibm.rational.pd.probekit/lib/*.so
      
    7. Après avoir installé Agent Controller, accédez au répertoire bin du répertoire de l'installation /usr/lpp/IBM/AgentController/bin et exécutez le script de configuration en entrant :

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

    Utilisation du canal de données sous z/OS :

    Pour définir une taille de canal de données élevée dans le fichier serviceconfig.xml, il peut s'avérer nécessaire d'augmenter la valeur de taille maximale du segment de mémoire partagée sur votre machine. Pour cela, augmentez la valeur IPCSHMMPAGES dans le membre BPXPRMxx parmlib. Cette valeur correspond au nombre maximal de 4K pages pouvant être pris en charge par le canal de données. Par exemple, si vous voulez attribuer la valeur 32M à dataChannelSize, vous devez attribuer une valeur supérieure à 8192 à IPCSHMMPAGES.

    Pour permettre à Agent Controller de communiquer simultanément avec un grand nombre d'agents, vous devez attribuer une valeur appropriée au paramètre IPCSHMNSEGS du membre BPXPRMxx parmlib. Cette valeur définit le nombre maximal des segments de mémoire partagée connectés pour chaque espace d'adresse. La valeur par défaut est 10. Faites passer cette valeur à 50.

    Pour plus d'informations sur les canaux de données utilisés par Agent Controller, reportez-vous à l'aide en ligne du produit.

    Pour plus d'informations sur les membres z/OS BPXPRMXX parmlib et savoir comment les mettre à jour, voir le document IBM z/OS MVS Initialization and Tuning Reference.

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

    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 sous OS/390 (z/OS)


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

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


    Incidents et restrictions connus

    La présente section traite des incidents et restrictions 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 des plateformes non 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 si le port TCP/IP 10002 n'est pas disponible. Agent Controller utilise par défaut ce port d'écoute. Il se peut que ce port soit utilisé par un autre processus en cours sur le système lors du démarrage du composant Agent Controller ou que ce dernier ait été arrêté puis redémarré avant que le port 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. Fermez Rational Application Developer.
    2. Arrêtez tous les processus java.exe qui contiennent l'agent de profilage Java ou J2EE Request Profiler.

    Chapitre 7. Configuration de Rational Application Developer pour une utilisation en environnement coopératif

    Par défaut, un plug-in Rational ClearCase SCM Adapter est installé automatiquement avec Rational Application Developer pour autoriser la prise en charge de Rational ClearCase en tant que système de gestion de configuration logicielle (SCM). Pour plus d'informations sur Rational ClearCase, consultez le site www.ibm.com/software/awdtools/clearcase/.

    Les plug-ins Concurrent Versions System (CVS) sont également installés automatiquement avec Rational Application Developer pour autoriser la prise en charge de CVS en tant que système SCM. La version la plus récente du serveur CVS est disponible sur le site www.cvshome.org. Pour utiliser CVS, il n'est pas nécessaire d'installer un client CVS, un serveur CVS suffit. Pour plus d'informations sur l'installation et l'utilisation de CVS, affichez l'aide en ligne de l'équipe CVS.

    Les plug-ins Rational ClearCase SCM Adapter et CVS doivent être activés pour pouvoir être utilisés. Pour activer les plug-ins :

    1. Dans le menu Rational Application Developer, sélectionnez Fenêtre > Préférences.
    2. Dans la page Préférences, sous Plan de travail, cliquez sur Capacités.
    3. Dans la fenêtre Capacités, faites défiler le contenu d'écran jusqu'à Equipe et cliquez sur la case située en regard des adaptateurs à activer.
    4. Cliquez sur Appliquer, puis sur OK.

    Les plug-ins peuvent également être activés lors du partage d'un projet en sélectionnant le fournisseur de référentiel d'équipe de votre choix.

    Ni le client ou le serveur Rational ClearCase, ni le serveur CVS n'est installé automatiquement. Vous devez les installer séparément à partir de Rational Application Developer.

    Pour plus d'informations sur l'installation du client ClearCase LT, voir "Installation de Rational ClearCase LT".

    Pour utiliser Rational Application Developer avec d'autres systèmes SCM disponibles, vous devez disposer d'un adaptateur spécifique pour le produit SCM. Les adaptateurs SCM sont généralement commercialisés par le fournisseur du produit SCM. IBM n'est pas responsable des autres adaptateurs SCM et ne les garantit pas. Pour obtenir des services d'assistance ou des informations supplémentaires concernant d'autres produits SCM, adressez-vous directement au fournisseur du produit.


    Logiciels pris en charge

    IBM Rational ClearCase

    Rational ClearCase SCM Adapter requiert ClearCase v2002 ou version suivante (Full ClearCase ou ClearCase LT) avec le correctif minimal requis, comme indiqué dans les tableaux suivants :


    Tableau 3. Windows

    Version ClearCase et correctif minimal requis
    IBM Rational ClearCase v2002.05.00 et p2002.05.00.NT-32
    IBM Rational ClearCase LT v2002.05.00 et clearcase_lt_p2002.05.00.NT-11
    IBM Rational ClearCase v2003.06.13
    IBM Rational ClearCase LT v2003.06.13

    Tableau 4. Linux

    Version ClearCase et correctif minimal requis
    IBM Rational ClearCase v2002.05.00 et clearcase_p2002.05.00-38
    IBM Rational ClearCase LTv2002.05.00 et clearcase_lt_p2002.05.00-17
    IBM Rational ClearCase v2003.06.00 et clearcase_p2003.06.00-11
    IBM Rational ClearCase LT v2003.06.00 et clearcase_lt_p2003.06.00-6

    Avertissement: Après avoir installé Rational ClearCase (ou ClearCase LT) et Rational Application Developer, vous devez vérifier que les environnements client et serveur de ClearCase sont mis à jour à l'aide de la version la plus récente du correctif approprié. Les correctifs sont obligatoires pour offrir le support nécessaire pour comparer et fusionner les diagrammes UML (Unified Modeling Language). Si vous ne mettez pas à jour Rational ClearCase (ou ClearCase LT) à l'aide du correctif approprié le plus récent lorsque vous utilisezRational Application Developer, le modèle risque d'être corrompu lors de la comparaison et de la fusion des fichiers de diagramme UML.

    Pour obtenir les éditions et les correctifs Rational ClearCase, accédez au site www.ibm.com/software/awdtools/clearcase/support/index.html ou appelez IBM Rational Support au numéro 1-800-426-7378 (numéro accessible à partir des Etats-Unis).

    IBM Rational ClearQuest

    Rational Application Developer prend en charge la version suivante de Rational ClearQuest :

    Rational ClearQuest est un système de suivi des défauts et des modifications qui organise et automatise les processus mis en oeuvre dans la soumission, l'affectation, le suivi, le test et la publication des demandes de modification. Pour plus d'informations sur Rational ClearQuest, consultez le site www.ibm.com/software/awdtools/clearquest/. Le client Rational ClearQuest pour Eclipse permet d'intégrer ClearQuest de manière transparente à la plateforme Eclipse, y compris Rational Software Development Platform.

    Pour pouvoir utiliser le client Rational ClearQuest pour Eclipse, vous devez d'abord effectuer les opérations ci-dessous.

    Des informations relatives au téléchargement du client Rational ClearQuest pour Eclipse sont disponibles à l'adresse www.ibm.com/support/docview.wss?uid=swg24007802 . Pour obtenir des instructions d'installation complètes, consultez le fichier Readme, disponible à cette même adresse.


    Installation de Rational ClearCase LT

    Téléchargement de Rational ClearCase LT

    Rational ClearCase LT est un outil de gestion de configuration destiné à des équipes de projet de petite taille. ClearCase LT fait partie de la gamme de produits IBM Rational ClearCase qui s'adresse aussi bien à des petits groupes de travail de projet qu'à une entreprise globale distribuée.

    Lors de l'achat d'IBM Rational Software Development Platform, il vous est octroyé une licence Rational ClearCase LT gratuite.

    Si vous ne disposez pas du support ClearCase LT, vous devez télécharger et installer la version prise en charge la plus récente de ClearCase LT.

    Si le support ClearCase LT v2002.05 ou ClearCase LT v2003.06 est déjà installé sur votre système, vous devez télécharger et installer les correctifs ClearCase LT les plus récents pour que ClearCase LT puisse être intégré à IBM Rational Software Development.

    Pour savoir comment vous procurer la version prise en charge la plus récente de ClearCase LT et les correctifs les plus récents requis pris en charge avec IBM Rational Software Development Platform, consultez la note technique numéro 1188585 sur le site de support IBM Rational à l'adresse : www.ibm.com/support/docview.wss?uid=swg21188585. Vous pouvez également vous connecter au site www.ibm.com et entrer 1188585 dans la zone de recherche.

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

    Avant d'installer Rational ClearCase LT, il est conseillé de lire les notes sur l'édition et la documentation d'installation du produit. Ces documents sont disponibles en ligne sur le site IBM Publications Center, à l'adresse www.ibm.com/shop/publications/order. Vous pouvez également consulter le sitewww.ibm.com/software/rational/support/documentation/. Pour ouvrir les fichiers PDF Acrobat, vous devez avoir installé le logiciel Adobe Reader qui peut être téléchargé à partir du site www.adobe.com/products/acrobat/readstep2.html.

    Pour Windows. Téléchargez les notes sur l'édition d'IBM Rational ClearCase LT pour Windows ainsi que les documents Rational Software Desktop Products Installation Guide et Rational Software Server Products Installation Guide pour Windows disponible sur le site IBM Publications Center :

    1. Sélectionnez votre pays/région dans la page d'accueil du centre de publications.
    2. Cliquez sur le lien de recherche de publications. La page de recherche rapide dans le centre de publications s'affiche.
    3. Pour télécharger le document Rational Software Desktop Products Installation Guide pour Windows, Version 2003.06.13 :
      1. Entrez S126-5304-01 dans la zone du numéro de publication puis appuyez sur la touche Entrée.
      2. Sur la page qui s'affiche, choisissez la méthode de téléchargement du document.
    4. Pour télécharger le document Rational Software Server Products Installation Guide pour Windows, Version 2003.06.13 :
      1. Entrez S126-5300-01 dans la zone du numéro de publication puis appuyez sur la touche Entrée.
      2. Sur la page qui s'affiche, choisissez la méthode de téléchargement du document.
    5. Pour télécharger les notes sur l'édition de Rational ClearCase LT pour Windows :
      1. Entrez GI11-4669-03 dans la zone du numéro de publication puis appuyez sur la touche Entrée.
      2. Sur la page qui s'affiche, choisissez la méthode de téléchargement du document.

    Pour Linux. Téléchargez les notes sur l'édition Rational ClearCase LT les plus récentes ainsi que le document Rational ClearCase LT Installation Guide pour Linux disponibles sur le site IBM Publications Center :

    1. Sélectionnez votre pays/région dans la page d'accueil du centre de publications.
    2. Cliquez sur le lien de recherche de publications. La page de recherche rapide dans le centre de publications s'affiche.
    3. Pour télécharger le guide d'installation de ClearCase LT pour la version 2003.06.00 et ultérieure, édition UNIX :
      1. Entrez S126-5310-00 dans la zone du numéro de publication puis appuyez sur la touche Entrée.
      2. Sur la page qui s'affiche, choisissez la méthode de téléchargement du document.
    4. Pour télécharger les notes sur l'édition de Rational ClearCase LT pour UNIX :
      1. Entrez GI11-6232-00 dans la zone du numéro de publication puis appuyez sur la touche Entrée.
      2. Sur la page qui s'affiche, choisissez la méthode de téléchargement du document.

    Installation de Rational ClearCase LT

    Les instructions présentées dans cette section ont pour but de vous aider à installer le code client et serveur de Rational ClearCase LT. Lors de l'installation, reportez-vous aux instructions complètes fournies dans le document Rational ClearCase LT Installation Guide.

    Pour connaître les modifications apportées à la dernière version de Rational ClearCase LT, voir les notes sur l'édition de Rational ClearCase LT. Pour savoir où trouver ces notes sur l'édition pour Windows et Linux, reportez-vous aux instructions présentées plus haut.

    Si vous installez ClearCase LT sur un système japonais, voir la section appropriée dans les Notes sur l'édition de Rational ClearCase LT.

    Installation de Rational ClearCase LT sous Windows

    1. Pour obtenir des informations détaillées sur la préparation de l'installation du produit, voir le document ClearCase LT Desktop Products Installation Guide.
    2. Lancez le programme setup.exe à partir du répertoire racine de l'image d'installation téléchargée.
    3. L'assistant d'installation de Rational s'affiche. Cliquez sur Next pour continuer.
    4. Dans la fenêtre Product Selection, sélectionnez Rational ClearCase LT.
    5. Choisissez une des méthodes de déploiement suivantes pour l'installation et la configuration : Pour en savoir plus sur la sélection d'un type de déploiement, voir le document Desktop Products Installation Guide.
    6. Pour l'option Enterprise deployment :
      1. Suivez les instructions qui s'affichent dans la boîte de dialogue pour terminer le processus de configuration.
      2. Sélectionnez Done une fois la procédure de configuration terminée.
    7. Pour l'option Desktop installation from the CD image :
      1. Indiquez si vous souhaitez installer le logiciel client et serveur ou client uniquement. Cliquez sur Next pour continuer.
      2. L'assistant d'installation s'affiche. Cliquez sur Next pour continuer.
      3. L'écran qui s'affiche alors contient le message suivant :"There are some product-specific warnings for this installation: STOP! Before proceeding with this install, please close all applications and disable anti-virus software." Conformément aux instructions, connectez-vous à l'adresse fournie dans le message d'avertissement (http://ibm.com/support/docview.wss?rs=203&context=SW000&q1=1135295&uid=swg21135295 ) avant de continuer le processus d'installation. Lisez le document et suivez toutes les étapes requises pour éviter toute corruption possible du système avant de poursuivre l'installation. Cliquez sur Suivant pour continuer.
    8. Suivez les instructions qui s'affichent à l'écran pour terminer la configuration. Par défaut, Rational ClearCase LT est installé dans le répertoire unité_système:\Program Files\Rational\. Sélectionnez Done une fois la procédure de configuration terminée.
    9. Sélectionnez Install pour commencer l'installation.

    Installation de Rational ClearCase LT sous Linux

    ClearCase LT ne prend pas actuellement en charge les environnements locaux Unicode. Il convient donc de définir un environnement local non Unicode pour que ClearCase LT puisse fonctionner correctement. Par défaut, Red Hat Enterprise Linux 3.0 et SuSE Linux Enterprise Server (SLES) version 9 définissent un environnement local Unicode, en_US.UTF-8 pour les installations US, mais également pour certaines installations internationales. Si vous exécutez ClearCase sur une de ces plateformes, vous pouvez modifier le paramètre d'environnement local de la manière suivante :

    Pour installer Rational ClearCase LT Version 2003.06.00 sous Linux :

    1. Connectez-vous en tant qu'utilisateur root en entrant : su
    2. A partir du répertoire dans lequel vous avez téléchargé Rational ClearCase LT, extrayez le contenu du fichier de téléchargement de ClearCase LT dans une zone de publication en procédant comme suit :
      1. Entrez la commande mkdir /usr/ccase_lt_rls pour créer le répertoire de la zone de publication. Les instructions qui suivent supposent que vous utilisez /usr/ccase_lt_rls comme répertoire de publication. Si vous avez indiqué un nom différent, utilisez-le à la place de /usr/ccase_lt_rls.
      2. Exécutez la commande uncompress <nomfichier_cclt.Z><nomfichier_cclt.Z> correspond au nom du fichier tar de téléchargement de ClearCase LT. Le fichier en résultant a l'extension .tar et non .tar.Z. Par exemple, si le fichier s'appelle C54UANA.tar.Z, la commande uncompress C54UANA.tar.Z génère un fichier nommé C54UANA.tar.
      3. Développez le fichier tar dans le répertoire de la zone de publication en entrant la commande tar xvf <nomfichier_cclt> -C /usr/ccase_lt_rls<nomfichier_cclt> correspond au nom du fichier tar ClearCase non compressé.
      Remarque :
      Les fichiers extraits incluent la documentation du produit. Avant de continuer le processus d'installation, voir les Notes sur l'édition et le guide d'installation de ClearCase LT.
      Pour savoir à quoi sert une zone de publication, voir le guide d'installation de ClearCase LT.
    3. Préparez votre zone de publication en exécutant la commande site_prep et procédez comme suit :
      cd /usr/ccase_lt_rls/rational_clearcase_lt/rhat_x86/clearcase/install
      ./site_prep

    4. A chaque invite, entrez des valeurs correspondant à la configuration requise. Lorsque vous êtes invité à entrer l'hôte de licence ClearCase, indiquez le nom d'hôte de votre machine. Pour plus d'informations sur l'exécution de site_prep, reportez-vous au guide d'installation de Rational ClearCase LT.
    5. Installez ClearCase en exécutant install_release et en suivant les instructions ci-après.
      ./install_release
      A chaque invite, entrez des valeurs correspondant à la configuration requise. Vous trouverez ci-dessous un exemple d'installation de ClearCase sous SuSE Linux Enterprise Server (SLES) Version 9.
      1. Choisissez "Local install."
      2. Acceptez l'accord de licence.
      3. Choisissez "Standard install"
      4. Choisissez l'installation de ClearCase LT Client.
      5. Lorsque le programme install_release se termine, un message doit s'afficher indiquant que l'exécution du programme est terminée et qu'aucune erreur n'est survenue. Le message indique également l'emplacement et le nom du fichier journal.
      Pour plus d'informations sur l'exécution d'install_release, reportez-vous au guide d'installation de Rational ClearCase LT.
    6. Ajoutez l'exécutable ClearCase à votre chemin de recherche.

      Par exemple, si vous utilisez un shell Bourne, vous pouvez lancer la commande suivante pour modifier votre chemin :
      PATH=${PATH}:/opt/rational/clearcase/bin
      export PATH

      Pour obtenir des instructions détaillées et des informations supplémentaires sur la personnalisation de l'environnement de l'hôte client ClearCase LT, voir le document Installation Guide .

    7. Si vous n'avez pas encore installé Rational Application Developer, faites-le maintenant.
    8. Pour vérifier que ClearCase a été installé correctement, exécutez la commande suivante à partir d'un ID utilisateur différent de root. Si la commande aboutit, l'hôte est capable d'acquérir une licence ClearCase LT. Si un message d'erreur est renvoyé, consultez la documentation de ClearCase LT.
      cleartool hostinfo -long
    9. Démarrez la plateforme Rational Development et assurez-vous que vous pouvez vous connecter à ClearCase.
    Remarque :
    Par défaut, la zone de publication est l'emplacement où se trouvent les fichiers d'installation extraits, parmi lesquels figurent les fichiers du programme de désinstallation. Si vous supprimez ce répertoire, vous ne pourrez plus exécuter le programme de désinstallation.

    Configuration de la licence de Rational ClearCase LT

    Si Rational Application Developer est installé sur le même poste que Rational ClearCase LT, il n'est pas nécessaire de configurer la licence de Rational ClearCase LT. Toutefois, si vous installez Rational ClearCase LT sans Rational Application Developer, il vous faudra configurer la licence de ClearCase LT. Pour obtenir des informations détaillées sur la configuration de la licence, voir le guide d'installation de ClearCase LT.

    La licence de Rational ClearCase LT fournie avec Rational Application Developer ne comprend pas de licence pour l'interface Web de Rational ClearCase. Si vous souhaitez utiliser l'interface Web de Rational ClearCase, vous devez vous procurer des licences Rational ClearCase ou ClearCase LT supplémentaires auprès d'IBM Rational Software. Pour plus d'informations sur l'obtention des licences, contactez le support IBM Rational au numéro 1-800-426-7378 (Etats-Unis).


    Utilisation de Rational ClearCase avec Rational Application Developer

    Pour plus d'informations sur l'utilisation de Rational ClearCase, voir l'aide en ligne de ClearCase.


    Correction des types d'élément de diagramme pré-existants

    Si les fichiers de diagramme ont été archivés dans les VOB (Versioned Object Bases) de votre environnement ClearCase avant l'application des correctifs ou la configuration de l'environnement comme indiqué ci-dessus, exécutez la commande suivante pour modifier le type de fichier des éléments VOB afin de permettre leur fusion :

    cleartool find . -name *.emx -exec "cleartool chtype -force xtools2 %CLEARCASE_PN%"
    

    Désinstallation de Rational ClearCase LT

    Pour Windows. Pour désinstaller Rational ClearCase LT sous Windows :

    1. Fermez Rational Application Developer.
    2. Ouvrez le panneau de configuration, puis affichez la fenêtre Ajouter ou supprimer des programmes. Sélectionnez Rational ClearCase LT et cliquez sur Modifier/Supprimer pour effectuer la désinstallation.
    3. Pour désinstaller le produit, suivez les instructions de l'assistant.

    Pour Linux. Pour désinstaller Rational ClearCase LT sous Linux :

    1. Connectez-vous en tant qu'utilisateur root en entrant : su
    2. Exécutez install_release à partir du répertoire de la zone de publication. Par exemple, si la zone de publication se trouve dans le répertoire /usr/ccase_lt_rls, entrez :
       cd /usr/ccase_lt_rls/rhat_x86/clearcase/install
      ./install_release
      
    3. Sélectionnez l'option de désinstallation locale pour supprimer le logiciel de l'ordinateur local.

    Chapitre 8. Installation de WebSphere Application Server 5.x en tant qu'environnement de test intégré

    Par défaut, WebSphere Application Server 6.0 est installé automatiquement avec Rational Application Developer. Si vous envisagez de développer des applications qui seront exécutées sur des serveurs d'applications 5.x, vous pouvez, en option, installer des environnements de test d'exécution supplémentaires.

    Pour pouvoir installer les environnement de test d'exécution supplémentaires, vous devez avoir déjà installé Rational Application Developer.

    Les environnements de test intégrés que vous pouvez installer sont les suivants :

    Pour installer un ou plusieurs environnements de test intégrés de niveau antérieur, procédez comme indiqué ci-dessous.

    1. A partir du programme de lancement Rational Application Developer, cliquez sur Installation de l'environnement de test WebSphere V5.x. Le programme d'installation des environnements de test intégrés IBM Rational 5.x s'affiche.
    2. Cliquez sur Suivant.
    3. Acceptez les termes du contrat de licence et cliquez sur Suivant.
    4. Sélectionnez les environnements de test intégrés à installer. Cliquez sur Suivant.
    5. Consultez les informations récapitulatives et cliquez sur Suivant pour procéder à l'installation. Ce résumé d'installation indiquera l'emplacement où sont installés les environnements de test.
    6. Cliquez sur Terminer pour quitter le programme d'installation une fois le processus terminé.
    Remarque :
    Si vous installez la fonction de support de messagerie intégrée et de mise en file d'attente, les environnements de test WebSphere version 5.x ne doivent pas être désinstallés avant que cette fonction ne soit désinstallée.



    Pour désinstaller les environnements de test de la version 5.x sous Windows, procédez comme suit.

    1. Ouvrez le panneau de configuration.
    2. Cliquez sur Ajout/Suppression de programmes.
    3. Cliquez sur Anciens environnements de test intégrés 5.x IBM Rational, puis sur Modifier/Supprimer.
    4. Le programme de désinstallation des environnements de test IBM Rational 5.x s'affiche. Cliquez sur Suivant.
    5. Sélectionnez les environnements de test à désinstaller et cliquez sur Suivant.
    6. Consultez les informations récapitulatives et cliquez sur Suivant.
    7. Cliquez sur Terminer pour quitter le programme de désinstallation une fois que les environnements de test ont été désinstallés.


    Pour Linux
    Pour désinstaller les anciens environnements de test sous Linux, procédez comme indiqué ci-dessous.

    1. Connectez-vous en tant qu'utilisateur root.
    2. Accédez au sous-répertoire lte_prod/_uninst du répertoire d'installation.
    3. Désinstallez les environnements de test de la version 5.x en entrant cette commande : ./uninstall.bin. Si vous utilisez un gestionnaire de fichiers, vous pouvez cliquer sur le fichier pour lancer le programme de désinstallation.
    4. Le programme de désinstallation des environnements de test IBM Rational 5.x s'affiche. Cliquez sur Suivant.
    5. Sélectionnez les environnements de test à désinstaller et cliquez sur Suivant.
    6. Consultez les informations récapitulatives et cliquez sur Suivant.
    7. Cliquez sur Terminer pour quitter le programme de désinstallation une fois que les environnements de test ont été désinstallés.

    Chapitre 9. Installation du support de messagerie et de mise en file d'attente pour les environnements de testWebSphere version 5.x

    Important : Vous devez installer conjointement Rational Application Developer et les environnements de test WebSphere version 5.x avant d'installer la fonction de support de messagerie et de mise en file d'attente.

    Il n'est pas nécessaire d'installer cette fonction si au moins une des conditions suivantes est vérifiée :

    Si vous souhaitez tester des applications JMS dans les environnements de test WebSphere version 5.x (environnements de test d'unité livrés avec Rational Application Developer) en utilisant la fonction de messagerie intégrée, vous devez installer cette dernière (elle est livrée avec le produit). Cette fonction de messagerie intégrée est la même que celle fournie avec IBM WebSphere Application Server V5.x. Il vous suffit d'installer la fonction de messagerie intégrée à partir de Rational Application Developer ou de WebSphere Application Server V5.x. Si vous installez les deux versions, la deuxième version installée remplace la première.

    Vous devez disposer d'au moins 200 Mo pour installer la fonction de messagerie et de mise en file d'attente.


    Installation et désinstallation du support de messagerie et de mise en file d'attente sous Windows

    Lorsque vous installez le support de messagerie et de mise en file d'attente à partir du CD-ROM d'installation de Rational Application Developer, WebSphere MQ et WebSphere Messaging Publish and Subscribe sont installés.

    Restrictions :

    Même si le support de messagerie et de mise en file d'attente n'a pas été installé, un message indiquant que seul le client de messagerie intégrée a été installé peut s'afficher lors du démarrage du serveur. Ce message concerne le code client intégré du simulateur MQ pour développeurs Java et non le support de messagerie et de mise en file d'attente. Ce message peut être ignoré sans risque.

    Installation à partir d'un CD-ROM

    Pour installer la fonction de messagerie intégrée destinée aux environnements de test WebSphere version 5.x :

    1. Arrêtez Rational Application Developer, s'il est démarré.
    2. Insérez le CD-ROM d'installation de Rational Application Developer dans l'unité.
    3. Si l'exécution automatique est désactivée sur votre système, lancez launchpad.exe à partir du répertoire racine du CD-ROM d'installation.
    4. Sélectionnez l'option d'installation d'un serveur et d'un client de messagerie intégrée à partir de la fenêtre de lancement de l'installation et suivez les instructions qui s'affichent à l'écran. L'installation n'aboutit pas si aucun environnement d'exécution de test version 5.x n'a été installé.

      Le répertoire d'installation cible par défaut est unité_système:\Program Files\IBM\WebSphere MQ\ (où unité_système correspond au disque dur sur lequel Windows est installé).

    5. Lorsque le support de messagerie et de mise en file d'attente est installé, cliquez sur Terminer pour fermer la fenêtre d'installation.
    6. Pour vérifier si une installation a abouti, procédez comme indiqué ci-après.

    Exécution d'une installation en mode silencieux

    Pour installer la fonction de messagerie intégrée en mode silencieux, procédez comme suit :

    1. Arrêtez Rational Application Developer, s'il est démarré.
    2. Insérez le CD-ROM d'installation du client de messagerie intégrée dans l'unité.
    3. A partir du répertoire IBM_Embedded_MQ du CD-ROM d'installation du support de messagerie et de mise en file d'attente, entrez la commande suivante sur la ligne de commande :
      java -cp setup.jar -Dis.media.home="<cd_rom>\IBM_Embedded_MQ\setup"
       -Dis.external.home="<cd_rom>\IBM_Embedded_MQ" run -silent
      

      cd_rom correspond à la lettre de l'unité du CD-ROM. Appuyez sur la touche Entrée.

      Remarque :
      Lorsque vous installez le support de messagerie et de mise en file d'attente pour Windows en mode silencieux, le programme d'installation ne vous signale pas quand l'installation est terminée. Pour qu'il n'en soit plus ainsi, entrez l'une des commandes suivantes sur la ligne de commande :
       répinstall_RA\runtimes\base_v5\java\bin\java -cp setup.jar 
      

      ou

       répinstall_RA\runtimes\base_v51\java\bin\java -cp setup.jar 
      

      répinstall_RA est le répertoire d'installation de Rational Application Developer

    4. Pour vérifier si une installation a abouti, procédez comme indiqué ci-après.

    Désinstallation du support de messagerie et de mise en file d'attente

    Restriction : Les environnements de test WebSphere version 5.x doivent être présents et ne doivent pas être désinstallés avant que la fonction de messagerie intégrée et de mise en file d'attente soit désinstallée. La désinstallation de la fonction de mise en file d'attente et de messagerie intégrée supprime l'ensemble des données utilisateur MQ.

    Pour désinstaller la fonction de messagerie intégrée, procédez comme suit :

    1. Arrêtez Rational Application Developer, s'il est démarré.
    2. A partir de la fenêtre d'ajout/suppression de programmes, sélectionnez Serveur et client de messagerie intégrée et cliquez ensuite sur Supprimer.
    3. Suivez les instructions à l'écran pour supprimer la fonction de messagerie intégrée.

    Installation et désinstallation du support de messagerie et de mise en file d'attente sous Linux

    Lorsque vous installez le support de messagerie et de mise en file d'attente à partir du CD-ROM d'installation de Rational Application Developer, WebSphere MQ et WebSphere Messaging Publish and Subscribe sont installés.

    Restrictions :

    Même si le support de messagerie et de mise en file d'attente n'a pas été installé, un message indiquant que seul le client de messagerie intégrée a été installé peut s'afficher lors du démarrage du serveur. Ce message concerne le code client intégré du simulateur MQ pour développeurs Java et non le support de messagerie et de mise en file d'attente. Ce message peut être ignoré sans risque.

    Installation du support de messagerie et de mise en file d'attente

    Si vous installez le support de messagerie et de mise en file d'attente sur votre machine pour la première fois, configurez les groupes d'utilisateurs en suivant les instructions de la section suivante.

    Configuration des groupes d'utilisateurs

    Avant d'installer le support de messagerie et de mise en file d'attente pour la première fois, vous devez créer deux groupes d'utilisateurs (mqm et mqbrkrs), ajouter l'utilisateur par défaut à chaque groupe puis ajouter l'utilisateur root à chaque groupe :

    1. Connectez-vous en tant qu'utilisateur root.
    2. Dans une fenêtre de terminal, entrez la commande suivante afin de créer le groupe d'utilisateurs mqm :
      groupadd mqm
      
    3. Créez le groupe d'utilisateurs mqbrkrs :
      groupadd mqbrkrs
      
    4. Créez un ID utilisateur mqm avec le groupe par défaut mqm :
      useradd mqm -g mqm
      
    5. Créez un ID utilisateur mqbrkrs avec le groupe par défaut mqbrkrs :
      useradd mqbrkrs -g mqbrkrs
      
    6. Ajoutez l'utilisateur root et les utilisateurs non root qui vont exécuter des applications JMS aux groupes d'utilisateurs mqm et mqbrkrs :
      1. Editez le fichier /etc/group.
      2. Recherchez la ligne de groupe mqm. (Par exemple, mqm:x:101:mqm). Cette ligne peut être légèrement différente dans le fichier etc/group. Modifiez cette ligne en ajoutant une extension 'root'. Dans exemple, vous auriez mqm:x:101:mqm,root.
      3. Recherchez la ligne de groupe mqbrkrs. Par exemple, mqbrkrs:x:102:mqm. Cette ligne peut être légèrement différente dans le fichier etc/group. Modifiez cette ligne en ajoutant une extension 'root'. Dans cet exemple, vous auriez mqbrkrs:x:102:mqm,root.
      4. Fermez le fichier et sauvegardez les modifications.
      5. Déconnectez-vous.

    Installation de la fonction de messagerie intégrée

    Pour installer la fonction de messagerie intégrée, procédez comme suit :

    1. Connectez-vous en tant qu'utilisateur root.
    2. Arrêtez Rational Application Developer, s'il est démarré.
    3. Insérez le CD-ROM d'installation de Rational Application Developer dans l'unité.
    4. Si le CD-ROM n'est pas monté, tapez :
      mount unité_CD
      

      unité_CD est par défaut /cdrom sous SuSE et /mnt/cdrom sous Red Hat.

    5. Pour afficher le programme de lancement de l'installation, entrez :
      unité_CD/launchpad.bin
      
    6. Sélectionnez l'option d'installation d'un serveur et d'un client de messagerie intégrée.
    7. Vous serez invité à insérer dans l'unité le CD-ROM d'installation de Rational Application Developer pour le client et le serveur de messagerie intégrée.
    8. Suivez les instructions à l'écran. Le répertoire d'installation cible par défaut est /opt/IBM/WebSphereMQ.
    9. Lorsque le support de messagerie et de mise en file d'attente est installé, cliquez sur Terminer pour fermer la fenêtre d'installation.
    10. Pour vérifier si une installation a abouti, procédez comme indiqué ci-après.

    Exécution d'une installation en mode silencieux

    Pour installer la fonction de messagerie intégrée en mode silencieux, procédez comme suit :

    1. Arrêtez Rational Application Developer, s'il est démarré.
    2. Si vous installez pour la première fois le support de messagerie et de mise en file d'attente destiné aux environnements de test, suivez la procédure décrite dans "Configuration des groupes d'utilisateurs".
    3. Insérez le CD-ROM d'installation de Rational Application Developer dans l'unité.
    4. A partir du répertoire IBM_Embedded_MQ du CD-ROM d'installation du client de messagerie intégrée, entrez la commande suivante sur une seule ligne :
      ./setup.bin -silent 
      
    5. Pour vérifier si une installation a abouti, procédez comme indiqué ci-après.

    Désinstallation du support de messagerie et de mise en file d'attente

    Restriction : Les environnements de test WebSphere version 5.x doivent être présents et ne doivent pas être désinstallés avant que la fonction de messagerie intégrée et de mise en file d'attente soit désinstallée. La désinstallation de la fonction de mise en file d'attente et de messagerie intégrée supprime l'ensemble des données utilisateur MQ.

    Pour désinstaller la fonction de messagerie et de mise en file d'attente, procédez comme suit :

    1. Connectez-vous en tant qu'utilisateur root.
    2. Accédez au répertoire d'installation (par exemple, /opt/IBM/WebSphereMQ).
    3. Entrez :
      ./_uninst/uninstaller.bin
      

    Si la désinstallation du support de mise en file d'attente et de messagerie n'aboutit pas, consultez le fichier journal (/tmp/EmbeddedMQ.log).


    Chapitre 10. Installation de l'environnement de test WebSphere Portal version 5.0

    L'environnement de test WebSphere Portal permet de tester des applications de portail à partir du plan de travail. Il est disponible sous Windows uniquement.

    Le matériel suivant doit être installé avant d'installer l'environnement de test WebSphere Portal :

    Les autres éléments requis sont identiques à ceux indiqués précédemment pour Rational Application Developer.

    Pour installer l'environnement de test Portal, suivez la procédure ci-dessous.

    1. Si vous avez installé un environnement de test intégré WebSphere Application Server, WebSphere Portal ou WebSphere Application Server, vérifiez qu'ils sont arrêtés, tout comme les serveurs HTTP. Sinon, l'installation risque d'échouer.
    2. A partir du programme de lancement de l'installation de Rational Application Developer, cliquez sur Installation de l'environnement de test WebSphere Portal V5.0. Le programme d'installation correspondant s'affiche.
    3. Cliquez sur Suivant.
    4. Acceptez les termes du contrat de licence et cliquez sur Suivant.
    5. L'environnement de test Portal est installé automatiquement dans le répertoire d'installation de Rational Application Developer. Cliquez sur Suivant.
    6. Cliquez sur Terminer pour quitter l'assistant une fois que l'installation de l'environnement de test Portal est terminée.

    Utilisation de la base de données DB2 ou Oracle en tant que référentiel de configuration de WebSphere Portal

    Par défaut, l'environnement de test WebSphere Portal V5.0 installe et utilise la base de données Cloudscape pour stocker des informations sur l'identité des utilisateurs, les justificatifs et les droits d'accès aux ressources du portail. Cloudscape est une base de données Java intégrée à WebSphere Portal, parfaitement adaptée aux environnements Portal de base.

    Pour installer et configurer une base de données DB2 ou Oracle, voir l'InfoCenter de WebSphere Portal Version 5.0.2 à l'adresse www.ibm.com/websphere/portal/library. Les instructions à suivre sont fournies dans l'InfoCenter de WebSphere Portal version 5.0.2, sous Installation > Base de données. Avant de procéder à la configuration de WebSphere Portal avec DB2 ou Oracle, vous devez accéder au sous-répertoire \runtimes\portal_base_v5\config du répertoire d'installation de Rational Application Developer et lancer la commande suivante :

     WPSconfig.bat wpcpconfigure
    

    Lorsqu'il est fait référence aux instructions de configuration présentées dans l'InfoCenter, <wp_root> correspond au sous-répertoire \runtimes\portal_v50 du répertoire d'installation de Rational Application Developer, et <was_root> correspond au sous-répertoire \runtimes\portal_base_v5 du répertoire d'installation de Rational Application Developer. Pour vérifier la connexion à la base de données, vous devez créer l'environnement de test WebSphere Portal 5.0 et démarrer le serveur au lieu de suivre la procédure décrite dans l'InfoCenter.

    Désinstallation de l'environnement de test WebSphere Portal 5.0

    Pour effectuer la désinstallation, suivez la procédure ci-dessous.

    1. Ouvrez le Panneau de configuration.
    2. Cliquez sur Ajout/Suppression de programmes.
    3. Sélectionnez Environnement de test WebSphere Portal V5.0 et cliquez sur le bouton Modifier/Supprimer.
    4. Suivez les instructions à l'écran pour désinstaller l'environnement de test Portal.

    Il arrive parfois, lorsqu'une installation est abandonnée par exemple, que le programme d'installation n'aboutisse pas ou ne fonctionne pas correctement. Il convient alors de terminer l'installation manuellement en procédant comme suit :

    1. Appelez regedit.exe à partir d'une invite de commande afin d'éditer le registre système de Windows.

      Le registre doit être manipulé avec précaution : Il est facile de commettre des erreurs en utilisant l'éditeur regedit.exe pour visualiser ou modifier le contenu du registre. Cet éditeur ne signale pas les erreurs d'édition, ce qui peut avoir des conséquences graves. Toute corruption du registre peut entraîner des dommages système si importants qu'il peut s'avérer nécessaire de réinstaller le système d'exploitation Windows.

      1. Développez et sélectionnez la clé HKEY_LOCAL_MACHINE\SOFTWARE\IBM\WebSphere Portal Server\5.0.0.0.
      2. Cliquez sur Editer > Supprimer à partir de la barre de menus pour supprimer la clé.
      3. Cliquez sur Oui pour confirmer la suppression.
      4. Lorsque vous avez terminé, cliquez sur Registre > Quitter à partir de la barre de menus.
    2. Supprimez les répertoires suivants, sous-répertoires compris, à partir de <répinstall_rational>\runtimes :
      1. portal_base_v5
      2. portal_v50

      <répinstall_rational> est le répertoire d'installation de Rational Application Developer.


    Chapitre 11. Installation de l'environnement de test WebSphere Portal version 5.1

    L'environnement de test Portail permet de tester les applications de portail à partir du plan de travail. La version 5.1 fournit des fonctionnalités supplémentaires par rapport à la version 5.0 et elle est prise en charge dans tous les environnements Windows compatibles avec Rational Application Developer. Elle est également prise en charge sous Red Hat Enterprise Linux Workstation, Version 3.0.

    Remarque :
    WebSphere Application Server 5.1 est installé automatiquement avec l'environnement de test WebSphere Portal version 5.1.

    Le matériel suivant doit être installé avant d'installer l'environnement de test WebSphere Portal :

    Les autres éléments requis sont identiques à ceux indiqués précédemment pour Rational Application Developer.

    Installation à partir du CD-ROM

    Pour pouvoir installer l'environnement de test Portal, vous devez avoir déjà installé Rational Application Developer. Il est conseillé d'arrêter Rational Application Developer avant de démarrer l'installation de l'environnement de test Portal.

    Pour installer l'environnement de test WebSphere Portal 5.1, suivez la procédure ci-dessous.

    1. Si vous avez installé un environnement de test intégré WebSphere Application Server, WebSphere Portal ou WebSphere Application Server, vérifiez qu'ils sont arrêtés, tout comme les serveurs HTTP. Sinon, l'installation risque d'échouer.
    2. Insérez le CD-ROM d'installation de WebSphere Portal 5.1 dans l'unité. (L'environnement de test Portal ne peut pas être installé à partir du programme de lancement d'installation principal de Rational Application Developer.)
    3. Sous Windows, le programme d'installation doit être lancé automatiquement. Si ce n'est pas le cas, exécutez le fichier install.bat à partir du répertoire racine du CD-ROM d'installation. Sur les systèmes Linux, exécutez install.sh à partir de la racine du CD d'installation.
    4. Sélectionnez la langue choisie pour l'exécution du programme d'installation et cliquez sur OK pour continuer.
    5. Lisez les informations présentées dans la page de bienvenue du programme d'installation et cliquez sur Suivant.
    6. Acceptez les termes du contrat de licence et cliquez sur Suivant.
    7. Cliquez sur le bouton d'option Environnement de test, puis sur Suivant.
      Remarque :
      Selon la plateforme utilisée, vous pouvez recevoir un message d'erreur indiquant que la vérification des éléments prérequis par le système d'exploitation a échoué. En effet, certains systèmes d'exploitation (Red Hat Enterprise Linux Workstation Version 3.0, par exemple) sont pris en charge uniquement dans l'environnement de test Portal. Vous pouvez ignorer ce message en toute sécurité ; cliquez sur OK pour continuer l'installation.
    8. Acceptez le répertoire d'installation par défaut pour WebSphere Application Server V5.1 ou sélectionnez un autre répertoire dans l'arborescence et cliquez sur Suivant. Le répertoire d'installation par défaut est C:\Program Files\Portal51UTE\AppServer pour Windows et opt/Portal51UTE/AppServer pour Linux. Il est recommandé d'utiliser le répertoire d'installation par défaut, sauf si l'espace disque est insuffisant.
    9. Acceptez le répertoire d'installation par défaut pour l'environnement de test Portal ou sélectionnez un autre répertoire dans l'arborescence et cliquez sur Suivant. Le répertoire d'installation par défaut est C:\Program Files\Portal51UTE\PortalServer pour Windows et opt/Portal51UTE/PortalServer pour Linux. Il est recommandé d'utiliser le répertoire d'installation par défaut, sauf si l'espace disque est insuffisant.
    10. Spécifiez l'ID utilisateur et le mot de passe à utiliser avec l'environnement de test Portal. Cliquez sur Suivant.
    11. Consultez les informations fournies dans la fenêtre récapitulative et cliquez sur Suivant.
    12. A l'invite du système, insérez le CD-ROM WebSphere Portal 5.1 approprié dans l'unité et indiquez l'emplacement de l'unité.
    13. Une fois l'installation terminée, cliquez sur Terminer pour fermer le programme d'installation.

    Remarques :

    Pour savoir comment configurer l'environnement de test Portal 5.1 pour pouvoir l'utiliser avec Rational Application Developer, voir le fichier d'aide en ligne "Configuration de l'environnement de test WebSphere Portal V5.1".

    Installation à partir des images électroniques

    Pour faciliter l'installation du logiciel, créez le répertoire approprié, téléchargez ensuite les fichiers et extrayez leur contenu dans ce répertoire.

    Remarque :
    Vous devez télécharger, extraire et exécuter les images sur la plateforme prise en charge. Par exemple, si le titre d'une image mentionne le système d'exploitation Windows, vous pouvez télécharger, extraire et exécuter cette image sur un système Windows uniquement.

    Les images du CD-ROM suivantes sont requises pour l'environnement de test WebSphere Portal version 5.1 :

    Pour créer les répertoires appropriés et télécharger les fichiers, procédez comme suit :

    1. Créez un répertoire pour chaque image à télécharger.

      Créez des répertoires dans un répertoire commun sur la même machine et nommez ces répertoires en fonction de l'identifiant du disque correspondant fourni dans le titre, précédé par les caractères cd. Par exemple, cdSetup, cd1-1, cd1-2, etc.

    2. Téléchargez chaque image et extrayez leur contenu.

      Téléchargez chaque image dans son propre répertoire. La procédure à suivre pour télécharger et extraire une image spécifique est décrite ci-dessous. L'image suivante est utilisée à titre d'exemple dans la procédure :
      WebSphere Portal V5.1 - Setup Manager for Windows and Linux (Setup) for Brazilian Portuguese, French, German, International English, Italian, Japanese, Korean, Simplified Chinese, Spanish, Traditional Chinese


      Nom du fichier : C7003ML.zip

      Pour télécharger et extraire le contenu de cette image, procédez comme suit :

      1. Créez un répertoire appelé cdSetup.
      2. Téléchargez le fichier C7003ML.zip dans le répertoire cdSetup.
      3. Décompressez les fichiers du fichier C7003ML.zip dans le répertoire cdSetup.
    3. Pour installer les images extraites, voir "Installation à partir du CD-ROM", présenté plus haut.

    Utilisation de la base de données DB2 ou Oracle en tant que référentiel de configuration de WebSphere Portal

    Par défaut, l'environnement de test WebSphere Portal V5.1 installe et utilise la base de données Cloudscape pour stocker des informations sur l'identité des utilisateurs, les justificatifs et les droits d'accès aux ressources du portail. Cloudscape est une base de données Java intégrée à WebSphere Portal, parfaitement adaptée aux environnements Portal de base.

    Pour installer et configurer une base de données DB2 ou Oracle, voir l'InfoCenter de WebSphere Portal V5.1 à l'adresse www.ibm.com/websphere/portal/library. Les instructions à suivre sont disponibles dans l'InfoCenter de WebSphere Portal version 5.1, sous Configuration > Base de données. Lorsqu'il est fait référence aux instructions de configuration présentées dans l'InfoCenter, <wp_root> correspond au répertoire d'installation de l'environnement de test WebSphere Portal 5.1, et <was_root> correspond au répertoire d'installation de WebSphere Application Server V5.1 (voir plus haut pour connaître les emplacements par défaut). De plus, pour vérifier la connexion à la base de données, vous devez créer l'environnement de test WebSphere Portal 5.1 et démarrer le serveur au lieu de suivre la procédure décrite dans l'InfoCenter.

    Configuration de l'environnement de test WebSphere Portal version 5.1

    Vous devez configurer l'environnement de test Portal 5.1 pour pouvoir l'utiliser avec Rational Application Developer. Pour cela, procédez comme suit :

    1. Démarrez Rational Application Developer.
    2. A partir de la barre de menus, sélectionnez Fenêtre > Préférences > Serveur > Environnements d'exécution installés. La page Environnements d'exécution du serveur installés s'affiche.
    3. Sélectionnez le module de remplacement WebSphere Portal v5.1 et cliquez sur Editer. La page Edition de l'environnement d'exécution du serveur s'affiche.
    4. Changez son nom en WebSphere Portal v5.1 et spécifiez l'emplacement de WebSphere Portal et de WebSphere Application Server. (Par exemple, C:\Program Files\Portal51UTE\PortalServer et C:\Program Files\Portal51UTE\AppServer respectivement).
    5. Cliquez sur Terminer, puis sur OK.

    Désinstallation de l'environnement de test Portal V5.1

    Pour désinstaller l'environnement de test Portal, suivez la procédure ci-dessous

    1. Accédez au répertoire dans lequel vous avez installé l'environnement de test Portal.
    2. Accédez au sous-répertoire PortalServer\uninstall et exécutez l'application de désinstallation.
    3. Suivez les instructions à l'écran.

    Il arrive parfois, lorsqu'une installation est abandonnée par exemple, que le programme d'installation n'aboutisse pas ou ne fonctionne pas correctement. Il convient alors de terminer la désinstallation manuellement. Pour obtenir des informations détaillées sur la désinstallation manuelle de l'environnement de test WebSphere Portal version 5.1, voir l'InfoCenter de l'environnement de test WebSphere Portal V5.1.


    Chapitre 12. Installation de Crystal Enterprise

    Crystal Enterprise est une architecture commune pour l'accès aux données, la création de rapports et la diffusion de l'information. Elle est conçue pour s'intégrer en toute transparence à vos données, solutions Web et applications existantes. Fondée sur Crystal Reports, Crystal Enterprise est une solution performante pour la diffusion de l'information auprès de plusieurs milliers d'utilisateurs.

    Crystal Enterprise Embedded Edition inclut un serveur de création de rapports à la demande pour les applications Web et constitue une solution idéale pour l'intégration de rapports dans une application unique à l'échelle d'un service. Elle est disponible pour Windows uniquement.

    Crystal Enterprise Professional Edition est une plateforme centralisée pour la gestion et la diffusion sécurisée de rapports complexes et interactifs via le Web ou intégrés par le biais de l'intranet, de l'extranet, d'Internet et d'applications de portail d'entreprise. La version Professional Edition inclut toutes les fonctionnalités de la version Embedded Edition et elle est disponible à la fois pour Windows et Linux.

    Pour une comparaison plus détaillée de Crystal Enterprise Embedded et Professional Editions, voir www.businessobjects.com/global/pdf/products/reporting/crystalenterprise/ce10_editions.pdf. (Pour ouvrir les fichiers PDF Acrobat, vous devez avoir installé le logiciel Adobe Reader qui peut être téléchargé à partir du site www.adobe.com/products/acrobat/readstep2.html.) Pour plus d'informations sur Crystal Enterprise en général, voir www.businessobjects.com/products/reporting/crystalenterprise/default.asp.

    En tant que suite intégrée pour la création de rapports, l'analyse et la diffusion de l'information, Crystal Enterprise fournit une solution permettant d'augmenter la productivité de l'utilisateur final et d'alléger les tâches d'administration.

    Installation de Crystal Enterprise V10 Embedded Edition

    Pour installer Crystal Enterprise V10 Embedded Edition, suivez la procédure ci-dessous.

    1. Insérez le disque Crystal Enterprise V10 Embedded Edition dans l'unité.
    2. A partir du programme de lancement de l'installation de Rational Application Developer, cliquez sur Install Crystal Enterprise V10 Embedded Edition. Le programme d'installation de Crystal Enterprise s'affiche.
    3. Cliquez sur Next. Acceptez les termes du contrat de licence et cliquez à nouveau sur Next.
    4. Vous pouvez sélectionner une installation complète (Full) ou personnalisée (Custom).
      1. L'installation par défaut est complète. Cette option est recommandée et permet d'installer tous les composants par défaut à l'emplacement suivant : C:\Program Files\Crystal Decisions.
      2. Pour personnaliser l'installation, comme par exemple le répertoire d'installation du produit, cliquez sur le bouton d'option Custom et cliquez sur Next. Personnalisez les options comme il convient. Pour plus d'informations sur les options de l'installation personnalisée, consultez le fichier install.pdf dans le sous-dossier en/docs du CD-ROM de Crystal Enterprise V10 Embedded Edition.
    5. Cliquez ensuite sur Next, puis à nouveau sur Next pour commencer l'installation.
    6. Une fois l'installation terminée, cliquez sur Next pour enregistrer Crystal Enterprise ou sur Register Later pour procéder à l'opération ultérieurement.
    7. Cliquez sur Terminer pour quitter l'assistant d'installation.

    Vous pouvez installer la version japonaise de Crystal Enterprise V10 Embedded Edition. Exécutez setup.exe à partir du sous-répertoire jp pour lancer l'assistant d'installation et suivez les mêmes instructions que celles présentées ci-dessus.

    Désinstallation de Crystal Enterprise V10 Embedded Edition

    Pour désinstaller Crystal Enterprise (version anglais ou japonaise), suivez la procédure ci-dessous.

    1. Ouvrez le Panneau de configuration.
    2. Cliquez sur Ajout/Suppression de programmes.
    3. Sélectionnez Crystal Enterprise 10 Embedded et cliquez sur le bouton Supprimer.

    Crystal Enterprise est supprimé du système.

    Installation de Crystal Enterprise V10 Professional Edition

    Pour Windows. Pour installer Crystal Enterprise V10 Professional Edition sous Windows, suivez la procédure ci-dessous.

    1. Insérez le disque Crystal Enterprise V10 Professional Edition pour Windows.
    2. A partir du programme de lancement de l'installation Rational Application Developer, cliquez sur Install Crystal Enterprise V10 Professional Edition. Le programme d'installation de Crystal Enterprise s'affiche.
    3. Cliquez sur Next. Acceptez les termes du contrat de licence et cliquez sur Next.
    4. Vous pouvez accepter le répertoire d'installation par défaut ou cliquer sur Browse pour en sélectionner un autre. Cliquez sur Next.
    5. Quatre types d'installation différents sont disponibles : New (pour une nouvelle installation), Expand (pour une installation étendue) et Custom (pour une installation personnalisée).
      1. L'option d'installation par défaut est New. Elle permet d'installer un nouveau système Crystal Enterprise.
      2. Pour étendre un système Crystal Enterprise existant, cliquez sur le bouton d'option Expand, puis sur le bouton Next. Vous pouvez entrer le nom CMS existant dans la zone Existing CMS Name (où CMS correspond au serveur Crystal Management Server) et sélectionner les serveurs à ajouter à votre système Crystal Enterprise. Pour plus d'informations sur l'extension d'un système Crystal Enterprise existant, consultez le fichier docs\install.pdf sur le CD de Crystal Enterprise V10 Professional Edition.

      Pour personnaliser les fonctions d'application installées, cliquez sur le bouton d'optionCustom, puis sur Next. Sélectionnez les fonctions à installer. Pour plus d'informations sur les installations personnalisées, consultez le fichier docs\install.pdf sur le CD de Crystal Enterprise V10 Professional Edition.

    6. Cliquez sur Suivant pour continuer.
    7. Si aucun serveur Web compatible n'est installé, un message d'avertissement est émis. Cliquez sur Next pour continuer.
    8. Si vous avez sélectionné New, et que le programme d'installation détecte la présence de Microsoft Data Engine (MSDE) ou de SQL Server, une boîte de dialogue Microsoft d'authentification SQL Server s'affiche. Vous devez alors fournir l'ID et le mot de passe correspondant au compte de base de données que vous avez défini pour Crystal Management Server (CMS). Si vous ne le faites pas et si le programme d'installation ne détecte pas la présence d'une base de données MSDE ou SQL Server, la boîte de dialogue MSDE Security Configuration s'affiche. Vous devez fournir un ID et un mot de passe pour le compte de l'administrateur SQL qui sera installé avec MSDE. Pour plus d'informations sur le serveur CMS (Crystal Management Server) ou sur le moteur MSDE (Microsoft Data Engine), consultez le fichier docs\install.pdf sur le CD de Crystal Enterprise V10 Professional Edition. Cliquez ensuite sur Next, puis à nouveau sur Next pour commencer l'installation.
    9. Si vous avez choisi d'étendre un système Crystal Enterprise existant et d'ajouter un serveur CMS supplémentaire, la boîte de dialogue CMS Database Information s'affiche. Spécifiez le type de connexion à la base de données que CMS doit utiliser pour se connecter à la base de données CMS existante. Cliquez ensuite sur Next, puis à nouveau sur Next pour commencer l'installation.
    10. Si vous sélectionné Custom (installation personnalisée), la boîte de dialogue CMS Clustering s'affiche. A moins que vous souhaitiez associer ce nouveau système à un système existant, cliquez sur No, puis sur Next pour continuer. Si le programme d'installation détecte la présence de Microsoft Data Engine (MSDE) ou de SQL Server, une boîte de dialogue Microsoft d'authentification SQL Server s'affiche. Vous devez alors fournir l'ID et le mot de passe correspondant au compte de base de données que vous avez défini pour Crystal Management Server (CMS). Si vous ne le faites pas et si le programme d'installation ne détecte pas la présence d'une base de données MSDE ou SQL Server, la boîte de dialogue MSDE Security Configuration s'affiche. Vous devez fournir un ID et un mot de passe pour le compte de l'administrateur SQL qui sera installé avec MSDE. Pour plus d'informations sur le serveur CMS (Crystal Management Server) ou sur le moteur MSDE (Microsoft Data Engine), consultez le fichier docs\install.pdf sur le CD de Crystal Enterprise V10 Professional Edition. Cliquez ensuite sur Next, puis à nouveau sur Next pour commencer l'installation.
    11. Le système peut vous inviter à réamorcer la machine au cours de l'installation.
    12. Une fois l'installation terminée, cliquez sur Next pour enregistrer Crystal Enterprise ou sur Register Later pour procéder à l'opération ultérieurement.
    13. Cliquez sur Terminer pour quitter l'assistant d'installation.

    Vous pouvez installer la version japonaise de Crystal Enterprise V10 Professional Edition. Accédez au répertoire racine de la version japonaise de Crystal Enterprise V10 Professional Edition sur le CDWindows et exécutez setup.exe pour lancer l'assistant d'installation. Suivez les mêmes instructions que celles présentées plus haut tout en sachant que l'assistant d'installation japonais doit être lancé directement à partir du CD-ROM de la version japonaise Crystal Enterprise V10 Professional Edition sur le CD Windows.

    Pour Linux. Pour installer Crystal Enterprise V10 Professional Edition sur Linux, suivez la procédure ci-dessous.

    1. Insérez le disque Crystal Enterprise V10 Professional Edition pour Linux et montez le CD-ROM.
    2. Ouvrez le fichier install.html se trouvant dans le répertoire racine du disque d'installation. Ce fichier comprend des instructions complètes pour l'installation de Crystal Enterprise V10 Professional Edition sur Linux. Reportez-vous aux instructions de ce fichier pour préparer le système et mener à terme le processus d'installation. Consultez également la section "Installation" du fichier release.htm qui se trouve dans le répertoire racine du disque d'installation avant d'installer le produit.
    3. Consultez la section relative à la configuration du système Linux du fichier install.html et effectuez les actions nécessaires afin d'exécuter le script d'installation.
    4. Désactivez tout logiciel antivirus avant d'installer le produit.
    5. Suivez les instructions d'exécution du script d'installation du fichier install.html pour mener à terme le processus d'installation. Ces instructions décrivent la procédure pour une installation utilisateur.

      Remarques :

      1. Dans les instructions d'exécution du script d'installation, il vous est indiqué de copier le fichier license.text (inclus avec la distribution du produit) ainsi que les fichiers contenant les fichiers binaires Crystal Enterprise (avec l'extension .gz) dans le répertoire HOME. Ces fichiers se trouvent dans le répertoire linux_x86 du disque d'installation.

      2. Dans la section relative à l'exécution du script d'installation, il existe une étape qui indique d'entrer un code clé d'activation du produit. Vous pouvez ignorer cette étape.
    6. Lorsque le script d'installation est terminé, vous devez déployez le bureau web Crystal Enterprise et les tableaux de bord Crystal Enterprise. Consultez la section relative au déploiement du bureau Web Crystal Enterprise dans le fichier install.html.
    7. Pour plus d'informations sur le déploiement de l'adaptateur WCA (Web Component Adapter), y compris des informations sur le déploiement de plusieurs adaptateurs WCA, reportez-vous à la section relative au déploiement de l'adaptateur WCA (Web Component Adapter) du fichier install.html.
    8. Activez votre logiciel antivirus si vous l'avez désactivé avant de commencer l'installation.

    Vous pouvez installer la version japonaise de Crystal Enterprise V10 Professional Edition. Suivez les mêmes instructions que celles présentées plus haut lors de l'utilisation de la version japonaise du CD Linux de la version japonaise de Crystal Enterprise V10 Professional.

    Désinstallation de Crystal Enterprise V10 Professional Edition

    Pour désinstaller Crystal Enterprise sous Windows (version anglaise ou japonaise), suivez la procédure ci-dessous.

    1. Ouvrez le Panneau de configuration.
    2. Cliquez sur Ajout/Suppression de programmes.
    3. Sélectionnez Crystal Enterprise 10 et cliquez sur le bouton Supprimer.

    Crystal Enterprise est supprimé du système.

    Pour désinstaller Crystal Enterprise sous Linux (version anglaise ou japonaise), suivez la procédure ci-dessous.

    1. Exécutez le script uninstallCE.sh qui se trouve dans le répertoire crystal de l'installation. Ce script supprime tous les fichiers installés au cours de l'installation initiale de Crystal Enterprise.

    Chapitre 13. Installation des mises à jour

    Le programme de mise à jour des produits Rational est un outil qui assure le suivi de tous les produits de développement de logiciels Rational installés sur votre système et qui recherche et installe les mises à jour et les nouvelles fonctionnalités facultatives de ces produits.

    Il est installé automatiquement avec le premier produit de développement de logiciels Rational que vous installez. Tous les produits Rational installés ultérieurement sont automatiquement enregistrés à l'aide de cet outil. Pour ces produits, vous pouvez rechercher et installer automatiquement les types de mise à jour suivants :

    Toutes les dépendances possibles entre les mises à jour sont appliquées automatiquement. Le programme de mise à jour des produits permet de gérer les mises à jour de tous les produits de développement de logiciels Rational à partir d'un emplacement unique. La mise à jour de ce programme s'effectue automatiquement.

    Le programme de mise à jour des produits permet également d'exécuter les tâches ci-dessous.

    Pour toute information sur l'utilisation de cet outil, consultez l'aide correspondante en suivant la procédure ci-dessous.

    1. Pour lancer le programme de mise à jour des produits dans Rational Application Developer, sélectionnez Aide > Mise à jour des logiciels > Programme de mise à jour des produits IBM Rational.
    2. Dans le programme de mise à jour des produits, sélectionnez Aide > Table des matières de l'aide.

    Chapitre 14. Notice de copyright

    Voir Notice de copyright