Instalando o Business Integration Connect

Depois de atender a todos os pré-requisitos anotados nas seções anteriores, você estará pronto para executar os assistentes de instalação do Database Loader e do WebSphere Business Integration Connect.

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.

Barra de Lançamento

O Business Integration Connect fornece um programa de barra de lançamento, consulte a Figura 2, para oferecer acesso único à Visão Geral do Produto, ao arquivo leia-me, à documentação do produto, ao Database Loader e ao Instalador do Business Integration Connect. Opcionalmente, é possível iniciar o Database Loader e os programas de instalação usando os programas setup*.* fornecidos. Consulte Criando o Banco de Dados e Instalando os Componentes Utilizando o Assistente de Instalação.

Nota:
Algumas opções na barra de lançamento requerem que um navegador esteja instalado e disponível no caminho do sistema.

O arquivo executável da barra de lançamento está localizado em:

{CD_ROM/MEDIA DIR}/LaunchPad.*
 



Figura 2. Tela Barra de Lançamento

Criando o Banco de Dados

O Business Integration Connect inclui um assistente de instalação para configurar as tabelas do 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 dos arquivos SQL manualmente permite que o administrador do banco de dados revise as tabelas do 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.

Nota:
Se o SQL for executado automaticamente, o Database Loader deverá ser executado no mesmo servidor no qual o banco de dados reside. Isso assegura que o endereço correto de host seja definido para o banco de dados.

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.

Para configurar as tabelas do banco de dados:

  1. Efetue login como administrador root.
  2. 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.
  3. No diretório do Database Loader, execute o executável de configuração específico para a sua plataforma, listado na Tabela 5:


    cd DBLoader


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

    Linux

    setupLinux

    AIX

    setupAIX

    Solaris

    setupSunOS

    O assistente Database Loader é iniciado e exibe a tela Welcome. Clique em Next.

  4. Na tela Software License Agreement, leia o Acordo de Licença do Software. Se concordar com os termos no acordo, selecione I accept the terms of the license agreement. Clique em Next.
  5. Na tela Directory Name, digite o caminho e o nome do diretório que o Database Loader utilizará ao configurar o banco de dados. Espaços incorporados ou caracteres especiais não deverão ser utilizados nos nomes de diretório. Consulte Figura 3.

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

    Nota:
    Ao procurar um diretório para selecioná-lo, digite um "." no campo Enter file name depois de selecionar o caminho de instalação desejado. Se um "." não for digitado, a tela Select a directory não retornará para a tela a partir da qual ela foi ativada.

    Figura 3. Tela Directory Name


  6. Na tela Database Type Selection, selecione o servidor de banco de dados que você pretende utilizar para o Business Integration Connect. Clique em Next. Consulte a Figura 4.

    Figura 4. Tela Database Type Selection


  7. Na tela Database Information, Figura 5, digite as seguintes informações sobre o banco de dados e, quando tiver terminado, clique em Next.

    DB2:

    Figura 5. Tela DB2 Database Information


    Oracle:

    Figura 6. Tela Oracle Database Information


  8. Na tela Database Location, Figura 7, digite o caminho completo do banco de dados e cada um de seus espaços de tabela no servidor de banco de dados. Por exemplo, o caminho de diretório do banco de dados DB2 pode parecer com o seguinte: DB2Home/IBM/WBIConnect/DBLoader/tables.
    Nota:
    Ao procurar um diretório para selecioná-lo, digite um "." no campo Enter file name depois de selecionar o caminho de instalação desejado. Se um "." não for digitado, a tela Select a directory não retornará para a tela a partir da qual ela foi ativada.
    Se algum desses valores for alterado, eles devem existir antes de executar os arquivos SQL. Se não existirem, deverão ser criados manualmente.

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

    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 Business Integration Connect.

    DB2:

    Figura 7. Tela DB2 Database Location

    Oracle:

    Figura 8. Tela Oracle Database Location


  9. Na tela Component Configuration, Figura 9, digite as informações de login para os componentes do Business Integration Connect e a localização dos arquivos comuns compartilhados. Clique em Next quando tiver concluído.

    Figura 9. Tela Component Configuration


    Nas caixas de texto User name e Password para o Community Console, Document Manager e Receiver, digite o nome e a senha do usuário de cada componente. Esses usuários foram criados quando o servidor foi configurado.

    Na caixa de texto Group Name, digite o nome do grupo que contém os usuários do Business Integration Connect.

    O sistema exibe o ponto de montagem da tela de informações compartilhadas.

  10. Digite a localização dos arquivos comuns compartilhados usados pelos componentes principais do Business Integration Connect.
    Nota:
    Ao procurar um diretório para selecioná-lo, digite um "." no campo Enter file name depois de selecionar o caminho de instalação desejado. Se um "." não for digitado, a tela Select a directory não retornará para a tela a partir da qual ela foi ativada.
  11. O sistema exibe a tela Summary. Reveja as informações da tela Summary, que identifica o local em que o Database Loader será instalado. Se esse local estiver incorreto, clique em Back para retornar às telas anteriores. Quando as informações que aparecem na tela de resumo estiverem corretas, clique em Next.
  12. O assistente exibe uma tela, na qual é possível selecionar se o Database Loader apenas criará os arquivos SQL ou criará esses arquivos e os executará. Consulte Figura 10.

    Figura 10. Execute a Tela SQL Files


    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 onde você está configurando o banco de dados do Business Integration Connect.

    Se desejar que o Database Loader execute os arquivos para você, marque a caixa de opções Run the SQL files.

    Clique em Next quando tiver concluído.

  13. Clique em Finish quando o botão Finish for ativado.
  14. Se estiver executando manualmente o SQL, consulte o arquivo Instructions.txt no diretório SQL (instalado pelo assistente de instalação do Database Loader) para obter informações adicionais.

    Após configurar o banco de dados do Business Integration Connect, você estará pronto para instalar os componentes do Business Integration Connect.

    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 Business Integration Connect possui três componentes principais: Community Console, Receiver e Document Manager. 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 do 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 Business Integration Connect em várias máquinas, a pasta common compartilhada deverá 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 do Business Integration Connect em Requisitos de Plataforma, Hardware e Software para obter os pré-requisitos de software e Visão Geral da Instalação para obter informações sobre como configurar o software. O banco de dados do Business Integration Connect 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.

