OsoftwareRemoteAPIClienteoSDK, osoftwareGSKITeoprograma Setup estãoincluídos noCD deinstalaçãonoformatodo Windows,paraqueseja possível instalá-losa partirdoCD nocomputadorWindows.Vocêdeveinstalaro software RemoteAPIClientem cadaPCcomclienteWindows; issotambém instalaráo softwareGSKITautomaticamente.OSDK serárequeridoapenas sevocê utilizará oclienteparadesenvolvernovosaplicativosutilizandoasAPIsRemotas do Windowsenão serárequeridosevocêo utilizaráapenasparaexecutar aplicativosexistentes.
Aimagemdeinstalaçãodo RemoteAPIClientnoWindows éumarquivo executável ZIPde extraçãoautomática,fornecido noCDdeinstalação.
v Paraoclientede32bits,eleé i_w32cli.exenodiretório /ibm-commserver-clients/windowsdoCD.
v Paraoclientex64,eleéi_w64cli.exenodiretório /ibm-commserver-clients/win-x64doCD.
É possívelcopiaressearquivoparaoutrosPCsWindowsnarede,de formaque sejapossívelinstalá-los semacessodireto aoCD deentregado Communications Server paraLinux.Aoexecutaresseexecutável,eledescompactaa imagemde instalaçãoe executaautomaticamenteo programaSetup.Sevocê simplesmente desejadescompactara imagemdeinstalaçãoemumdiretóriotemporário,por exemploparaexecutaroprogramaSetupa partirdalinhadecomandos,poderá fazê-locarregandooexecutávelZIPdeextração automáticaemseuprogramade descompactação dearquivos.
Aprimeira vezquevocê executaoprogramaSetupemum computadorespecífico, o programaéexecutadodaorigemselecionada.Oprogramaexecutaoprocesso de instalaçãocompleto, defineumaconfiguraçãobásicae,alémdisso, instalaecria um íconeparasipróprio.Apósa conclusãodainstalação,você poderáutilizaro programa Setup(selecionando-onoGerenciadordeArquivosouselecionandoseu ícone)seprecisarreinstalar osoftware.
Depoisdeextrair aimagemdeinstalaçãodo RemoteAPIClientparaumdiretório temporário,serápossívelinstalarosoftwarede umadestas duasmaneiras:
v Executeo programaSetupatravésdo Windows,conformeexplicadoem
“Instalandoo RemoteAPIClientnoWindows UtilizandooPrograma de Instalação”napágina57.Vocêdeveutilizaressemétodosedesejarinstalaro SDK.
Requisitos de Hardware e Software
v Digiteocomandosetupna linhadecomandos,conformeexplicadoem
“Instalandoo SoftwareRemoteAPIClienta PartirdaLinhadeComandos” na página61.Essemétodonão permiteinstalaroSDK.
Nota: AntesqueoIBM RemoteAPIClient possaseconectaraosservidores utilizandoHTTPS,énecessário atualizaroarquivodedadosde rededo clienteparaespecificarosservidoresCommunicationsServer paraLinuxaos quaiso clientepodeseconectare onomedoservidor WebSphereque fornecesuporteHTTPS. ConsulteaseçãosobrecomogerenciarosRemote APIClientsnoCommunicationsServerparaLinux:GuiadeAdministração para obterdetalhes adicionais.
Instalando o Remote API Client no Windows Utilizando o Programa de Instalação
Executeoprograma setup,automaticamentecomo partedaexecuçãodoexecutável ZIPde extraçãoautomáticai_w32cli.exe(cliente de32bits)oui_w64cli.exe(cliente x64), oumanualmentea partirdalinhadecomandos.Primeiro,oprogramaexibe umatelaEscolherIdioma deInstalação.
1. Selecioneoidiomaquedesejautilizarparainstalare configuraroRemoteAPI Client eescolhaOK.
OprogramaexibeumatelaWelcomequeapresentavocê aoprograma Setup.
2. EscolhaAvançar paracontinuarcomainstalação.
OprogramaexibeoContratodeLicençade Software,quevocêdeveler e compreender.
3. Sevocê concordarcomostermosdelicenciamento,escolhaAceitarpara continuar.
Oprogramasolicitaquevocêespecifiqueumdiretóriodedestinoemqueos arquivosdevemser instalados.
4. Digiteodiretóriodedestino.
Oprogramasolicitaquevocêescolhaotipode instalaçãodesejado:
Padrão
Escolhaessaopção senão precisainstalaroSDK.OSDKserá requeridoapenassevocêutilizará oclienteparadesenvolvernovos aplicativosutilizandoasAPIsRemotasdo Windowsenão será requeridosevocêoutilizará apenasparaexecutaraplicativos existentes.
Desenvolvedor
Escolhaessaopção seprecisainstalaroSDK:istoé,seoclienteserá utilizado paradesenvolvernovosaplicativosutilizandoasAPIs Remotas doWindows.
Nota: SevocêdesejainstalaroSDK,deveráescolher Desenvolvedor.
5. Escolhaotipo deinstalação.
Em seguida,o programasolicitaráquevocê digiteonomedapastade programasnaqualdesejaqueosícones doRemoteAPIClientnoWindows apareçam.
6. Digiteonome dapasta.
7. Seo diretórioSystemjácontiverarquivos.DLL comnomesquesejamiguais aosarquivosutilizadosporesseprogramaSetup,masnãoforemarquivosdo
Acessando o Programa Setup
RemoteAPIClient(porexemplo,arquivosdealgumoutrosoftwareSNA),o programa solicitaráavocê paraexecutarum dosseguintes procedimentos:
v Copiarosarquivos.DLLdoRemoteAPIClientsobreosarquivos.DLL existentes
v Copiarosarquivos.DLLexistentesparaumsubdiretóriodenominado OTHERSNAdentrodo diretóriodeinstalaçãoe,emseguida,instalaros arquivos.DLLdoRemoteAPIClient.Essaopção permiterestaurara configuraçãooriginalexistente antesdainstalaçãodoRemoteAPIClient,se vocêdesinstalarosarquivosemummomentoposterior(consulte
“DesinstalandooSoftwareRemoteAPIClient”napágina 65).
v Cancelarainstalaçãodo softwaredocliente.
Seosarquivos.DLLdo RemoteAPIClientjáestiverem presentes,oprograma Setupexibirá umamensagemindicandoisso.Novosarquivos.DLL
sobrescreverãoosarquivos.DLL existentessomenteseestestiveremnúmeros de versãoinferioresaosarquivos.DLLdo programaSetup.
8. Nesteponto,oprogramaSetupcopiaarquivosdaorigem especificadae instala-os noslocaisapropriados. 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 partirdaqualvocêestáexecutandooprograma Setupnão contiver todososarquivosnecessários,oprograma solicitaráquevocê forneça um nomedediretório.Digiteo nomedeumdiretórionoqualosarquivos necessáriosestãolocalizados.
Seasinformaçõesespecificadas nãoforemsuficientesparalocalizarcópiasdos arquivosdo RemoteAPIClient,oprograma exibiráessatelanovamente.
10. Quando osarquivosrequeridostiveremsidocopiados,o programaSetup exibirá ajanelaConfiguração.
Os valoresdeconfiguraçãopadrão sãoobtidosdoarquivodeconfiguraçãode domínio.Paraobter informaçõesadicionais,consulteCommunicationsServerfor LinuxAdministrationGuide.Sevocê nãodesejarutilizaressesvalorespadrão, poderáconfigurá-los conformemostradoa seguir:
Domínio
Especifiqueonomedo domíniocliente/servidordo Communications Server paraLinux.
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
Instalando o Remote API Client no Windows Utilizando o Programa Setup
opção difusõesUDP;sevocêespecificarumou maisservidores,por suavez,oclienteostentará,seelenão pudercontatarumservidor utilizandoasdifusõesUDP.
v Paraincluir umnovoservidor nalista,utilizeobotãoIncluir.
v Pararemoverumservidor dalista, selecioneoservidoreutilizeo botãoRemover.
v Paramoverum servidorparacimaouparabaixonalista,selecione oservidoreutilizeosbotõesdeslizantes dalateraldalista.
Seocliente estivernamesma redeprivadaqueseusservidorese acessá-los utilizandoTCP/IP,cadaservidor seráidentificado simplesmenteporseunomedeservidor.
Seocliente utilizarHTTPSparaacessar seusservidores, será necessário identificarcadaservidor especificando-seo nomedo servidor doWebSpherequefornecesuporteHTTPSeonome do servidor doCommunicationsServerparaLinux,noseguinteformato:
webservername:servername1
Issoassumequeo WebSphereestáconfiguradoparautilizaraporta padrão443 paraconexõesHTTPS.Seoadministrador daredetiver configuradooWebSphereparautilizarumnúmerodeporta diferente, incluaonúmerodaportanoseguinteformato:
webservername:portnumber:servername1
Paraobter detalhesadicionaissobrea configuraçãodoWebSphere parasuportarconexõesHTTPS,consulte “ConfigurandooWebSphere ApplicationServer”napágina31.
Difusões deUDP
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 nolugardospadrõesfornecidospelo programa Setup,cliquenobotãoAvançadonaparte inferiordajanela.
OprogramaSetupexibeajanelaOpçõesAvançadas,quecontém definiçõesavançadas paraa configuraçãodoclienteWindows.A maioriadosusuáriospodeutilizarasdefiniçõespadrãoparaestes parâmetros,portanto vocêprovavelmentenãoprecisealterar as definiçõesna caixade diálogo.
Paraobter maisinformaçõessobreestesparâmetros,consulte“Opções Avançadasparaa ConfiguraçãodoRemoteAPIClient”napágina 60.
Paraobter informaçõesadicionaissobrequaisquerparâmetrosdeconfiguração ou definições,cliqueem Ajuda.
Instalando o Remote API Client no Windows Utilizando o Programa Setup
11. Quando vocêtiverconcluídoajanelaConfiguração,cliqueemOK.O programa Setupexibeumamensagemsevocênão completouessa telade maneira adequada.
12. Quando ainstalaçãotiversidoconcluídacomêxito,a janelaConcluirserá exibida. Vocêpodeselecionar umaouasduasaçõesa seguirparaserem executadas depoisquesairdo programadeinstalação:
Visualizaro arquivoLEIA-ME VisualizeoarquivoLEIA-ME.
Iniciarcliente
Começar aexecuçãodesseclientedo CommunicationsServerpara Linux.
EscolhaConcluirparasairdoprograma deinstalação.