ORemoteAPIClient,osoftwareSDK,osoftwareGSKIT eoprogramade Instalaçãoestãopresentes noCDdeinstalação,noformatodoWindows,e, portanto,podemserinstalados apartirdoCDnocomputadorWindows.Você deveinstalarosoftwareRemoteAPIClientemcadaPCcomclienteWindows;isso também instalaráosoftwareGSKITautomaticamente.OSDKsóserápreciso se você utilizaroclienteparadesenvolvernovosaplicativosutilizandoasAPIs Remotas doWindows;eelenãoseránecessáriocasosejautilizadoapenaspara executarosaplicativosexistentes.
Aimagemdeinstalaçãodo RemoteAPIClientnoWindows éumarquivoZIP executável,presentenoCDde instalação.
v Nocasodoclientede 32bits,éo arquivoi_w32cli.exenodiretório /ibm-commserver-clients/windowsdoCD.
v Nocasodoclientex64, éoarquivoi_w64cli.exenodiretório /ibm-commserver-clients/win-x64doCD.
Você podecopiaressearquivoparaoutrosPCsWindows narede,demaneiraque possa instalá-lossemacessodiretoaoCDdo CS/AIX.Aoexecutaresseexecutável, eledescompactaa imagemdeinstalaçãoeiniciaautomaticamenteoprogramade Instalação.Afimdedescompactarsimplesmentea imagemde instalaçãoparaum diretóriotemporário,porexemplo,paraexecutaroprogramadeInstalaçãoa partir dalinhadecomandos,carregueoexecutávelZIPdeauto-extraçãonoseu
programa dedescompactação.
Aprimeira vezqueexecutaroprograma deInstalaçãoemum computador específico,eleseráexecutadoapartirdaorigemselecionada.Oprogramaexecuta o processodeinstalaçãocompleto, defineumaconfiguraçãobásicae,alémdisso, instalaecria umíconeparasipróprio.Apósa conclusãodainstalação,utilizeo programa deInstalação(selecionando-onoGerenciadordeArquivosouclicando em seuícone)seprecisarreinstalar osoftware.
Depoisdeextrair aimagemdeinstalaçãodo RemoteAPIClientnumdiretório temporário,serápossívelinstalarosoftwareem umdosseguintesdoismodos:
v Executeo programadeInstalaçãopeloWindows,conformeexplicadoem
“Instalandoo RemoteAPIClientnoWindows UtilizandooPrograma de Instalação”napágina63.UtilizeessemétodoparainstalaroSDK.
v Digiteocomandosetupna linhadecomandos,conformeexplicadoem
“Instalandoo SoftwareRemoteAPIClienta partirdaLinhadeComandos” na página66.Essemétodonão permiteinstalaroSDK.
Nota: AntesqueoIBM RemoteAPIClient possaseconectaraosservidores utilizandoHTTPS,énecessário atualizaroarquivodedadosde rededo clienteparaespecificarosservidoresCS/AIXaosquaisoclientepode se conectareonomedoservidor WebSpherequefornecesuporteHTTPS.
Consultea seçãosobregerenciamentodeRemoteAPIClientsnoIBM CommunicationsServerforAIXAdministrationGuideparaobterdetalhes adicionais.
Instalando o Remote API Client no Windows Utilizando o Programa de Instalação
Executeoprograma deinstalação,automaticamentecomo partedaexecuçãodo arquivoZIPexecutáveldeauto-extraçãoi_w32cli.exe(clientede32bits)ou i_w64cli.exe(clientex64), oumanualmentena linhadecomandos.Inicialmente,o programa exibea telaEscolherIdiomadaInstalação.
1. Selecioneoidiomaaser utilizadoparainstalare configuraroRemoteAPI Client,ecliqueem OK.
OprogramaexibeumatelaBem-vindoqueapresentao programade Instalação.
2. EscolhaAvançar paracontinuarcomainstalação.
OprogramaexibeoSoftwareLicensingAgreement,oqualvocê develer e entender.
3. Seestiver deacordocomostermosdalicença,escolhaAceitarparacontinuar.
Oprogramasolicitaquevocêespecifiqueumdiretóriodedestinoemqueos arquivosdevemser instalados.
4. Digiteodiretóriodedestino.
Oprogramasolicitaquevocêescolhaotipode instalaçãodesejado:
Padrão
Escolhaessaopção senão fornecessárioinstalaroSDK.OSDKsó serápreciso sevocêutilizarocliente paradesenvolvernovos aplicativosutilizandoasAPIsRemotasdo Windows;eelenãoserá necessário casosejautilizadoapenasparaexecutarosaplicativos existentes.
Desenvolvedor
Selecioneessaopção parainstalaroSDK:ouseja, sefornecessário utilizarocliente paradesenvolvernovosaplicativosqueutilizamAPIs Remotas doWindows.
Nota: ParainstalaroSDK, escolhaDesenvolvedor.
5. Escolhaotipo deinstalação.
Nessaaltura,oprogramasolicitaainserçãodo nomedapasta deprogramas noqual osíconesdo RemoteAPIClientnoWindows devemfigurar.
6. Digiteonome dapasta.
7. Seo diretórioSystemjácontiverarquivos.DLL comnomesidênticosaos utilizadospeloprogramadeInstalaçãoquenãosejamarquivosdoRemote APIClient(porexemplo,quepertençam aalgumoutrosoftwareSNA),o programa oinstruiráaexecutarumadasseguintesopções:
v Copiarosarquivos.DLLdoRemoteAPIClient,sobrescrevendoosarquivos .DLLexistentes
v Copiarosarquivos.DLLexistentesparaumsubdiretóriocomonome OTHERSNAdodiretóriodeinstalaçãoeinstalarosarquivos.DLL do
Acessando o Programa de Instalação
RemoteAPIClient.Essa opçãopermiterestauraraconfiguraçãooriginal anteriorà instalaçãodoRemoteAPIClient,sedesinstalarosarquivos posteriormente(consulte“DesinstalandooSoftwareRemoteAPIClient”na página70).
v Canceleainstalaçãodosoftware docliente.
Seosarquivos.DLLdo RemoteAPIClientjáestiverem presentes,oprograma de Instalaçãoexibiráumamensagemindicandoisso.Novosarquivos.DLL sobrescreverãoosarquivos.DLL existentessomenteseestestiveremnúmeros de versãoinferioresaosarquivos.DLLdo programadeInstalação.
8. Nesteponto,oprogramade Instalaçãocopiaarquivosdaorigemespecificada e instala-osnoslocaisapropriados. Duranteesteprocesso,umabarrade informações exibequepartedainstalaçãoestáconcluída.Osarquivos.DLL sãocopiados paraodiretórioSystemou equivalenteeosoutros arquivossão copiados paraodiretóriodedestinoespecificadonaEtapa2.Durantecada operaçãode transferênciadearquivos,um registroégravadonoarquivo setup.log,queécriadonodiretórioespecificado.Sequalquerumdosarquivos a sergravadofor“somente leitura”ousealgumarquivonãopuderser
copiadoporalgum outromotivo,osnovosarquivosserãoremovidosevocê receberá umamensagemaconselhando-o averificaroarquivosetup.log.
9. Sea origema partirdaqualestáexecutandooprogramade Instalaçãonão contiver todososarquivosnecessários,oprograma solicitaráqueforneçaum nome dediretório.Digiteonome deumdiretórionoqualosarquivos necessáriosestãolocalizados.
Seasinformaçõesespecificadas nãoforemsuficientesparalocalizarascópias dosarquivosdoRemoteAPIClient,oprogramaexibiráessa telanovamente.
10. Quando osarquivosnecessáriostiveremsidocopiados,oprogramade Instalaçãoexibirá ajanelaConfiguração.
Os valoresdeconfiguraçãopadrão sãoobtidosdoarquivodeconfiguraçãode domínio.Paraobter informaçõesadicionais,consulteoIBMCommunications Server forAIXAdministrationGuide.Sevocênão desejarutilizaresses valores padrão,poderáconfigurá-los conformemostradoaseguir:
Domínio
Especifiqueonomedo domíniocliente/servidordo CS/AIX.
Seo clienteutilizaroendereçamentoIPv6,seránecessárioconfiguraras seguintes configurações.Elas sãoopcionais,seocliente utilizaro endereçamento IPv4.
NomedoServidor
Atelamostraumalistadeaténoveservidoresaosquaisestecliente pode serconectado.Aordem emqueosservidoresaparecemnessa lista éaordem emqueoclienteselecionaesses servidores.Seocliente não puderserconectadoaoprimeiroservidornalista, seráfeitauma tentativa comopróximoservidor.
Seo clienteutilizaroendereçamentoIPv6,seránecessárioconfigurar pelomenosumservidor.Seoclienteutilizaroendereçamento IPv4, não seránecessárioespecificarqualquerservidorsevocêutilizara opção difusõesUDP;sevocêespecificarumou maisservidores,por suavez,oclienteostentará,seelenão pudercontatarumservidor utilizandoasdifusõesUDP.
v Paraincluir umnovoservidornalista,utilizeobotãoIncluir.
v Pararemoverumservidor dalista, selecione-oeutilizeobotão Remover.
v Paramoverum servidorparacimaouparabaixonalista,selecione oservidoreutilizeosbotõesdeslizantes dalateraldalista.
Seocliente estivernamesma redeprivadaqueosservidorese acessá-los viaTCP/IP,cadaservidor seráidentificadosimplesmente pelonomedo servidor.
Seocliente utilizarHTTPSparaacessar seusservidores, será necessário identificarcadaservidor pelaespecificaçãodo nomedo servidor WebSpherequefornecesuporteHTTPSeonomedo servidor CS/AIX,noseguinteformato:
webservername:servername1
Esseparte dapremissaqueo WebSphereestáconfiguradopara utilizara porta443,a portapadrãoparaconexõesHTTPS. Seo administradordaredetiverconfiguradooWebSphereparautilizar um númerode portadiferente,incluaonúmerodaporta noseguinte formato:
webservername:portnumber:servername1
Paraobter maisdetalhessobrecomoconfiguraroWebSphereparadar suporte aconexõesdo HTTPS,consulte“Configurandoo WebSphere ApplicationServer”napágina38.
Difusões UDP
Especifiqueseesteclienteutilizará difusõesUDPparaserconectadoa um servidor.Quandoessaopção estiverselecionada,oclienteenviará difusõesUDPnaredeparalocalizarumaconexãodeservidor,em vez de tentarseconectardiretamenteaumservidor específico.
AconfiguraçãopadrãoéutilizardifusõesUDP.Paraalteraresta configuração,cliquenacaixa.
Seocliente utilizaroendereçamentoIPv6,asdifusõesUDPnãoserão suportadas.Desativea opçãoparautilizarasdifusõesUDPe
especifiquepelomenosumNomedoServidor.
Asseguintes configuraçõessãoopcionais:
Avançado
Parafornecervaloresadicionais,em vezdosvalorespadrãofornecidos peloprogramade Instalação,cliquenobotãoAvançadonaparte inferiordajanela. OprogramadeInstalaçãoexibeajanelaOpções Avançadas,quecontémdefiniçõesavançadas paraaconfiguraçãode cliente Windows.Amaioriadosusuáriospode utilizarasdefinições padrãoparaestesparâmetros,portantovocê provavelmentenão precise alterarasdefiniçõesnacaixadediálogo.
Paraobter maisinformaçõessobreestesparâmetros,consulte“Opções AvançadasdaConfiguraçãodoRemoteAPIClient”na página66.
Paraobter maisinformaçõessobrequalquerumdosparâmetros (ou definições)de configuração,cliqueem Ajuda.
11. Quando vocêtivercompletadoa janelaConfiguração,cliqueemOK.O programa deConfiguraçãoexibeumamensagemsevocênãocompletouessa telade maneiraadequada.
12. Quando ainstalaçãotiversidoconcluídacomêxito,a janelaConcluirserá exibida. Vocêpodeselecionar umaouasduasaçõesa seguirparaserem executadasdepois quesairdo programadeinstalação:
Instalando o Remote API Client no Windows Utilizando o Programa de Instalação
Visualizaro arquivoLEIA-ME VisualizeoarquivoLEIA-ME.
Iniciarcliente
Iniciaraexecuçãodessecliente doCS/AIX.
EscolhaConcluirparasairdoprograma deinstalação.