Fazendo Upgrade do Business Integration Connect

Este procedimento de upgrade assume que o mesmo ambiente será utilizado para a nova versão, incluindo a configuração do gerenciador de filas da mesma versão do MQSeries. Ele também presume que o upgrade será para a mesma edição do Business Integration Connect (por exemplo, Enterprise versão 4.2.x -> Enterprise versão 4.2.x).

Para fazer upgrade do Business Integration Connect para a versão mais recente:

Feche a versão anterior:

  1. Pare o Receiver utilizando o script shutdown_bcg.* apropriado para o seu sistema operacional. O script shutdown_bcg.* está localizado no seguinte diretório:
    {WBIC INSTALL DIR}/receiver/was/bin
     

    Verifique o Document Viewer no console para certificar-se de que o processamento dos documentos em andamento foi concluído.

  2. Pare o Gerenciador de Documentos utilizando o script shutdown_bcg.* apropriado para o seu sistema operacional. O script shutdown_bcg.* está localizado no seguinte diretório:
    {WBIC INSTALL DIR}/router/was/bin
     
  3. Pare o Community Console utilizando o script stopServer.* apropriado para seu sistema operacional. O script stopServer.* está localizado no diretório {WBIC INSTALL DIR}/console/was/bin. Especifique server1 como o nome do servidor. Por exemplo:
    {WBIC INSTALL DIR}/console/was/bin/stopServer.* server1
     

Faça backup da versão anterior:

  1. Faça backup do banco de dados. Consulte o administrador do banco de dados ou a documentação do banco de dados para obter informações sobre como fazer isso. Essa etapa é importante porque o banco de dados contém dados do Business Integration Connect que são difíceis de recriar.
  2. Faça backup da árvore de diretórios comum compartilhada, localizada em {WBIC INSTALL DIR}/common. Essa etapa é importante porque a árvore comum, compartilhada, contém dados do Business Integration Connect, como, por exemplo, diretórios de armazenamento de mensagens e não-recusa, que são difíceis de recriar.
  3. Faça backup dos diretórios de instalação do Business Integration Connect anterior. Por exemplo: {WBIC INSTALL DIR}/console, {WBIC INSTALL DIR}/receiver e {WBIC INSTALL DIR}/router.


    De modo alternativo, você pode repetir as etapas a seguir para fazer backup apenas dos dados de configuração especificados:

    1. Faça backup da configuração WAS incorporada chamando o script was/bin/backupConfig.* apropriado para o seu sistema operacional. Copie o arquivo de backup WebSphereConfig*.zip para o local de backup.
    2. Faça backup da árvore de subdiretório was/jndi/WBIC.
    3. Faça backup da árvore de subdiretório was/wbic/config.

Execute o instalador do DBLoader:

  1. Desinstale o Database Loader digitando o seguinte comando (como usuário root ou Administrador ou como usuário root no UNIX):
    {WBIC INSTALL DIR}/DBLoader/_uninst/uninstall
     

    Importante:
    Não selecione "Drop the database" durante a desinstalação. A eliminação do banco de dados causará perda de dados se não houver backup dele. O upgrade do banco de dados existente será feito nas etapas subseqüentes.
  2. Execute o Database Loader com upgrade a partir do local da mídia, utilizando o ativador setup* específico para seu sistema operacional. Por exemplo:
    {CD_ROM/MEDIA DIR}/DBLoader/setup*
     

    Nota:
    Para Windows, certifique-se de que você tenha efetuado login como o usuário que possui o banco de dados. Esse usuário é geralmente DB2ADMIN.

    Siga as orientações a seguir:

    1. Especifique os mesmos valores de entrada utilizados na versão anterior. Por exemplo: IDs de usuários, senhas, fornecedor do banco de dados, etc.
    2. Verifique os padrões de configuração e os substitua conforme necessário.
    3. Não selecione "Run the SQL Files automatically".
  3. Execute o script BCGUpgrade*.sql, localizado no diretório {WBIC INSTALL DIR}/DBLoader/scripts/DB2 ou {WBIC INSTALL DIR}/DBLoader/scripts/Oracle.
    Nota:
    Cada script BCGUpgrade_from-ver_to-ver.sql deve ser executado começando pela última versão que se aplica ao seu sistema e continuando com o script subseqüente.

    DB2

    Execute os comandos a seguir:

    1. UNIX: su - db2inst1
      Windows: Inicie o DB2CLP
      Nota:
      Para Windows, certifique-se de que você tenha efetuado login como o usuário que possui o banco de dados. Esse usuário é geralmente DB2ADMIN.
    2. db2start (se o banco de dados não estiver iniciado)
    3. db2 connect to bcgapps (em que "bcgapps" é o nome do banco de dados)
    4. cd {WBIC INSTALL DIR}/DBLoader/scripts/DB2
    5. Execute um dos scripts a seguir, dependendo de sua versão existente, para fazer upgrade do banco de dados:
      4.2.0 para 4.2.1:
      db2 -td! -f BCGUpgrade_420_421.sql -z
        /tmp/WBIConnect/logs/BCGUpgrade_420_421.log
       

      4.2.1.0 para 4.2.1 (Fix Pack 1 não instalado):

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

      4.2.1.1 para 4.2.2:

      db2 -td! -f BCGUpgrade_421FP1_422.sql -z
        /tmp/WBIConnect/logs/BCGUpgrade_421FP1_422.log
       
    6. Execute o script save_inputs.sql para carregar as entradas de usuário do DBLoader no banco de dados. Por exemplo:
      db2 -td! -f save_inputs.sql -z
        /tmp/WBIConnect/logs/save_inputs.log
       

    Oracle

    Execute os comandos a seguir:

    Nota:
    Para Windows, é necessário estar conectado como usuário Administrador.
    1. cd {WBIC INSTALL DIR}/DBLoader/scripts/Oracle
    2. Execute um dos scripts a seguir, dependendo de sua versão existente, para fazer upgrade do banco de dados:
      4.2.1.0 para 4.2.1 (Fix Pack 1 não instalado):
      sqlplus -L bcgapps/password @BCGUpgrade_421_421FP1.sql
        >/tmp/WBIConnect/logs/BCGUpgrade_421_421FP1.log
       

      4.2.1.1 para 4.2.2:

      sqlplus -L bcgapps/password @BCGUpgrade_421FP1_422.sql
        >/tmp/WBIConnect/logs/BCGUpgrade_421FP1_422.log
       
    3. Execute o script save_inputs.sql para carregar as entradas de usuário do DBLoader no banco de dados. Por exemplo:
      sqlplus -L bcgapps/password @save_inputs.sql
        >/tmp/WBIConnect/logs/save_inputs.log
       

