Mise à niveau de Business Integration Connect

La procédure de mise à niveau suivante implique l'utilisation du même environnement pour la nouvelle version, et notamment la même configuration du gestionnaire de file d'attente MQSeries. Cette procédure implique également que la mise à niveau est destinée à la même édition de Business Integration Connect (par exemple, Enterprise version 4.2.x -> Enterprise version 4.2.x).

Pour mettre à niveau Business Integration Connect à la dernière version :

Arrêtez la version en cours :

  1. Arrêtez le réceptionnaire à l'aide du script shutdown_bcg.* correspondant à votre système d'exploitation. Le script shutdown_bcg.* est placé dans le répertoire suivant :
    {WBIC INSTALL DIR}/receiver/was/bin 
     

    A l'aide de l'afficheur de documents de la console, vérifiez que l'exécution des documents est terminée.

  2. Arrêtez le gestionnaire de documents à l'aide du script shutdown_bcg.* approprié à votre système d'exploitation. Le script shutdown_bcg.* est placé dans le répertoire suivant :
    {WBIC INSTALL DIR}/router/was/bin
     
  3. Arrêtez la console de communauté à l'aide du script stopServer.* correspondant à votre système d'exploitation. Le script stopServer.* est placé dans le répertoire {WBIC INSTALL DIR}/console/was/bin . Indiquez le nom du serveur server1 . Par exemple :
    {WBIC INSTALL DIR}/console/was/bin/stopServer.* server1
     

Sauvegardez la version en cours :

  1. Sauvegardez la base de données. Pour cela, adressez-vous à votre administrateur de base de données ou consultez la documentation relative à la base de données. Cette étape est importante car la base de données contient des données de Business Integration Connect difficiles à recréer.
  2. Sauvegardez l'arborescence commune de répertoires partagés, placée dans {WBIC INSTALL DIR}/common. Cette étape est importante car l'arborescence commune contient des données de Business Integration Connect difficiles à recréer, telles que les répertoires de stockage des messages et d'irréfutabilité.
  3. Sauvegardez les répertoires d'installation de Business Integration Connect de la version en cours. Par exemple : {WBIC INSTALL DIR}/console, {WBIC INSTALL DIR}/receiver et {WBIC INSTALL DIR}/router.


    Vous pouvez également répéter les étapes suivantes pour sauvegarder uniquement les données de configuration :

    1. Sauvegardez la configuration WAS imbriquée en appelant le script was/bin/backupConfig.* approprié à votre système d'exploitation. Copiez le fichier de sauvegarde WebSphereConfig*.zip vers l'emplacement de sauvegarde.
    2. Sauvegardez l'arborescence de sous-répertoires was/jndi/WBIC .
    3. Sauvegardez l'arborescence de sous-répertoires was/wbic/config.

