Instalando Adaptadores

Siga as instruções em uma das seções seguintes para instalar um adaptador, se indicado pela visão geral de procedimentos no Visão Geral da Instalação:

Observe que, nas plataformas UNIX, os nomes de arquivos fazem distinção entre maiúsculas e minúsculas. Se você alterar as letras maiúsculas ou minúsculas de qualquer nome de arquivo, o adaptador falhará durante a inicialização e registrará um erro. Se você receber um erro ao tentar iniciar o adaptador, verifique os nomes dos arquivos XSD no repositório do Configurador do Conector. Os arquivos XSD devem ter uma extensão .xsd em letras minúsculas. Por exemplo, um nome de arquivo Customer.XSD fará com que o adaptador falhe. Nesse caso, você deve alterar o nome do arquivo para Customer.xsd.

Instalando Adaptadores Utilizando o Instalador Gráfico

Execute o procedimento a seguir para instalar um adaptador utilizando o instalador gráfico:

  1. Chame o Installer, conforme descrito em Chamando o Instalador Gráfico WBIA.
  2. No prompt de seleção de idioma, escolha o idioma desejado no menu drop-down e clique em OK.
  3. Na tela Bem-vindo, clique em Avançar.
    Nota:
    Se você utilizar o comando java -jar setup.jar para ativar o Instalador, o programa de instalação precisará de um JRE (Java Runtime Environment) versão 1.4 ou superior. Se essa condição não for atendida, o Instalador exibirá uma mensagem de erro instruindo que você instale o JRE 1.4 ou superior e, em seguida, reative o Instalador. Clique em Cancelar e instale ou faça upgrade do JRE.
  4. Na tela Aceitação de Licença da IBM, clique em Eu aceito os termos do contrato de licença e, em seguida, clique em OK.
    Nota:
    O Installer verifica no sistema determinados pré-requisitos de software neste ponto. Se um pré-requisito não for localizado, o Instalador exibirá uma tela informando sobre isso e indicando que o item deve ser instalado ou que você deve digitar o diretório no qual ele reside antes da instalação do adaptador continuar. Instale ou procure o local do software requerido e reinicie o WebSphere Business Integration Adapters Installer.
  5. A tela do diretório do produto permitirá especificar onde instalar os adaptadores. O instalador do adaptador tentará localizar o local de instalação do Adapter Framework; se ele o localizar, esse caminho será exibido por padrão. Se ele não o localizar, então os seguintes padrões serão exibidos: Para Windows: C:\IBM\WebSphereAdapterse para UNIX, /opt/IBM/WebSphereAdapters.

    Você pode especificar um outro diretório, mas ele deve conter uma instalação de uma versão compatível do Adapter Framework.

    Para obter informações sobre como instalar o Adapter Framework, consulte Instalando a Estrutura do Adaptador. Para obter informações adicionais sobre como instalar o WebSphere InterChange Server, consulte o

    Na tela do diretório do produto, execute uma das seguintes tarefas:

  6. A tela de resumo lista os recursos que serão instalados, o diretório do produto especificado e a quantidade de espaço em disco requerida. Leia as informações para verificá-la e clique em Avançar.
  7. Na tela Nome do Intermediário, execute uma das tarefas a seguir, dependendo de seu intermediário de integração:
  8. Se você estiver instalando em um computador Windows, o Installer apresentará a tela de seleção de pasta de programa. No campo Grupo de Programas, digite o nome do grupo de programas no qual você deseja criar atalhos para os adaptadores ou aceite o grupo de programas padrão e, em seguida, clique em Avançar.
  9. Após a conclusão bem-sucedida do Installer, clique em Concluir.

