IBM WebSphere Business Integration. Guia de Instalação para WebSphere Business Integration Adapters

(1)

IBM

WebSphere

Business

Integration

Guia

de

Instalação

para

WebSphere

Business

Integration

Adapters

(2)

(3)

IBM

WebSphere

Business

Integration

Guia

de

Instalação

para

WebSphere

Business

Integration

Adapters

(4)

Nota!

Antesdeutilizarestasinformaçõeseoprodutosuportadoporelas,leiaasinformaçõesnos“Avisos”napágina47.

25deJunhode2004

Estaediçãoaplica-seàversão4.2.2doIBMWebSphereInterChangeServer,àversão2.4.0doIBMWebSphere BusinessIntegrationAdapterFrameworkeatodososreleasesemodificaçõessubseqüentes,atéquesejaindicado deoutraformaemnovasedições.

Paraenviarseuscomentáriossobreestedocumento,envieume-mailparadoc-comments@us.ibm.com.Esperamos receberosseuscomentários.

(5)

Índice

Sobre

Este

Documento

.

. v

Público-alvo . . . v

DocumentosRelacionados. . . v

ConvençõesTipográficas . . . vi

Novo

neste

Release

.

. ix

NovonoWebSphereBusinessIntegrationAdapter Frameworkv2.4(25dejunhode2004) . . . ix

NovonoRelease2.4 . . . ix

NovonoRelease2.3.1 . . . x

Capítulo

1. Visão

Geral

do

Processo

de

Instalação

.

. 1

AmbientesLocaisdoAdaptador. . . 1

AmbientesDistribuídosdoAdaptador. . . 2

AmbientesRemotosdoAdaptador. . . 4

AmbientesdeDesenvolvimentodeAdaptador . . . 5

Capítulo

2. Requisitos

de

Instalação

.

. 7

RequisitosdeHardware . . . 7

RequisitosdeSoftware . . . 8

InstalandoeConfigurandoOutroSoftware. . . . 10

RequisitosdeRotinadeTratamentodeDados. . . 11

Capítulo

3. Instalando

os

Produtos

WebSphere

Business

Integration

Adapters

.

. 13

PreparandoaMídiadeInstalação. . . 13

ProcedimentosGeraisparaUtilizaraMídiade Instalação . . . 14

InstalandooAdapterFramework . . . 16

InstalandoRotinasdeTratamentodeDados . . . 20

InstalandoAdaptadores . . . 22

InstalandooAdapterDevelopmentKit . . . 25

Diretórios,ArquivoseVariáveisdeAmbientedo WBIA . . . 27

Capítulo

4. Desinstalando

os

Produtos

WebSphere

Business

Integration

Adapters

.

. 31

DesinstalandooWebSphereBusinessIntegration AdaptersUtilizandooDesinstaladorGráfico . . . 31

ExecutandoumaDesinstalaçãoSilenciosa . . . . 33

Capítulo

5. Distribuindo

Agentes

de

Conector

nas

Redes

.

. 35

ComponentesaSeremInstalados . . . 35

TarefasdeInstalação . . . 36

Segurança. . . 41

Capítulo

6. Fazendo

Upgrade

do

WebSphere

Business

Integration

Adapters

.

. 43

FazendoUpgradedeumAmbientede DesenvolvimentodeAdaptador . . . 43

FazendoUpgradedeumWebSphereBusiness InformationAdapter . . . 43

FazendoUpgradedoAdaptadorPersonalizado . . 44

Avisos

.

. 47

InformaçõessobreInterfacedeProgramação . . . 48

MarcasRegistradaseMarcasdeServiço. . . 49

(6)

(7)

Sobre

Este

Documento

OportfóliodoIBM(R)WebSphere(R)Business IntegrationAdapterfornecea conectividade deintegraçãoparatecnologiaseaplicativoscorporativosde e-businesslíderesde mercado.Osistemainclui oIBMWebSphereBusiness IntegrationToolsetegabaritosparapersonalizar,criare gerenciarcomponentes paraa integraçãodoprocesso denegócios.

Estedocumentodescrevecomoinstalaro IBMWebSphereBusinessIntegration AdaptersnosambientesWindows,Solaris,AIXeHP-UX.

Nota: Estedocumento explicaa instalaçãodeadaptadoresedecomponentesde adaptadoresliberadoscomorelease doWebSphereBusiness Integration Adaptersde junhode2004.Sevocêestiver utilizandoum adaptador

liberadoantesde junhode2004,eleutilizará umprocedimentodeinstalação diferentedaqueledocumentadonestemanual.Certifique-sedeconsultara versãodoWebSphereBusinessIntegrationAdapters:GuiadeInstalação quecorrespondeaoadaptadorquevocêestáinstalando.Osseguintes adaptadores,emparticular,utilizamumprogramadeinstalaçãoanterior (liberadoemdezembrode 2003)nãodocumentadonestemanual,evocê deveconsultaroGuia deInstalaçãodedezembrode 2003:

v _Adaptador_para_Acord v _Adaptador_para_Ariba v _Adaptador_para_FIX

v _Adaptador_para_Healthcare_Data_Protocols v _Adaptador_para_mySAP.com

v _Adaptador_para_QAD_MFG/PRO

OAdapterDevelopmentKiteoAdapterFrameworktambémutilizam esse programadeinstalaçãoanterior; noentanto,asinstruçõesneste Guiade Instalação(junho de2004)representama versãocorretaparaesses componentes.

Nota: Emboravocê possaestarinstalandoosadaptadoresemumcomputador UNIX,énecessárioterumcomputadorWindowsparaexecutaras ferramentas.

Público-alvo

Estedocumentodestina-seaosconsultores,desenvolvedorese administradoresdo sistemaqueplanejam,instalam,implementameadministramoWebSphere Business IntegrationAdapters.

Documentos

Relacionados

Você podeinstalaradocumentaçãooufazersualeituradiretamenteapenasnos seguintes sites:

v _Para_obter_{informações}_gerais_sobre_o_adaptador, _utilizar_adaptadores_com_os servidoresintermediáriosde mensagensdo WebSphere(WebSphereMQ Integrator,WebSphereMQIntegrator Broker,WebSphereBusiness Integration MessageBroker)eutilizaradaptadorescomoWebSphereApplicationServer:

(8)

http://www.ibm.com/websphere/integration/wbiadapters/infocenter v _Para_utilizar_adaptadores_com_o _WebSphere_InterChange_Server:

http://www.ibm.com/websphere/integration/wicserver/infocenter

Esses sitescontêminstruçõessimplesparafazerdownload,instalarevisualizara documentação.

Nota: Informaçõesimportantessobreosprodutosdescritosneste guiapoderão estardisponíveisnosTechnoteseFlashesdoSuporteTécnicoemitidosapós estedocumento serpublicado.ElespodemserlocalizadosnoWebsitedo WebSphereBusinessIntegrationSupport,

http://www.ibm.com/software/integration/websphere/support/.

Selecioneaáreadecomponentesde interesseepesquisea seçãoTechnotes andFlashes.

Convenções

Tipográficas

Estedocumentoutilizaasseguintesconvenções:

Nota: Nestedocumento,asbarrasinvertidas(\)sãoutilizadascomoaconvenção paraoscaminhosdediretório.ParainstalaçõesUNIX,substituabarras(/) porbarrasinvertidas.Todososnomesdecaminhode arquivosãorelativos aodiretórionoqualo produtoestáinstaladoem seusistema.

fonte courier _Indica_um_valor_literal,_como_um_nome_de_comando,_nome dearquivo,informaçõesquevocêdigitaouinformaçõesque osistemaimprimenatela.

itálico,itálico _Indica_um_novo_termo,_um_nome_de_variável_ou_uma

referênciacruzadanaprimeiravezemqueaparece.

textoazul Umcontornoazul,queévisívelapenasquandovocêexibeo

manualon-line,indicaumhyperlinkdereferênciacruzada. Cliquedentrodocontornoparairparaoobjetode

referência.

{ } Emumalinhadesintaxe,aschavescircundamumconjunto deopçõesapartirdasquaisvocêdeveescolherumae apenasuma.

| Emumalinhadesintaxe,umcanalseparaumconjuntode opçõesapartirdasquaisvocêdeveescolherumaeapenas uma.

[ ] Emumalinhadesintaxe,oscolchetescircundamum parâmetroopcional.

... Emumalinhadesintaxe,asreticênciasindicamuma repetiçãodoparâmetroanterior.Porexemplo,option[,...] significaquevocêpodeinserirváriasopçõesseparadaspor vírgulas.

< > Oscolchetesangularescircundamelementosindividuaisde umnomeparadistingui-los,comoem

