Mise à niveau de WebSphere Business Integration Connect - Express Version 4.2.1 vers WebSphere Partner Gateway - Express Version 6.0 -- toutes plateformes

La présente section décrit la procédure de mise à niveau de Business Integration Connect - Express version 4.2.1 vers WebSphere Partner Gateway - Express version 6.0. La procédure de mise à niveau utilise une interface graphique et s'applique à toutes les plateformes sur lesquelles Business Integration Connect - Express version 4.2.1 est installé.

Remarque :
Si vous installez WebSphere Partner Gateway - Express pour la première fois, reportez-vous aux instructions d'installation figurant dans l'une des sections suivantes, selon le type d'installation que vous effectuez :

Les étapes suivantes expliquent comment procéder :

  1. Arrêtez la version 4.2.1 de Business Integration Connect - Express.
    1. Si une version existante de Business Integration Connect - Express est en cours d'exécution, assurez-vous que tous les documents en cours de progression ont terminé le traitement.
    2. Fermez toutes les sessions de navigateur Web ouvertes qui sont connectées à la console WebSphere Partner Gateway - Express.
    3. Arrêtez le serveur WebSphere Partner Gateway - Express.
  2. Installez WebSphere Partner Gateway - Express version 6.0 à l'aide du programme d'installation.
    Remarque :
    Le programme d'installation détecte la version 4.2.1 de Business Integration Connect - Express et sauvegarde ses données.
    1. Lancez le programme d'installation à l'aide du tableau de bord (Launchpad).

      Sur une plateforme Windows : insérez le CD-ROM de WebSphere Partner Gateway - Express 6.0 dans le lecteur de CD-ROM de l'ordinateur. La fenêtre du tableau de bord (Launchpad) s'ouvre.

      Remarque :
      Si le tableau de bord (Launchpad) ne s'ouvre pas automatiquement, vous pouvez le démarrer manuellement en exécutant LaunchPad.bat, situé dans le répertoire racine du CD-ROM.

      Sur une plateforme Linux : insérez le CD-ROM de WebSphere Partner Gateway - Express 6.0 dans le lecteur de CD-ROM de l'ordinateur. Ouvrez le tableau de bord (Launchpad) en exécutant LaunchPad.sh, situé dans le répertoire racine du CD-ROM.

      Remarque :
      Vous pouvez également ignorer cette méthode et exécuter le programme d'installation en vous plaçant dans le répertoire de WebSphere Partner Gateway - Express et en exécutant setupLinux. Si vous procédez ainsi, la fenêtre de l'assistant d'installation s'ouvre, suivie d'un message vous indiquant qu'une version antérieure de Business Integration Connect - Express a été détectée. Passez à l'étape 2c.

      Sur un système exécutant i5/OS ou OS/400 : insérez le CD-ROM de WebSphere Partner Gateway - Express 6.0 dans le lecteur de CD-ROM du PC Windows connecté au système exécutant i5/OS ou OS/400. La fenêtre du tableau de bord (Launchpad) s'ouvre.

      Remarque 1 :
      Si le tableau de bord (Launchpad) ne démarre pas automatiquement, vous pouvez le démarrer manuellement en naviguant jusqu'au dossier express et en cliquant deux fois sur Launchpad.bat.

      Remarque 2 :
      Si vous le souhaitez, vous pouvez également ignorer cette procédure et démarrer le programme d'installation en exécutant la commande setup.exe -os400. Dans ce cas, la fenêtre de connexion au serveur s'affiche. Passez à l'étape 2c.

      Avertissement :
      Si vous omettez le paramètre -os400 dans la commande setup.exe -os400, l'installation se produit sur la machine Windows.

      La fenêtre du tableau de bord (Launchpad) présente cinq options :

      • Présentation du produit qui utilise votre navigateur Web pour afficher le site Web IBM contenant des informations relatives à WebSphere Partner Gateway - Express.
      • Fichier ReadMe qui ouvre le fichier ReadMe sur le disque d'installation.
      • Documentation du Centre d'aide et d'information qui utilise le navigateur Web pour afficher le site Web de la bibliothèque IBM WebSphere Partner Gateway - Express à partir de laquelle vous pouvez télécharger la documentation relative à une édition de WebSphere Partner Gateway - Express.
      • Installation du produit qui lance l'assistant d'installation.
      • Quitter qui ferme la fenêtre du tableau de bord (Launchpad).
    2. Cliquez sur Installation du produit.

      La fenêtre de l'assistant d'installation s'ouvre, suivie d'un message vous indiquant qu'une version antérieure de Business Integration Connect - Express a été détectée.

    3. Cliquez sur Suivant dans le panneau "Version antérieure détectée".

      La fenêtre de sauvegarde automatique s'ouvre, vous demandant si vous souhaitez copier les données de Business Integration Connect - Express version 4.2.1 dans un répertoire de sauvegarde.

    4. Cliquez sur le bouton Oui et assurez-vous que le chemin d'accès à l'emplacement de l'installation courante de Business Integration Connect - Express version version 4.2.1 est correct.
    5. Cliquez sur Suivant.

      Les données de Business Integration Connect - Express version 4.2.1 commencent à se copier dans le sous-répertoire 421_backup sous le répertoire d'installation de WebSphere Partner Gateway - Express version 6.0. Une boîte d'état s'ouvre montrant la progression de l'opération de sauvegarde. Une fois la copie des données terminée, la boîte d'état se ferme.

    6. Cliquez sur Suivant. La fenêtre Port HTTP s'affiche. L'assistant d'installation détecte les ports en cours d'utilisation, puis affecte les ports non utilisés par défaut pour une utilisation par WebSphere Partner Gateway - Express.

      Les types de ports suivants sont affichés :

      • Port HTTP : port de communication par défaut pour les communications normales
      • Port HTTPS1 : port de communication utilisé pour les communications sécurisées (chiffrées)
      • Port HTTP2 : double du port de communication par défaut pour les communications normales
      • Port HTTPS2 : double du port de communication utilisé pour les communications sécurisées (chiffrées)
      • Port d'amorçage : port utilisé en interne par WebSphere Partner Gateway pour démarrer la version imbriquée de WebSphere Application Server
      • Port de l'adresse SOAP : port utilisé en interne par WebSphere Partner Gateway pour démarrer la version imbriquée de WebSphere Application Server
    7. Assurez-vous que le numéro de port HTTP est le même que celui qui est utilisé dans l'installation de la version 4.2.1. Si les autres ports par défaut (HTTPS1, HTTP2, HTTPS2, amorçage [Bootstrap] et SOAP) affichés n'entrent pas en conflit avec d'autres ressources de l'ordinateur, acceptez-les.
      Remarque :
      Si vous indiquez un port HTTP déjà utilisé, le système envoie un avertissement et une exception lorsque vous démarrez le serveur. Dans ce cas, réinstallez WebSphere Partner Gateway - Express et choisissez un autre port HTTP.
    8. Cliquez sur Suivant. La fenêtre Nom du dossier par défaut s'affiche.
    9. Cette fenêtre affiche le nom du dossier du menu de raccourci que WebSphere Partner Gateway - Express installe dans le menu Démarrer > Programmes. Vous pouvez accepter le nom par défaut ou le modifier.
    10. Cliquez sur Suivant. La fenêtre Paramètres du service apparaît.
    11. Cliquez sur Suivant. La fenêtre d'installation de service de Windows s'affiche. Si vous voulez enregistrer WebSphere Partner Gateway - Express en tant que service Windows, cochez la case Install as a Windows Service (Installer en tant que service Windows).
      Remarque :
      Vous devez disposer des privilèges d'administrateur pour configurer WebSphere Partner Gateway - Express afin qu'il s'exécute en tant que service. Si vous n'avez pas les privilèges d'administrateur, le fenêtre Vérification de l'administrateur apparaît. Vous devez cliquer surPrécédent et désélectionner la case Exécuter WebSphere en tant que service.
    12. Cliquez sur Suivant. La fenêtre Récapitulatif apparaît.
    13. Vérifiez vos sélections dans la fenêtre Récapitulatif. Si vous devez modifier des choix, cliquez sur le bouton Précédent pour revenir à la fenêtre appropriée, effectuez vos modifications, puis cliquez sur Suivant jusqu'à revenir à la fenêtre Récapitulatif.
    14. Cliquez sur Suivant. Le programme installe le logiciel WebSphere Partner Gateway - Express (ceci peut prendre quelques minutes).
      Remarque :
      WebSphere Application Server 6.0 est automatiquement installé avec le produit WebSphere Partner Gateway - Express.
    15. Une fois la procédure d'installation achevée, la fenêtre des options de l'application Premiers pas s'affiche, vous demandant si vous souhaitez ou non lancer cette application. Pour apprendre à démarrer avec WebSphere Partner Gateway - Express, sélectionnez Oui. Sinon, cliquez sur Non.
      Remarque :
      Si vous avez installé WebSphere Partner Gateway - Express version 6.0 en tant que mise à niveau d'une version antérieure, sélectionnez Non pour éviter le démarrage de l'application Premiers Pas.
    16. Cliquez sur Suivant. La fenêtre de confirmation d'installation apparaît.
    17. Cliquez sur Terminer dans la fenêtre de confirmation d'installation pour achever la procédure. Si Oui a été sélectionné dans la fenêtre de lancement de l'application Premiers Pas, l'application s'ouvre. Pour plus d'informations sur l'utilisation de cette fonctionnalité, voir Utilisation de l'application Premiers Pas.
      Remarque :
      Sur des PC particulièrement rapides, la fenêtre Premiers Pas peut s'ouvrir dans la partie supérieure de la fenêtre de confirmation d'installation avant d'avoir cliqué sur Terminer. Dans ce cas, faites de la fenêtre de confirmation d'installation la fenêtre courante et cliquez sur Terminer pour la fermer avant de passer aux Premiers Pas.
  3. Démarrez le serveur WebSphere Partner Gateway - Express à l'aide du raccourci sur le bureau créé lors de l'installation de WebSphere Partner Gateway - Express 6.0.
    Remarque :
    Plusieurs minutes peuvent être nécessaires pour que le serveur WebSphere Partner Gateway - Express soit totalement opérationnel.
  4. Exécutez l'outil de pré-migration des données pour convertir les données de sécurité de la version 4.2.1 en données compatibles avec l'environnement 6.0. Les données de sécurité comprennent : La procédure suivante explique comment exécuter l'outil de pré-migration des données.
    1. Ouvrez une fenêtre d'invite de commande.
    2. Passez dans le répertoire WebSphere_Partner_Gateway_Express_Install_Dir.
    3. Exécutez le script de shell bcgMigrateConvertor.bat ou bcgMigrateConvertor.sh , selon votre système d'exploitation.
      Remarque :
      Si le répertoire 421_backup n'est pas un sous-répertoire du répertoire WebSphere_Partner_Gateway_Express_Install_Dir, vous devez spécifier le chemin d'accès complet au répertoire 421_backup comme le premier paramètre d .
    4. Lorsque l'exécution de l'outil de migration est terminée, fermez la fenêtre d'invite de commande.
  5. Exécutez l'outil de migration des données pour faire migrer les données de Business Integration Connect - Express version 4.2.1 enregistrées précédemment dans votre nouvelle installation de WebSphere Partner Gateway - Express version 6.0. Pour exécuter l'outil, procédez comme suit :
    1. Ouvrez une fenêtre de commande.
    2. Passez dans le répertoire WebSphere_Partner_Gateway_Express_Install_Dir/bin
    3. Exécutez le script de shell bcgMigrate.bat ou bcgMigrate.sh, selon votre système d'exploitation.
      Remarque :
      Si le répertoire 421_backup n'est pas un sous-répertoire du répertoire WebSphere_Partner_Gateway_Express_Install_Dir, vous devez spécifier le chemin d'accès complet au répertoire 421_backup comme premier paramètre.
    4. Lorsque l'exécution de l'outil de migration est terminée, fermez la fenêtre de commande.
  6. Exécutez WebSphere Partner Gateway - Express version 6.0 pour vérifier qu'il est correctement installé et configuré.
    1. Démarrez la console.
      Si l'écran de connexion s'ouvre dans une session de navigateur Web, cela signifie que le serveur est opérationnel. En revanche, s'il ne s'ouvre pas, attendez quelques minutes et essayez à nouveau de démarrer la console. Ne vous connectez pas.
    2. Fermez le navigateur Web pour quitter l'écran de connexion.
    3. Démarrez le serveur WebSphere Partner Gateway - Express à l'aide du raccourci sur le bureau créé lors de l'installation de WebSphere Partner Gateway - Express 6.0.
    4. Démarrez le serveur WebSphere Partner Gateway - Express à l'aide du raccourci situé sur le bureau et créé au cours de l'installation.
    5. Démarrez la console WebSphere Partner Gateway - Express à l'aide du raccourci situé sur le bureau et créé au cours de l'installation.

      WebSphere Partner Gateway - Express version 6.0 est maintenant prêt à être utilisé.

  7. Désinstallez Business Integration Connect - Express version 4.2.1. Pour plus d'instructions, reportez-vous à Annexe C. Désinstallation de WebSphere Partner Gateway - Express.

Copyright IBM Corp. 2003, 2005