Fazendo Upgrade do WebSphere Business Integration Connect - Express Versão 4.2.1 para o WebSphere Partner Gateway - Express Versão 6.0 -- Todas as Plataformas

Esta seção descreve como fazer upgrade do Business Integration Connect - Express versão 4.2.1 para o WebSphere Partner Gateway - Express versão 6.0. O procedimento de upgrade utiliza uma GUI (Interface Gráfica com o Usuário) e é aplicável a todas as plataformas nas quais o Business Integration Connect - Express versão 4.2.1 está instalado.

Nota:
Se você estiver instalando o WebSphere Partner Gateway - Express pela primeira vez, consulte as instruções de instalação em uma das seções a seguir, dependendo do tipo de instalação desempenhado:

As etapas a seguir descrevem como desempenhar o upgrade:

  1. Encerre a versão 4.2.1 do Business Integration Connect - Express.
    1. Se a versão existente do Business Integration Connect - Express estiver em execução, certifique-se de que o processamento de todos os documentos em andamento já esteja concluído.
    2. Feche todas as sessões abertas do navegador da Web que estiverem conectadas ao console do WebSphere Partner Gateway - Express.
    3. Pare o servidor WebSphere Partner Gateway - Express.
  2. Instale o WebSphere Partner Gateway - Express versão 6.0 utilizando o instalador.
    Nota:
    O instalador detecta a versão 4.2.1 do Business Integration Connect - Express e faz o backup de seus dados.
    1. Ative o instalador utilizando o Launchpad.

      Em uma plataforma Windows: Insira o CD-ROM do WebSphere Partner Gateway - Express 6.0 na unidade de CD-ROM do computador. A janela Launchpad é aberta.

      Nota:
      Se o Launchpad não for iniciado automaticamente, será possível iniciá-lo manualmente executando o arquivo LaunchPad.bat, localizado no diretório raiz do CD.

      Em uma plataforma Linux: Insira o CD-ROM do WebSphere Partner Gateway - Express 6.0 na unidade de CD-ROM do computador. Abra o Launchpad executando o arquivo LaunchPad.sh, localizado no diretório raiz do CD.

      Nota:
      Como alternativa, é possível ignorar o Launchpad e executar o instalador alterando diretórios para o diretório do WebSphere Partner Gateway - Express e executando o setupLinux. Esse procedimento abrirá a janela do assistente de instalação e, em seguida, um painel de mensagem informando que uma versão mais antiga do Business Integration Connect - Express foi detectada. Prossiga com o 2c.

      Em um sistema com o i5/OS ou o OS/400 em execução: Insira o CD-ROM do WebSphere Partner Gateway - Express 6.0 na unidade de CD-ROM do PC Windows que está conectado ao sistema com o i5/OS ou o OS/400 em execução. A janela Launchpad é aberta.

      Nota 1:
      Se o Launchpad não for iniciado automaticamente, será possível iniciá-lo manualmente navegando até a pasta express e dando um clique duplo no arquivo Launchpad.bat.

      Nota 2:
      Como alternativa, se você quiser ignorar o Launchpad, inicie o instalador executando o comando setup.exe -os400. Esse procedimento ativará a janela Conectar-se ao Servidor. Prossiga com o 2c.

      Cuidado:
      Se você omitir o parâmetro -os400 no comando setup.exe -os400, a instalação ocorrerá na máquina Windows.

      A janela Launchpad oferece cinco opções:

      • Visão Geral do Produto, que utiliza o navegador da Web para acessar o Web site da IBM que contém informações sobre o produto WebSphere Partner Gateway - Express.
      • Arquivo Leia-me, que abre o arquivo Leia-me no disco de instalação.
      • Documentação do InfoCenter, que utiliza o navegador da Web para acessar o Web site de publicações do IBM WebSphere Partner Gateway - Express, onde é possível fazer o download da documentação referente a qualquer edição do WebSphere Partner Gateway - Express.
      • Instalar o produto, que inicia o assistente de instalação.
      • Sair, que fecha a janela Launchpad.
    2. Clique em Instalar o produto.

      A janela do assistente de instalação é aberta, seguida de um painel de mensagem informando que uma versão mais antiga do Business Integration Connect - Express foi detectada.

    3. No painel "versão mais antiga detectada", clique em Avançar.

      A janela Backup Automatizado é aberta, perguntando se você deseja copiar os dados do Business Integration Connect - Express versão 4.2.1 para um diretório de backup.

    4. Clique no botão Sim e certifique-se de que o caminho exibido para o local da instalação atual do Business Integration Connect - Express versão 4.2.1 está correto.
    5. Clique em Avançar.

      Os dados do Business Integration Connect - Express versão 4.2.1 começarão a ser copiados para o subdiretório 421_backup, localizado no diretório de instalação do WebSphere Partner Gateway - Express versão 6.0. Uma caixa de status é aberta para mostrar o progresso da operação de backup. Após a cópia dos dados, essa caixa de status será fechada.

    6. Clique em Avançar. A janela Porta HTTP é exibida. O assistente de instalação detectará as portas que estiverem em uso e, em seguida, designará portas padrão disponíveis a serem utilizadas pelo WebSphere Partner Gateway - Express.

      Os seguintes tipos de porta são exibidos:

      • Porta HTTP -- A porta de comunicação padrão para comunicações comuns.
      • Porta HTTPS1 -- A porta de comunicação utilizada para comunicações seguras (criptografadas).
      • Porta HTTP2 -- Uma duplicata da porta de comunicação padrão para comunicações comuns.
      • Porta HTTPS2 -- Uma duplicata da porta de comunicação utilizada para comunicações seguras (criptografadas).
      • Porta de Auto-inicialização -- Uma porta utilizada internamente pelo WebSphere Partner Gateway para iniciar a versão incorporada do WebSphere Application Server.
      • Porta de Endereços SOAP -- Uma porta utilizada internamente pelo WebSphere Partner Gateway para iniciar a versão incorporada do WebSphere Application Server.
    7. Certifique-se de que o número da porta HTTP seja o mesmo número utilizado na instalação da versão 4.2.1. Se as outras portas padrão mostradas (HTTPS1, HTTP2, HTTPS2, Bootstrap e SOAP) não entrarem em conflito com outros recursos no computador, aceite-as.
      Nota:
      Se você especificar uma porta HTTP que já esteja em uso, o sistema gerará um aviso e uma Exceção no momento em que o servidor for iniciado. Se isto ocorrer, reinstale o WebSphere Partner Gateway - Express e escolha uma porta HTTP diferente.
    8. Clique em Avançar. A janela Nome da Pasta Padrão é exibida.
    9. A janela Nome da Pasta Padrão mostra o nome da pasta de menus de atalhos que o WebSphere Partner Gateway - Express instalará no menu Iniciar > Programas. Aceite o nome padrão ou altere-o.
    10. Clique em Avançar. A janela Configurações de Serviço é exibida.
    11. Clique em Avançar. A janela Instalação de Serviços do Windows aparece. Se desejar registrar os recursos do WebSphere Partner Gateway - Express como um serviço do Windows, selecione a caixa de opções Instalar como um serviço do Windows.
      Nota:
      É necessário ter privilégios de administrador para configurar o WebSphere Partner Gateway - Express para executar como um serviço. Sem esses privilégios, a janela de verificar Administrador será exibida. Clique em Voltar e desmarque a caixa de opções Instalar o WebSphere como um serviço.
    12. Clique em Avançar. A janela Resumo é exibida.
    13. Revise as seleções na janela Resumo. Se for necessário alterá-las, clique no botão Voltar para retornar à janela apropriada, faça as alterações e clique em Avançar até acessar novamente a janela Resumo.
    14. Clique em Avançar. O Instalador instala o software WebSphere Partner Gateway - Express (o processo pode demorar vários minutos).
      Nota:
      O WebSphere Application Server 6.0 é automaticamente instalado com o produto WebSphere Partner Gateway - Express.
    15. Quando o processo de instalação estiver concluído, a janela de opções do aplicativo First Steps será exibida, perguntando se você deseja ativar esse aplicativo. Para conhecer os primeiros passos de utilização do WebSphere Partner Gateway - Express, selecione Sim. Caso contrário, clique em Não.
      Nota:
      Se o WebSphere Partner Gateway - Express versão 6.0 foi instalado como um upgrade de uma versão anterior, selecione Não para evitar iniciar o aplicativo First Steps.
    16. Clique em Avançar. A janela Confirmação da Instalação é exibida.
    17. Clique em Concluir na janela Confirmação da Instalação para finalizar o processo de instalação. Se a opção Sim tiver sido selecionada na janela de ativação do aplicativo First Steps, a janela desse aplicativo será aberta. Consulte Utilizando o Aplicativo First Steps para obter informações sobre como utilizar esse recurso.
      Nota:
      Em PCs especificamente rápidos, a janela do First Steps poderá aparecer sobrepondo-se à janela Confirmação da Instalação antes da seleção do botão Concluir. Nesse caso, faça com que a janela Confirmação da Instalação permaneça como a janela atual e clique em Concluir para fechá-la antes de prosseguir até o First Steps.
  3. Inicie o servidor WebSphere Partner Gateway - Express utilizando o atalho do desktop fornecido durante a instalação do WebSphere Partner Gateway - Express 6.0.
    Nota:
    Podem ser necessários vários minutos até que o servidor WebSphere Partner Gateway - Express fique totalmente operacional.
  4. Execute a ferramenta de migração de dados anterior para converter os dados de segurança da versão 4.2.1 em dados compatíveis com o ambiente 6.0. Os dados de segurança podem incluir: As etapas a seguir descrevem como executar a ferramenta de migração de dados anterior.
    1. Abra uma janela de prompt de comandos.
    2. Altere o diretório para WebSere_Partner_Gateway_Express_Install_Dir.
    3. Execute o script de shell bcgMigrateConvertor.bat ou bcgMigrateConvertor.sh, dependendo do sistema operacional.
      Nota:
      Se o diretório 421_backup não for um subdiretório do diretório WebSpere_Partner_Gateway_Express_Install_Dir, especifique o caminho completo para o diretório 421_backup como o primeiro parâmetro d.
    4. Após a conclusão da ferramenta de migração, feche a janela de prompt de comandos.
  5. Execute a ferramenta de migração de dados para migrar os dados já salvos do Business Integration Connect - Express versão 4.2.1 para a nova instalação do WebSphere Partner Gateway - Express versão 6.0. Para executar a ferramenta:
    1. Abra uma janela de comandos.
    2. Altere o diretório atual para: WebSpere_Partner_Gateway_Express_Install_Dir/bin
    3. Execute o script de shell bcgMigrate.bat ou bcgMigrate.sh, dependendo do sistema operacional.
      Nota:
      Se o diretório 421_backup não for um subdiretório do diretório WebSpere_Partner_Gateway_Express_Install_Dir, especifique o caminho completo para o diretório 421_backup como o primeiro parâmetro.
    4. Após a execução da ferramenta de migração, feche a janela de comandos.
  6. Execute o WebSphere Partner Gateway - Express versão 6.0 para confirmar se ele está instalado e configurado corretamente.
    1. Inicie o console.
      Se a tela de login for aberta em uma sessão de navegador da Web, significa que o servidor está operacional. (Se a janela de login não for aberta, aguarde alguns minutos e, em seguida, tente reiniciar o console.) Não efetue login.
    2. Feche o navegador da Web para sair da tela de login.
    3. Pare o servidor WebSphere Partner Gateway - Express utilizando o atalho do desktop fornecido durante a instalação do WebSphere Partner Gateway - Express 6.0.
    4. Inicie o servidor WebSphere Partner Gateway - Express utilizando o atalho do desktop fornecido durante a instalação.
    5. Inicie o console do WebSphere Partner Gateway - Express utilizando o atalho do desktop fornecido durante a instalação.

      O WebSphere Partner Gateway - Express versão 6.0 já está pronto para uso.

  7. Desinstale o Business Integration Connect - Express versão 4.2.1. Consulte o Apêndice C. Desinstalando o WebSphere Partner Gateway - Express para obter instruções.

Copyright IBM Corp. 2003, 2005