Lancez le programme d'installation de Database Loader :

  1. Désinstallez Database Loader en entrant la commande suivante (en tant qu'administrateur sous Windows ou en tant qu'utilisateur root sous UNIX) :
    {WBIC INSTALL DIR}/DBLoader/_uninst/uninstall
     

    Important:
    Ne sélectionnez pas "Supprimer la base de données" durant la désinstallation. Si vous supprimez la base de données sans faire de sauvegarde, toutes les données seront perdues. La base de données existante va être mise à niveau dans les étapes suivantes.
  2. Lancez Database Loader mis à jour à partir du support, à l'aide du programme de lancement setup* spécifique à votre programme d'exploitation. Par exemple :
    {CD_ROM/MEDIA DIR}/DBLoader/setup*
     

    Remarque :
    Sous Windows, veillez à vous connecter en tant qu'utilisateur propriétaire de la base de données. Cet utilisateur est en général DB2ADMIN.

    Suivez les instructions ci-dessous :

    1. Indiquez les mêmes valeurs d'entrée utilisées dans la version précédente. Par exemple : ID utilisateurs, mots de passe, fournisseur de la base de données, etc.
    2. Vérifiez les valeurs de configuration par défaut et modifiez-les si nécessaire.
    3. Ne sélectionnez pas "Exécuter les fichiers SQL automatiquement".
  3. Lancez le script BCGUpgrade*.sql , placé dans le répertoire {WBIC INSTALL DIR}/DBLoader/scripts/DB2 ou {WBIC INSTALL DIR}/DBLoader/scripts/Oracle.
    Remarque :
    Chaque script BCGUpgrade_from-ver_to-ver.sql doit être exécuté en commençant par la version la plus ancienne qui s'applique à votre système puis en continuant avec chaque script suivant.

    DB2

    Exécutez les commandes suivantes :

    1. UNIX : su - db2inst1
      Windows : Lancez DB2CLP
      Remarque :
      Sous Windows, veillez à vous connecter en tant qu'utilisateur propriétaire de la base de données. Cet utilisateur est en général DB2ADMIN.
    2. db2start (si la base de données n'a pas été démarrée)
    3. db2 connect to bcgapps (où "bcgapps" correspond au nom de la base de données)
    4. cd {WBIC INSTALL DIR}/DBLoader/scripts/DB2
    5. Pour mettre à niveau la base de données, exécutez l'un des scripts suivants, selon votre version en cours :
      4.2.0 vers 4.2.1 :
      db2 -td! -f BCGUpgrade_420_421.sql -z
        /tmp/WBIConnect/logs/BCGUpgrade_420_421.log
       

      4.2.1.0 vers 4.2.1 (Fix Pack 1 non installé) :

      db2 -td! -f BCGUpgrade_421_421FP1.sql -z
        /tmp/WBIConnect/logs/BCGUpgrade_421_421FP1.log
       

      4.2.1.1 vers 4.2.2:

      db2 -td! -f BCGUpgrade_421FP1_422.sql -z
        /tmp/WBIConnect/logs/BCGUpgrade_421FP1_422.log
       
    6. Exécutez le script save_inputs.sql pour charger les données d'entrée de l'utilisateur DBLoader sur la base de données. Par exemple :
      db2 -td! -f save_inputs.sql -z
        /tmp/WBIConnect/logs/save_inputs.log
       

    Oracle

    Exécutez les commandes suivantes :

    Remarque :
    Sous Windows, vous devez être connecté en tant qu'administrateur.
    1. cd {WBIC INSTALL DIR}/DBLoader/scripts/Oracle
    2. Pour mettre à niveau la base de données, exécutez l'un des scripts suivants, selon votre version en cours :
      4.2.1.0 vers 4.2.1 (Fix Pack 1 non installé) :
      sqlplus -L bcgapps/password @BCGUpgrade_421_421FP1.sql
        >/tmp/WBIConnect/logs/BCGUpgrade_421_421FP1.log
       

      4.2.1.1 vers 4.2.2:

      sqlplus -L bcgapps/password @BCGUpgrade_421FP1_422.sql
        >/tmp/WBIConnect/logs/BCGUpgrade_421FP1_422.log
       
    3. Exécutez le script save_inputs.sql pour charger les données d'entrée de l'utilisateur DBLoader sur la base de données. Par exemple :
      sqlplus -L bcgapps/password @save_inputs.sql
        >/tmp/WBIConnect/logs/save_inputs.log
       

Mettez à jour la configuration des files d'attente MQSeries/JMS :

Remarque :
Sous Windows, vous devez être connecté en tant qu'administrateur.
  1. Pour UNIX : su -mqm
  2. Exécutez la commande suivante :
    runmqsc bcg.queue.manager < {CD_ROM/MEDIA DIR}
     /Tools/MQSeries/BCGUpgrade_Queues_v422.mqsc
     

    bcg.queue.manager est le nom du gestionnaire de file d'attente MQSeries.

Désinstallez la version précédente de Business Integration Connect :

  1. En tant qu'utilisateur administrateur sous Windows ou en tant qu'utilisateur root sous UNIX, désinstallez la version précédente en entrant la commande suivante :
    {WBIC INSTALL DIR}/_uninst/uninstaller
     

    Sélectionnez toutes les fonctions à désinstaller. Si un message s'affiche vous indiquant qu'un fichier du système a été modifié depuis l'installation, et vous demandant si vous souhaitez le supprimer, Cliquez sur Non

  2. Supprimez les arborescences de répertoires restantes.
    Important:
    Ne supprimez pas l'arborescence commune {WBIC INSTALL DIR}/. Elle contient la plupart des documents et des données d'exécution. Si vous supprimez l'arborescence commune sans faire de sauvegarde, toutes les données seront perdues.

Installez Business Integration Connect :

En tant qu'utilisateur administrateur sous Windows ou en tant qu'utilisateur root sous UNIX, installez Business Integration Connect à l'aide du programme de lancement setup* correspondant à votre système d'exploitation. Par exemple, CD_ROM/MEDIA DIR}/hub/setup*

  1. Indiquez les mêmes valeurs d'entrée utilisées dans la version précédente. Par exemple : ID utilisateurs, mots de passe, fournisseur de la base de données, etc.
  2. Vérifiez les valeurs de configuration par défaut et modifiez-les si nécessaire.
  3. Vérifiez que l'arborescence commune partagée est correcte.

Restaurez les configurations personnalisées :

Restaurez toute configuration personnalisée à partir de la version précédente. Les modifications des fichiers de configuration du Réceptionnaire et du Gestionnaire de documents proviennent de la version 4.2.2. Les fichiers de configuration de la version 4.2.2 doivent être utilisés. Ne remplacez les fichiers de configuration de la version 4.2.2 par l'ancienne version contenue dans le répertoire de sauvegarde.

Pour identifier les modifications effectuées sur les fichiers de configuration de l'installation 4.2.1, comparez le contenu de chaque fichier du répertoire de sauvegarde 4.2.1 avec les fichiers du répertoire d'installation 4.2.2. Fusionnez manuellement les modifications dans les fichiers 4.2.2.

Remarque :
Les fichiers version.properties de ces répertoires ne doivent pas être modifiés.

Comparez le contenu des fichiers placés dans les répertoires suivants :

console/was/wbic/config
 

receiver/was/wbic/config
 

router/was/wbic/config
 

Le fichier router/was/wbic/config/bcg.properties contient les propriétés bcg.alertNotifications.mail* et les informations de contact RosettaNet, placées dans les propriétés bcg.A01.from* . Si ces valeurs n'ont pas été entrées correctement lors de l'installation du concentrateur 4.2.2, les valeurs peuvent être copiées du fichier bcg.properties 4.2.1 vers le nouveau fichier router/was/wbic/config/bcg.properties 4.2.2.

Remarque :
Après une modification au module de base RosettaNet V02.00, celui-ci doit être rechargé via la console s'il a été précédemment installé.

Lancez Business Integration Connect :

Sous UNIX, reportez-vous à Démarrage de Business Integration Connect.

Sous Windows, reportez-vous à Démarrage de Business Integration Connect.

Copyright IBM Corp. 1997, 2004