Instalando o WebSphere Partner Gateway

Depois de atender a todos os pré-requisitos indicados nas seções anteriores, você está pronto para executar os assistentes de instalação do Database Loader e do WebSphere Partner Gateway. Esses assistentes podem ser executados diretamente ou por meio do LaunchPad. Consulte LaunchPad para obter informações adicionais.

Nota:
O arquivo tar de imagem do produto eletrônico AIX não pode ser desarquivado com êxito, utilizando o programa tar padrão disponível no AIX, pois a imagem tem caminhos com mais de 100 caracteres. No entanto, a IBM distribui um programa tar que desarquivará com êxito o arquivo tar de imagem do produto eletrônico AIX. Esse programa tar está disponível por meio da Caixa de Ferramentas AIX para Aplicativos Linux no seguinte local:
http://www-1.ibm.com/servers/aix/products/aixos/linux/download.html

Variável de Ambiente DISPLAY

Os assistentes de instalação do Database Loader e do Hub utilizam o sistema X Windows no UNIX para exibir a interface gráfica com o usuário. O sistema X Windows requer que a variável de ambiente DISPLAY seja exportada para o ambiente do sistema. As linhas a seguir definem a variável de ambiente DISPLAY para o IP_Address a partir de um shell Bourne:

DISPLAY=IP_Address:0.0

export DISPLAY

Utilize a sintaxe apropriada para seu shell para definir a variável de ambiente DISPLAY.

Nota:
Teste se a variável de ambiente do sistema DISPLAY e o sistema X Windows estão configurados adequadamente, executando um programa cliente X, como xclock, a partir da linha de comandos. Se o cliente xclock for exibido na janela do X Server (local ou remoto), os assistentes também deverão ser exibidos adequadamente.

LaunchPad

O WebSphere Partner Gateway fornece o programa LaunchPad para proporcionar acesso único à Visão Geral do Produto, ao Arquivo Leia-me, à documentação do produto, ao Database Loader e ao Instalador do WebSphere Partner Gateway. Alternativamente, você pode iniciar o Database Loader e os programas de instalação utilizando os programas setup*.* fornecidos. Consulte Criando o Banco de Dados e Instalando os Componentes Utilizando o Assistente de Instalação.

Nota:
Algumas opções no LaunchPad requerem que um navegador esteja instalado e disponível no caminho do sistema.

O arquivo executável do LaunchPad está localizado em:

{CD_ROM/MEDIA DIR}/LaunchPad.sh

Criando o Banco de Dados

O WebSphere Partner Gateway inclui um assistente de instalação para configurar as tabelas de banco de dados. Esse assistente, o Database Loader, reúne informações para criar e preencher as tabelas para você. Alternativamente, ele pode salvar os arquivos SQL utilizados para criar as tabelas. Você poderá então utilizar os arquivos SQL para criar e preencher as tabelas. A execução manual dos arquivos SQL permite revisar as tabelas de banco de dados antes de preenchê-las.

Antes de iniciar, verifique se o servidor de banco de dados está instalado, configurado corretamente e em execução.

O DBLoader pode ser executado em uma máquina que não possui o banco de dados real. O Oracle/DB2 deve estar instalado nessa máquina, mas o banco de dados real pode estar em outra. O DBA precisa fazer algumas alterações na configuração para que isto ocorra, o que provavelmente não faz parte deste guia. Primeiro, você cria o banco de dados em uma máquina remota. Em seguida, configura um banco de dados remoto com oracle/db2 na máquina em que o dbloader será instalado, especificando em que máquina está em execução, que porta utiliza, etc. Depois que essa configuração é concluída, o DBLoader pode ser executado como se o banco de dados fosse local. O Oracle/DB2 cuidará automaticamente do restante. Todos os comandos sql referentes a esse banco de dados irão para a máquina correta para processamento. As SQLs podem ser executadas automaticamente.