Atualize a configuração de filas do JMS/MQSeries:

Nota:
Para Windows, é necessário estar conectado como usuário Administrador.
  1. Para UNIX: su -mqm
  2. Execute o comando a seguir:
    runmqsc bcg.queue.manager < {CD_ROM/MEDIA DIR}
     /Tools/MQSeries/BCGUpgrade_Queues_v422.mqsc
     

    Em que bcg.queue.manager é o nome do gerenciador de filas do MQSeries.

Desinstale a versão anterior do Business Integration Connect:

  1. Como usuário Administrador no Windows ou como usuário root no UNIX, desinstale a versão anterior digitando o seguinte comando:
    {WBIC INSTALL DIR}/_uninst/uninstaller
     

    Selecione todos os recursos para desinstalação. Se avisado com uma mensagem informando que um arquivo "exists on this system and it has been modified since installation. Do you want to remove this file?" (existe no sistema e ele foi modificado desde a instalação. Deseja remover este arquivo?) Clique em No

  2. Exclua as árvores de diretório restantes.
    Importante:
    Não exclua a árvore comum {WBIC INSTALL DIR}/. É onde a maioria dos documentos de tempo de execução e dados são armazenados. A exclusão da árvore comum causará perda de dados se não houver backup dela.

Instale o Business Integration Connect:

Como usuário Administrador no Windows ou como usuário root no UNIX, instale o Business Integration Connect utilizando o ativador setup* adequado para o seu sistema operacional. Por exemplo: CD_ROM/MEDIA DIR}/hub/setup*

  1. Especifique os mesmos valores de entrada utilizados na versão anterior. Por exemplo: IDs de usuários, senhas, fornecedor do banco de dados, etc.
  2. Verifique os padrões de configuração e os substitua conforme necessário.
  3. Confirme se a árvore de diretório comum, compartilhada está correta.

Restaure as configurações personalizadas:

Restaure qualquer configuração personalizada da versão anterior. Alterações nos arquivos de configuração do Receiver e do Document Manager foram introduzidas com a versão 4.2.2. Os novos arquivos de configuração 4.2.2 devem ser utilizados. Não substitua a versão 4.2.2 dos arquivos de configuração pela versão mais antiga do diretório de backup.

Para identificar as alterações dos arquivos de configuração que possam ter sido feitas na instalação 4.2.1, compare o conteúdo de cada um dos arquivos nos diretórios do backup 4.2.1 e da instalação 4.2.2. Mescle manualmente quaisquer alterações nos arquivos 4.2.2.

Nota:
Os arquivos version.properties nesses diretórios não devem ser alterados.

Compare o conteúdo dos arquivos localizados nos diretórios a seguir:

console/was/wbic/config
 

receiver/was/wbic/config
 

router/was/wbic/config
 

O arquivo router/was/wbic/config/bcg.properties contém as propriedades bcg.alertNotifications.mail* e as informações de contato do RosettaNet, localizadas nas propriedades bcg.A01.from*. Se esses valores não forem digitados adequadamente durante a instalação do hub 4.2.2, os valores poderão ser copiados do arquivo 4.2.1 bcg.properties para o novo arquivo 4.2.2 router/was/wbic/config/bcg.properties.

Nota:
Uma alteração no pacote base do RosettaNet V02.00 requer que ele seja recarregado através do console se ele já tiver sido instalado anteriormente.

Inicie o Business Integration Connect:

Para UNIX, consulte Iniciando o Business Integration Connect.

Para Windows, consulte Iniciando o Business Integration Connect.

Copyright IBM Corp. 1997, 2004