<nome_do_servidor_{><nome_do_conector>tmp.log.} /, \ _Neste_documento,_as_barras_invertidas_(\)_são_utilizadas

comoaconvençãoparacaminhosdediretório.Para instalaçõesUNIX,substituabarras(/)porbarrasinvertidas. Todososnomesdecaminhosdoprodutosãorelativosao diretórioemqueoconectordeAribaBuyerestáinstalado emseusistema.

(9)

%text%e$text Textocomsinaldeporcentagem(%)indicaovalorda variáveldesistemaouvariáveldousuáriotext_do Windows.AnotaçãoequivalenteemumambienteUNIXé $text_,_indicando_o_valor_da_variável_de_ambientetext_do

UNIX.

ProductDir Representaodiretórioemqueoprodutoestáinstalado.

(10)

(11)

Novo

neste

Release

Novo

no

WebSphere

Business

Integration

Adapter

Framework

v2.4

(25

de

junho

de

2004)

Asseguintes alteraçõesforamfeitasneste release: v _Novas_Estruturas_de_Arquivos_Instaladas

v _Cada_instalador_de_adaptador_agora_fornece_a _opção_para_registrar_o_adaptador comoumserviçodoWindows,sesuportadopeloadaptadore seoInterchange Serverestiversendoexecutadocomoo servidorintermediário

v _Instalação_de _documentos_para_novos_adaptadores

v _Novo_arquivo_em _batch_de_instalação_(Windows)_e_arquivo_de_script_shell (UNIX)

Novo

no

Release

2.4

Asseguintes alteraçõesforamfeitasneste release:

v _Cada_produto_WebSphere_Business_Integration_Adapters_agora_possui _seu próprioinstalador. Paraobter informaçõesadicionaissobrecomoutilizarcada instalador,consulteo Capítulo3,“InstalandoosProdutosWebSphereBusiness IntegrationAdapters”,na página13.

v _Este_guia_agora _apresenta_o_Capítulo_1,_“Visão_Geral _do_Processo_de _{Instalação”,} napágina1,queforneceinstruçõesdeprocedimentosparaprepararos

diferentestiposdeambientesdoWebSphereBusinessIntegrationAdapters. v _Este_guia_agora _apresenta_o_Capítulo_2,_{“Requisitos}_de_{Instalação”,}_na_página _7,

quedescreveospré-requisitosdehardwareesoftware.

v _Este_guia_agora _apresenta_o_Capítulo_5,_{“Distribuindo}_Agentes _de_Conector_nas Redes”,napágina35,queforneceinformaçõessobrecomoativarosadaptadores paracomunicaçãoremotautilizandooWebSphereMQInternet Pass-Thru. v _Este_guia_apresenta_agora _o_Capítulo_6,_“Fazendo_Upgrade_do_WebSphere

BusinessIntegrationAdapters”,napágina43,queofereceinformaçõessobre comofazerupgradedeambientesnosquaisvocêdesenvolveadaptadores,como executaradaptadoresdesenvolvidosdemaneirapersonalizadaecomo executar adaptadoresquefazemparte doprodutoWebSphereBusinessIntegration Adapters.

v _O_processo _de_{desinstalação}_do_WebSphere_Business_Integration_Adapters_foi alterado.Paraobterinformaçõessobrecomodesinstalaro WebSphereBusiness IntegrationAdapters,consulteoCapítulo4,“DesinstalandoosProdutos WebSphereBusiness IntegrationAdapters”,na página31.

v _O_IBM _Java_Development_Kit_é_agora _fornecido_com_o_Adapter _Framework_para aplataformaWindows.Paraobterinformações sobrecomoinstalaroIBMJDK, consulte“InstalandooIBMJava DevelopmentKit noWindows”napágina 10. v _O_VisiBroker _Object_Request_Broker_foi_substituído_pelo_IBM _Java_Object_Request

Broker.

v _Os_scripts_de_adaptadores_foram_modificados_para_este_release._Para_obter informaçõessobreasalteraçõesquetalvezvocê precisefazernosscripts existentes,consulteasnotassobreo release.

(12)

Novo

no

Release

2.3.1

(13)

Capítulo

1. Visão

Geral

do

Processo

de

Instalação

Estecapítuloapresentaumadescriçãodosdiferentestiposdeambientesdo WebSphereBusinessIntegrationAdaptersquevocêtalveztenhaquepreparareo workflowa serseguidoparafazerisso.

AFigura1 ilustraostiposde ambientesdo WebSphereBusiness Integration Adapters.

Ambientes

Locais

do

Adaptador

Geralmente vocêinstalaumadaptadornomesmocomputadorem queo servidor intermediáriode integraçãoéinstaladoeexecutado.Essetipode ambienteémais fácilde sermantidoegerenciado,principalmentequandovocê estádesenvolvendo e testandointerfaces, porquetodososcomponentesnosistemadeintegração de negóciossãoinstalados emumúnicocomputador.Oambiente1 naFigura1 ilustra essetipo deambiente.

Executeoseguinteparaprepararumambientelocaldoadaptador:

1. Obtenhacomputadoresqueatendamaosrequisitosde hardwarede cadaum dosambientesrequeridos.

Paraobterinformações adicionaissobreosrequisitosde hardware,consulte “RequisitosdeHardware”napágina7.

2. Seoservidor intermediáriodeintegraçãoforoWebSphereBusinessIntegration MessageBrokerou WebSphereApplicationServer,instale oWebSphereMQ ClientconformedescritonadocumentaçãodoWebSphereMQ.Aversão suportada doWebSphereMQClienté listadanaTabela5 napágina8.

Figura1.AmbientesdoWebSphereBusinessIntegrationAdapter

(14)

3. Executeumdosprocedimentosa seguir,dependendodoservidor intermediário deintegração quevocê estáimplementando:

v _Se_o _servidor_{intermediário}_de_integração_for_o_WebSphere_InterChange Server,instale oWebSphereInterChangeServer etodososseussoftwaresde pré-requisito,conformedescritonoSystemInstallationGuideforWindowsou noSystemInstallationGuideforUNIX.

v _Se_o _servidor_{intermediário}_de_integração_for_um_dos_servidores

intermediários demensagenssuportados ouoWebSphereApplicationServer, instale oAdapterFrameworkconformedescritoem“InstalandooAdapter Framework” napágina16.

Nota: Seoservidorintermediáriode integraçãoforoWebSphere

InterChangeServerevocê estiverinstalandoo WebSphereBusiness IntegrationAdaptersnomesmocomputadornoqualoInterChange Serverestáinstalado,nãoinstaleoAdapterFramework.OAdapter FrameworkéinstaladocomoWebSphereInterChangeServer. 4. Leiaocapítulo“InstalandoeConfigurandooConector”noguiadecada

adaptadorquevocê estáplanejandoinstalarnoambienteedeterminequaisquer requisitosderotinade tratamentode dadosparaoambiente.

5. Instalecadarotinadetratamentodedados requeridaparaoambiente,

conformedescritoem“InstalandoRotinasdeTratamentodeDados”na página 20.

6. Instalecadaadaptadorrequeridoparao ambiente,conformedescritoem “InstalandoAdaptadores”napágina 22.

7. Executequaisqueretapasde instalaçãoespecíficasdoadaptador, como,por exemplo,instalaroaplicativo clientenocomputadorhostdo adaptador, conformedescritonoguiarelacionadoa cadaadaptadorrequeridono ambiente.

Ambientes

Distribuídos

do

Adaptador

Embora sejafreqüentementepossível instalaradaptadoresnomesmocomputador quehospedaoservidor intermediáriode integração,àsvezesénecessário

distribuirosadaptadores.Issosignificainstalarosadaptadoresemumcomputador diferente daquelenoqualo servidorintermediárioestáinstalado.

Háváriasrazõesparavocêquerer distribuirosagentesdeconectores,incluindo as seguintes:

v _Você_pode_aprimorar _o_desempenho_do_sistema_de_integração_de_negócios, liberandoocomputadorquehospedaoservidorintermediáriodacargaimposta pelosadaptadores.

v _Você_pode_aprimorar _o_desempenho_de_um_adaptador,_instalando-o_em _um computadorpróximo, narede,aocomputadorquehospedao aplicativo. v _Você_poderá_não_obter_uma_versão_do_adaptador_no_sistema_operacional _do

computadorquehospedaoservidorintermediário.

Oambiente2 naFigura1 napágina1 ilustraessetipode ambiente,noqualo adaptadorédistribuídoparasecomunicarcomumaplicativodemainframe.

Executeoprocedimento aseguirparaprepararumambientedistribuídodo adaptadornaredecorporativa:

(15)

