IBM Rational Web 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 Web 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 Web 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 Web Developer
  • Démarrage de Rational Web Developer
  • Désinstallation de Rational Web Developer
  • Désinstallation de Rational Web 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 Web 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 Web Developer
  • Augmentation du nombre de descripteurs de fichier disponibles
  • Démarrage de Rational Web Developer
  • Désinstallation de Rational Web Developer
  • Désinstallation de Rational Web 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 Web Developer pour une utilisation en environnement coopératif

  • Logiciels pris en charge
  • IBM Rational ClearCase
  • IBM Rational ClearQuest
  • Chapitre 8. Installation de WebSphere Application Server 5.x en tant qu'environnement de test intégré

    Chapitre 9. Installation des mises à jour

    Chapitre 10. Notice de copyright


    Chapitre 1. Introduction

    Le présent guide d'installation fournit les instructions nécessaires pour installer et désinstaller Rational Web Developer, les fonctionnalités optionnelles et les produits supplémentaires fournis avec Rational Web 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 Web Developer


    Eléments matériels requis

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


    Conditions logicielles requises

    Systèmes d'exploitation

    Les éléments logiciels ci-dessous doivent être installés avant d'installer Rational Web 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 Web 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_rwd pour Rational Web 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 Web 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 rwd_prod pour Rational Web 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 Web Developer pour Windows

    La présente section comporte des informations relatives à l'installation de Rational Web Developer sous Windows. Vous pouvez installer Rational Web 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 Web 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 Web 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 Web Developer. Rational Web 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 Web Developer.

    Vous pouvez migrer WebSphere Studio 5.1.x vers Rational Web Developer ou faire coexister ces deux produits. Pour plus d'informations sur la migration, voir le Guide de migration de Rational Web 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 Web 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 Web Developer.

      Conseils :

    5. A partir du programme de lancement de l'installation de Rational Web Developer, sélectionnez Installation d'IBM Rational Web 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 Web 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, 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 Web 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 Web 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 Web 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. La fenêtre qui s'affiche alors contient 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 9, "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 Web 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 Web 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".

    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.
    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 Web Developer, soit copier le contenu des CD-ROM, comme il est décrit ci-dessus.

    Vous devez disposer d'environ 4 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 Web 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. Environnements de test WebSphere V5.x

    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 Web 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 Web 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 Web 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 Web Developer :

    Pour installer Rational Web 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 Web 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 Web 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 Web Developer

    Rational Web 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 Web 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_rwd_win32.active
    Langage EGL (Enterprise Generation Language) feature_egl_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 Web 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 Web Developer

    Pour lancer Rational Web Developer :

    1. Sélectionnez Démarrer > Programmes > IBM Rational >IBM Rational Web Developer 6.0 > Rational Web 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 Web 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 Web 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 Web 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 Web Developer

    Pour désinstaller Rational Web Developer :

    1. Fermez Rational Web Developer.
    2. Ouvrez le panneau de configuration, puis affichez la fenêtre Ajouter ou supprimer des programmes. Sélectionnez IBM Rational Web 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 Web 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 Web Developer ou d'annuler la sélection des fonctions que vous ne souhaitez pas désinstaller.

    Désinstallation de Rational Web Developer en mode silencieux

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

    rwd_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 Web 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 Web Developer qui ont été installés. Si le répertoire que vous destiniez à l'installation de Rational Web 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 Web 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 Web 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 Web 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 Web Developer pour Linux

    La présente section contient des informations relatives à l'installation de Rational Web Developer sous Linux. Vous pouvez installer Rational Web 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 Web 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 Web Developer ou faire coexister ces deux produits. Pour plus d'informations sur la migration, voir le Guide de migration de Rational Web 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 Web Developer. Rational Web 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 Web 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 Web 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 Web Developer du programme de lancement de l'installation.

      Conseils :

    8. A partir du programme de lancement de l'installation de Rational Web Developer, sélectionnez Installation d'IBM Rational Web 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 Web 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, 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 Web Developer.
    13. Cliquez sur Suivant pour continuer l'installation de Rational Web 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 Web Developer.
    16. Lorsque Rational Web Developer est installé, cliquez sur Suivant pour terminer l'installation.
    17. La fenêtre qui s'affiche alors contient 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 9, "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 Web 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 Web 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".

    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.
    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 Web Developer, soit copier le contenu des CD-ROM, comme il est décrit ci-dessus.

    Vous devez disposer d'environ 4 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 Web 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. Environnements de test WebSphere V5.x

    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 Web 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 Web 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 Web 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 Web Developer :

    Pour installer Rational Web 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 Web 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 Web 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 Web Developer

    Rational Web 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 Web 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
    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 Web 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 Web 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 Web Developer

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

    1. Pour démarrer Rational Web 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 Web 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 Web 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 Web 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 Web Developer

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

    1. Connectez-vous en tant qu'utilisateur root.
    2. Accédez au sous-répertoire rwd_prod/_uninst/ du répertoire d'installation.
    3. Désinstallez Rational Web 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 Web 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 Web Developer ou d'annuler la sélection des fonctions que vous ne souhaitez pas désinstaller.

    Désinstallation de Rational Web Developer en mode silencieux

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

    rwd_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 Web 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 Web 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 Web 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. Pour Windows : si vous installez Agent Controller à partir du CD-ROM d'installation de Rational Web Developer, sélectionnez Installation d'Agent Controller dans la fenêtre du programme de lancement (si l'exécution automatique est désactivée, exécutez le programme lauchpad.exe à partir de la racine du CD-ROM d'installation). Passez ensuite à l'étape 5.
    3. A partir du support d'installation, accédez au répertoire correspondant à votre plateforme.
    4. Exécutez le programme setup.exe. Pour une plateforme non Windows, exécutez setup.bin.
    5. Cliquez sur Suivant dans l'écran de bienvenue pour continuer.
    6. Avant de continuer l'installation, fermez toutes les plateformes Eclipse. Cliquez sur Suivant pour continuer.
    7. Lisez le contrat de licence.
    8. Sélectionnez Approuver et cliquez sur Suivant pour continuer.
    9. Un message vous informe que toute installation existante d'Agent Controller sera supprimée. Cliquez sur Suivant pour continuer.
    10. Spécifiez le chemin d'installation d'Agent Controller et cliquez sur Suivant pour continuer.
    11. Sélectionnez les fonctionnalités Agent Controller que vous voulez installer :

      Cliquez sur Suivant pour continuer.

    12. 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.
    13. 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.
    14. Spécifiez les hôtes pouvant accéder à Agent Controller. Les options disponibles sont les suivantes :

      Cliquez sur Suivant pour continuer.

    15. 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.

    16. Cliquez sur Suivant dans la fenêtre récapitulative pour continuer.
    17. 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. 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.
    5. 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.
    6. 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)
      
    7. 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)
      
    8. Démarrez QShell et créez le répertoire /opt/hyadesdc dans le système de fichiers intégré (IFS).
    9. 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/*')
      
    10. 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)
      
    11. 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
      
    12. 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 l'image d'installation ibmrac.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 bin de l'installation /usr/lpp/IBM/AgentController/bin, et exécutez le script makelinks en entrant :

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

      extattr +p /usr/lpp/IBM/AgentController/lib/*.so
       
      
    6. 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
      
    7. 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 Web 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 Web Developer pour une utilisation en environnement coopératif

    Par défaut, un plug-in Rational ClearCase SCM Adapter est installé automatiquement avec Rational Web 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 Web 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 Web 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 Web Developer.

    Pour utiliser Rational Web 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 Web 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 Web 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 Web 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.


    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 Web 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 Web 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 Web 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 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 Web 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 10. Notice de copyright

    Voir Notice de copyright