Nota:
Se você estiver utilizando uma plataforma Linux, siga estas etapas para evitar perdas de memória:
a. Altere o parâmetro max semaphores kernel de 32000 para 256000 no servidor de banco de dados.
b. Faça upgrade do kernel Linux para pelo menos 2.4.9-e.27.

Para instalar o Business Integration Connect:

  1. Efetue login como root.

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

  2. No diretório do hub, execute o executável de configuração específico para sua plataforma, listado na Tabela 6.


    cd hub


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

    Linux

    setupLinux

    AIX

    setupAIX

    Solaris

    setupSolaris

    O assistente será iniciado e exibirá a tela Welcome. Clique em Next.

  3. Na tela Software License Agreement, leia o acordo de licença. Se concordar com seus termos, clique em I accept the terms of the license agreement. Clique em Next.
  4. Na tela Directory Name, Figura 11, digite o caminho e o nome do diretório que o assistente utilizará ao instalar o Business Integration Connect. Espaços incorporados ou caracteres especiais não deverão ser utilizados nos nomes de diretório. Clique em Next.
    Nota:
    Ao procurar um diretório para selecioná-lo, digite um "." no campo Enter file name depois de selecionar o caminho de instalação desejado. Se um "." não for digitado, a tela Select a directory não retornará para a tela a partir da qual ela foi ativada.

    Figura 11. Tela Directory Name


  5. Na tela Component Selection, Figura 12, selecione os componentes que você deseja instalar no servidor. É possível selecionar vários componentes. Clique em Next.

    Figura 12. Tela Component Selection


    O restante deste procedimento assume que você está instalando todos os componentes nesse servidor. Se você não estiver instalando todos eles, algumas das telas descritas a seguir neste procedimento não aparecerão.

  6. Na tela Database Server Selection, Figura 13, selecione o servidor de banco de dados que você pretende utilizar. É possível selecionar DB2 8.1.2 ou posterior ou Oracle 9i.9.2.0 ou posterior. Clique em Next.

    Figura 13. Tela Database Server Selection


  7. A tela Database Information aparece. 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ê tiver selecionado DB2, a tela DB2 Database Information aparecerá. Consulte a Figura 14.

    Digite o host name 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 de texto Port, 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 system temp/WBIConnect/logs. A porta padrão é 50000.

    Nos campos de texto User name, Password, Database name e Instance name, 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 Next.

    Figura 14. Tela DB2 Database Information


    Oracle:

    Se você tiver selecionado Oracle, a tela Database Information aparecerá. Consulte a Figura 15.

    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 9i. Ele pode ser transferido por download do endereço http://otn.oracle.com/software/tech/java/sqlj-jdbc/index.html. Na seção JDBC Driver Downloads, clique em Oracle 9i Release 2 drivers. Certifique-se de selecionar a versão do driver que corresponda à versão de serviço do Oracle 9i (9.2.0) que você está executando.

    Nota:
    Ao procurar um diretório para selecioná-lo, digite um "." no campo Enter file name depois de selecionar o caminho de instalação desejado. Se um "." não for digitado, a tela Select a directory não retornará para a tela a partir da qual ela foi ativada.

    Figura 15. Tela Oracle Database Information


    A tela Database Connection Confirmation aparecerá. Consulte a Figura 16. 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, reveja a tela de informações para se orientar ou consulte a documentação do banco de dados para endereçar o código de erro. Consulte a Figura 17.

    Figura 16. Tela Database Connection Confirmation



    Figura 17. Tela Database Connection Failure

  8. Na tela User Information, digite o nome do usuário, a senha e o nome do grupo do administrador responsável pela instalação.
    Nota:
    Estas informações devem corresponder às informações utilizadas na instalação do Database Loader.
  9. Na tela Common Information Directory, digite o local das informações comuns compartilhadas pelos componentes. Clique em Next.
    Nota:
    Ao procurar um diretório para selecioná-lo, digite um "." no campo Enter file name depois de selecionar o caminho de instalação desejado. Se um "." não for digitado, a tela Select a directory não retornará para a tela a partir da qual ela foi ativada.
  10. Na tela WebSphere MQ Server, Figura 18, digite o nome de host do computador que está executando o WebSphere MQ, se ele não estiver instalado neste computador. Certifique-se de alterar o nome do gerenciador de filas se o nome padrão não foi utilizado. Consulte a Figura 18.

    Figura 18. Tela WebSphere MQ Server


    Na caixa de texto Host name, se o WebSphere MQ não estiver na máquina atual, substitua localhost pelo nome do sistema que contém o WebSphere MQ.

    Na caixa de texto Queue Manager, substitua o nome padrão pelo nome utilizado ao configurar o WebSphere MQ (Consulte 2 em "Configurando o WebSphere MQ").

    Na caixa de texto Listener Port, digite a porta que o listener está utilizando (consulte "Configurando o WebSphere MQ"). A porta padrão é 9999.

    Clique em Next.

  11. Se você selecionou instalar o Community Console, configure-o usando a tela Community Console Configuration. Consulte a Figura 19.

    Figura 19. Tela Community Console Configuration


    Na caixa de texto User name, digite o ID do usuário que o componente Community Console utiliza para efetuar login no banco de dados.

    Na caixa de texto Password, 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.

    Na caixa de texto HTTP port, digite o nome da porta na qual o componente atende as mensagens. O Community Console, o Receiver e o Document Manager devem possuir números de porta exclusivos e eles devem estar disponíveis nesse computador. A porta padrão é 58080.

    Na caixa de texto HTTPS port, digite o nome da porta segura na qual o componente atende as mensagens. O Community Console, o Receiver e o Document Manager devem possuir números de porta exclusivos e eles devem estar disponíveis nesse computador. A porta padrão é 58443.

    Clique em Next.

    Nota:
    Se a conexão do banco de dados falhar, a tela de informações sobre o banco de dados aparecerá. Reveja a tela de informações para se orientar ou consulte a documentação do banco de dados para endereçar o código de erro.
  12. Se você selecionou os componentes Receptor ou Gerenciador de Documentos, configure-os usando suas telas de configuração. Essas telas possuem os mesmos campos da tela Community Console Configuration. Todos os três componentes (Community Console, Receiver e Document Manager) devem ter portas HTTP e HTTPS diferentes. Consulte a Figura 20 e a Figura 21.
    Nota:
    Se você estiver instalando o Receiver e o Document Manager em máquinas diferentes, a máquina do Receiver deverá ter um nome de host que possa ser resolvido pela máquina do Document Manager.

    Figura 20. Tela Receiver Configuration


    Figura 21. Tela Document Manager Configuration


  13. Na tela RosettaNet Configuration, Figura 22, digite as informações de contato para as mensagens 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.

    Figura 22. Tela RosettaNet Configuration


    Na caixa de texto Name, digite o nome da pessoa que deve ser contatada em caso de problemas do RosettaNet.

    Nas caixas de texto Phone number e Fax number, digite os números de telefone e fax do contato do RosettaNet.

    Na caixa de texto E-mail address, digite o endereço de e-mail da pessoa de contato do RosettaNet.

    Clique em Next.

  14. Na tela Alert Notification, Figura 23, configure o Business Integration Connect de modo que ele possa enviar alertas por e-mail. Esses valores padrão são obrigatórios. Utilize-os se não souber os valores corretos.

    Figura 23. Tela Alert Notification


    Na caixa de texto SMTP relay, digite o nome do host do SMTP se ele não estiver sendo executado nesse computador.

    Na caixa de texto From e-mail address, digite o endereço de e-mail que o Business Integration Connect utiliza para enviar e-mails.

    Na caixa de texto To e-mail address, 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 Next.

  15. Na tela Summary, reveja as informações que identificam os componentes que serão instalados. Se alguma dessas informações estiver incorreta, clique em Back para retornar às telas anteriores. Quando todas as informações da tela de resumo estiverem corretas, clique em Next.
  16. O Instalador do Business Integration Connect instala e configura os componentes selecionados. Quando tiver concluído a tarefa, o instalador ativa o botão Finish. Clique em Finish.

Repita este procedimento em cada servidor onde deseja instalar os componentes do Business Integration Connect. 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.

Quando tiver instalado todos os componentes do Business Integration Connect, consulte "Iniciando o Business Integration Connect".

Copyright IBM Corp. 1997, 2004