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.

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 no seguinte diretório:

{CD_ROM/MEDIA DIR}/LaunchPad.*

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, para que você possa utilizá-los para criar e preencher manualmente 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 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.

Nota:
Se planejar utilizar o DB2 como o servidor de banco de dados, será necessário executar o SQL (manualmente ou automaticamente) como o usuário DB2ADMIN do Windows.

Para configurar as tabelas do banco de dados:

  1. Efetue login como DB2ADMIN se estiver utilizando o DB2 como o banco de dados.
  2. Execute o arquivo CD-MediaDir\DBLoader\setup.exe do Database Loader localizado no CD do produto do sistema WebSphere Partner Gateway.

    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 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.

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

    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.

  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, em seguida, 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:

    Nota:
    Se algum desses valores for alterado, eles devem existir antes de executar os arquivos SQL. Se não existirem, deverão ser criados manualmente.

    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. Figura 19 .
    Nota:
    Se algum desses valores for alterado, eles devem existir antes de executar os arquivos SQL. Se não existirem, deverão ser criados manualmente.

    Figura 19. Janela Local do Diretório Home do Oracle
  7. Na janela de local do banco de dados, 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

    Digite o local do banco de dados e cada um de seus espaços de tabela no servidor RDBMS. Os campos devem conter o caminho completo. Clique em Avançar. Consulte a Figura 2.

    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.

    Figura 20. Janela Local do Banco de Dados DB2

    Oracle

    Digite o local do banco de dados e cada um de seus espaços de tabela no servidor RDBMS. Os campos devem conter o caminho completo. Clique em Avançar. Consulte a Figura 21.

    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.
    Figura 21. Janela Local do Banco de Dados Oracle
  8. Na janela Configuração de Componente (consulte a Figura 22), digite as informações de login para os componentes do WebSphere Partner Gateway e o local dos arquivos compartilhados comuns.

    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.

    Clique em Avançar.

    Figura 22. Janela Configuração de Componente
  9. O sistema exibe a janela Ponto de Montagem para Informações Compartilhadas. Digite o local dos campos compartilhados comuns utilizados pelos componentes principais do WebSphere Partner Gateway. Clique em Avançar.
    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 (consulte a Figura 23), na qual você pode selecionar se o Database Loader criará apenas os arquivos SQL ou criará os arquivos SQL e, em seguida, os executará.

    Se o Database Loader executar 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 23. 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 Database Loader) para obter mais informações.

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

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 ou instalar cada componente em um servidor separado. 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 a mesma letra de unidade 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 Verificando e Configurando os Pré-requisitos Instalados 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.

O procedimento a seguir descreve como instalar os componentes utilizando a GUI do assistente InstallShield.

Nota:
Também é possível instalar os componentes usando a linha de comandos. Consulte Instalando os Componentes Utilizando a Linha de Comandos para obter detalhes.