2. InstaleoWebSphereMQClientconformedescritona documentaçãodo WebSphereMQ.Certifique-se deinstalaro recursoJavaMessaging.Aversão suportada doWebSphereMQClienté listadanaTabela5 napágina8.

3. Executeoseguinteprocedimento,dependendodeseuservidor intermediáriode integração:

v _Se_o_servidor _{intermediário}_de_integração_for_o_WebSphere_Application Server ouumdosservidoresintermediáriosdemensagenssuportados, executeoseguinteprocedimento:

a. InstaleoAdapterFrameworkconformedescritoem “Instalandoo AdapterFramework” napágina16.

b. Leiaocapítulo“InstalandoeConfigurandooConector”noguia decada adaptadorquevocê estáplanejandoinstalarnoambienteedetermine quaisquerrequisitosderotinade tratamentode dadosparaoambiente. c. Instalecadarotinadetratamentodedados requeridaparaoambiente,

conformedescritoem“InstalandoRotinasdeTratamentodeDados”na página 20.

d. Instalecadaadaptadorrequeridoparaoambiente,conformedescritoem “InstalandoAdaptadores”napágina22.

v _Se_o_servidor _{intermediário}_de_integração_for_o_WebSphere_InterChange Server,executeoseguinteprocedimento:

a. ExecuteoinstaladordoWebSphereInterChangeServer nocomputador distribuídoparainstalara versãocorretadoAdapterFramework. QuandooAssistentedeConfiguraçãodoInterChangeServerfor

apresentado,especifiqueosmesmosvaloresdeconfiguraçãoqueaqueles especificadosaoinstalaroInterChangeServernocomputadorhostdo servidorintermediário.

Paraobterinformaçõesadicionais sobrecomoinstalaroWebSphere InterChangeServer,consulteoSystemInstallationGuideforWindowsou o

SystemInstallationGuideforUNIX.

Nota: VocênãodeveiniciaressainstânciadoInterChangeServer.Você estáinstalando-oapenasparainstalarumaversãocompatíveldo Adapter Frameworknocomputadorhostdo adaptador.

b. Apliquequaisquercorreçõesqueforamaplicadasaocomputadorhostdo InterChangeServeraocomputadordistribuído,paraqueosambientesde servidorintermediárioede adaptadorestejamem execuçãonomesmo níveldecorreção.

c. Instaleoadaptadorconformedescritoem“InstalandoAdaptadores”na página 22nocomputadordistribuído.

NatelaIBMWebSphereInterChangeServer,especifiqueonome da instânciadoInterChangeServer nocomputadorhostdoservidor intermediário,emvezdo nomedainstânciado InterChangeServer que você instalounocomputadorhost doadaptador(quefoinecessário instalarparainstalaroAdapterFrameworknocomputador).

d. Importea definiçãodeconectorcriadanodiretóriorepositoryparaseu ambientede desenvolvimento,conformedescritonoImplementationGuide forWebSphereInterchangeServer.

e. Configureoconectorconformedescritonoguiadoadaptador.

f. Implementeoconectornorepositóriodo InterChangeServer,conforme descritonoImplementationGuideforWebSphereInterchangeServer.

(16)

4. Executeoseguinteprocedimentoparaconfiguraroambienteparasecomunicar comoservidor intermediário:

a. Abraoarquivodeambientecompartilhado, localizadonodiretório

ProductDir\bin,em umeditordetexto.

EmcomputadoresWindows,oarquivodeambientecompartilhadoé denominadoCWSharedEnv.bat.

EmcomputadoresUNIX,oarquivodeambientecompartilhadoé

denominadoadapterEnv.shou CWSharedEnv.sh,dependendodoservidor intermediárioquevocê estáutilizandoe aversãodeseurelease.

b. Definaovalor dapropriedadeORB_PORTparaa portaatravésdaqual o ObjectRequestBrokerinstaladonocomputadordoservidor intermediário estáconfiguradoparasecomunicar.

c. Definaovalor dapropriedade ORB_HOSTparaoendereçoIPdocomputador noqualoservidor intermediárioestáinstalado.

5. Executequaisqueretapasde instalaçãoespecíficasdoadaptador, como,por exemplo,instalaroaplicativo clientenocomputadorhostdo adaptador, conformedescritonoguiarelacionadoa cadaadaptadorrequeridono ambiente.

Ambientes

Remotos

do

Adaptador

Você deveprepararumambiente remotodoadaptadorparapermitirqueum adaptadortroquedados comoservidorintermediáriodeintegração noslimitesda rede.Issoécomum quandoumaempresadevetrocardadosdenegócioscom parceiros denegócios.

Oambiente3 naFigura1 napágina1 ilustraessetipode ambiente,noqualo adaptadoréativadoparasecomunicarcomoservidorintermediárioatravésda Internet.

Executeoseguinteprocedimento paraprepararumambienteremoto do adaptador:

2. InstaleoWebSphereMQClientconformedescritona documentaçãodo WebSphereMQ.Certifique-se deinstalarorecursoJavaMessaging.Aversão suportada doWebSphereMQClienté listadanaTabela5 napágina8.

3. InstaleeconfigureoWebSphereMQInternetPass-Thruconformedescritono Capítulo5,“DistribuindoAgentesdeConector nasRedes”,napágina 35. 4. Executeoseguinteprocedimento,dependendodeseuservidor intermediáriode

integração:

v _Se_o _servidor_{intermediário}_de_integração_for_o_WebSphere_Application Server ouumdosservidoresintermediáriosdemensagenssuportados, executeoseguinteprocedimento:

a. InstaleoAdapterFrameworkconformedescritoem “Instalandoo AdapterFramework” napágina16.

b. Leiaocapítulo“InstalandoeConfigurandooConector”noguia decada adaptadorquevocê estáplanejandoinstalarnoambienteedetermine quaisquerrequisitosderotinade tratamentode dadosparaoambiente.

(17)

c. Instalecadarotinadetratamentodedados requeridaparaoambiente, conformedescritoem“InstalandoRotinasdeTratamentodeDados”na página 20.

d. Instalecadaadaptadorrequeridoparaoambiente,conformedescritoem “InstalandoAdaptadores”napágina22.

v _Se_o_servidor _{intermediário}_de_integração_for_o_WebSphere_InterChange Server,executeoseguinteprocedimento:

a. ExecuteoinstaladordoWebSphereInterChangeServer nocomputador distribuídoparainstalara versãocorretadoAdapterFramework. QuandooAssistentedeConfiguraçãodoInterChangeServerfor

apresentado,especifiqueosmesmosvaloresdeconfiguraçãoqueaqueles especificadosaoinstalaroInterChangeServernocomputadorhostdo servidorintermediário.

Paraobterinformaçõesadicionais sobrecomoinstalaroWebSphere InterChangeServer,consulteoSystemImplementationGuideforWindows

ouoSystemImplementationGuideforUNIX.

Nota: VocênãodeveiniciaressainstânciadoInterChangeServer.Você estáinstalando-oapenasparainstalarumaversãocompatíveldo Adapter Frameworknocomputadorhostdo adaptador.

b. Apliquequaisquercorreçõesqueforamaplicadasaocomputadorhostdo InterChangeServeraocomputadordistribuído,paraqueosambientesde servidorintermediárioeadaptadorestejamemexecuçãonomesmonível decorreção.

c. Instaleoadaptadorconformedescritoem“InstalandoAdaptadores”na página 22nocomputadordistribuído.

NatelaIBMWebSphereInterChangeServer,especifiqueonome da instânciadoInterChangeServer nocomputadorhostdoservidor intermediário,emvezdo nomedainstânciado InterChangeServer que você instalounocomputadorhost doadaptador(quefoinecessário instalarparainstalaroAdapterFrameworknocomputador).

d. Importea definiçãodeconectorcriadanodiretóriorepositoryparaseu ambientede desenvolvimento,conformedescritonoImplementationGuide forWebSphereInterchangeServer.

e. Configureoconectorconformedescritonoguiadoadaptador.

f. Implementeoconectornorepositóriodo InterChangeServer,conforme descritonoImplementationGuideforWebSphereInterchangeServer.

5. Executequaisqueretapasde instalaçãoespecíficas doadaptador, como,por exemplo,instalaroaplicativocliente nocomputadorhostdo adaptador, conformedescritonoguiarelacionadoa cadaadaptadorrequeridono ambiente.

Ambientes

de

Desenvolvimento

de

Adaptador

Você deveprepararumambiente dedesenvolvimentode adaptadorparacriar adaptadorespersonalizados.Emborasejapossíveldesenvolveradaptadoresemum ambiente noqualoservidorintermediárioestáinstaladoeosadaptadoresestão sendoexecutados,você tambémpode utilizarum ambientequesejadedicado exclusivamenteaodesenvolvimentode adaptador.

