Instructions d'installation

Table des matières

• A propos du groupe de mises à jour 2 de la version 6.0 (6.0.2.0)
• Historique des changements
• Prérequis du groupe de mises à jour
• Espace requis
• Procédure d'installation du groupe de mises à jour 2 de la version 6.0 (6.0.2.0)
• Procédure d'installation dans un environnement de déploiement réseau
• Incidents recensés
• Informations complémentaires
• Fichier readme de l'utilitaire d'installation de mises à jour
• Marques

Historique des changements
Edition : 22 décembre 2006
Publication : 22 décembre 2006

Haut de page

Prérequis du groupe de mises à jour
Pour pouvoir utiliser ce groupe de mises à jour, 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, 6.0.1.3 ou 6.0.1.4.

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 mises à jour. 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 mises à jour 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 mises à jour, soit de 25 à 750 Mo.

Haut de page

Procédure d'installation du groupe de mises à jour 2 de la version 6.0 (6.0.2.0)

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 mises à jour assurent la maintenance des profils existants. L'utilitaire d'installation de mises à jour vous invite à sauvegarder votre configuration lorsque vous installez un groupe de mises à jour qui exige la maintenance de profils.
   A l'aide de la commande backupConfig, sauvegardez la configuration de chaque profil pouvant être mis à jour par le groupe de mises à 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 mises à jour, l'utilitaire d'installation de mises à jour ne désinstalle pas ses mises à jour 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 mises à jour, 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 mises à jour, 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 pour l'installation du serveur devant être mise à niveau. Cela inclut le processus nodeagent, le processus du gestionnaire de déploiement et tous les processus serveur appartenant aux produits devant être mis à jour, tels que IBM HTTP Server. Pour plus d'informations sur la mise à niveau d'un environnement de déploiement réseau, voir la section "Procédure d'installation dans un environnement de déploiement réseau".
   
   Si vous installez le groupe de mises à jour 2 de la version 6.0 (6.0.2.0) 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 mises à jour dans un environnement Network Deployment avec une durée d'immobilisation minimale, reportez-vous à la section C "Pour les clusters d'un environnement Network Deployment dans lequel une durée d'immobilisation minimale pendant une mise à niveau est requise".
   
   
5. Téléchargez le groupe de mises à jour 6.0.2.0 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 et l'utilitaire d'installation du groupe de mises à jour 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-WS-WPS-ESB-LinuxX32-RP0000002.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 des fichiers "updateinstaller/update" et "updateinstaller/updateWPS-WESB-6020.sh" pour les rendre exécutables. Pour cela, lancez la commande "chmod a+x updateinstaller/update*".
   
   Le module téléchargeable 6.0.2.0 contient l'utilitaire d'installation de mises à jour, les fichiers du groupe de mises à jour 6.0.2.0 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 mises à jour sont situés 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-6020

   
   Sous Linux et UNIX :
   

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

   
   Important :
   Si vous avez commencé d'installer certains éléments du module de maintenance, vous devrez modifier le script pour les supprimer. Si vous avez déjà installé le groupe de correctifs 4 de la version 6.0.1 (6.0.1.4), alors le groupe de correctifs 17 de WAS version 6.0.2 (6.0.2.17) et le logiciel SDK de cette version, compris dans le groupe de mises à jour 2 de la version 6.0 (6.0.2.0) sont déjà installés. 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-IFPK34465.pak 6.0.2.17-WS-WAS-IFPK33358.pak 6.0.2.18-WS-WAS-IFPK34001.pak 6.0-WS-WPS-ESB-<plateforme>-RP0000002.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.
   
   

Procédure d'installation dans un environnement de déploiement réseau