O procedimento a seguir descreve como configurar o banco de dados utilizando a GUI do Database Loader. Também é possível instalar o Database Loader sem utilizar a GUI. Consulte Instalando os Componentes Utilizando a Linha de Comandos para obter mais informações.

Nota:
Verifique a documentação do DB2 para obter requisitos específicos do sistema operacional, como definições de configuração ou versões de produto requeridas.

Para configurar as tabelas do banco de dados:

  1. Efetue login como o usuário root.

    O Database Loader requer privilégio de administrador para executar automaticamente o SQL de criação/alteração da propriedade dos diretórios dos espaços de tabelas.

  2. No diretório do Database Loader, execute o executável de configuração, específico de sua plataforma, listado na Tabela 9:

    cd DBLoader

    Tabela 9. Plataforma Executável Específica para o Installer
    Plataforma Executável

    Linux

    setupLinux

    AIX

    setupAIX

    Solaris

    setupSunOS

    O assistente do Database Loader é iniciado e exibe a janela Bem-vindo. Clique em Avançar.

  3. Na janela Contrato de Licença de Software, leia o contrato de licença de software. Se concordar com os termos no acordo, selecione Eu aceito os termos do contrato de licença. Clique em Avançar.
  4. Na janela Nome do Diretório, digite o caminho e o nome do diretório que o Database Loader utilizará quando configurar o banco de dados. A IBM recomenda criar um novo local de diretório ou selecionar um que esteja vazio. Espaços incorporados ou caracteres especiais não devem ser utilizados em nomes de diretórios.

    Selecione um local com espaço suficiente para o banco de dados e todos os dados do aplicativo que serão armazenados nele. Clique em Avançar.

    Nota:
    Ao procurar um diretório para selecioná-lo, digite um "." no campo Digite o nome do arquivo depois de selecionar o caminho de instalação desejado. Se um "." não for digitado, a janela Selecionar um Diretório não retornará à janela a partir da qual ela foi ativada.
  5. Na janela Seleção de Tipo de Banco de Dados, selecione o servidor de banco de dados que você pretende utilizar para o WebSphere Partner Gateway. É possível selecionar DB2 8.2 ou Oracle 9i 9.2.0.4 ou posterior. Clique em Avançar.
  6. Na janela Informações do Banco de Dados, digite as informações do banco de dados a seguir e clique em Avançar quando concluir.

    DB2:

    Se você selecionou DB2, aparece a janela Informações do Banco de Dados DB2. Digite as seguintes informações do banco de dados DB2:

    Oracle:

    1. Se você selecionou Oracle, aparece a janela Informações do Banco de Dados Oracle. Digite as seguintes informações do banco de dados Oracle:
      • ID de login do administrador
      • Senha do administrador
      • SID Oracle
      • Login do proprietário do esquema
      • Senha do proprietário do esquema
    2. Aparece a janela Local de Origem do Oracle. Digite ou clique em Procurar para inserir o local do diretório Home do Oracle. Consulte a Figura 2.

      Figura 2. Janela Local do Diretório Home do Oracle
  7. Na janela Local do Banco de Dados,Figura 3 para DB2 e Figura 4 para Oracle, digite o caminho completo para o local do banco de dados e cada um de seus espaços de tabela no servidor de banco de dados. Por exemplo, o caminho do diretório do banco de dados DB2 pode ser semelhante a este: DB2Home/IBM/bcgdbloader/tables.
    Nota:
    Ao procurar um diretório para selecioná-lo, digite um "." no campo Digite o nome do arquivo depois de selecionar o caminho de instalação desejado. Se um "." não for digitado, a janela Selecionar um Diretório não retornará à janela a partir da qual ela foi ativada.
    Se quaisquer valores forem alterados, eles deverão existir antes dos arquivos SQL serem executados. Se não existirem, deverão ser criados manualmente.

    Quando tiver digitado as informações requeridas, clique em Avançar.

    Nota:
    Selecione um local do sistema de arquivo com espaço suficiente para conter o banco de dados e todos os dados do aplicativo. O tamanho do banco de dados aumentará durante a execução do WebSphere Partner Gateway.

    DB2

    Figura 3. Janela Local do Banco de Dados DB2

    Oracle

    Figura 4. Janela Local do Banco de Dados Oracle
  8. Na janela Configuração de Componente, Figura 5, digite as informações de login para os componentes do WebSphere Partner Gateway e o local dos arquivos compartilhados comuns. Clique em Avançar quando tiver concluído.

    Nos campos Nome do Usuário e Senha para o Community Console, Gerenciador de Documentos e Receptor, digite o nome e a senha do usuário para cada componente. Se estiver utilizando o DB2, esses usuários foram criados durante a configuração do servidor.

    No campo Nome do Grupo, digite o nome do grupo que contém os usuários do WebSphere Partner Gateway.

    Figura 5. Janela Configuração de Componente
  9. Na janela Ponto de Montagem para Informações Compartilhadas, digite o local dos arquivos compartilhados comuns utilizados pelos principais componentes do WebSphere Partner Gateway.
    Notas:
    1. Se você estiver instalando o WebSphere Partner Gateway em várias máquinas, a pasta comum compartilhada deve utilizar o mesmo ponto de montagem e a mesma estrutura de diretório em todas as máquinas.
    2. Ao procurar um diretório para selecioná-lo, digite um "." no campo Digite o nome do arquivo depois de selecionar o caminho de instalação desejado. Se um "." não for digitado, a janela Selecionar um Diretório não retornará à janela a partir da qual ela foi ativada.
  10. O assistente exibe uma janela na qual você pode selecionar se o Database Loader apenas criará os arquivos SQL ou criará os arquivos SQL e, em seguida, os executará. Consulte a Figura 6.

    Quando o Database Loader executa os arquivos SQL, ele faz o seguinte:

    Como o Database Loader reinicia a instância do DB2 como parte de sua rotina, desconecte quaisquer aplicativos que estejam utilizando a instância do DB2 em que você está configurando o banco de dados do WebSphere Partner Gateway.

    Se desejar que o Database Loader execute os arquivos para você, selecione a caixa de opções Executar os arquivos SQL. Clique em Avançar.

    Figura 6. Janela Executar os Arquivos SQL
  11. Confirme o local da instalação do Database Loader. Clique em Avançar.
  12. Clique no botão Concluir quando estiver ativado.
  13. Se estiver executando manualmente o SQL, consulte o arquivo Instructions.txt no subdiretório bcgdbloader/scripts (instalado pelo assistente de instalação do Database Loader) para obter informações adicionais.

    Depois de configurar o banco de dados do WebSphere Partner Gateway, você está pronto para instalar os componentes do WebSphere Partner Gateway.

    A seção a seguir descreve como instalar os componentes utilizando a GUI do assistente InstallShield. Também é possível instalar os componentes sem utilizar a GUI. Consulte Instalando os Componentes Utilizando a Linha de Comandos para obter mais informações.

