WebSphere Development Tools for iSeries 5.1 - Remarques d'installation

Ces remarques d'installation s'appliquent à WebSphere Development Tools for iSeries version 5.1. Cette version est conçue pour être installée uniquement sur un poste de travail PC sur lequel s'exécute l'un des systèmes d'exploitation Windows ci-dessous. Elle est disponible sur CD-ROM et DVD-ROM uniquement.

Le fichier README contient les informations concernant les conditions prérequises, les limitations du produit et des données qui ne sont pas incluses dans la documentation.

Le document Remarques d'édition décrit les composants du produit, indique les conditions système requises détaillées, propose des exemples de migration ainsi que des remarques d'édition relatives au produit VisualAge for Java Version 3.5.3 Enterprise Toolkit for AS/400.

Table des matières

Remarques sur l'installation

Remarques concernant tous les systèmes d'exploitation Windows

Remarques générales

VisualAge for Java for iSeries 3.5.3 figure sur le CD-ROM 5 et peut être installé avant ou après le reste du produit. Nous vous recommandons d'installer d'abord VisualAge for Java de manière à avoir la possibilité d'installer Enterprise Tookit for AS/400 (qui nécessite VisualAge for Java) en même temps que le reste du produit. Une fois VisualAge for Java installé, vous devez relancer votre poste de travail.

Brève description de la procédure d'installation :

  1. Vérifiez que les conditions requises pour votre poste de travail décrites dans les remarques d'édition sont remplies.
  2. Installez VisualAge for Java for iSeries 3.5.3 (facultatif) à partir du CD 5. Si le système vous propose d'installer Distributed Debugger, répondez Non.
  3. Installez WebSphere Development Tools for iSeries 5.1 :
  4. Redémarrez le poste de travail
  5. Après l'installation et le redémarrage, vous pouvez lancer l'assistant de de configuration de l'hôte et du serveur pour définir les options de connexion aux serveurs iSeries et vérifier que les logiciels sous licence et les PTF nécessaires sont installés sur ces derniers.

Lorsque le système vous propose de redémarrer le poste lors de l'installation, répondez toujours Oui, sauf si vous venez d'installer MS JVM ou S2JDK d'IBM (si ces logiciels sont requis).

WebSphere Studio installe des logiciels qui ne disposent d'aucune signature électronique Microsoft. Lorsque la boîte de dialogue indiquant que la signature électronique n'a pas été trouvée vous invite à poursuivre l'installation, cliquez sur Oui.

WebSphere Development Tools for iSeries V5.1 ne peut pas être installé sous Windows 95.

Support de la langue nationale

Le produit s'installe dans la langue correspondant à l'environnement local de l'utilisateur. Si vous modifiez l'environnement local après l'installation, les composants du produit et les écrans d'aide risquent de ne pas s'afficher correctement. Pour modifier la langue, désinstallez complètement le produit comme le décrit la section Procédure de désinstallation, changez les paramètres de l'environnement local, puis réinstallez le produit.

Pour utiliser le produit Distributed Debugger en espagnol, assurez-vous que la valeur définie pour l'environnement local de votre machine est Espagnol (Tri traditionnel) ou Espagnol (Espagne) avant de procéder à l'installation de ce produit.

Installation personnalisée

L'installation personnalisée vous permet de choisir les composants du produit que vous souhaitez installer. Certains composants doivent être sélectionnés en fonction d'autres choix opérés. Ces composants sont répertoriés dans le tableau ci-dessous. Les sélections nécessaires se font automatiquement. Par exemple, si vous sélectionnez WebFacing (serveur frontal), CODE et AS/400 Toolbox for Java sont également sélectionnés.
Ce composant :requiert ces composants :
La base de WebSphere Development Tools est toujours installée.
VisualAge RPG
AS/400 Toolbox for Java
CODEAS/400 Toolbox for Java
WebFacing ToolCODE
AS/400 Toolbox for Java
Enterprise Toolkit for AS/400VisualAge for Java for iSeries version 3.5 ou suivante (installé séparément)
WebSphere Studio for iSeries
Distributed Debugger et NetQuestion sont toujours installés.
NetQuestion fournit toutes les fonctions de recherche associées au système d'aide.
Distributed Debugger, qui comprend Object Level Trace, peut déboguer du Java interprété et compilé ainsi que d'autres langages compilés tel que C++.