Oambiente4 naFigura1 napágina1 ilustraessetipode ambiente.

(18)

Executeoseguinteprocedimento paraprepararoambientede desenvolvimentode adaptador:

2. InstaleoAdapterFrameworkconformedescritoem“InstalandooAdapter Framework” napágina16.

3. Instalecadarotinadetratamentodedados queserárequeridaparaos adaptadoresquevocêestádesenvolvendo,conformedescritoem “Instalando RotinasdeTratamentodeDados” napágina20.

4. InstaleoAdapterDevelopmentKitconformedescritoem “Instalandoo AdapterDevelopmentKit”napágina25.

5. Instaleumcompilador apropriadoparaalinguagemna qualvocêestará desenvolvendooadaptador:

v _Se_você _estiver_{desenvolvendo}_o_adaptador_em_C_ou_C++, _instale_um compilador Cou C++.

v _Se_você _estiver_{desenvolvendo}_o_adaptador_no_Java,_instale_o _IBM_Java DevelopmentKit:

– Pressupõe-sequeseusistemaoperacional sejaAIX,portantovocê jápossui a versãosuportadado IBMJDK instalada.

– Paraobterinformações sobrecomoinstalaroIBMJava DevelopmentKit noWindows,consulte“InstalandooIBM JavaDevelopmentKitno Windows”napágina10.

– Paraobterinformações sobrecomoinstalaroSunJavaDevelopmentKit, consultea documentaçãodoSunJDK.

– Paraobterinformações sobrecomoinstalaroHPJava DevelopmentKit, consultea documentaçãodoHPJDK.

(19)

Capítulo

2. Requisitos

de

Instalação

Estecapítulocontémasseguintes seções: v _{“Requisitos}_de_Hardware”

v _{“Requisitos}_de_Software” _na_página₈

AntesdeinstalarosoftwareIBM WebSphereBusiness IntegrationAdapters, assegure-sede quevocê tenhatodosospré-requisitosnecessários.Ostópicosneste capítulofornecemumabrevevisãogeral dosrequisitosdehardwareesoftwaredo sistema,dosoftwarede pré-requisitoedascontasde usuáriorequeridaspara executaro WebSphereBusiness IntegrationAdapters.

Requisitos

de

Hardware

ATabela1listaosrequisitosmínimosdehardware.Noentanto,osrequisitosreais paraseusistemapodemser superiores,dependendodosprodutosespecíficos WebSphereBusinessIntegrationAdapter instaladosedosrequisitosde integração. Além disso,asinformaçõesaseguirsãoapenas paraosprodutosWebSphere Business IntegrationAdapter.Sevocêexecutaroutrosprodutos, comoservidores intermediários deintegraçãoouaplicativosclientes,nomesmocomputadorqueos produtos WebSphereBusiness IntegrationAdapter,seránecessárioajustaros requisitosapropriadamente.

Tabela1.RequisitosdeHardwaredoWindows

Componente RequisitoMínimo

Processador SistemaIBMeServerxSeriesebaseadoemIntel(ou equivalente)queexecutaaumavelocidademínimado processadorde1GHz

Memória 512MB

Espaçoemdisco 435MB

Tabela2.RequisitosdeHardwaredoAIX

Processador SistemaIBMeServerpSeriesouRS/6000comum uniprocessadoroumultiprocessadorsimétricoque executaaumavelocidademínimadoprocessadorde375 MHz

Memória 512MB

Tabela3.RequisitosdeHardwaredoSolaris

Processador SistemadeprocessadorSunMicrosystemsUltraSPARC queexecutaaumavelocidademínimadoprocessadorde 450MHz

Memória 512MB

(20)

Tabela4.RequisitosdeHardwaredoHP-UX

Processador SistemadeprocessadorHewlett-PackardHP-9000 PA-RISCqueexecutaaumavelocidademínimado processadorde440MHz

Memória 512MB

Requisitos

de

Software

Oconjuntodeprodutos WebSphereBusiness IntegrationAdaptersconsisteem componentes daIBM ecomponentesdeterceiros.Outrossoftwaresde terceiros, como oJavaDevelopmentKitsparaSunSolarise HP-UX,não sãofornecidospela IBM.

ATabela5listaosrequisitosdesoftwareparaosprodutos WebSphereBusiness IntegrationAdapters.Consultetambémoguia dousuárioindividual parao adaptadorespecíficoquevocê estáinstalando,paraobterinformações sobre software depré-requisitoparaesseadaptador.

Tabela5.RequisitosdeSoftwareparaWindows

Software VersãoeCorreção Comentários

SistemaOperacional(UmdosSeguintes) Umdosseguintes:

v _Windows_2000,_{Professional,}_Server_e_Advanced Server

v _Service_Pack₄

v _Windows_XP v _Service_Pack_1A v _Suportado_apenas_para_o

conjuntodeferramentasdo WebSphereBusiness IntegrationAdapters.Não suportadoparaaexecução deadaptadores.

v _AIX_5.1 v _Nível_de_manutenção₄

v _AIX_5.2 v _Nível_de_manutenção₁

v _Sun_Solaris₇ v _Solaris_7,_data_de_cluster

decorreçãorecomendada de23dejulhode2003

v _Sun_Solaris₈ v _Solaris_8,_data_de_cluster

decorreçãorecomendada de23dejulhode2003

v _HP-UX_11.11_(11i) v _GOLDAPPS_11i,

r=B.11.11.0306.4e GOLDBASE11i, r=B.11.11.03.06.4 ServidorIntermediáriodeIntegração

Umdosseguintes:

v _WebSphere_Application_Server,_Enterprise_Edition v _5.0.2 v _IBM_WebSphere_MQ_Integrator_Broker v _2.1_CSD05

(21)

Tabela5.RequisitosdeSoftwareparaWindows (continuação)

Software VersãoeCorreção Comentários

v _WebSphere_Business_Integration_Message_Broker v _5.0_CSD02

v _WebSphere_InterChange_Server v _4.1.1,_4.2.0,_4.2.1,_4.2.2 Nota: Algunsadaptadores nãosãocompatíveiscom todasasversõeslistadas doInterChangeServer. Paraobterinformações adicionais,consulteoguia deadaptadores.

OutrosSoftwaresRequeridos(comBasenaFunçãoNecessária)

IBMWebSphereMQServereClient Versão5.3.0.2comCSD05 Importante: Sevocênão aplicaroCSD05,os conectoresnãoestarãoaptos parainicializar.

Requeridoparapersistência deeventosdurantea comunicaçãoentreos conectoreseoservidor intermediário.

IBMWebSphereMQIPT(MQInternetPass-Thru) Versão1.3,SupportPacMS81 Opçãoparausocomo RemoteAgent(consulte Capítulo5,“Distribuindo AgentesdeConectornas Redes”,napágina35)

SunJRE Versão1.4 ParausocomoRemote

Agent JavaDevelopmentKit

Umdosseguintes,dependendodosistema operacional:

v _IBM_JDK_(para_computadores_Windows_e_AIX) v _1.3.1_SR5 v _Sun_JDK_(para_computadores_Solaris) v _{1.3.1_07} v _HP_JDK_(para_computadores_HP-UX) v _{1.3.1_06}

Umdosseguintesnavegadores: Requeridoparaexibir

documentos. v _Microsoft_Internet_Explorer v _N/D

v _Netscape_Navigator v _Versão_4.x

AdobeAcrobatReader4.0ouposterior.AIBM recomendautilizaraversão4.0.5ouposteriordo AcrobatReader,comaopçãoPesquisar,paraque vocêpossaaproveitarorecursodePesquisadoPDF aomáximo.Váparaoendereço

http://www.adobe.comparaobteraversãomais recentedoAdobeAcrobatReaderparaasua plataforma.

Estruturadeferramentas Umdosseguintes:

v _WebSphere_Studio_Workbench v _2.0.3 v _WebSphere_Studio_Application_Developer

IntegrationEdition

v _5.0.1

(22)

Instalando

e

Configurando

Outro

Software

Estaseçãocontéminformaçõessobrecomoinstalareconfigurarosoftwarequenão é fornecidocomoWebSphereBusinessIntegrationAdaptersequenão possui necessariamentesuaprópriadocumentação.Vocêseráinstruídoa executaressas tarefaspor outrasseçõesdesteguia,quandonecessário.

Configurando

o

Ambiente

para

Emulação

X

Sevocê estiverinstalandoemumcomputadorUNIX,masestiverutilizandoum computadorWindowsparaconectar-seaocomputadorUNIX,executeoseguinte procedimento paraconfiguraroambienteparaa emulaçãoX:

1. DetermineoendereçoIPdocomputadorWindowsqueestásendoutilizado paraconectar-seaocomputadorUNIX.

Vocêpode executarocomandoipconfignainterface dalinhadecomandosdo Windows paraexibiroendereçoIPdocomputadorWindows.

2. Definaa variáveldeambienteDISPLAYnocomputadorUNIXcomoendereço IPdeterminadonaetapa1.

DepoisdoendereçoIP,coloquedoispontos(:)eoidentificadordo monitorou dovídeo nocomputadorclienteWindows. Seocomputadorcliente Windows tiverapenasumúnicomonitor,ovalor dovídeoserá0.0.

OseguinteexemplomostraavariáveldeambienteDISPLAY sendodefinida para oúnicomonitor emumcomputadorWindowscujo endereçoIPé9.26.244.30:

DISPLAY=9.26.244.30:0.0

3. Exportea variávelde ambienteDISPLAYnocomputadorUNIXexecutandoo seguintecomando:

export DISPLAY

4. Inicieo clientedeemulaçãoXnocomputadorWindows econecte-seao computadorUNIX.

Instalando

o

IBM

Java

Development

Kit

no

Windows

Executeoseguinteprocedimento parainstalaroIBMJava DevelopmentKitno Windows:

1. Copie osarquivosdenominadosibm-sdk-in131.exeeibm-sdk-tn131.exedo diretórioIBM_JDK_WIN32 apartirdamídia deinstalaçãodoAdapter

Frameworkparaum diretóriotemporário nosistema.

2. Dêumcliqueduplonosarquivosdenominadosibm-sdk-in131.exee ibm-sdk-tn131.exe nodiretóriotemporário paraextrair seuconteúdo. 3. Dêumcliqueduplonoarquivodenominado install.exe,quefoicriado

quandoo conteúdodosarquivoscompactadosfoiextraídona etapa2. 4. Nopromptdeseleção deidioma,escolhaoidiomadesejadonomenu

drop-down ecliqueemOK.

5. NatelaBem-vindo,cliqueem Avançar.

6. NatelaAceitaçãodeLicença doSoftware,cliqueem Sim.

7. NatelaEscolher LocalizaçãodeDestino,aceiteocaminhopadrão ouexecute umadastarefasa seguir,eentão, cliqueemAvançarquandoconcluído: v _Clique_em_Procurar_e_selecione_um _diretório_para_instalar_o_JDK,_em

seguida,cliqueem OK

v _Clique_em_Procurar_,_digite_o_diretório_no_qual_você _deseja_instalar_o_JDK_no campoCaminho,emseguida,cliqueemOK

(23)

8. NatelaSelecionarComponentes,deixetodasascaixasde opçõesdos componentes ativadasecliqueem Avançar.

9. Quando solicitadoparainstalaroJava RuntimeEnvironmentcomoa JVMdo Sistema,cliqueem Não.

10. NatelaIniciarCópiadeArquivos,cliqueemAvançar. 11. NatelaConfiguraçãoConcluída,cliqueemConcluir.

Requisitos

de

Rotina

de

Tratamento

de

Dados

ATabela6listaosrequisitosderotinadetratamentodedados paracada adaptador, sehouver algum.

Tabela6.RequisitosdeRotinadeTratamentodeDadosparaAdaptadores

IBMWebSphereBusinessIntegrationAdapterpara...

RotinasdeTratamento Requeridas

ACORDXML XML

RotinadeTratamentodeDadosComplexa XML

SAPExchangeInfrastructure XML

HTTP XML

i2 XML

NightFireApplications XML

SiebeleBusinessApplications XML

Telcordia XML

WebSphereCommerce XML

WebSphereBusinessIntegrationMessageBroker XML

WebSphereMQWorkflow XML

XML XML

QADMFGPRO XML

(24)

(25)

Capítulo

3. Instalando

os

Produtos

WebSphere

Business

Integration

Adapters

EstecapítulodescrevecomoinstalaroWebSphereBusinessIntegrationAdapters.

Sevocê estiverfazendoupgradede umaversãoanterior,primeirofaçabackupdo sistemado servidorintermediáriodeintegração,conformedescritonoguia de instalaçãoou implementaçãodo servidorintermediário.

Estecapítuloincluiasseguintesseções: v _{“Preparando}_a_Mídia _de_{Instalação”}

v _{“Procedimentos}_Gerais_para_Utilizar _a_Mídia _de_{Instalação”}_na_página ₁₄ v _{“Instalando}_o_Adapter_Framework” _na_página₁₆

v _{“Instalando}_Rotinas_de _Tratamento_de _Dados”_na_página₂₀ v _{“Instalando}_{Adaptadores”}_na _página₂₂

v _{“Instalando}_o_Adapter_Development_Kit”_na_página₂₅

v _{“Diretórios,}_Arquivos_e_Variáveis_de_Ambiente_do_WBIA” _na_página₂₇

Preparando

a

Mídia

de

Instalação

Executeasetapasem umadasseçõesseguintes,dependendodesuamídiade instalação:

v _{“Preparando}_um_CD_do _Produto”

v _{“Utilizando}_o_Passport_Advantage”_na_página ₁₄

Preparando

um

CD

do

Produto

Seo seuprodutoWebSphereBusinessIntegrationAdaptersestiveremum CD, executeoseguinteprocedimento paraprepararocomputadorparaainstalação, dependendodeseusistemaoperacional:

v _No_AIX:

Insirao CDdoprodutonaunidadede CDdocomputadorAIXeexecuteo seguintecomandoparamontaroCD:

mount -V cdrfs -o ro /dev/cd0 /cdrom

v _No_Windows:

Insirao CDdoprodutonaunidadede CDdocomputadorWindows. v _No_Solaris:

Insirao CDdoprodutonaunidadede CDdocomputadorSolariseexecuteo seguintecomandoparamontaroCD:

mount -r -F hsfs /dev/sr0 /cdrom

v _No_HP-UX:

Insirao CDdoprodutonaunidadede CDdocomputadorHP-UXeexecuteo seguintecomandoparamontaroCD:

1. Executeosseguintescomandosparainiciaro daemonde montagemPFS:

/usr/sbin/pfs_mountd & /usr/sbin/pfsd &

2. Adicione umalinhacomoa seguinteaoarquivoetc/pfs_fstab:

(26)

/dev/dsk/cdrom_device /ponto_de_montagem pfs-iso9660 xlat=unix 0 0

em quecdrom_deviceéoidentificador dodispositivodediscoCD-ROM (por exemplo,c3t2d0 )e /mount_pointé oponto demontagem desejadopor meiodo qualvocê desejaacessar oCD (porexemplo,/cdrom).

3. ExecuteoseguintecomandoparamontaroCD:

mount /mount_point

em que/mount_pointéoponto demontagemespecificado naetapa 2na página 13.

Utilizando

o

Passport

Advantage

Sevocê obtiveroprodutoWebSphereBusinessIntegrationAdaptersapartirdo PassportAdvantage,executeoseguinteprocedimentoparaprepararamídia de instalação:

v _No_Windows,_faça_download_do_executável_{autodescompactável}_a_partir_do PassportAdvantage e,em seguida,dê umcliqueduplonele paraextrairos arquivosdeinstalação.

v _No_UNIX, _faça_download_do _arquivo_.tar _compactado_a_partir_do _Passport Advantagee,emseguida,descompacte-oparaextrairosarquivosde instalação.

Procedimentos

Gerais

para

Utilizar

a

Mídia

de

Instalação

Estaseçãodescreveosprocedimentosgeraisparautilizara mídiadeinstalação. Outras seçõesnesteguiareferem-se aoconteúdodestaseção.

Chamando

o

WBIA

Installer

Gráfico

OWebSphereBusinessIntegrationAdaptersInstallergráficoapresentaum assistentequepermitequevocêfaçaopçõessobreainstalaçãodo WebSphere Business IntegrationAdapters.VocêchamaoInstallerexecutandoosexecutáveis específicos daplataformaparaosdiferentesinstaladoresdoproduto.Os

instaladores doprodutosãoidênticos,quer sejamobtidosdeumCD oudo PassportAdvantage.Estaseçãodescrevecomo chamaroInstallerparaqualquer um dosprodutos WebSphereBusiness IntegrationAdaptersem ambosos computadores,Windowse UNIX.

Chamando

o

Installer

em

um

Ambiente

Windows

Certifique-se deterefetuadologincomprivilégiosadministrativosantesde instalar o WebSphereBusiness IntegrationAdaptersem umambienteWindows.Para chamar oInstallerem umambienteWindows,navegue parao diretórioWindows damídia deinstalaçãoeexecuteosetupwin32.exe.

Chamando

o

Installer

em

um

Ambiente