Para instalar o WebSphere Partner Gateway, siga estas etapas:

  1. Efetue login como um usuário com privilégios de Administrador.

    O instalador do hub requer privilégio de Administrador para criar corretamente o serviço do Windows.

  2. Execute o arquivo CD-MediaDir\hub\setup.exe localizado no CD do produto do sistema WebSphere Partner Gateway.

    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 no qual o WebSphere Partner Gateway está instalado. A IBM recomenda criar um novo local de diretório ou selecionar um que esteja vazio. 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 24, selecione os componentes que você deseja instalar no servidor. É possível selecionar vários componentes. Clique em Avançar.
    Figura 24. 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 e clique em Avançar. Consulte a Figura 7.
  8. Na janela Seleção do Servidor de Banco de Dados, Figura 26, selecione o servidor de banco de dados que você planeja utilizar. Você pode selecionar DB2 8.2 ou Posterior ou Oracle 9i.9.2.0.4 ou Posterior. Clique em Avançar.
    Figura 26. Janela Seleção de Banco de Dados
  9. Aparece a janela Informações do Banco de Dados. Se você selecionou o DB2 como o banco de dados, siga as instruções específicas do DB2 neste procedimento. Se você selecionou o Oracle como o 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. Consulte a Figura 27.

    No campo Nome do Host, se o DB2 não estiver no sistema atual, substitua localhost pelo nome do sistema que contém o DB2.

    No campo Porta, digite a 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 para determinar as propriedades ou digite o seguinte em uma linha de comandos: db2 get dbm cfg. Essas informações (configuração do DB2) também são salvas pelo Database Loader no diretório "system temp"/bcgdbloader/logs. A porta padrão é 50000.

    Nos campos de texto Nome do proprietário, Senha do proprietário, Nome do banco de dados e Nome do esquema, digite as informações solicitadas. Esses são os nomes que foram utilizados na instalação do Database Loader para definir o banco de dados. Consulte Criando o Banco de Dados.

    Clique em Avançar.

    Figura 27. Janela de Informações do DB2

    Oracle

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

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

    Nota:
    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 na árvore do diretório de instalação do Oracle. Ele também pode ser transferido por download a partir do seguinte Web site: 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 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.
    Figura 28. Janela de Informações do Oracle

    Aparecerá a janela Confirmação de Conexão com o Banco de Dados. Consulte a Figura 29. 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 29. Janela de Confirmação de Conexão com o Banco de Dados
  10. Na janela Diretório de Informações Comuns, digite o local dos componentes compartilhados comuns. Este valor deve corresponder à localização do diretório utilizado na instalação do Database Loader.
    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.
  11. Na janela Servidor WebSphere MQ, digite as informações necessárias sobre seu servidor WebSphere MQ. Consulte a Figura 30.

    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 utilizado ao configurar o WebSphere MQ (consulte 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 30. Janela Servidor WebSphere MQ
  12. Aparece a janela Instalação do Serviço Windows. Se você desejar registrar o recurso WebSphere Partner Gateway como um serviço Windows, selecione a caixa de opções Instalar como Serviço Windows. Consulte a Figura 31.

    Clique em Avançar.

    Figura 31. Janela Instalação do Serviço Windows
  13. Se você selecionou para instalar o Community Console, configure-o utilizando a janela de Configuração do Community Console. Consulte a Figura 32.

    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 número 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 número 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.

    No campo Nome do Host do Sistema de Ajuda, digite o endereço do servidor no qual o Sistema de Ajuda residirá.

    No campo Número da Porta do Sistema de Ajuda, digite o número da porta para acesso ao Sistema de Ajuda.

    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 32. Janela 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 a Figura 33 e a Figura 34.
    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.

    Clique em Avançar quando tiver concluído.

    Figura 33. Janela Configuração do Receptor
    Figura 34. Janela de Configuração do Gerenciador de Documentos
  15. Na janela de Configuração do RosettaNet, Figura 35, digite as informações de contato para as mensagens do RosettaNet. Os valores são obrigatórios nesses campos de texto. Utilize os valores padrão se você não souber os valores apropriados. 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 da pessoa de contato do RosettaNet.

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

    Clique em Avançar.

    Figura 35. Janela de Configuração do RosettaNet
  16. Na janela Notificação de Alerta, Figura 36, 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 local do servidor SMTP.

    No campo Endereço de E-mail de Origem, digite o endereço de e-mail que o WebSphere Partner Gateway utiliza 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 36. 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. Quando tiver concluído essa tarefa, o instalador ativa o botão Concluir. Clique em Concluir.
  19. Verifique se os seguintes valores estão definidos:

    DB2:

    1. Abra o arquivo console\lib\config\bcg_console.properties. Verifique se o seguinte valor está definido: bcg.co.db.schema=DB2ADMIN.
    2. Abra o arquivo receiver\lib\config\bcg_receiver.properties. Verifique se o seguinte valor está definido: bcg.co.db.schema=DB2ADMIN.
    3. Abra o arquivo router\lib\config\bcg.properties. Verifique se o seguinte valor está definido: bcg.co.db.schema=DB2ADMIN.

    Oracle:

    1. Abra o arquivo console\lib\config\bcg_console.properties. Verifique se o seguinte valor está definido: bcg.co.db.schema=BCGAPPS.
    2. Abra o arquivo receiver\lib\config\bcg_receiver.properties. Verifique se o seguinte valor está definido: bcg.co.db.schema=BCGAPPS.
    3. Abra o arquivo router\lib\config\bcg.properties. Verifique se o seguinte valor está definido: bcg.co.db.schema=BCGAPPS.
  20. 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 Instalando os Componentes Utilizando a Linha de Comandos.

Copyright IBM Corp. 2003, 2005