Nota:
Se o intermediário de integração for ICS e estiver instalado em um sistema remoto, é necessário mover os arquivos de configuração do adaptador para o sistema ICS. Isso disponibiliza os arquivos de configuração do adaptador para o Connector Configurator na máquina ICS remota. Para localizar os arquivos de configuração do adaptador, consulte a tabela de estruturas de arquivos instalados no guia do usuário do adaptador. O arquivo de configuração é, geralmente, denominado <nome do adaptador>ConnectorTemplate. Em seguida, mova este arquivo para o diretório da instância do Connector Configurator que estará em execução na máquina host ICS. Para obter informações adicionais sobre a estrutura de arquivos instalados de ICS e o Connector Configurator, consulte o System Installation Guide para sua plataforma. Se você não estiver utilizando um intermediário de integração ICS ou se o intermediário ICS residir na mesma máquina do adaptador, não será necessário transferir os arquivos de configuração do adaptador.

Instalando Adaptadores Silenciosamente nos Sistemas Windows

Faça o seguinte para executar uma instalação silenciosa de um adaptador nos sistemas Windows:

  1. Prepare um arquivo de resposta para instalar o adaptador, conforme descrito em Preparando o Arquivo de Resposta da Instalação, utilizando as opções desejadas listadas na Tabela 3.
    Tabela 3. Opções de Instalação Silenciosa para Adaptadores para Sistemas Windows
    Nome da Opção Valores da Opção
    -W destination.path

    Defina essa opção para o caminho do diretório no qual o produto WebSphere Business Integration Adapters deve ser instalado. Por exemplo,

    -W destination.path="C:\IBM\WebSphereAdapters"

    O caminho de instalação não pode conter espaços. O local de instalação deve conter uma versão compatível da estrutura da placa.

    -W inputServer.name

    Se seu servidor intermediário não for o IBM WebSphere InterChange Server, especifique um nome de servidor InterChange válido. Esse nome deve atender os seguintes critérios: 1. Menos de 80 caracteres. 2. Não deve conter espaço. 3. Deve começar com um caractere alfabético em inglês (a-z, A-Z) . 4. Deve conter apenas caracteres alfabéticos e numéricos em inglês.

    Se você não estiver utilizando o WebSphere Interchange Server como o servidor intermediário, comente essa opção.

    -W inputShortcuts.folder

    Defina essa opção para o nome do grupo de programas criado para o produto WBIA, como por exemplo, IBM WebSphere Business Integration Adapters.

    -W inputServer.adapterService

    Defina essa opção para yes se quiser que o adaptador seja registrado como um serviço do Windows. Defina essa opção para no se não quiser que o adaptador seja registrado como um serviço do Windows.

    -G createDirectoryResponse= Defina esta opção (yes ou no) para especificar se é necessário criar o diretório de destino, se já não existir um.
    -G replaceExistingResponse

    Defina essa opção como yesToAll ou yes para substituir todos os arquivos localizados no sistema que possuem o mesmo nome que aqueles que estão sendo copiados pelo instalador.

    Defina essa opção como noToAll ou no para não substituir quaisquer arquivos localizados no sistema que tenham o mesmo nome que aqueles sendo copiados pelo instalador.

    -G replaceNewerResponses

    Defina essa opção como yesToAll ou yes para substituir todos os arquivos localizados no sistema que forem mais recentes que aqueles sendo copiados pelo instalador.

    Defina essa opção como noToAll ou no para não substituir quaisquer arquivos localizados no sistema que forem mais recentes que aqueles sendo copiados pelo instalador.

    -G removeExistingResponse

    Esta opção especifica se irá remover um arquivo de resposta existente no sistema. Observe que essa opção é apenas para desinstalação. Defina-a para yestoall ou yes para remover os arquivos de resposta existentes. Defina-a para notoall ou no para sair dos arquivos existentes no sistema.

    -G removeModifiedResponse

    Esta opção especifica se irá remover um arquivo de resposta que foi modificado desde que foi instalado pela última vez. Observe que essa opção é apenas para desinstalação. Defina-a para yestoall ou yes para remover os arquivos de resposta modificados. Defina-a para notoall ou no para sair dos arquivos modificados no sistema.

  2. Execute a instalação silenciosa conforme descrito em Executando a Instalação Silenciosa, utilizando o arquivo de resposta preparado na etapa 1.