UNIX

OWBIAInstallerem umambienteUNIXé chamadopormeiode umarquivo.bin específicodaplataforma,localizadonodiretórioUNIXdamídia de instalação.

Quando vocêinstalaemumcomputadorbaseadoemUNIX,aspermissõesparaas pastasearquivosquesãocriadassãodefinidascombasenaspermissõesdaconta do usuárioqueexecutaainstalação.Certifique-sedenão terinstaladoo

WebSphereBusinessIntegrationAdapterscomorootem umcomputadorAIX.A entradaadicionadaaoODM(Object DataManager)aoinstalarcomorootimpede quevocêutilizeoSMITparadesinstalaroutros aplicativos,portantovocê nãodeve instalaroWBIAcomoroot.

(27)

Sigaasetapas deumadasseguintesseçõesparachamaroinstaladordependendo de comovocêestátrabalhandocomocomputadorUNIX:

v _“Se_Estiver_Executando_o _CDE_no_Computador_UNIX”

v _“Se_Estiver_{Conectando-se} _ao_Computador_UNIX_Através_do_Software_de EmulaçãoX”

SeEstiverExecutandoo CDEno ComputadorUNIX: Navegueparaodiretório UNIX damídia deinstalação ecliqueduasvezesnoarquivo.binespecificodo sistemaoperacional.

Você tambémpode navegarparaodiretórioUNIXdamídia deinstalaçãoe executar oarquivo.binnalinhade comandos.Oseguinteexemplomostra como fazerisso emumcomputadorAIX:

# ./setupAIX.bin

SeEstiverConectando-seaoComputadorUNIXAtravés doSoftwarede EmulaçãoX: Façaoseguinteparachamaro instalador:

1. Sigaasetapasem “ConfigurandooAmbiente paraEmulaçãoX” napágina10. 2. Executeoarquivo.binespecíficodo sistemaoperacional.Oseguinteexemplo

mostracomofazerisso emumcomputadorAIX:

# ./setupAIX.bin

OinstaladorgráficoéiniciadonocomputadorWindows queestásendo utilizadoparaconectar-seaocomputadorUNIX.

Nota: Asteclasdeacessorápidode acessibilidadenão funcionamquandovocê estátrabalhandoem umcomputadorUNIXpormeiodosoftwarede emulação.Parautilizarasteclasdeacessorápidodeacessibilidade, você devetrabalhardiretamentenocomputadorUNIX.

Executando

uma

Instalação

Silenciosa

Você podeexecutarumainstalaçãosilenciosadoWebSphereBusiness Integration Adapters, naqualfornecesuasopções deinstalaçãoemumarquivoemvezde fazerisso nastelasdo assistentede instalação.Issoéespecialmenteútilquandoé necessário executarváriasinstalaçõesidênticas.

Paraexecutarumainstalaçãosilenciosa,crieumarquivocomsuas opçõesde instalação,conformedescritoem“PreparandooArquivodeRespostada Instalação”,em seguida,executeainstalaçãoutilizandooarquivo, conforme descritoem“ExecutandoaInstalaçãoSilenciosa”napágina16.Asseçõesseguintes sobreainstalaçãodosdiferentestiposde produtosWebSphereBusinessIntegration Adapterstratamdasopçõesde instalaçãoespecíficas decadatipode produto: v _{“Instalando}_o_Adapter_Framework_{Silenciosamente”}_na_página ₁₈

v _{“Instalando}_Rotinas_de _Tratamento_de _Dados_{Silenciosamente”}_na _página₂₁ v _{“Instalando}_Adaptadores_{Silenciosamente”}_na_página ₂₃

v _{“Instalando}_o_Adapter_Development_Kit_{Silenciosamente”}_na_página ₂₆

Preparando

o

Arquivo

de

Resposta

da

Instalação

Aoexecutarumainstalaçãosilenciosa,você preparaumarquivode resposta(ou arquivodeopções) contendosuasopções deinstalação.AIBMfornecegabaritosde arquivoderespostaquecontêmasopções paracadaprodutoWebSphereBusiness IntegrationAdapters. Osgabaritosdearquivoderespostasãodenominados settings.txte sãofornecidoscomosoutros arquivosdeinstalação.

(28)

Sevocê estiverexecutandoinstalaçõesidênticasem váriasmáquinas,poderá registrarfacilmenteumaimagemdaprimeira instalaçãoemumarquivoeutilizar essearquivocomooarquivoderespostadainstalaçãoparainstalações

subseqüentes.Consulte“Gravando Seleçõesde Instalação”napágina25paraobter informações adicionais.

Astabelasa seguirlistamasopções disponíveisparacadatipode produtos WebSphereBusinessIntegrationAdapters:

v _Tabela₈_na _página₁₈ v _Tabela₉_na _página₂₁ v _Tabela₁₀_na_página₂₃ v _Tabela₁₁_na_página ₂₆

Leia todasasinformações dacoluna ValoresdaOpção,poiselaespecificaquando determinadasopções devemser colocadascomocomentárioequaissãoas

compatibilidades doservidor intermediárioe daplataforma.

Você podemodificarum dosgabaritosdo arquivoderesposta eutilizá-loparaa instalaçãosilenciosa.Nessecaso, deverácertificar-sedequeasopções queforem incompatíveis comoutrasrequeridassejamcolocadascomocomentário, colocando um símbolodesinalnumérico# nafrentedelas. Ouentão poderácriarumnovo arquivoderespostacomasopções requeridas.Avantagemdessaabordageméque asopções desnecessáriasou blocosdedescriçãocolocadoscomocomentáriosão omitidosdoarquivoderesposta,facilitandoaleituraeedição.Sevocêassumir essa abordagem,recomenda-secopiarumarquivodegabaritoeremoverasseções e opçõesdesnecessárias,em vezdedigitar asopções necessáriasemumnovo arquivo.

Nota: Nãodevehavernenhumespaçonafrentedequaisqueropções noarquivo deresposta.

Executando

a

Instalação

Silenciosa

Paraexecutara instalaçãosilenciosa,executeoarquivoexecutáveldoinstalador específicodaplataformanalinhadecomandoscomváriasopções,incluindoo nome doarquivoderespostaquevocê preparou.

Oexemploaseguir mostracomofazerissoemum computadorWindows,noqual o arquivoderesposta existenodiretórioC:\data :

D:\WebSphereBI>setupwin32.exe -silent -options C:\data\settings.txt

Oexemploaseguir mostracomofazerissoemum computadorAIX,noqualum arquivode respostapersonalizado,denominadoinstall.txt ,foicriadono diretório/home/wbia:

# ./setupAIX.bin -silent -options /home/wbia/install.txt

Instalando

o

Adapter

Framework

Sigaasinstruções emumadasseçõesseguintesparainstalaroAdapter

Framework,seindicadopelavisãogeral deprocedimentosnoCapítulo1,“Visão Geral doProcessodeInstalação”,napágina1:

v _{“Instalando}_o_Adapter_Framework_Utilizando_o_Instalador_Gráfico” _na_página₁₇ v _{“Instalando}_o_Adapter_Framework_{Silenciosamente”}_na_página ₁₈

(29)

Instalando

o

Adapter

Framework

Utilizando

o

Instalador

Gráfico

Executeoseguinteprocedimento parainstalaroAdapterFramework:

Nota: Sevocêestiver instalandooWebSphereBusinessIntegrationAdaptersno mesmocomputadornoqualoInterChangeServerestáinstalado,oAdapter Frameworknãodeverá serinstalado.

1. Chame oInstaller,conformedescritoem “ChamandooWBIAInstaller Gráfico” napágina14,paraoAdapterFramework.

2. Nopromptdeseleção deidioma,escolhaoidiomadesejadonomenu drop-down ecliqueemOK.

3. NatelaBem-vindo,cliqueem Avançar.

4. NatelaAceitaçãodeLicença daIBM,cliqueem Euaceitoostermosdo contratodelicençae,emseguida,cliqueemOK.

5. Natelado diretóriodo produto,executeumadasseguintestarefas: v _Digite_o_caminho _completo_do _diretório_no_qual_você _deseja_instalar_o

AdapterFrameworknocampoNomedoDiretórioe cliqueem Avançar

v _Clique_em_Procurar_para_selecionar_um_diretório_e_clique_em _Avançar v _Aceite_o _caminho_padrão_e_clique_em _Avançar

ATabela7lista osdiretóriospadrãodo produtoparaoWebSphereBusiness IntegrationAdaptersnossistemas operacionaissuportados:

Tabela7.DiretóriosPadrãodoProdutoparaoWebSphereBusinessIntegrationAdapters

SistemaOperacional DiretórioPadrãodoProduto