Instalando os Componentes Utilizando o Assistente de Instalação

O WebSphere Partner Gateway possui três componentes principais: Community Console, Receptor e Gerenciador de Documentos. Os três componentes compartilham conteúdo comum. É possível instalar os componentes e o conteúdo comum em um único servidor, instalar cada componente em um servidor separado ou utilizar uma combinação dessas duas opções. Você deve instalar uma instância de cada componente em pelo menos um servidor. Consulte Planejamento de Ambiente e Topologias para obter informações sobre como planejar o posicionamento dos vários componentes em servidores diferentes.

Nota:
Se você estiver instalando o WebSphere Partner Gateway em várias máquinas, a pasta common compartilhada deve utilizar o mesmo ponto de montagem e estrutura de diretórios em todas as máquinas.

Antes de começar, certifique-se de que o software de pré-requisito esteja instalado e configurado adequadamente. Consulte a tabela Requisitos para Todos os Servidores WebSphere Partner Gateway em Requisitos de Plataforma, Hardware e Requisitos de Software para obter os pré-requisitos de software e Visão Geral da Instalação para obter informações sobre como configurar esse software. O banco de dados do WebSphere Partner Gateway também deve estar configurado. Para obter informações sobre isso, consulte Criando o Banco de Dados. Por último, o servidor de banco de dados e o WebSphere MQ deverão estar em execução, incluindo o gerenciador de filas e o listener.

