Instructions d'installation

Table des matières

• A propos de la version 6.0.1, groupe de correctifs 4
• Historique des changements
• Incidents traités par ce groupe de correctifs
• Prérequis
• Espace requis
• Procédure d'installation de la version 6.0.1, groupe de correctifs 4
• Configuration de Business Process Choreographer
• Incidents recensés
• Informations complémentaires
• Fichier readme de l'utilitaire d'installation de mises à jour
• Marques

Historique des changements
Edition : 5 janvier 2007
Publication : 5 janvier 2007

Haut de page

Incidents traités par ce groupe de correctifs
Outre les incidents résolus par les correctifs déjà publiés (version 6.0.1, groupes de correctifs cumulatifs 1, 2 et 3, les incidents résolus par le présent groupe de correctifs sont présentés dans le document V6.0.1 Fix Pack 4 Content, à l'adresse : ftp://ftp.software.ibm.com/software/ts/cw/servers/wps/r601/FP/4/6014DefectList.html.

Haut de page

Prérequis
Pour pouvoir utiliser ce groupe de correctifs, vous devez avoir installé l'une des versions suivantes de WebSphere Enterprise Service Bus ou de WebSphere Process Server : 6.0.1.0, 6.0.1.1, 6.0.1.2. ou 6.0.1.3.

Tous les prérequis logiciels et matériels sont décrits dans les pages des prérequis système pour WebSphere Enterprise Service Bus et WebSphere Process Server.

Veillez à disposer d'un espace disque suffisant avant de lancer l'installation du présent groupe de correctifs. Pour plus de détails, voir la section Espace requis.

Haut de page

Espace requis
L'espace requis varie selon la plateforme utilisée. La taille des différents modules pouvant être téléchargés figure dans les pages de support de WebSphere Enterprise Service Bus et de WebSphere Process Server. Un groupe de correctifs requiert environ 600 Mo d'espace libre dans le répertoire temporaire du système (généralement /tmp sous Linux ou UNIX) et 600 Mo supplémentaires dans le système de fichiers contenant l'image de WebSphere Enterprise Service Bus ou de WebSphere Process Server (généralement /usr ou /opt sous Linux ou UNIX), ou environ 1,2 Go d'espace disponible sur le disque d'installation d'une plateforme Windows.

De l'espace est également nécessaire dans les répertoires "<racine_installation>/updateinstaller" et "<racine_installation>/properties/version/update/backup". L'espace nécessaire pour chaque répertoire est égal à la taille du groupe de correctifs, soit de 25 à 750 Mo.

Haut de page

Procédure d'installation de la version 6.0.1, groupe de correctifs 4

1. Exécutez la commande backupConfig pour sauvegarder les fichiers de configuration. Pour plus d'informations, voir la page Sauvegarde et restauration des configurations d'administration du centre de documentation en ligne.
   Remarque : sauvegarde de profils existants dans WebSphere Enterprise Service Bus ou WebSphere Process Server.
   Outre la maintenance des fichiers de base du produit, certains groupes de correctifs assurent la maintenance des profils existants. L'utilitaire d'installation de mises à jour vous invite à sauvegarder votre configuration lorsque vous installez un groupe de correctifs qui exige la maintenance de profils.
   Utilisez la commande backupConfig pour sauvegarder la configuration des profils que le groupe de correctifs peut mettre à jour. Vous pouvez également archiver le répertoire "<racine_installation>/profiles" pour sauvegarder simultanément tous les profils. Si vous désinstallez un groupe de correctifs, l'utilitaire d'installation de mises à jour ne désinstalle pas les mises à jour des correctifs dans les profils. En effet, il se peut que vous ayez configuré le profil après l'installation de la maintenance. Pour restaurer un profil d'origine, utilisez la commande restoreConfig ou copiez le profil situé dans le répertoire des profils archivés pour remplacer le profil modifié.
   
   
2. Si vous avez déjà installé un kit de maintenance, vous devez effectuer l'opération suivante :
   Avant d'extraire le contenu du groupe de correctifs, sauvegardez et supprimez les fichiers d'installation de maintenance antérieurs. Supprimez le contenu du répertoire :
   "<racine_installation>/updateinstaller"
   ("<racine_installation>" représente le répertoire racine de l'installation de WebSphere Enterprise Service Bus ou de WebSphere Process Server). Par exemple, si vous utilisez une plateforme Linux(x86) et que WebSphere Enterprise Service Bus est installé dans le répertoire par défaut, vous devez remplacer <racine_installation> par "/opt/ibm/WebSphere/ESB".


3. Vérifiez que l'espace disque nécessaire est disponible, comme le décrit le fichier readme de l'utilitaire d'installation de mises à jour <racine_installation>/updateinstaller/docs/readme_updateinstaller.html.
   
   
4. Après avoir sauvegardé les fichiers de configuration et avant d'installer le groupe de correctifs, arrêtez tous les processus Java qui s'exécutent avec l'environnement d'exécution Java 2 d'IBM fourni par WebSphere Enterprise Service Bus ou WebSphere Process Server.
   Arrêtez tous les processus WebSphere Enterprise Service Bus ou WebSphere Process Server, le processus de l'agent de noeud et celui du gestionnaire de déploiement, ainsi que tous les processus serveur appartenant aux produits devant être mis à jour, comme IBM HTTP Server.
   Si vous installez la version 6.0.1, groupe de correctifs 4, pendant l'exécution d'un processus lié à WebSphere Enterprise Service Bus ou WebSphere Process Server, alors le produit WebSphere Enterprise Service Bus ou WebSphere Process Server installé pourrait ne pas continuer à fonctionner correctement.
   IMPORTANT : Pour savoir comment installer le groupe de correctifs dans un environnement Network Deployment avec une durée d'immobilisation minimale, reportez-vous à la section D ci-dessous.
   
   
5. Téléchargez le groupe de correctifs 6.0.1.4 approprié depuis le site de support produit WebSphere Enterprise Service Bus ou WebSphere Process Server. Téléchargez-le vers un emplacement temporaire sur le disque.
   
   
6. Décompressez le package directement dans le répertoire <racine_installation>. Ainsi, les fichiers de mise à jour et l'utilitaire d'installation des mises à jour du groupe de correctifs sont placés dans le répertoire <racine_installation>/updateinstaller et un sous-répertoire de maintenance est créé.
   Par exemple, sous Linux (x86), si votre installation est située dans l'emplacement WebSphere ESB par défaut, "/opt/ibm/WebSphere/ESB", et que vous avez téléchargé le fichier dans le répertoire /tmp, utilisez les commandes suivantes pour décompresser son contenu :
   
   

   cd /opt/ibm/WebSphere/ESB unzip /tmp/6.0.1-WS-WPS-ESB-LinuxX32-FP0000004.zip

   
   Si la commande unzip n'est pas disponible, lancez la commande "jar -xvf" pour utiliser le fichier binaire JAR du kit de développement Java 2 fourni avec votre produit WebSphere ESB ou WebSphere Process Server. Remarque : Sous Linux ou UNIX, si vous utilisez la commande jar pour décompresser les fichiers, vous devrez peut-être changer les droits d'accès des fichiers "updateinstaller/update" et "updateinstaller/updateWPS-WESB-6014.sh" pour les rendre exécutables. Pour cela, lancez la commande "chmod a+x updateinstaller/update*".
   
   Le module téléchargeable 6.0.1.4 contient l'utilitaire d'installation de mises à jour, les fichiers du groupe de correctifs 6.0.1.4 et un script d'installation qui vous permet d'installer dans l'ordre toutes les mises à jour en mode silencieux. Le produit Update Installer for WebSphere Software et le script d'installation se trouvent dans le répertoire <racine_installation>/updateinstaller. Les fichiers du groupe de correctifs se trouvent dans le répertoire <racine_installation>/updateinstaller/maintenance.
   
   Après avoir décompressé le module téléchargé, vous devrez peut-être le supprimer pour libérer de l'espace.
   
   
7. Pour installer en mode silencieux toutes les mises à jour à l'aide du script d'installation fourni, exécutez les opérations suivantes :
   
   Sous Windows :
   

   cd <racine_installation>\updateinstaller updateWPS-WESB-6014

   
   Sous Linux et UNIX :
   

   cd <racine_installation>/updateinstaller ./updateWPS-WESB-6014.sh

   
   Important :
   Si vous avez commencé d'installer certains éléments du module de maintenance, vous devrez modifier le script pour les supprimer. Les scripts contiennent toutes les informations utiles pour réaliser cette opération. Les scripts contiennent également des instructions pour l'installation d'autres correctifs supplémentaires.
   
   
8. Pour lancer l'interface graphique d'installation, accédez au répertoire <racine_installation>/updateinstaller/, exécutez le fichier binaire update et suivez les instructions affichées.
   
   Important :
   Le programme d'installation traite un seul module à la fois. Lorsque vous êtes invité à entrer le nom d'un module, vous devez le sélectionner en respectant l'ordre suivant. Les noms de module varient en fonction de la <plateforme> utilisée.
   
   

   6.0.2-WS-WAS-<plateforme>-FP0000017.pak 6.0.2-WS-WASJavaSDK-<plateforme>-FP0000017.pak Remarque : l'installation de ce module SDK Java se déroule en deux étapes. Suivez scrupuleusement les instructions affichées pour ce module. 6.0.2.11-WS-WAS-IFPK31745.pak 6.0.2.13-WS-WAS-IFPK32982.pak 6.0.2.13-WS-WAS-IFPK34465.pak 6.0.2.17-WS-WAS-IFPK35426.pak 6.0.2.18-WS-WAS-IFPK34001.pak 6.0.2.9-WS-WAS-IFPK35039.pak 6.0.2-WS-WAS-IFPK35285.pak 6.0.1-WS-WPS-ESB-<plateforme>-FP0000004.pak

   
   Pour chaque fichier de la liste ci-dessus, sélectionnez le module dans l'utilitaire d'installation et cliquez sur "Next" pour l'installer. Relancez l'utilitaire d'installation après l'installation de chaque module.
   
   Lorsque toutes les installations sont terminées, cliquez sur Terminer.
   
   Pour l'utilisation de la commande update, reportez-vous au fichier <racine_installation>/updateinstaller/docs/readme_updateinstaller.html.
   
   Remarque sur l'installation de la mise à jour du logiciel SDK Java : comme indiqué précédemment, elle comporte deux étapes. La première étape consiste à lancer l'utilitaire d'installation de mises à jour et à sélectionner le module de maintenance 6.0.2-WS-WASJavaSDK-<plateforme>-FP0000017.pak. Ensuite, relancez de nouveau l'utilitaire d'installation de mises à jour et choisissez le même module de maintenance à installer.
   
   

Configuration de Business Process Choreographer
(WebSphere Process Server uniquement)

Pendant l'installation du groupe de correctifs, les éléments de Business Process Choreographer fournis au format EAR sont mis à jour dans le système de fichiers. Cependant, ces fichiers ne sont pas automatiquement déployés dans la configuration de l'environnement d'exécution de WebSphere Process Server. Pour cela, consultez la procédure ci-dessous qui s'applique aux serveurs autonomes, dans des environnements Network Deployment et qui permet de minimiser la durée d'immobilisation des environnements groupés :

1. Pour les profils autonomes
   Pour chaque profil autonome utilisant Business Process Choreographer, effectuez les opérations suivantes :
   1. Veillez à ce que le serveur d'applications sur lequel est configuré Business Process Choreographer soit arrêté.
   2. Installez le groupe de correctifs 4 de la version 6.0.1 sur l'installation autonome.
   3. Accédez au répertoire <racine_installation>/ProcessChoreographer.
   4. Selon votre plateforme, utilisez l'une des commandes suivantes :
      Sous Windows :

      ..\bin\wsadmin -conntype NONE -profileName <nom_profil> -f bpeupgrade.jacl

      Sous UNIX et Linux :
      

      ../bin/wsadmin.sh -conntype NONE -profileName <nom_profil> -f bpeupgrade.jacl

      (<nom_profil> représente le nom du profil contenant la configuration de Business Process Choreographer).
   5. Relancez le serveur d'applications.


2. Pour les serveurs non groupés dans un environnement Network Deployment
   
   1. Arrêtez le gestionnaire de déploiement.
   2. Installez le groupe de correctifs 4 de la version 6.0.1 sur l'installation du gestionnaire de déploiement.
   3. Lancez le gestionnaire de déploiement.
   4. Effectuez les opérations suivantes pour chaque noeud d'un ou plusieurs serveurs où vous avez configuré Business Process Choreographer :
      1. Veillez à ce que tous les serveurs (serveurs d'applications et agents de noeud) sur lesquels Business Process Choreographer doit être mis à niveau soient arrêtés.
      2. Installez le groupe de correctifs 4 de la version 6.0.1 sur l'installation du noeud.
      3. Sur le noeud, accédez au répertoire <racine_installation>/ProcessChoreographer.
      4. Selon votre plateforme, utilisez l'une des commandes suivantes :
         Sous Windows :

         ..\bin\wsadmin -profileName <nom_profil> -f bpeupgrade.jacl

         Sous UNIX et Linux :
         

         ../bin/wsadmin.sh -profileName <nom_profil> -f bpeupgrade.jacl

         (<nom_profil> représente le nom du profil du noeud).
      5. Relancez tous les serveurs du noeud.


3. Pour les clusters dans un environnement Network Deployment
   Remarque : pour connaître la procédure de mise à niveau des clusters entraînant une durée d'immobilisation minimale, consultez la section D ci-dessous.
   1. Arrêtez le gestionnaire de déploiement.
   2. Installez le groupe de correctifs 4 de la version 6.0.1 sur l'installation du gestionnaire de déploiement.
   3. Lancez le gestionnaire de déploiement.
   4. Pour chaque cluster où Business Process Choreographer est configuré, effectuez les opérations suivantes :
      1. Veillez à ce que les membres du cluster et leurs agents de noeud soient arrêtés.
      2. Installez le groupe de correctifs 4 de la version 6.0.1 sur toutes les installations hébergeant des membres de cluster.
      3. Dans le gestionnaire de déploiement, accédez au répertoire <racine_installation>/ProcessChoreographer.
      4. Selon votre plateforme, utilisez l'une des commandes suivantes :
         Sous Windows :

         ..\bin\wsadmin -profileName <nom_profil> -cluster <nom_cluster> -f bpeupgrade.jacl

         Sous UNIX et Linux :
         

         ../bin/wsadmin.sh -profileName <nom_profil> -cluster <nom_cluster> -f bpeupgrade.jacl

         (<nom_profil> est le nom du profil du gestionnaire de déploiement et <nom_cluster> est le nom du cluster).
      5. Relancez tous les membres du cluster.


4. Pour les clusters d'un environnement Network Deployment dans lequel une durée d'immobilisation minimale pendant une mise à niveau est requise
   Les instructions suivantes s'appliquent à un environnement groupé réparti devant être mis à niveau avec une durée d'immobilisation minimale des serveurs d'applications. Ces instructions sont basées sur une configuration standard qui devra peut-être être adaptée à votre environnement :
   • Le gestionnaire de déploiement est installé sur une machine indépendante.
   • Le cluster comprend au moins deux serveurs, situés chacun sur un poste de travail.
   • La synchronisation automatique des noeuds est activée (option par défaut).
   
   Pour mettre à jour la configuration de Business Process Choreographer, effectuez les opérations suivantes :
   
   1. Arrêtez le gestionnaire de déploiement.
   2. Installez le groupe de correctifs 4 de la version 6.0.1 sur l'installation du gestionnaire de déploiement.
   3. Lancez le gestionnaire de déploiement.
   4. Pour chaque cluster où Business Process Choreographer est configuré, effectuez les opérations suivantes :
      
      1. Arrêtez la moitié des membres du cluster et leurs agents de noeud (par exemple, s'il y a deux membres, arrêtez-en un).
      2. Installez le groupe de correctifs 4 de la version 6.0.1 sur l'installation correspondante. Ne relancez pas encore les serveurs.
      3. Arrêtez les autres membres du cluster. Cette courte durée d'immobilisation ne peut être évitée.
      4. Dans le gestionnaire de déploiement, accédez au répertoire <racine_installation>/ProcessChoreographer.
      5. Selon votre plateforme, utilisez l'une des commandes suivantes :
         Sous Windows :

         ..\bin\wsadmin -profileName <nom_profil> -cluster <nom_cluster> -f bpeupgrade.jacl

         Sous UNIX et Linux :
         

         ../bin/wsadmin.sh -profileName <nom_profil> -cluster <nom_cluster> -f bpeupgrade.jacl

         (<nom_profil> est le nom du profil du gestionnaire de déploiement et <nom_cluster> est le nom du cluster).
      6. Relancez les membres du cluster dont les noeuds ont reçu le groupe de correctifs 4 de la version 6.0.1.
      7. Installez le groupe de correctifs 4 de la version 6.0.1 sur les installations des membres de cluster restants. Relancez chaque membre de cluster lorsque le groupe de correctifs a été installé.

Haut de page

Incidents recensés :
Tous les processus Java de WebSphere Application Server doivent être arrêtés avant d'utiliser le logiciel Update Installer for WebSphere Software. Consultez la note technique suivante pour plus d'informations :
http://www.ibm.com/support/docview.wss?rs=180&uid=swg21199141

Incident :
L'exemple de cotation en bourse échoue après l'installation du nouveau niveau de correctif.
Solution :
Si vous avez déployé l'exemple de cotation en bourse, vous devez le mettre à jour avec la nouvelle version. Depuis la console d'administration :

1. Cliquez sur Applications -> Applications d'entreprise.
2. Sélectionnez StockQuote et cliquez sur Mettre à jour.
3. Parmi les options de mise à jour des applications, sélectionnez le système de fichiers local, puis sélectionnez <racine_installation>/samples/lib/ESBStockQuoteSample/StockQuote.ear.
4. Cliquez sur Suivant. Acceptez les liaisons et les mappages par défaut, puis cliquez de nouveau sur Suivant.
5. Acceptez les options d'installation par défaut et passez à l'étape Récapitulatif.
6. Cliquez sur Terminer.
7. Cliquez sur Sauvegarde des modifications dans le référentiel principal.

• Le programme de désinstallation ne supprime pas le produit correctement.
• Le redémarrage des mises à jour du SDK ne lance pas l'utilitaire d'installation de mises à jour.
  Il s'agit d'un incident recensé sur certains systèmes HP-UX. Utilisez toujours la dernière version du logiciel Update Installer for WebSphere Software pour installer les kits de maintenance.
• La ligne de commande reprend la main prématurément lorsque l'utilitaire d'installation de mises à jour annule un SDK IBM mis à jour.
  Si l'espace disque disponible est insuffisant, l'utilitaire d'installation de mises à jour ne redémarre pas après avoir copié le SDK.
• Après l'installation de WebSphere Application Server 6.0.2, le démarrage des profils qui ne sont pas installés à la racine du système génère une erreur.
• Un incident se produit lors du clonage de SDK pour les mises à jour du SDK du produit.
• Les scripts de mise à jour et d'annulation de profils sont limités aux jeux de caractères SBCS et aux caractères sans signe diacritique en raison de limites du système d'exploitation.
• Des profils WebSphere Application Server 6.0.2 peuvent persister après l'annulation de WebSphere Application Server 6.0.2.

Haut de page

Informations complémentaires :
Pour plus d'informations sur ces rubriques, consultez les centres de documentation de WebSphere Process Server ou de WebSphere Enterprise Service Bus.

Pour plus d'informations sur les stratégies de mise à jour ou pour obtenir des mises à jour pour WebSphere Process Server ou WebSphere Enterprise Service Bus, voir aussi les pages des mises à jour recommandées pour WebSphere Process Server et pour WebSphere Enterprise Service Bus, ainsi que la page Stratégie de mise à jour de WebSphere Application Server version 6.0.

Haut de page

Fichier readme de l'utilitaire d'installation de mises à jour
Pour plus d'informations sur l'utilitaire d'installation de mises à jour, consultez le fichier readme en ligne http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg27006162.

Après avoir décompressé la version 6.0.1.4, vous pouvez consulter le fichier readme (racine_installation/updateinstaller/docs/readme_updateinstaller.html). Cependant, la version en ligne est mise à jour périodiquement, ce qui n'est pas le cas de la version locale incluse.

Haut de page

Marques :
Pour obtenir des informations sur les marques, consultez la page Web d'IBM Conditions d'utilisation.