Programmes supplémentaires

Vous devrez peut-être installer certains programmes supplémentaires, en fonction des sélections effectuées et des composants déjà sur votre poste. L'assistant d'installation vous invite à les installer si nécessaire.
ProgrammeInclus
avec le produit		Redémarrage
nécessaire		Type d'installationCommentaires
MS JVM Oui Non Interactif - lancé à partir de l'installation Doit être installé pour que les DTC Studio puissent fonctionner correctement mais il ne doit pas nécessairement s'agir du JVM système.
Kit JDK (Java Development Kit) Kit J2SDK 1.2.2 d'IBM Oui Non Interactif - lancé à partir de l'installation Requis pour toutes les fonctions de CODE/400, VARPG et WebFacing Tool. Reportez-vous aux remarques relatives à JDK contenues dans le fichier README.
JDK de Sun Non Non Installation manuelle Version 1.2.x
Navigateur Web prenant en charge les cadres Netscape Communicator Non, disponible
auprès de votre fournisseur		 Non Installation manuelle de la version 4.7 ou suivante Obligatoire si aucun autre navigateur n'est installé.
Microsoft Internet Explorer Non, disponible
auprès de votre fournisseur		 Oui Installation manuelle de la version 4.0 ou suivante Obligatoire pour certaines fonctions principales de Studio. Facultatif si Studio n'est pas installé. La version 5.0 est requise pour le serveur Web frontal (WebFacing Tool) et d'autres composants. Pour en savoir plus, reportez-vous à la section relative aux logiciels requis dans les remarques d'édition.
Autre Non, disponible
auprès de votre fournisseur		 Selon le produit Installation manuelle. La version dépend du produit. Les autres navigateurs ne sont pas pris en charge.

Remarques d'installation concernant Windows 98

Pour que tous les composants s'installent et s'exécutent correctement, vous devez procéder aux modifications suivantes :

Si vous recevez un message d'erreur indiquant que NetQuestion ne peut pas être installé ; ceci provient du fait que l'instruction PATH de votre fichier autoexec.bat contient plus de 200 caractères. Pour y remédier, indiquez une instruction PATH plus courte.

Lorsque NetQuestion est désinstallé (lors de la désinstallation de n'importe quel produit IBM qui l'utilise), l'entrée correspondante dans l'instruction PATH n'est pas enlevée. Le fait de désinstaller plusieurs fois le produit peut générer une instruction de plus de 200 caractères. Pour y remédier, indiquez une instruction PATH plus courte.

Remarques d'installation concernant Windows NT et Windows 2000

En raison d'une modification apportée à Microsoft Installer dans l'utilisation de variables d'environnement sous Windows NT et 2000, respectez les consignes ci-dessous.

Attention : Vous devez être connecté en tant qu'administrateur pour pouvoir désinstaller le produit.

Remarques d'installation concernant Windows ME

Pour que tous les composants s'installent et s'exécutent correctement, vous devez procéder aux modifications suivantes :

  1. Recherchez le fichier command.com à l'aide de l'Explorateur Windows.
  2. Cliquez à l'aide du bouton droit de la souris sur le fichier command.com.
  3. Cliquez sur Propriétés pour afficher la fenêtre Propriétés de command.com.
  4. Cliquez sur l'onglet Mémoire.
  5. Sélectionnez la valeur 32000 dans la liste déroulante de la zone Environnement initial.
  6. Cliquez sur OK.
  7. Redémarrez le poste de travail une fois le produit installé.

