Instructions d'installation - Version 6.0.1.3

Instructions d'installation

Résumé
Ce document regroupe les instructions relatives à l'installation d'IBM(r) WebSphere(r) Enterprise Service Bus et d'IBM WebSphere Process Server, version 6.0.1, groupe de correctifs 3 (6.0.1.3).
Table des matières
Copyright International Business Machines Corporation 2006. All rights reserved.
US Government Users Restricted Rights: Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

A propos de la version 6.0.1, groupe de correctifs 3
Ce groupe de correctifs constitue un kit de maintenance pour une combinaison produit/plateforme donnée. Il s'agit d'un seul module qui regroupe plusieurs correctifs.

Après l'installation de la version 6.0.1, groupe de correctifs 3, le niveau de votre produit WebSphere Enterprise Service Bus ou WebSphere Process Server sera 6.0.1.3.

Pour plus de détails sur l'installation de ce groupe de correctifs, reportez-vous à la section Procédure d'installation de la version 6.0.1, groupe de correctifs 3.

Haut de page

Historique des changements
Edition : 30 septembre 2006
Publication : 30 septembre 2006

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 et 2), les incidents résolus par le présent groupe de correctifs sont présentés dans le document V6.0.1 Fix Pack 3 Content, à l'adresse : ftp://ftp.software.ibm.com/software/ts/cw/servers/wps/r601/FP/3/6013DefectList.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 ou 6.0.1.2.

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 (/tmp sous Linux(r) ou UNIX(r)) et 600 Mo supplémentaires dans le système de fichiers contenant l'image de WebSphere Enterprise Service Bus ou de WebSphere Process Server (/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 3



  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/maintenance"
    ("<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".
    IMPORTANT : Pour utiliser une version de l'utilitaire d'installation de mises à jour plus récente que la version déjà installée, sauvegardez et supprimez le répertoire <racine_installation>/updateinstaller", ainsi que ses sous-répertoires. Si vous n'êtes pas certain d'avoir besoin d'une nouvelle version de l'utilitaire d'installation de mises à jour, sauvegardez, puis supprimez le répertoire updateinstaller. Le nouveau groupe de correctifs comporte en effet une nouvelle version de cet utilitaire.

  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 3, 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.3 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 groupe de correctifs 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 groupe de correctifs 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-FP0000003.zip

    Si la commande unzip n'est pas disponible, lancez la commande "jar -xvf" pour utiliser le fichier binaire JAR de l'installation du SDK Java 2 fournie 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 du fichier binaire "updateinstaller/update" pour le rendre exécutable. Pour cela, lancez la commande "chmod a+x updateinstaller/update".

    Le module téléchargeable 6.0.1.3 contient l'utilitaire d'installation de mises à jour et les fichiers du groupe de correctifs 6.0.1.3. Le produit Update Installer for WebSphere Software se trouve 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. Depuis le répertoire <racine_installation>/updateinstaller/, exécutez le fichier binaire update pour lancer le programme d'installation graphique et suivez les instructions d'installation du groupe de correctifs.

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

    1. 6.0.2-WS-WAS-<plateforme>-FP0000013.pak
    2. 6.0.2-WS-WASJavaSDK-<plateforme>-FP0000011.pak
      Remarque : l'installation de ce module Java SDK se déroule en deux étapes. Suivez scrupuleusement les instructions affichées pour ce module.
    3. 6.0.2.12-WS-WAS-IFPK29634.pak
    4. WS-WAS-IF353793.pak
    5. 6.0.1-WS-WPS-ESB-<plateforme>-FP0000003.pak

    Pour chaque fichier de la liste, sélectionnez le module dans l'utilitaire d'installation et cliquez sur "Suivant" pour l'installer. Relancez l'utilitaire d'installation après l'installation de chaque module.

    Remarque : le module Java SDK n'est pas fourni pour la plateforme Solaris x86-64 car il était déjà proposé dans le module d'installation 6.0.1.0 pour Solaris x86-64.

    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 de Java SDK : 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>-FP0000011.pak. Ensuite, arrêtez et quittez l'utilitaire d'installation de mises à jour. Ne sélectionnez pas l'option de redémarrage. Ensuite, lancez de nouveau l'utilitaire d'installation de mises à jour et choisissez le même module de maintenance à installer. Lorsque l'installation du module a abouti, quittez l'utilitaire d'installation de mises à jour et procédez à l'installation des autres modules. L'installation de la mise à jour de Java SDK doit être exécutée depuis l'interface graphique de l'utilitaire d'installation et non depuis une ligne de commande.

    Pour effectuer une installation en mode silencieux depuis une invite de commande :
    Pour chaque nom de module de la liste ci-dessus (et toujours dans l'ordre indiqué), utilisez les commandes suivantes en remplaçant <nom_module> par le nom de fichier dans la liste :

    Sous Windows :
    cd <racine_installation>\updateinstaller
    update -silent -W maintenance.package=.\maintenance\<nom_module>

    Sous UNIX :
    cd <racine_installation>/updateinstaller
    ./update -silent -W maintenance.package=./maintenance/<nom_module>

Haut de page

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 3 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 3 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 3 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 3 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 3 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 :
    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 3 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 3 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 agents de noeud ont reçu le groupe de correctifs 3 de la version 6.0.1.
      7. Installez le groupe de correctifs 3 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.


Consultez le fichier readme de l'utilitaire d'installation de mises à jour pour les solutions palliatives aux incidents suivants :
Incidents :

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.3, 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.