Windows C:\IBM\WebSphereAdapters

UNIX(AIX,Solaris,HP-UX) /opt/IBM/WebSphereAdapters

Importante: Vocêdeveespecificarumcaminho enomedediretóriodo produtoquenãocontenha espaços.

6. Ateladeresumolistaosrecursosqueserãoinstalados,odiretóriodoproduto especificado ea quantidadede espaçoem discorequerida.Leia as

informações paraverificá-la ecliqueemAvançar.

7. NatelaBibliotecadoWebSphereMQJava,digiteocaminho dodiretóriopara o diretóriojava\libdainstalaçãodoWebSphereMQou cliqueemProcurar

paraselecionar odiretório,em seguida,cliqueem Avançar.

8. Sevocê estiverinstalandonoWindowseoinstaladordetectarquevocêpossui umaversãosuportadadoWebSphereStudioApplicationDeveloper

IntegrationEditioninstalada,eleapresentará umatelanaqual oseguinte procedimento deveserexecutado:

v _Deixe_o_botão_de_opções _Incluir_plug-ins_em_uma_instalação_existente_do

workbenchativadosedesejarinstalarosplug-insdeferramentas na instalaçãodetectadadoWebSphereStudioApplicationDeveloper IntegrationEdition,emseguidacliqueemAvançar.

v _Ative_o_botão_de _opções_Instalar_o _WebSphere_Studio_Workbench_e_os

plug-insparainstalaroWebSphereStudioWorkbencheinstalarosplug-ins deferramentasnessainstalação,emseguidacliqueemAvançar.

9. Seo botãodeopçõesIncluirplug-insemumainstalaçãoexistentedo workbench foiativadonaetapa8, seráapresentadaumatelaexibindoo caminho dodiretórioWSADIEpadrão.Esseéocaminho noqual osplug-ins de ferramentasserãoinstalados.

(30)

Paraalterar opadrãoparaolocaldeumdiretórioWSADIEdiferente,digite o caminho paraodiretóriodeinstalaçãodoWSADIEnocampodetexto etiquetadoDiretóriodo IBMWebSphereStudioWorkbenchoucliqueem

Procurar paranavegarparaodiretório,emseguidacliqueemAvançar. 10. Se vocêestiverinstalandoemumcomputadorWindows,oInstaller

apresentará emseguidaatelade seleçãodepastade programa.Nocampo

GrupodeProgramas,digiteonome dogrupode programasnoqualos atalhos paraosadaptadoresdevemser criadosouaceiteogrupode programaspadrãoe,emseguida,cliqueemAvançar.

11. Após aconclusãobem-sucedidado Installer,cliqueemConcluir.

Instalando

o

Adapter

Framework

Silenciosamente

Executeoseguinteprocedimento paraexecutarumainstalaçãosilenciosado Adapter Framework:

1. Prepareum arquivoderespostaparainstalaroAdapter Framework,conforme descritoem“PreparandooArquivodeRespostadaInstalação”napágina 15, utilizandoasopçõesdesejadaslistadas naTabela8.

Tabela8.OpçõesdeInstalaçãoSilenciosadoAdapterFramework

NomedaOpção ValoresdaOpção

-P installLocation Definaessaopçãoparaocaminhoenomedodiretóriono qualdesejaqueoprodutosejainstalado.

Sevocêdeixaressaopçãomarcadacomocomentário,o produtoseráinstaladonodiretóriopadrãolistadonaTabela7 napágina17.

Essevalornãodeveconterquaisquerespaços.

-W mqDirectoryUserInput.mqLibraryLocation Definaessaopçãoparaocaminhododiretóriojava\libna instalaçãodoWebSphereMQnocomputador,quandoo sistemaoperacionalforWindows.

Marqueessaopçãocomocomentárioseoservidor intermediárioforWebSphereInterChangeServerevocê estiverinstalandooAdapterFrameworknomesmo computadoremqueoservidorintermediárioestáinstalado ouseosistemaoperacionalnãoforWindows.

Marqueessaopçãocomocomentáriosedesejarutilizaros valorespadrão.NaplataformaWindows,oinstalador pesquisaoregistrodoWindowsporpadrãoeutilizaovalor encontradolá.

-W mqUserInputAIX.mqLibraryLocation Definaessaopçãoparaocaminhododiretóriojava/libna instalaçãodoWebSphereMQnocomputador,quandoo sistemaoperacionalforAIX.

Marqueessaopçãocomocomentárioseoservidor intermediárioforWebSphereInterChangeServerevocê estiverinstalandooAdapterFrameworknomesmo computadoremqueoservidorintermediárioestáinstalado ouseaplataformanãoforAIX.

Marqueessaopçãocomocomentáriosedesejarutilizaros valorespadrão.NaplataformaAIX,oinstaladorutilizao valorpadrão/usr/mqm/java/lib_.

(31)

Tabela8.OpçõesdeInstalaçãoSilenciosadoAdapterFramework (continuação)

-W mqUserInputSOL.mqLibraryLocation Definaessaopçãoparaocaminhododiretóriojava/libna instalaçãodoWebSphereMQnocomputador,quandoo sistemaoperacionalforSolarisouHP-UX.

Marqueessaopçãocomocomentárioseoservidor intermediárioforWebSphereInterChangeServerevocê estiverinstalandooAdapterFrameworknomesmo computadoremqueoservidorintermediárioestáinstalado ouseaplataformanãoforSolarisouHP-UX.

Marqueessaopçãocomocomentáriosedesejarutilizaros valorespadrão.NasplataformasSolariseHP-UX,o instaladorutilizaovalorpadrão/opt/mqm/java/lib. -W workbenchChoice.workbenchList Definaessaopçãocomo1paraadicionarosplug-insde

ferramentasaumainstalaçãoexistentedoWebSphereStudio WorkbenchouWebSphereStudioApplicationDeveloper IntegrationEdition.

Definaessaopçãocomo2parainstalaroWeSphereStudio Workbench.

EssaopçãoérelevanteapenasnaplataformaWindows. MarqueessaopçãocomocomentárioaoinstalarnoUNIX. -W workbenchLocation.workbenchLocDirectory SevocêespecificouqueoWebSphereStudioWorkbenchfosse

instaladodefinindo-seovalordaopção

workbenchChoice.workbenchListcomo2,definaessaopção paraodiretórioemqueoworkbenchdeveserinstalado,por exemplo,C:\WebSphereAdapters\Tools_.

EssaopçãoérelevanteapenasnaplataformaWindows. MarqueessaopçãocomocomentárioaoinstalarnoUNIX. -W inputShortcuts.folder Definaessaopçãoparaonomedogrupodeprogramas

criadoparaoprodutoWBIA,comoporexemplo,IBM WebSphere Business Integration Adapters.

EssaopçãoérelevanteapenasnaplataformaWindows. MarqueessaopçãocomocomentárioaoinstalarnoUNIX. -G replaceExistingResponse DefinaessaopçãocomoyesToAllouyes parasubstituir

todososarquivoslocalizadosnosistemaquepossuemo mesmonomequeaquelesqueestãosendocopiadospelo instalador.

DefinaessaopçãocomonoToAll_ouno _para_não_substituir quaisquerarquivoslocalizadosnosistemaquetenhamo mesmonomequeaquelessendocopiadospeloinstalador. -G replaceNewerResponses DefinaessaopçãocomoyesToAllouyes parasubstituir

todososarquivoslocalizadosnosistemaqueforemmais recentesqueaquelessendocopiadospeloinstalador. DefinaessaopçãocomonoToAllouno paranãosubstituir quaisquerarquivoslocalizadosnosistemaqueforemmais recentesqueaquelessendocopiadospeloinstalador.

(32)

Tabela8.OpçõesdeInstalaçãoSilenciosadoAdapterFramework (continuação)

-G createDirectoryResponse Definaessaopçãocomoyesparacriarodiretóriodoproduto especificadopelaopção,seeleaindanãoexistir.

Definaessaopçãocomono_para_não_criar_o_diretório_do produto,seelenãoexistir.

Paraqueainstalaçãosejabem-sucedida,essaopçãodeverá serdefinidacomoyes_se_o_diretório_especificado_não_existir. -G removeExistingResponse Essaopçãonãoérelevanteparaoservidorintermediárioem

nenhumaplataforma.Marqueessaopçãocomocomentário. -G removeModifiedResponse Essaopçãonãoérelevanteparaoservidorintermediárioem

nenhumaplataforma.Marqueessaopçãocomocomentário.

2. Executeainstalaçãosilenciosaconformedescritoem“ExecutandoaInstalação Silenciosa”napágina 16,utilizandooarquivoderespostapreparadonaetapa1 napágina 18.

Instalando

Rotinas

