As informações desta seção descrevem como instalar o WBIA (WebSphere Business Integration Adapters).
O produto WBIA é instalado executando-se um arquivo executável específico da plataforma do instalador. A Tabela 1 lista o executável do instalador de cada sistema operacional. Os executáveis do instalador estão localizados no diretório WebSphereBI no CD do produto.
Tabela 1. Executáveis Específicos da Plataforma do WBIA Installer
Sistema operacional | Arquivo executável do WBIA Installer |
---|---|
Windows | setupwin32.exe |
AIX | setupAIX.bin |
Solaris | setupsolarisSparc.bin |
HP-UX | setupHP.bin |
Utilize o arquivo executável do instalador para executar a instalação da seguinte maneira:
O WBIA Installer gráfico apresenta um assistente que permite fazer opções sobre a instalação do produto WBIA. Embora o instalador seja baseado em Java e, portanto, independente de plataforma, existem maneiras diferentes de chamar o instalador de cada plataforma. Esta seção descreve as abordagens nos computadores Windows e UNIX.
Para chamar o instalador em um ambiente Windows, acesse o diretório WebSphereBI do CD do produto e execute setupwin32.exe.
O WBIA Installer em um ambiente UNIX é chamado através de um arquivo .bin específico da plataforma, localizado no diretório WebSphereBI. A Tabela 1 fornece o nome do arquivo .bin de cada plataforma.
Siga as etapas de uma das seguintes seções para chamar o instalador dependendo de como você está trabalhando com o computador UNIX:
Se estiver executando o CDE (Common Desktop Environment) e trabalhando no computador UNIX diretamente, poderá navegar para o diretório WebSphereBI do CD do produto e dar um clique duplo no arquivo .bin específico do sistema operacional.
Você também pode navegar para o diretório WebSphereBI do CD do produto e executar o arquivo .bin na linha de comandos. O seguinte exemplo mostra como fazer isso em um computador Solaris:
# ./setupsolarisSparc.bin
Se você estiver utilizando um computador Windows para conectar-se ao computador UNIX através do software de emulação X, faça o seguinte para chamar o instalador:
Você pode executar o comando ipconfig na interface da linha de comandos do Windows para exibir o endereço IP do computador Windows.
Depois do endereço IP, coloque dois pontos (:) e o identificador do monitor ou do vídeo no computador cliente Windows. Se o computador cliente Windows tiver apenas um único monitor, o valor do vídeo será 0.0.
O seguinte exemplo mostra a variável de ambiente DISPLAY sendo definida para o único monitor em um computador Windows cujo endereço IP é 9.26.244.30:
DISPLAY=9.26.244.30:0.0
export DISPLAY
# ./setupAIX.bin
O instalador gráfico é iniciado no computador Windows que está sendo utilizado para conectar-se ao computador UNIX.
Uma vez em execução, o WBIA Installer solicita que você faça suas opções de instalação e, em seguida, executa a instalação.
Ao selecionar um adaptador para instalação, os componentes de tempo de execução e as rotinas de tratamento de dados necessários para suportá-lo são selecionados automaticamente para instalação. No entanto, se o instalador determinar a existência de versões atuais de componentes de tempo de execução no sistema, eles não serão instalados.
Faça o seguinte para prosseguir com o instalador:
A Tabela 2 mostra os diretórios de instalação padrão do adaptador para os diferentes servidores intermediários de integração nas diferentes plataformas suportadas.
Tabela 2. Diretórios de Instalação Padrão do Adaptador
Tipo de servidor intermediário | Diretório padrão do Windows | Diretório padrão do UNIX |
---|---|---|
WebSphere MQ Integrator Broker | C:\WebSphereAdapters | /$HOME/WebSphereAdapters |
WebSphere InterChange Server | C:\IBM\WebSphereICS | /$HOME/IBM/WebSphereICS |
WebSphere Application Server | C:\WebSphereAdapters | /$HOME/WebSphereAdapters |
Dependendo do servidor intermediário, estarão disponíveis recursos diferentes para a instalação. Por exemplo, se você escolher o WebSphere MQ Integrator Broker ou o WebSphere Application Server como seu servidor intermediário, então o tempo de execução e as ferramentas do adaptador estarão disponíveis para seleção. Se no entanto você tiver escolhido o WebSphere InterChange Server, elas não estarão disponíveis pois as ferramentas e o tempo de execução são instalados como parte da instalação do servidor intermediário.
Dependendo do sistema operacional, estarão disponíveis recursos diferentes para a instalação. Por exemplo, as ferramentas são suportadas apenas em ambientes Windows e estarão disponíveis para seleção, portanto, quando você executar o instalador em um computador Windows.
Digite o caminho para o diretório java\lib da instalação do WebSphere MQ ou clique em Browse para selecionar o diretório e clique em Next.
Escolha Add System Manager files to an existing Workbench installation se você desejar adicionar os plug-ins em uma instalação existente do WSADIE 5.0.1. Você será solicitado a especificar o diretório do produto da instalação existente do WSADIE 5.0.1 na próxima tela do Installer, conforme descrito na etapa 11.
Escolha Install Workbench with System Manager files se você desejar instalar o WebSphere Studio Workbench 2.0.3 e adicionar plug-ins nessa instalação. O workbench é instalado em um subdiretório do diretório de instalação do adaptador denominado Tools\WSWB203 se você fizer essa seleção.
Clique em Next após fazer sua seleção.
Você pode executar uma instalação silenciosa do WBIA, na qual fornecerá suas opções de instalação em um arquivo em vez de fazer isso nas telas do assistente de instalação. Isso é especialmente útil quando é necessário executar várias instalações idênticas.
Para executar uma instalação silenciosa, crie primeiramente um arquivo com suas opções de instalação, conforme descrito em Preparando o Arquivo de Resposta da Instalação e, em seguida, execute a instalação utilizando o arquivo, conforme descrito em Executando a Instalação Silenciosa.
Ao executar uma instalação silenciosa, você prepara um arquivo de resposta
contendo suas opções de instalação. A IBM fornece quatro gabaritos de
arquivo de resposta contendo as opções para diferentes combinações de servidor
intermediário de integração e suporte de plataforma. Os gabaritos de
arquivo de resposta estão localizados no diretório WebSphereBI no
CD do produto. A Tabela 3 lista os gabaritos de arquivo de resposta de cada
combinação.
Tabela 3. Gabaritos de Arquivos de Resposta
Combinação de servidor intermediário de integração e plataforma | Gabarito do arquivo de resposta |
WebSphere InterChange Server no Windows: | settings_WBIAInstaller_ICS.txt |
WebSphere Application Server e WebSphere MQ Integrator Broker no Windows: | settings_WBIAInstaller_WSMQ.txt |
WebSphere InterChange Server no UNIX: | settings_WBIAInstaller_ICS_unix.txt |
WebSphere Application Server e WebSphere MQ Integrator Broker no UNIX: | settings_WBIAInstaller_WSMQ_unix.txt |
A Tabela 4 lista as opções que podem ser utilizadas durante uma
instalação silenciosa. Leia todas as informações da coluna
Valores da Opção, pois
ela especifica quando determinadas opções devem ser colocadas como comentário
e quais são as compatibilidades do servidor intermediário e da
plataforma.
Tabela 4. Opções de Instalação Silenciosa
Nome da opção | Valores da opção |
---|---|
brokerType.brokerSelection |
Definir como 1 para WebSphere MQ Integrator Broker. Definir como 2 para o WebSphere InterChange Server. Definir como 3 para o WebSphere Application Server.
|
setWINICSDest.value |
Definir para o caminho de diretório em que o InterChange Server está instalado. Se você deixar essa opção comentada, o produto é instalado no diretório padrão listado em Tabela 2. Essa opção será relevante apenas para o servidor intermediário WICS quando
instalado no Windows. Certifique-se de que esteja colocada como
comentário ao instalar para os servidores intermediários WMQI ou WAS, ou ao
instalar em um computador UNIX.
|
setWINWMQIDest.value |
Defina para um caminho de diretório válido, sem espaços, para especificar a localização em que o produto WBIA deve ser instalado. Se você deixar essa opção comentada, o produto é instalado no diretório padrão listado em Tabela 2. Essa opção será relevante apenas para os servidores intermediários WMQI e
WAS, quando instalados no Windows. Certifique-se de que esteja colocada
como comentário ao instalar para o servidor intermediário WICS, ou ao instalar
em um computador UNIX.
|
setUnixICSDest.value |
Definir para o caminho de diretório em que o InterChange Server está instalado. Se você deixar essa opção comentada, o produto é instalado no diretório padrão listado em Tabela 2. Essa opção será relevante apenas para o servidor intermediário WICS quando
instalado no UNIX. Certifique-se de que esteja colocada como comentário
ao instalar para o servidor intermediário WMQI ou WAS, ou ao instalar em um
computador Windows.
|
setUnixWMQIDest.value |
Defina para um caminho de diretório válido, sem espaços, para especificar a localização em que o produto WBIA deve ser instalado. Se você deixar essa opção comentada, o produto é instalado no diretório padrão listado em Tabela 2.. Essa opção será relevante apenas para os servidores intermediários WMQI e
WAS, quando instalados no UNIX. Certifique-se de que esteja colocada
como comentário ao instalar para o servidor intermediário WICS, ou ao instalar
em um computador Windows.
|
-P main_product.active |
Definir como true para instalar todos os componentes disponíveis no produto WBIA. Definir como false para instalar componentes
selecionados.
|
-P f_connectors.active |
Definir como true para instalar todos os adaptadores. Definir como false para instalar adaptadores
especificados.
|
-P adaptorFrameWork.active |
Definir como true para que os adaptadores funcionem com os servidores intermediários WMQI e WAS. Assinale essa opção para que o programa a ignore ao instalar para o
servidor intermediário WICS.
|
-P WindowEnvSetup.active |
Definir como true para que os adaptadores funcionem com os servidores intermediários WMQI e WAS. Retire o comentário dessa opção ao instalar o servidor intermediário WICS
ou ao instalar no UNIX.
|
-P support.active |
Definir como true para que os adaptadores funcionem com os servidores intermediários WMQI e WAS no UNIX. Marque esta opção como comentário para que o programa a ignore ao instalar
para o servidor intermediário WICS ou ao instalar para o servidor
intermediário WMQI ou WAS no Windows.
|
-P supportFileRequirement.active |
Definir como true para que os adaptadores funcionem com os servidores intermediários WMQI e WAS no UNIX. Marque esta opção como comentário para que o programa a ignore ao instalar
para o servidor intermediário WICS ou ao instalar para o servidor
intermediário WMQI ou WAS no Windows.
|
-P frameworkTOOLS.active |
Definir como true quando o WMQI for o servidor intermediário e o Windows for a plataforma para instalar as ferramentas utilizadas para funcionar com os componentes instalados. Definir como false se o WICS ou o WAS for o servidor
intermediário, se a plataforma for UNIX ou se você não quiser instalar as
ferramentas.
|
-P adaptorDevelopmentKit.active |
Definir como true quando o WMQI for o servidor intermediário e o Windows for a plataforma para instalar o Adapter Development Kit, que fornece as interfaces necessárias para desenvolver adaptadores personalizados. Definir como false se o WICS ou o WAS for o servidor
intermediário, se a plataforma for UNIX ou se você não quiser instalar o
Adapter Development Kit.
|
-P cn<adaptervalue>.active | Definir como true para instalar um adaptador específico, em
que adaptervalue é o valor que identifica o adaptador.
Por exemplo, cnJDBC identifica o Adaptador para JDBC. Consulte os gabaritos do arquivo de resposta para obter os adaptadores disponíveis e os valores associados a eles. Nem todos os adaptadores estão disponíveis para todos os servidores intermediários e plataformas. Consulte os gabaritos do arquivo de resposta para determinar se um determinado adaptador está disponível para essa combinação de servidor intermediário e plataforma. |
-P dataHandler.active |
Definir como true para ativar a instalação das rotinas de
tratamento de dados.
|
-P <datahandlervalue>.active |
Definir como true para instalar uma rotina de tratamento de dados específica, em que datahandlervalue é o valor que identifica a rotina de tratamento de dados. Por exemplo, xmlDataHandler identifica a rotina de tratamento de dados XML. Consulte os gabaritos do arquivo de resposta para obter as rotinas de tratamento de dados disponíveis e os valores associados a elas. O instalador avalia todas as dependências da rotina de tratamento de dados
dos adaptadores selecionados para que não seja necessário especificar que
sejam instaladas apenas para satisfazer requisitos do adaptador. Você
precisará selecionar rotinas de tratamento de dados para instalação se
planejar utilizá-las para adaptadores que planeje desenvolver e se elas não
forem instaladas por padrão.
|
-P AllDataHandlers.active |
Definir como true para instalar todas as rotinas de tratamento de dados. Definir como false para instalar as rotinas de tratamento de
dados especificadas.
|
-W mqDirectoryUserInput.mqLibraryLocation |
Definir para o caminho de diretório java\lib na instalação do WebSphere MQ no computador ao instalar para o servidor intermediário WMQI ou WAS. Assinale essa opção para que o programa a ignore ao instalar para o servidor intermediário WICS. Marque esta opção como comentário para que o programa a ignore se quiser
utilizar os valores padrão. Na plataforma Windows, o instalador
pesquisa o registro do Windows por padrão e utiliza o valor encontrado
lá. Na plataforma AIX, o instalador utiliza o valor padrão
/usr/mqm/java/lib. Nas plataformas Solaris e HP-UX, o
instalador utiliza o valor padrão /opt/mqm/java/lib.
|
-W workbenchChoice.workbenchList |
Definir como 1 para adicionar os plugins de ferramentas a uma instalação existente do WebSphere Studio Workbench ou WebSphere Studio Application Developer Integration Edition. Definir como 2 para instalar o WebSphere Studio
Workbench.
|
-W workbenchLocation.workbenchLocDirectory | Se você especificou que o WebSphere Studio Workbench fosse instalado definindo-se o valor da opção workbenchChoice.workbenchList como 2, defina essa opção para o diretório em que o workbench deve ser instalado, por exemplo, C:\WebSphereAdapters\Tools. |
-W inputServer.name |
Definir para o nome da instância do InterChange Server com a qual os adaptadores instalados se comunicarão. O nome faz distinção entre maiúsculas e minúsculas e deve ser especificado com exatidão ou os adaptadores não conseguirão se comunicar com o servidor. Certifique-se de que essa opção não seja colocada como comentário e que
seja definida com o valor apropriado ao instalar adaptadores para se comunicar
com o servidor intermediário WICS. Marque essa opção para que o
programa a ignore ao instalar para o servidor intermediário WMQI ou
WAS.
|
-W inputShortcuts.folder |
Definir com o nome do grupo de programas criado para o produto WBIA, por exemplo, IBM WebSphere Business Integration Adapters. Essa opção é relevante apenas na plataforma Windows. Marque essa
opção como comentário para que o programa a ignore ao instalar no UNIX.
|
-W createReposFile.active |
Definir como true para criar um arquivo que contenha as definições dos componentes selecionados para instalação. Definir como false para não criar um arquivo contendo as definições. Os arquivos de definição de componentes individuais ainda serão copiados
para o diretório repository mesmo se você escolher não criar esse
arquivo abrangente.
|
-G replaceExistingResponse |
Definir como yesToAll ou yes para substituir todos os arquivos localizados no sistema que tenham o mesmo nome daqueles copiados pelo instalador. Definir como noToAll ou no para não substituir os
arquivos localizados no sistema que tenham o mesmo nome daqueles copiados pelo
instalador.
|
-G replaceNewerResponses |
Definir como yesToAll ou yes para substituir todos os arquivos localizados no sistema que forem mais recentes que aqueles copiados pelo instalador. Definir como noToAll ou no para não substituir os
arquivos localizados no sistema que forem mais recentes que aqueles copiados
pelo instalador.
|
-G createDirectoryResponse |
Definir como yes para criar o diretório do produto especificado pela opção se ainda não existir. Definir como no para não criar o diretório se não existir. Para que a instalação seja bem-sucedida, essa opção deverá ser definida
como yes se o diretório especificado não existir.
|
-G removeExistingResponse |
Essa opção não é relevante para o servidor intermediário em nenhuma
plataforma. Marque essa opção como comentário para que o programa a
ignore.
|
-G removeModifiedResponse |
Essa opção não é relevante para o servidor intermediário em nenhuma
plataforma. Marque essa opção como comentário para que o programa a
ignore.
|
Você pode modificar um dos gabaritos do arquivo de resposta e utilizá-lo para a instalação silenciosa. Nesse caso, deverá certificar-se de que as opções que forem incompatíveis com outras requeridas sejam colocadas como comentário, colocando um símbolo de sinal numérico # na frente delas. Ou então poderá criar um novo arquivo de resposta com as opções requeridas. A vantagem dessa abordagem é que as opções desnecessárias ou blocos de descrição colocados como comentário são omitidos do arquivo de resposta, facilitando a leitura e edição. Se você assumir essa abordagem, recomenda-se copiar um arquivo de gabarito e remover as seções e opções desnecessárias, em vez de digitar as opções necessárias em um novo arquivo.
Para executar a instalação silenciosa, execute o arquivo executável do instalador específico da plataforma na linha de comandos com várias opções, incluindo o nome do arquivo de resposta que você preparou.
O seguinte exemplo mostra como fazer isso em um computador Windows em que o gabarito de arquivo de resposta dos servidores intermediários de integração WAS e WMQI é utilizado e existe no diretório C:\data:
D:\WebSphereBI>setupwin32.exe -silent -options C:\data\settings_WBIAInstaller_WSMQ.txt
O seguinte exemplo mostra como fazer isso em um computador AIX em que um arquivo de resposta personalizado denominado install.txt foi utilizado e existe no diretório /home/icsadmin:
# ./setupAIX.bin -silent -options /home/icsadmin/install.txt
Para instalar adaptadores adicionais, execute o WBIA Installer novamente. A palavra (installed) é exibida na tela de seleção de componentes próxima a todos os componentes que já foram instalados no sistema.
O Installer cria vários diretórios, arquivos e variáveis de ambiente dependendo das seleções que você fez ao executar o Installer.
Após a conclusão da instalação, você pode visualizar o sistema de arquivos
e seu conteúdo. A Tabela 5 lista alguns dos diretórios que você pode precisar
conhecer. As pastas e os arquivos criados variam dependendo das
escolhas feitas durante a instalação e no sistema operacional.
Tabela 5. Diretórios do WebSphere Business Integration Adapter
Nome do diretório | Conteúdo |
---|---|
_jvm231 | Esse diretório contém os arquivos Java Runtime.
|
_uninst_WBIA2.3.1 | Esse diretório contém arquivos necessários para desinstalar o produto
WebSphere Business Integration Adapters.
Para obter informações adicionais sobre como desinstalar o WBIA, consulte Desinstalando os Adaptadores do WebSphere Business Integration.
|
bin | Esse diretório contém os arquivos executáveis e os scripts de shell utilizados pelo Business Integration Adapters. |
connectors | Esse diretório contém arquivos específicos para cada adaptador do sistema. Também contém arquivos específicos do adaptador que você pode precisar instalar no aplicativo suportado pelo adaptador. |
DataHandlers | Esse diretório contém os arquivos .jar das rotinas de tratamento de dados. |
DevelopmentKits | Esse diretório contém os arquivos necessários para desenvolver conectores. |
legal | Esse diretório contém os arquivos de licença. |
lib | Esse diretório contém as bibliotecas compartilhadas e os arquivos .jar para o sistema. |
logs | Este diretório é fornecido para armazenar arquivos de log e de rastreio. |
messages | Esse diretório contém arquivos de texto de mensagem utilizados pelos conectores para gerar mensagens de log e de rastreio. |
ODA | Esse diretório contém os arquivos .jar e .bat para cada Object Discovery Agent. |
repository | Esse diretório contém os arquivos de definição do conector. |
templates | Esse diretório contém arquivos de script de amostra para criar e limpar
filas do WebSphere MQ.
Se seu servidor intermediário de integração for o WebSphere MQ Integrator Broker ou o WebSphere Application Server, consulte o seu guia de implementação do servidor intermediário para obter informações adicionais sobre a utilização desses scripts. Se o servidor intermediário de integração for o WebSphere InterChange Server, consulte o guia de instalação do InterChange Server na plataforma apropriada. |
Tools |
Este diretório contém o diretório WSWB203 que, por sua vez,
contém a instalação do WebSphere Studio Workbench se você escolheu
instalá-lo.
|
Se você escolheu o WebSphere MQ Integrator Broker ou o WebSphere
Application Server como seu servidor intermediário, o Installer executa as
ações descritas em Tabela 6 para criar e atualizar variáveis de ambiente no
computador. Essas ações não são executadas se você escolheu WebSphere
InterChange Server como seu servidor intermediário de integração, pois as
variáveis de ambiente requeridas para esse servidor intermediário são criadas
durante a instalação do próprio servidor intermediário.
Tabela 6. Ações Executadas pelo Installer para Variáveis de Ambiente
Nome da variável de ambiente | Ação do Installer |
---|---|
CROSSWORLDS |
Cria essa variável de ambiente para referenciar o diretório do produto
WBIA, conforme especificado ao utilizar o Installer.
|
MQ_LIB |
Cria essa variável de ambiente para conter o caminho no diretório
Java\lib dentro da instalação do WebSphere MQ, conforme
especificado ao utilizar o Installer.
|
CLASSPATH | Adiciona as seguintes entradas:
ProductDir\lib\rt.jar;
|
PATH | Adiciona as seguintes entradas:
ProductDir\bin\hotspot;
|
O método de desinstalação do WBIA ou de adaptadores selecionados depende de como o produto foi instalado.
Se o produto WBIA foi instalado a partir do CD, siga as instruções de Desinstalando Adaptadores Instalados a Partir do CD.
Se o produto WBIA foi instalado utilizando o ESD (Electronic Software Delivery), siga as instruções de Desinstalando Adaptadores Instalados a Partir do ESD.
Os adaptadores instalados a partir de um CD podem ser desinstalados da seguinte maneira:
Siga as etapas de uma das seguintes seções para chamar o instalador dependendo da plataforma em que o produto WBIA está instalado:
Navegue até o diretório ProductDir/_uninst_WBIA2.3.1 e execute o WBIA Uninstaller, uninstaller.exe.
Navegue até o diretório ProductDir/_uninst_WBIA2.3.1 e execute o WBIA Uninstaller, uninstaller.bin.
Se você estiver executando o Common Desktop Environment e estiver trabalhando diretamente no computador UNIX, dê um clique duplo no arquivo uninstaller.bin.
Se estiver utilizando o software de emulação X para conectar-se ao computador UNIX a partir de um computador Windows, deverá executar o arquivo uninstaller.bin na linha de comandos, como no seguinte exemplo:
# ./uninstaller.bin
Com o WBIA Uninstaller, faça o seguinte para desinstalar o sistema inteiro ou componentes selecionados:
Para executar uma desinstalação silenciosa, execute o executável do desinstalador específico da plataforma no diretório _uninst_WBIA2.3.1 em ProductDir na linha de comandos com a opção -silent.
O seguinte exemplo mostra como fazer isso em um computador Windows se o produto WBIA estiver instalado em C:\WebSphereAdapters:
C:\WebSphereAdapters\_uninst_WBIA2.3.1>uninstaller.exe -silent
O seguinte exemplo mostra como fazer isso em um computador AIX:
# ./uninstaller.bin -silent
Se um adaptador do WebSphere Business Integration foi instalado com o ESD (Electronic Software Delivery), o desinstalador estará em um diretório denominado _uninstXXX, em que XXX identifica o adaptador que ele desinstalará. Por exemplo, o desinstalador do adaptador do WBIA do JMS está localizado em um diretório denominado _uninstJMS. Para desinstalar um adaptador que foi transferido por download com o ESD, faça o seguinte:
java -cp uninstall.jar run