Lorsque NetQuestion est désinstallé (lors de la désinstallation de tous les produits IBM qui l'utilisent), l'entrée correspondante dans la variable système PATH n'est pas enlevée. Le fait de désinstaller plusieurs fois le produit peut générer une chaîne de variable de plus de 200 caractères. Pour y remédier, indiquez une variable PATH plus courte.

Procédure d'installation à partir d'un CD-ROM

Les CD-ROM sont au nombre de cinq. Les disques 1 à 4 contiennent WebSphere Development Tools for iSeries. Le CD-ROM 5 contient VisualAge for Java for iSeries 3.5.3. Après fermeture de l'unité de CD-ROM, attendez que le voyant s'éteigne avant de cliquer sur OK.

  1. (Facultatif) Installez VisualAge for Java for iSeries 3.5.3.
    1. Insérez le CD-ROM 5 dans l'unité.
    2. Si elle n'est pas lancée automatiquement, procédez comme suit :
      1. Cliquez sur Démarrer, puis sur Exécuter.
      2. Tapez X:setup, où X correspond à l'unité de CD-ROM.
      3. Appuyez sur Entrée.
    3. Suivez les instructions d'installation.
    4. Redémarrage du poste de travail
  2. Installez WebSphere Development Tools for iSeries.
    1. Insérez le CD-ROM 1 dans l'unité.
    2. Si elle n'est pas lancée automatiquement, procédez comme suit :
      1. Cliquez sur Démarrer, puis sur Exécuter.
      2. Tapez X:setup, où X correspond à l'unité de CD-ROM.
      3. Appuyez sur Entrée.
    3. Suivez les instructions d'installation de WebSphere Development Tools for iSeries.
    4. Redémarrage du poste de travail

Procédure d'installation à partir d'un DVD-ROM

  1. (Facultatif) Installez VisualAge for Java for iSeries 3.5.3.
    1. Insérez le CD-ROM 5 dans l'unité.
    2. Si elle n'est pas lancée automatiquement, procédez comme suit :
      1. Cliquez sur Démarrer, puis sur Exécuter.
      2. Entrez X:setup, où X est l'unité de DVD-ROM.
      3. Appuyez sur Entrée.
    3. Suivez les instructions d'installation.
    4. Redémarrage du poste de travail
  2. Installez WebSphere Development Tools for iSeries.
    1. Insérez le DVD-ROM dans l'unité.
    2. Si elle n'est pas lancée automatiquement, procédez comme suit :
      1. Cliquez sur Démarrer, puis sur Exécuter.
      2. Entrez X:setup, où X est l'unité de DVD-ROM.
      3. Appuyez sur Entrée.
    3. Suivez les instructions d'installation de WebSphere Development Tools for iSeries.
    4. Redémarrage du poste de travail

Procédure d'utilisation d'un fichier réponses

Un fichier réponses constitue l'enregistrement des composants installés et de leur emplacement. Une installation effectuée sur un autre poste de travail qui utilise un fichier réponses sera conforme à l'installation qui a généré ce fichier, sans les écrans et boîtes de dialogue. Reportez-vous aux remarques ci-après pour connaître les exceptions.

Pour créer un fichier de réponses, appuyez sur le bouton Création d'un fichier de réponses de l'assistant d'installation. Le chemin d'accès et le nom par défaut du fichier réponses sont C:\Program Files\IBM\v5r1rspn.wdt. Vous pouvez modifier le nom et le chemin d'accès par défaut.

Si vous procédez à une installation avec un fichier réponses, aucun autre fichier réponses n'est créé. L'utilisation d'un fichier réponses signifie que vous avez accepté les termes du contrat de licence. Reportez-vous à la section relative aux informations de licence du fichier README pour connaître l'emplacement du contrat de licence.

Pour utiliser le fichier réponses, entrez la commande setup en indiquant les paramètres comme dans l'exemple suivant :
setup -f "C:\Program Files\IBM\v5r1rspn.wdt" où l'unité et le chemin d'accès du fichier réponses sont indiqués entre guillemets.

Si l'installation du fichier réponses se termine par une erreur, vous trouverez le message d'erreur correspondant dans le dernier fichier journal créé. Reportez-vous à la section relative aux fichiers journal dans le chapitre sur l'identification et la résolution des incidents.

Remarque : Le fait d'utiliser un fichier réponses pour l'installation ne permet pas d'installer MS JVM et J2SDK d'IBM, lesquels sont requis pour un certain nombre de composants. Si ces logiciels ne sont pas encore installés sur le système, vous pouvez les installer manuellement avant d'installer WebSphere Development Tools for iSeries. MS JVM se trouve sur le CD-ROM ou le DVD-ROM 4, dans le répertoire \extras. Exécutez msjavx86.exe, puis redémarrez votre poste de travail. Installez IBM SDK 1.2.2 SR10a en exécutant \extras\ibmsdk\install.exe, puis relancez votre poste de travail.

Procédure d'installation du produit sur un serveur de réseau local

Un administrateur ou un utilisateur peut copier tous les fichiers contenus sur les CD ou les DVD sur un serveur de réseau local. Ainsi, l'utilisateur peut installer le produit à partir du serveur vers un poste de travail.

Pour copier les fichiers d'un CD sur un serveur, procédez comme suit :

  1. Créez un répertoire qui contiendra les fichiers produit. Un minimum de 1,3 Go est requis.
  2. Insérez le CD-ROM d'installation 1 dans l'unité. Assurez-vous que la commande d'installation setup ne s'exécute pas.
  3. Copiez tous les fichiers du disque 1 vers le répertoire de stockage à l'aide de la commande suivante :
    xcopy X:*.* y:\wdtimage /e /q où X désigne l'unité de CD-ROM etY:\wdtimage, l'unité cible et son chemin d'accès.
  4. Copiez tous les fichiers des CD-ROM 2 à 4 vers le répertoire de stockage à l'aide de la commande ci-dessus.

Pour copier les fichiers d'un DVD sur un serveur, procédez comme suit :

  1. Créez un répertoire qui contiendra les fichiers produit. Un minimum de 1,3 Go est requis.
  2. Insérez le DVD-ROM d'installation 1 dans l'unité. Assurez-vous que la commande d'installation setup ne s'exécute pas.
  3. Copiez tous les fichiers du DVD vers le répertoire de stockage à l'aide de la commande suivante :
    xcopy X:*.* y:\wdtimage /e /q où X désigne l'unité de DVD-ROM etY:\wdtimage, l'unité cible et son chemin d'accès.

Procédure d'installation à partir d'un serveur de réseau local vers un poste de travail

Une fois le produit copié sur un serveur de réseau local (voir la section Procédure d'installation du produit sur un serveur de réseau local ), il peut être installé sur un poste de travail à partir du serveur. L'installation doit avoir lieu sur le poste de travail.
  1. Ouvrez une fenêtre d'invite de commande sur le poste de travail.
  2. Entrez la commande net use pour vous connecter à l'unité du serveur de réseau local sur laquelle le produit a été copié. Assurez-vous que vous disposez d'un espace minimal de 1,3 Go sur le poste de travail.
  3. Si aucun fichier réponses n'est utilisé, entrez la commande X:\wdtimage\setup (où X désigne l'unité du serveur de réseau local) et suivez les instructions d'installation.
    Si un fichier réponses est utilisé, entrez la commande setup en indiquant un paramètre comme dans l'exemple suivant :
    X:\wdtimage\setup -f "C:\Program Files\IBM\wdtrspn.wdt" où l'unité et le chemin d'accès du fichier réponses sont indiqués entre guillemets.

Procédure d'installation du produit sur un serveur iSeries

Un administrateur ou un utilisateur peut copier tous les fichiers contenus sur les CD ou les DVD sur un serveur iSeries. Ainsi, l'utilisateur peut installer le produit à partir du serveur iSeries vers un poste de travail.

Pour copier les CD-ROM ou les DVD-ROM sur un serveur iSeries, effectuez les étapes suivantes :

  1. Sur le serveur iSeries
    1. Assurez-vous que Netserver est opérationnel. Connectez-vous au système iSeries, puis entrez STRTCPSVR *NETSVR en ligne de commande.
    2. Créez un répertoire qui contiendra les fichiers produit. Un minimum de 1,3 Go est requis.
    3. Sur la ligne de commande, tapez md install où "install" correspond au répertoire de stockage.
  2. Connexion d'une unité réseau au serveur iSeries
    1. Sur le poste de travail, lancez l'Explorateur comme suit :
      • Démarrer-->Programmes-->Explorateur Windows NT pour Windows NT
      • Démarrer-->Programmes-->Explorateur Windows pour Windows 98
      • Démarrer-->Programmes-->Accessoires-->Explorateur Windows pour Windows 2000 et Windows ME
    2. Dans la fenêtre de l'Explorateur, sélectionnez Outils-->Connecter un lecteur réseau pour afficher la fenêtre correspondante.
    3. Dans la fenêtre Connecter un lecteur réseau :
      • Sélectionnez une unité disponible dans la zone Lecteur (M dans l'exemple) et spécifiez \\iSeriesname\root dans la zone Chemin pour Windows NT, Windows 98, Windows ME ou dans la zone Dossier pour Windows 2000. "iSeriesname" peut également être l'adresse TCP/IP du serveur iSeries.
      • Sélectionnez Reconnecter à l'ouverture de session si vous souhaitez vous reconnecter à cette unité lors du prochain redémarrage.
      • Cliquez sur OK ou Terminer. L'unité réseau connectée au serveur iSeries est maintenant M.
  3. Copiez les fichiers vers le serveur iSeries.
    1. Insérez le CD-ROM d'installation 1 dans l'unité. Assurez-vous que la commande d'installation setup.exe ne s'exécute pas.
    2. Copiez tous les fichiers du CD-ROM 1 vers le répertoire de stockage en exécutant la commande suivante : xcopy X: *.* m:\install /e /q , où X désigne l'unité de CD-ROM et m:\install, l'unité et le chemin cible sur le serveur iSeries.
    3. Copiez tous les fichiers des CD-ROM 2 à 4 vers le répertoire de stockage à l'aide de la commande ci-dessus.

Procédure d'installation à partir d'un serveur iSeries vers un poste de travail

Une fois le produit copié sur le serveur iSeries (voir la section Procédure d'installation du produit sur un serveur iSeries), il peut être installé sur un poste de travail à partir du serveur. L'installation doit avoir lieu sur le poste de travail.

  1. Connectez l'unité réseau à l'unité iSeries sur laquelle le produit a été copié. Reportez-vous à la section Connexion d'une unité réseau au serveur iSeries. Assurez-vous que vous disposez d'un espace minimal de 1,3 Go sur le poste de travail.
  2. Cliquez deux fois sur le répertoire m:\install.
  3. Cliquez deux fois sur setup.
  4. Suivez les instructions d'installation.

Procédure de désinstallation à partir d'un poste de travail

Pour désinstaller l'ensemble de WebSphere Development Tools for iSeries, sélectionnez Démarrer>Paramètres>Panneau de configuration>Ajout/Suppression de programmes. Cliquez sur IBM WDT400 V5R1M0 uniquement, puis sur l'option de modification/de retrait pour Windows 2000 ou le bouton Ajouter/supprimer pour les autres systèmes d'exploitation Windows afin de lancer l'assistant de modification. Cliquez sur le bouton de suppression du produit. Ne supprimez pas les composants individuellement en supprimant les répertoires correspondants car la suppression ne serait pas complète. Redémarrez systématiquement votre machine après avoir désinstallé le produit.

Sous Windows NT et sous Windows 2000, l'utilisateur doit disposer des droits d'administrateur pour pouvoir désinstaller un produit.

Procédure d'ajout ou de suppression de composants après installation

Pour ajouter ou supprimer des composants, sélectionnez Démarrer>Paramètres>Panneau de configuration>Ajout/Suppression de programmes. Cliquez sur IBM WDT400 V5R1M0 uniquement, puis sur l'option de modification/de retrait pour Windows 2000 ou le bouton Ajouter/supprimer pour les autres systèmes d'exploitation Windows afin de lancer l'assistant de modification. Cliquez sur le bouton de modification du produit pour ouvrir l'assistant de modification permettant de sélectionner les composants à ajouter ou supprimer. Si vous ajoutez des composants, vous devez disposer des CD-ROM, des DVD-ROM, de l'unité réseau ou du serveur iSeries d'installation d'origine. Redémarrez systématiquement votre machine après avoir modifié le produit.

Lorsque l'option de modification de produit est sélectionnée, vous devez sélectionner ou désélectionner les cases à cocher correspondant aux composants à ajouter ou enlever. Initialement, les cases à cocher des composants déjà installés sont sélectionnées. Pour qu'un composant soit ajouté, vous devez sélectionner la case à cocher correspondante. Pour enlever un composant, désélectionnez la case à cocher correspondante. Lorsque vous avez terminé cette opération, seuls les composants sélectionnés sont installés. Ne désélectionnez pas une case à cocher correspondant à un composant déjà installé que vous ne souhaitez pas enlever.

Identification et résolution des incidents et palliatifs

Si vous rencontrez des difficultés ou des incidents lors de l'installation, consultez les remarques ci-après.
Commentaires
Assurez-vous que la variable PATH n'est pas trop longue. Cette considération concerne Windows 98 et ME. Reportez-vous aux remarques d'installation concernantWindows 98 et Windows ME.
Assurez-vous que vous disposez de suffisamment d'espace disque temporaire. La procédure d'installation utilise l'espace disque des répertoires spécifiés par les variables d'environnement TEMP et TMP. Si un message signalant un manque de mémoire temporaire s'affiche au cours de l'installation, modifiez ces variables pour indiquer une autre unité offrant un espace suffisant. L'installation peut nécessiter jusqu'à 400 Mo de mémoire temporaire. Vous devez relancer Windows 98 et Windows ME pour que les modifications soient prises en compte.
Recherchez les informations relatives à la durée anormalement longue de l'installation. Si l'installation ne semble pas progresser :
  • Il se peut que des messages d'installation cachés derrière d'autres fenêtres nécessitent une réponse de votre part.
  • Si vous procédez à une installation à partir d'un serveur, tentez de déterminer s'il existe d'autres demandes exécutées sur le serveur susceptibles de ralentir l'installation.
Enterprise Toolkit for AS/400 ne peut pas être installé sans VisualAge for Java for iSeries. ET/400 requiert VAJava for iSeries. Installez VAJava, puis le produit.
Si le produit est déjà installé, ajoutez ET/400 à l'aide de l'option de modification décrite à la section Procédure d'ajout ou de suppression de composants après installation.
Toutes les dépendances de composant sont décrites à la section Installation personnalisée.
Si vous cliquez sur Annuler au cours de l'installation, vous devez identifier les composants ayant été installés. Si vous cliquez dessus au cours de l'installation d'un composant :
  • Celui-ci est installé mais les composants restants ne le sont pas.
  • L'aide n'est pas complète et vous ne pouvez pas vous déplacer ni faire de recherches dans cette dernière.
  • IBM Distributed Debugger n'est pas installé.
Pour installer les composants manquants, vous devez utiliser l'assistant de modification décrit précédemment dans la section Procédure d'ajout ou de suppression de composants après installation.
Si vous désinstallez VisualAge for Java for AS/400, installé en même temps que la V4R5M1, un message d'erreur est généré. Vous devez alors utiliser le fichier de nettoyage. Le fichier de nettoyage, \extras\cleanvaj.exe, figure sur le CD-ROM 4.
Consultez le fichier journal relatif à l'installation. Chaque installation ou modification de produit est consignée dans un fichier journal distinct : C:\Program Files\IBM\V5R1_xxx.log, où xxx est un nombre séquentiel à partir de 001. Les fichiers journal contiennent des informations relatives aux composants installés ou désinstallés et des messages d'erreur. Le fichier journal le plus récent est celui qui contient le numéro séquentiel le plus élevé.