de

Tratamento

de

Dados

Sigaasinstruções emumadasseçõesseguintesparainstalarumarotinade tratamentode dados,seindicadopelavisãogeraldeprocedimentosnoCapítulo1, “VisãoGeral doProcessode Instalação”,napágina1:

v _{“Instalando}_Rotinas_de _Tratamento_de _Dados_Utilizando_o_Instalador_Gráfico” v _{“Instalando}_Rotinas_de _Tratamento_de _Dados_{Silenciosamente”}_na _página₂₁

Instalando

Rotinas

de

Tratamento

de

Dados

Utilizando

o

Instalador

Gráfico

Executeoprocedimento aseguirparainstalarumarotina detratamentodedados utilizandoo instaladorgráfico:

1. Chameo Installer,conformedescritoem“ChamandooWBIAInstaller Gráfico” napágina 14parasuarotina detratamentodedados.

2. Nopromptdeseleçãode idioma,escolhaoidiomadesejadonomenu drop-down ecliqueemOK.

3. NatelaBem-vindo,cliqueemAvançar.

4. NatelaAceitação deLicençadaIBM,cliqueemEu aceitoostermosdo contratodelicença e,emseguida,cliqueemOK.

5. Ateladediretóriodoprodutopermiteespecificarondeasrotinasde tratamentodedados serãoinstaladas.Oinstaladordo adaptadortentará localizaro localdeinstalaçãodoAdapter Framework;seeleolocalizar,esse caminhoseráexibido porpadrão.Seelenão olocalizar,então,osseguintes padrõesserãoexibidos: ParaWindows:C:\IBM\WebSphereAdapterseparaUNIX, /opt/IBM/WebSphereAdapters.

Vocêpode especificarumoutrodiretório,maseledeveconter umainstalação deumaversãocompatíveldoAdapterFramework.Paraobterinformações sobrecomoinstalaroAdapterFramework,consulte“InstalandooAdapter Framework” napágina16.Paraobterinformaçõesadicionaissobrecomo instalaroWebSphereInterChangeServer,consulteo SystemImplementation GuideforWindowsou oSystemImplementationGuideforUNIX.Natelado diretóriodoproduto,executeumadasseguintes tarefas:

(33)

v _Digite_o_caminho_completo_do_diretório_no_qual_você _deseja_instalar_o Adapter FrameworknocampoNomedo DiretórioecliqueemAvançar

v _Clique_em _Procurar_para_selecionar_um_diretório_e_clique_em_Avançar v _Aceite_o_caminho _padrão_e_clique_em_Avançar

6. Ateladeresumolistaosrecursosqueserãoinstalados,o diretóriodo produto especificado eaquantidadedeespaçoemdiscorequerida.Leiaasinformações paraverificá-laecliqueem Avançar.

7. Sevocê estiverinstalandoem umcomputadorWindows,oInstallerapresentará a telade seleçãodepasta deprogramaparaalgumasrotinasdetratamentode dados.NocampoGrupodeProgramas,digiteonomedo grupodeprogramas noqualvocê desejacriar atalhosparaosadaptadoresou aceiteogrupo de programaspadrãoe,emseguida,cliqueemAvançar.

8. Apósa conclusãobem-sucedidado Installer,cliqueem Concluir.

Instalando

Rotinas

de

Tratamento

de

Dados

Silenciosamente

Façaoseguinteparaexecutarumainstalaçãosilenciosadeumarotinade tratamentodedados:

1. Prepareumarquivoderespostaparainstalararotinade tratamentode dados, conformedescritoem“PreparandooArquivodeRespostadaInstalação”na página15,utilizandoasopçõesdesejadaslistadas naTabela9.

Tabela9.OpçõesdeInstalaçãoSilenciosaparaRotinasdeTratamentodeDados

-W destination.path Definaessaopçãoparaocaminhododiretórionoqualo produtoWebSphereBusinessIntegrationAdaptersestá instalado.

-G replaceExistingResponse DefinaessaopçãocomoyesToAllouyes parasubstituir todososarquivoslocalizadosnosistemaquepossuemo mesmonomequeaquelesqueestãosendocopiadospelo instalador.

DefinaessaopçãocomonoToAll_ouno _para_não_substituir quaisquerarquivoslocalizadosnosistemaquetenhamo mesmonomequeaquelessendocopiadospeloinstalador. -G replaceNewerResponses DefinaessaopçãocomoyesToAllouyes parasubstituir

todososarquivoslocalizadosnosistemaqueforemmais recentesqueaquelessendocopiadospeloinstalador. DefinaessaopçãocomonoToAllouno paranãosubstituir quaisquerarquivoslocalizadosnosistemaqueforemmais recentesqueaquelessendocopiadospeloinstalador.

-G createDirectoryResponse Definaessaopçãocomoyesparacriarodiretóriodoproduto especificadopelaopção,seeleaindanãoexistir.

Definaessaopçãocomono_para_não_criar_o_diretório_do produto,seelenãoexistir.

Paraqueainstalaçãosejabem-sucedida,essaopçãodeverá serdefinidacomoyesseodiretórioespecificadonãoexistir. -G removeExistingResponse Estaopçãoespecificaseiráremoverumarquivoderesposta existentenosistema.Observequeessaopçãoéapenaspara desinstalação.Defina-aparayestoallouyespararemoveros arquivosderespostaexistentes.Defina-aparanotoall_ouno parasairdosarquivosexistentesnosistema.

(34)

Tabela9.OpçõesdeInstalaçãoSilenciosaparaRotinasdeTratamentodeDados (continuação)

-G removeModifiedResponse Estaopçãoespecificaseiráremoverumarquivoderesposta quefoimodificadodesdequefoiinstaladopelaúltimavez. Observequeessaopçãoéapenasparadesinstalação.Defina-a parayestoall_ou yes_para_remover_os_arquivos_de_resposta modificados.Defina-aparanotoallounoparasairdos arquivosmodificadosnosistema.

2. Executeainstalaçãosilenciosaconformedescritoem“ExecutandoaInstalação Silenciosa”napágina 16,utilizandooarquivoderespostapreparadonaetapa1 napágina 21.

Instalando

Adaptadores

Sigaasinstruções emumadasseçõesseguintesparainstalarumadaptador, se indicadopelavisãogeralde procedimentosnoCapítulo1,“VisãoGeraldo ProcessodeInstalação”,napágina 1:

v _{“Instalando}_Adaptadores_Utilizando_o_Instalador_Gráfico” v _{“Instalando}_Adaptadores_{Silenciosamente”}_na_página ₂₃ v _“Gravando_Seleções_de_{Instalação”}_na_página ₂₅

Observe que,nasplataformas UNIX,osnomesdearquivosfazemdistinçãoentre maiúsculas eminúsculas.Sevocê alterarasletrasmaiúsculasouminúsculasde qualquernomede arquivo,oadaptadorfalharádurante ainicializaçãoeregistrará um erro.Sevocê receberumerroaotentariniciaroadaptador, verifiqueosnomes dosarquivosXSDnorepositóriodo Configuradordo Conector.OsarquivosXSD devem terumaextensão.xsdemletrasminúsculas. Porexemplo,umnome de arquivoCustomer.XSDfarácomqueoadaptadorfalhe.Nesse caso,você deve alterar onomedoarquivoparaCustomer.xsd.

Instalando

Adaptadores

Utilizando

o

Instalador

Gráfico

Executeoprocedimento aseguirparainstalarumadaptadorutilizandoo instaladorgráfico:

1. Chameo Installer,conformedescritoem“ChamandooWBIAInstaller Gráfico” napágina 14.

2. Nopromptdeseleçãode idioma,escolhaoidiomadesejadonomenu drop-down ecliqueemOK.

3. NatelaBem-vindo,cliqueemAvançar.

4. NatelaAceitação deLicençadaIBM,cliqueemEu aceitoostermosdo contratodelicença e,emseguida,cliqueemOK.

Nota: OInstaller verificanosistemadeterminadospré-requisitosdesoftware nesteponto.Seumpré-requisitonão forlocalizado,oInstallerexibirá umatelainformandosobreissoequeoitemdeveser instaladoantesda instalaçãodoadaptadorcontinuar.Instaleosoftwarerequeridoereinicie oWebSphereBusiness IntegrationAdaptersInstaller.

5. Ateladodiretóriodoprodutopermitirá especificarondeinstalaros

adaptadores.Oinstaladordo adaptadortentarálocalizarolocalde instalação doAdapterFramework;seeleolocalizar,essecaminhoseráexibidopor padrão.Seelenãoolocalizar,então osseguintespadrões serãoexibidos:Para Windows:C:\IBM\WebSphereAdapterseparaUNIX,