Os componentes comuns precisam ser instalados apenas uma vez ao utilizar qualquer configuração diferente da topologia consolidada.

Para instalar o WebSphere Partner Gateway:

  1. Efetue login como administrador root.

    O instalador do Hub requer privilégio root/Administrador para integrar ao registro nativo de software.

  2. No diretório de hub, execute o executável de configuração, específico de sua plataforma, listado na Tabela 10.
    Tabela 10. Plataforma Executável Específica para o Installer
    Plataforma Executável

    Linux

    setupLinux

    AIX

    setupAIX

    Solaris

    setupSolaris

    O assistente inicia e exibe a janela Bem-vindo. Clique em Avançar.

  3. Na janela Contrato de Licença de Software, leia o contrato de licença. Se concordar com seus termos, clique em Eu aceito os termos do contrado de licença. Clique em Avançar.
  4. Na janela Nome do Diretório, digite o caminho e o nome do diretório que o assistente deve utilizar ao instalar o WebSphere Partner Gateway. A IBM recomenda criar um novo local de diretório ou selecionar um que esteja vazio. Espaços incorporados ou caracteres especiais não devem ser utilizados em nomes de diretórios. Clique em Avançar.
    Nota:
    Ao procurar um diretório para selecioná-lo, digite um "." no campo Digite o nome do arquivo depois de selecionar o caminho de instalação desejado. Se um "." não for digitado, a janela Selecionar um Diretório não retornará à janela a partir da qual ela foi ativada.
  5. Na janela Seleção de Componentes, Figura 7, selecione os componentes que você deseja instalar no servidor. É possível selecionar vários componentes. Clique em Avançar.
    Figura 7. Janela Seleção de Componentes

    O restante deste procedimento assume que você está instalando todos os componentes. Se você não estiver instalando todos eles, algumas das janelas descritas no restante deste procedimento não aparecerão.

  6. Especifique o nome completo do host da máquina em que você está instalando. Clique em Avançar.
  7. Selecione um dos WebSphere Application Servers a seguir que será utilizado para hospedar o WebSphere Partner Gateway. Consulte a Figura 8. Clique em Avançar:
  8. Na janela Seleção do Servidor de Banco de Dados, Figura 9, selecione o servidor de banco de dados que você planeja utilizar. É possível selecionar DB2 8.2 ou Posterior ou Oracle 9i 9.2.0.4 ou Posterior. Clique em Avançar.
    Figura 9. Janela Seleção de Banco de Dados
  9. Aparece a janela Informações do Banco de Dados. Se você selecionou o DB2 como o servidor de banco de dados, siga as instruções específicas do DB2 neste procedimento. Se você selecionou o Oracle como o servidor de banco de dados, siga as instruções específicas do Oracle neste procedimento.

    DB2

    Se você selecionou DB2, aparece a janela Informações do Banco de Dados DB2.Figura 10.

    Digite o Nome do host do computador que está executando o DB2 se ele não estiver instalado no sistema atual, substituindo localhost pelo nome do sistema que contém o DB2.

    No campo Porta, digite o número da porta que a instância do DB2 está utilizando. Para descobrir qual porta a instância do DB2 está utilizando, use o Centro de Controle do DB2 (GUI) para determinar as propriedades ou digite o seguinte comando de configuração do DB2 em um prompt de comandos: db2 get dbm cfg. Essas informações de configuração do DB2 também são salvas pelo Database Loader no diretório temp/bcgdbloader/logs do sistema. A porta padrão é 50000.

    Nos campos Nome do proprietário, Senha do proprietário, Nome do banco de dados e Nome do esquema, digite o nome do proprietário, a senha do proprietário, o nome do banco de dados e o nome da instância, respectivamente. Esses são os nomes utilizados na instalação do Database Loader para definir o banco de dados. Consulte Criando o Banco de Dados.

    Clique em Avançar.

    Figura 10. Janela de Informações do DB2

    Oracle:

    Se você selecionou Oracle, a janela de informações do banco de dados aparece. Consulte a Figura 11.

    Digite as informações requeridas sobre o banco de dados Oracle. A porta padrão é 1521.

    O caminho completo e o nome do driver JDBC devem apontar para a versão correta do driver nesse computador. O driver pode ser localizado no diretório de instalação do Oracle.

    Ele também pode ser transferido por download de http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/index.html. Na seção JDBC Driver Downloads, clique em Oracle xx Release x drivers. Certifique-se de selecionar a versão do driver que corresponda à versão do Oracle xx que você está executando.

    Nota:
    Ao procurar um diretório para selecioná-lo, digite um "." no campo Digite o nome do arquivo depois de selecionar o caminho de instalação desejado. Se um "." não for digitado, a janela Selecionar um Diretório não retornará à janela a partir da qual ela foi ativada.

    Clique em Avançar.

    Figura 11. Janela de Informações do Banco de Dados Oracle

    Aparecerá a janela de confirmação de conexão com o banco de dados. Consulte a Figura 12. Se a sua conexão for bem-sucedida, observe e confirme as informações de contagem de Tabela, Visualização, Função e Procedimento. Se a conexão falhar, revise a janela de informações como orientação ou consulte a documentação do banco de dados para tratar do código de erro.

    Figura 12. Janela de Confirmação de Conexão com o Banco de Dados
  10. Na janela Informações do Usuário, digite o nome do usuário, a senha e o nome do grupo do administrador responsável pela instalação. Clique em Avançar.
    Nota:
    Estas informações devem corresponder às informações utilizadas na instalação do Database Loader.
  11. Na janela Diretório de Informações Comuns, digite o local das informações comuns compartilhadas pelos componentes. Clique em Avançar.
    Nota:
    Ao procurar um diretório para selecioná-lo, digite um "." no campo Digite o nome do arquivo depois de selecionar o caminho de instalação desejado. Se um "." não for digitado, a janela Selecionar um Diretório não retornará à janela a partir da qual ela foi ativada.
  12. Na janela Servidor WebSphere MQ, Figura 13, digite o nome do host do computador que está executando o WebSphere MQ, se não estiver instalado no mesmo computador. Certifique-se de alterar o nome do gerenciador de filas se o nome padrão não foi utilizado.

    No campo Nome do Host, se o WebSphere MQ não estiver na máquina atual, substitua localhost pelo nome do sistema que contém o WebSphere MQ.

    No campo Gerenciador de Filas, substitua o nome padrão pelo nome que foi utilizado durante a configuração do WebSphere MQ (Consulte a etapa 2 em Configurando o WebSphere MQ).

    No campo Porta Listener, digite a porta que o listener está utilizando (consulte Configurando o WebSphere MQ). A porta padrão é 9999.

    Clique em Avançar.

    Figura 13. Janela Servidor WebSphere MQ
  13. Se você selecionou para instalar o Community Console, configure-o utilizando a janela Configuração do Community Console. Consulte a Figura 14.

    No campo Nome do Usuário, digite o ID do usuário que o componente Community Console utiliza para efetuar login no banco de dados.

    No campo Senha, digite a senha associada ao nome do usuário. Certifique-se de digitar a senha correta, pois o Community Console não funcionará com uma senha incorreta.

    No campo Porta HTTP, digite o nome da porta na qual o componente atende mensagens. O Community Console, o Receptor e o Gerenciador de Documentos devem possuir números de porta exclusivos e eles devem estar disponíveis nesse computador. A porta padrão é 58080.

    No campo Porta HTTPS, digite o nome da porta segura na qual o componente atende mensagens. O Community Console, o Receptor e o Gerenciador de Documentos devem possuir números de porta exclusivos e eles devem estar disponíveis nesse computador. A porta padrão é 58443.

    Clique em Avançar.

    Nota:
    Se a conexão com o banco de dados falhar, aparecerá a janela Informações do Banco de Dados. Revise a janela de informações como orientação ou consulte a documentação do banco de dados para tratar do código de erro.
    Figura 14. Janela Configuração do Community Console
  14. Se você selecionou os componentes Receptor ou Gerenciador de Documentos, configure-os utilizando suas janelas de configuração. Essas janelas possuem os mesmos campos que a janela Configuração do Community Console. Todos os três componentes (Community Console, Receptor e Gerenciador de Documentos) devem ter portas HTTP e HTTPS diferentes. Consulte as figuras Figura 15 e Figura 16 na página Figura 15.
    Nota:
    Se você estiver instalando o Receptor e o Gerenciador de Documentos em máquinas diferentes, a máquina do Receptor deverá ter um nome de host que possa ser resolvido pela máquina do Gerenciador de Documentos.
    Figura 15. Janela Configuração do Receptor
    Figura 16. Janela Configuração do Gerenciador de Documentos
  15. Na janela Configuração do RosettaNet, Figura 17, digite as informações de contato para as mensagens do RosettaNet. Se não souber os valores corretos, utilize os valores padrão obrigatórios. Essas informações são necessárias se estiver utilizando o RosettaNet e são recomendadas para todas as instalações.

    No campo Nome, digite o nome da pessoa que deve ser contatada em caso de problemas do RosettaNet.

    Nos campos Número de Telefone e Número de Fax, digite os números de telefone e fax do contato do RosettaNet.

    No campo Endereço de E-mail, digite o endereço de e-mail da pessoa de contato do RosettaNet.

    Clique em Avançar.

    Figura 17. Janela de Configuração do RosettaNet
  16. Na janela Notificação de Alerta, Figura 18, configure o WebSphere Partner Gateway de modo que possa enviar alertas por e-mail. Os valores são obrigatórios. Utilize os valores padrão se você não souber os valores apropriados.

    No campo Retransmissão de SMTP, digite o nome do host do SMTP, se ele não estiver em execução nesse computador.

    No campo Endereço de E-mail de Origem, digite o endereço de e-mail que o WebSphere Partner Gateway utilizará para enviar e-mails.

    No campo Endereço de E-mail de Destino, digite o endereço de e-mail de destino que os usuários que respondem a notificações de alerta utilizam quando enviam um e-mail de resposta.

    Clique em Avançar.

    Figura 18. Janela Notificação de Alerta
  17. Na janela Resumo, revise as informações que identificam os componentes que serão instalados. Se alguma dessas informações estiver incorreta, clique em Voltar para retornar às janelas anteriores. Quando todas as informações na janela de resumo estiverem corretas, clique em Avançar.
  18. O Instalador do WebSphere Partner Gateway instala e configura os componentes selecionados. Ao concluir esta tarefa, o Instalador ativa o botão Concluir. Clique em Concluir.

Repita este procedimento em cada servidor no qual você deseja instalar os componentes do WebSphere Partner Gateway. O conteúdo comum precisa ser instalado apenas uma vez porque ele está disponível para todos os computadores por meio do sistema de arquivos compartilhado.

Depois de instalar todos os componentes do WebSphere Partner Gateway, consulte Iniciando o WebSphere Partner Gateway.

Copyright IBM Corp. 2003, 2005