Instalando Adaptadores Silenciosamente nos Sistemas UNIX e Linux

Faça o seguinte para executar uma instalação silenciosa de um adaptador nos sistemas Windows:

  1. Prepare um arquivo de resposta para instalar o adaptador, conforme descrito em Preparando o Arquivo de Resposta da Instalação, utilizando as opções desejadas listadas na Tabela 3.
    Tabela 4. Opções de Instalação Silenciosa para Adaptadores para Sistemas UNIX e Linux
    Nome da Opção Valores da Opção
    -W destination.path

    Defina essa opção para o caminho do diretório no qual o produto WebSphere Business Integration Adapters deve ser instalado. Por exemplo,

    -W destination.path="C:\IBM\WebSphereAdapters"

    O caminho de instalação não pode conter espaços. O local de instalação deve conter uma versão compatível da estrutura da placa.

    -W inputServer.name

    Se seu servidor intermediário não for o IBM WebSphere InterChange Server, especifique um nome de servidor InterChange válido. Esse nome deve atender os seguintes critérios: 1. Menos de 80 caracteres. 2. Não deve conter espaço. 3. Deve começar com um caractere alfabético em inglês (a-z, A-Z) . 4. Deve conter apenas caracteres alfabéticos e numéricos em inglês.

    Se você não estiver utilizando o WebSphere Interchange Server como o servidor intermediário, comente essa opção.

    -G createDirectoryResponse= Defina esta opção (yes ou no) para especificar se é necessário criar o diretório de destino, se já não existir um.
    -G replaceExistingResponse

    Defina essa opção como yesToAll ou yes para substituir todos os arquivos localizados no sistema que possuem o mesmo nome que aqueles que estão sendo copiados pelo instalador.

    Defina essa opção como noToAll ou no para não substituir quaisquer arquivos localizados no sistema que tenham o mesmo nome que aqueles sendo copiados pelo instalador.

    -G replaceNewerResponses

    Defina essa opção como yesToAll ou yes para substituir todos os arquivos localizados no sistema que forem mais recentes que aqueles sendo copiados pelo instalador.

    Defina essa opção como noToAll ou no para não substituir quaisquer arquivos localizados no sistema que forem mais recentes que aqueles sendo copiados pelo instalador.

    -G removeExistingResponse

    Esta opção especifica se irá remover um arquivo de resposta existente no sistema. Observe que essa opção é apenas para desinstalação. Defina-a para yestoall ou yes para remover os arquivos de resposta existentes. Defina-a para notoall ou no para sair dos arquivos existentes no sistema.

    -G removeModifiedResponse

    Esta opção especifica se irá remover um arquivo de resposta que foi modificado desde que foi instalado pela última vez. Observe que essa opção é apenas para desinstalação. Defina-a para yestoall ou yes para remover os arquivos de resposta modificados. Defina-a para notoall ou no para sair dos arquivos modificados no sistema.

  2. Execute a instalação silenciosa conforme descrito em Executando a Instalação Silenciosa, utilizando o arquivo de resposta preparado na etapa 1.

Gravando Seleções de Instalação

Você pode gravar suas seleções de instalação em um arquivo, utilizando uma opção especial ao chamar o programa de instalação a partir da linha de comandos. Ao concluir a instalação, suas seleções de instalação serão gravadas no arquivo especificado na linha de comandos. Você pode utilizar as informações de instalação gravadas nesse arquivo como um registro de suas definições de instalação e como um arquivo de resposta para instalações silenciosas em outras máquinas.

Para criar esse arquivo, digite o seguinte comando na linha de comandos:

<executável_do_ativador_da_instalação> -options-record <nome_do_arquivo>

Por exemplo, digite o seguinte comando em uma janela de comandos para gravar as seleções da instalação do adaptador em um computador Windows:

setupwin32.exe -options-record C:\data\settings.txt

Copyright IBM Corp. 2003, 2005