1. Pour les serveurs non groupés dans un environnement Network Deployment
   
   1. Arrêtez le gestionnaire de déploiement.
   2. Installez le groupe de mises à jour 2 de la version 6.0 (6.0.2.0) sur l'installation du gestionnaire de déploiement.
   3. Lancez le gestionnaire de déploiement.
   4. Pour chaque noeud fédéré n'appartenant pas à l'installation du gestionnaire de déploiement, effectuez les opérations suivantes :
      1. Arrêtez tous les serveurs (serveurs d'applications et agents de noeud).
      2. Installez le groupe de mises à jour 2 de la version 6.0 (6.0.2.0) sur l'installation du noeud. Si le message "INSTCONFPARTIALSUCCESS" est renvoyé, consultez le journal <racine_installation>/logs/wbi/99SWbiProfileUpgrade.log. Si une erreur a été générée, tentez de la résoudre (elle est probablement causée par l'impossibilité d'établir une connexion au gestionnaire de déploiement), puis effectuez les opérations suivantes :
         1. Sur le noeud (et non sur le gestionnaire de déploiement), accédez au répertoire <racine_installation>/util.
         2. Pour chaque profil associé à une erreur dans le fichier 99SWbiProfileUpgrade.log, exécutez l'une des commandes suivantes, selon votre plateforme :
            Sous Windows :

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

            Sous UNIX et Linux :
            

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

            (<nom_profil> représente le nom du profil du noeud). Si les fonctions de sécurité globale de WebSphere sont activées, vous devez également indiquer les paramètres "-user <ID_utilisateur> -password <mot_de_passe>" (<ID_utilisateur> correspond à un ID utilisateur du registre d'utilisateurs, qui dispose de droits d'administration et <mot_de_passe> correspond au mot de passe de cet ID).
      3. Relancez tous les serveurs du noeud.


2. 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 C ci-dessous.
   1. Arrêtez le gestionnaire de déploiement.
   2. Installez le groupe de mises à jour 2 de la version 6.0 (6.0.2.0) sur l'installation du gestionnaire de déploiement.
   3. Lancez le gestionnaire de déploiement.
   4. Pour chaque cluster, effectuez les opérations suivantes :
      1. Arrêtez tous les membres du cluster.
      2. Installez le groupe de mises à jour 2 de la version 6.0 (6.0.2.0) sur toutes les installations hébergeant des membres de cluster. Si le message "INSTCONFPARTIALSUCCESS" est renvoyé, consultez le journal <racine_installation>/logs/wbi/99SWbiProfileUpgrade.log. Si une erreur a été générée, tentez de la résoudre (elle est probablement causée par l'impossibilité d'établir une connexion au gestionnaire de déploiement), puis effectuez les opérations suivantes :
         1. Pour chaque installation de membre de cluster, accédez au répertoire <racine_installation>/util.
         2. Pour chaque profil associé à une erreur dans le fichier 99SWbiProfileUpgrade.log, exécutez l'une des commandes suivantes, selon votre plateforme :
            Sous Windows :

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

            Sous UNIX et Linux :
            

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

            (<nom_profil> représente le nom du profil). Si les fonctions de sécurité globale de WebSphere sont activées, vous devez également indiquer les paramètres "-user <ID_utilisateur> -password <mot_de_passe>" (<ID_utilisateur> correspond à un ID utilisateur du registre d'utilisateurs, qui dispose de droits d'administration et <mot_de_passe> correspond au mot de passe de cet ID).
      3. Sur le gestionnaire de déploiement, accédez au répertoire <racine_installation>/util.
      4. Selon votre plateforme, utilisez l'une des commandes suivantes :
         Sous Windows :

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

         Sous UNIX et Linux :
         

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

         (<nom_profil> est le nom du profil du gestionnaire de déploiement et <nom_cluster> est le nom du cluster). Si les fonctions de sécurité globale de WebSphere sont activées, vous devez également indiquer les paramètres "-user <ID_utilisateur> -password <mot_de_passe>" (<ID_utilisateur> correspond à un ID utilisateur du registre d'utilisateurs, qui dispose de droits d'administration et <mot_de_passe> correspond au mot de passe de cet ID).
      5. Relancez tous les membres du cluster.


3. 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).
   
   
   1. Arrêtez le gestionnaire de déploiement.
   2. Installez le groupe de mises à jour 2 de la version 6.0 (6.0.2.0) sur l'installation du gestionnaire de déploiement.
   3. Lancez le gestionnaire de déploiement.
   4. Pour chaque cluster, effectuez les opérations suivantes :
      
      1. Arrêtez la moitié des membres du cluster (par exemple, s'il y a deux membres, arrêtez-en un).
      2. Installez le groupe de mises à jour 2 de la version 6.0 sur l'installation correspondante. Ne relancez pas encore les serveurs. Si le message "INSTCONFPARTIALSUCCESS" est renvoyé, consultez le journal <racine_installation>/logs/wbi/99SWbiProfileUpgrade.log. Si une erreur a été générée, tentez de la résoudre (elle est probablement causée par l'impossibilité d'établir une connexion au gestionnaire de déploiement), puis effectuez les opérations suivantes :
         1. Pour chaque installation de membre de cluster, accédez au répertoire <racine_installation>/util.
         2. Pour chaque profil associé à une erreur dans le fichier 99SWbiProfileUpgrade.log, exécutez l'une des commandes suivantes, selon votre plateforme :
            Sous Windows :

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

            Sous UNIX et Linux :
            

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

            (<nom_profil> est le nom du profil du gestionnaire de déploiement et <nom_cluster> est le nom du cluster). Si les fonctions de sécurité globale de WebSphere sont activées, vous devez également indiquer les paramètres "-user <ID_utilisateur> -password <mot_de_passe>" (<ID_utilisateur> correspond à un ID utilisateur du registre d'utilisateurs, qui dispose de droits d'administration et <mot_de_passe> correspond au mot de passe de cet ID).
      3. Arrêtez les autres membres du cluster. Cette courte durée d'immobilisation ne peut être évitée.
      4. Sur le gestionnaire de déploiement, accédez au répertoire <racine_installation>/util.
      5. Selon votre plateforme, utilisez l'une des commandes suivantes :
         Sous Windows :

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

         Sous UNIX et Linux :
         

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

         (<nom_profil> est le nom du profil du gestionnaire de déploiement et <nom_cluster> est le nom du cluster). Si les fonctions de sécurité globale de WebSphere sont activées, vous devez également indiquer les paramètres "-user <ID_utilisateur> -password <mot_de_passe>" (<ID_utilisateur> correspond à un ID utilisateur du registre d'utilisateurs, qui dispose de droits d'administration et <mot_de_passe> correspond au mot de passe de cet ID).
      6. Relancez les membres du cluster dont les noeuds ont reçu le groupe de mises à jour 2 de la version 6.0.
      7. Installez le groupe de mises à jour 2 de la version 6.0 sur les installations des membres de cluster restants. Relancez chaque membre de cluster lorsque le groupe de mises à jour 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 groupe de mises à jour.
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.

1. Dans le panneau Sommaire, cliquez sur WebSphere Process Server for Multiplatforms, Version 6.0.x.
2. Accédez au dossier correspondant à la version 6.0.2.
3. Sélectionnez les rubriques suivantes :
   Administration de WebSphere Process Server->Administration des ressources WebSphere Process Server->Overview of business rules and selectors>Business rules manager.

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