Bemvindoaorecursode plug-inparaoWebSphereApplicationServer-Express.
Oplug-indoservidor daWebpermitequeosusuáriosseparemamáquinado servidor daWeb eoservidordamáquinadoExpressApplicationparamaior segurança edesempenho.Essaseparaçãotambémpermitesermais flexívelna arquitetura doWebsiteemgeral.
Esses plug-inscomunicam-secomoWebSphereApplicationServer-Expresspelo HTTP(S).
Ainstalaçãodoplug-indoServidordaWebincluioscomponentesnecessários paraconfigurarautomaticamenteosservidoresdaWeba seguirnasplataformas em quesãosuportados.
v IBMHTTPServer v Apache(TM)
v Microsoft(TM)Internet Informationsystem v LotusDomino
v iPlanet(TM)/SunONE(TM)
Plataformas
Suportadas
para
Plug-ins
Web
Server
ApacheWebServer v MicrosoftWindows2000/NT v Linux v AIX v HP-UX v SunSolaris IBMHTTPWeb Server v MicrosoftWindows2000/NT v Linux v AIX v HP-UX v SunSolaris
MicrosoftIIS(Internet InformationSystem)
v MicrosoftWindows2000/NT
iPlanet(SunONE) WebServer v MicrosoftWindows2000/NT v Linux v AIX v HP-UX v SunSolaris
LotusDominoWeb Server v MicrosoftWindows2000/NT v Linux v AIX v HP-UX v SunSolaris
WebSphere
ApplicationServer- Express
v MicrosoftWindows2000/NT v LinuxAdvancedServer v AIX
v HP-UX v SunSolaris Nota#1
Notas:
1. AsplataformassuportadasparaoWebSphereApplicationServer-Express incluem apenasoservidor.Asferramentas dedesenvolvimentodo WebSphere Studio sãosuportadasnoMicrosoft WindowsenoLinux.
Software
Suportado
ApacheWebServer v Versão1.3.x
IBMHTTPWeb Server
v Versão1.3.x v Versão2.0.x
MicrosoftIIS(Internet InformationSystem)
v Versão4-Windows(TM)NT v Versão5-Windows(TM)2000
iPlanet(SunONE) WebServer
v Versão4.1 v Versão6.0
LotusDominoWeb Server v Versão5 v Versão6 WebSphere ApplicationServer- Express v Versão5.1.0
ConsulteNota#1abaixo
Notas:
1. Consulte(http://www-
3.ibm.com/software/webservers/appserv/express/support/)paraobteruma lista dee-fixesparao WebSphereApplicationServer -Express.
Notas
de
Instalação
1. Duranteainstalaçãodosplug-insdoservidor daWeb,selecioneosservidores quedevemserconfigurados automaticamente.Todasasbibliotecasearquivos deplug-inexigidosserãoinstaladoseosservidoresdaWebserãoentão configurados.
2. Oplug-indoservidorWebrequer queoIBM GSKit(GlobalSecurityKit) versão7estejainstaladonamáquina.Oprogramadeinstalaçãoinstalará automaticamenteoGSKitversão7ou,casocontrário,registraráo aplicativode plug-indoWebSphereApplicationServer-Express noGSKit seestejáestiver instalado.
3. Duranteainstalação,vocêserásolicitadoa fornecerasinformaçõesa seguir: v Diretório deinstalação
Ondeosarquivosde plug-ine asbibliotecas doservidorWeb serão
instalados.SeoWebSphereApplicationServer -Expressestiverinstaladona máquina, alocalizaçãopadrãoserá<Dir_de_Inst_do_Express>/Plugins.
Nota:Odiretóriodeinstalaçãoéa localizaçãoem queosarquivosdelicença, de produto,daJVMededesinstalaçãoestãoinstalados.Osarquivosdo Plug-inWebServer necessáriosnotempo deexecuçãosãoinstaladosem <Dir_de_Inst>/../AppServer.
Exemplo de Estrutura de diretórios:
C:\ - Arquivos de Programas -IBM -WebSphere - Plugins - AppServer
Em umambientedecamada única,emqueoservidorWebestáinstaladona mesma máquinado servidorExpressApplication,osWebServerPlugins estãolocalizadosnodiretório<Dir_de_Inst_do_Express>/AppServerdo WebSphereApplicationServer-Express.Issoforneceráumaintegração completado Plug-inWebServer comoservidorExpressApplication. Issofaz comqueodiretóriopadrãodoplugin-cfg.xmlRegeneratedsejaomesmo localqueoservidordaWebfoiconfiguradoparautilizar. Portanto,nãohá necessidadedecopiarmanualmenteoude moveroplugin-cfg.xml
restaurado apóssuarestauração.
v Nomedohostdo WebSphereApplicationServer-Express
Éo nomedohostdamáquinaqueestáexecutandooWebSphereApplication Server -Express.Estasinformaçõessãoreunidasparainserirvalores
apropriadosnoarquivode configuraçãodoplug-in(plugin-cfg.xml).Ovalor padrãoé onomedohostdo hostlocal.SeoWebSphereApplicationServer - Express estiversendoexecutado emumamáquinadiferente,insiraonome do hostdesseservidorremoto.
v Localizaçãodo ArquivodeConfiguraçãodoServidorWeb
Paracadaplug-indoservidordaWebselecionadoparainstalação,você será solicitadoa fornecera localizaçãode seuarquivodeconfiguração.Oarquivo deveexistirparacontinuarcomainstalação.
4. Paracadaplug-indoservidordaWebselecionadoparainstalação,serãofeitas modificaçõesautomáticasnoarquivodeconfiguraçãodo servidordaWeb.As modificaçõesincluema adiçãodeumareferênciaà bibliotecaadequadado plug-indoservidor daWebeumareferênciaà localizaçãodo arquivode configuraçãodoplug-in(plugin-cfg.xml)doservidordaWeb.
Consultea seção4.0“Quais AlteraçõesEstãoSendoFeitasnaConfiguração do meuServidordaWeb” paraobterinformaçõesdetalhadas.
5. Osplug-insdo servidordaWebparaoMicrosoft(TM)Internet Information SystemeparaoLotusDomino(TM)exigemquealocalizaçãodoarquivode configuraçãodoplug-in(plugin-cfg.xml)sejaarmazenadanoregistrodo sistemaWindows(TM).Aentradade registroéumachavedo WebSphere ApplicationServerversão5.1.0.0.Oprograma deinstalaçãoinformarásea entradadoregistrofoiatualizadadurante ainstalação.
Consultea seção4.0“Quais AlteraçõesEstãoSendoFeitasnaConfiguração do meuServidordaWeb” paraobterinformaçõesdetalhadas.
Alterações
Feitas
Automaticamente
na
Configuração
do
Meu
Servidor
da
Web
Estaseçãodescreveasmodificaçõesnos arquivosde configuraçãodoservidorda Webdurante ainstalação,comotarefasquepodemser concluídasmanualmente. Essasetapassãorealizadasautomaticamentepeloprocessode instalaçãoe estão listadas aquiparareferência.
Asmodificaçõesincluem aadiçãode umareferência àbibliotecadoplug-indo servidor daWebeumareferência àlocalizaçãodoarquivodeconfiguraçãodo plug-in(plugin-cfg.xml)doservidor daWeb.
v IBMHTTPServerimpulsionadopeloApache1.3(página42) v IBMHTTPServerimpulsionadopeloApache2.0(página42) v ApacheHTTPServerVersão 1.3(página 42)
v DominoWebServer(página 43)
v SunONE (iPlanet)WebServer(página44) v InternetServiceManagerWebServer(página 45)
Etapasparaestatarefa
1. ConfigurarEntradasdeArquivo doIBMHTTPServer1.3.xhttpd.conf. Utilizeasseguintes entradascomomodeloparaconfiguraçãodeseu
arquivo.NOTA: <Raiz_de_Inst_dos_plugins>éo diretórioraizde instalação dosplug-insdoWebSphereApplicationServer-Express.
v PlataformabaseadaemUNIX:
LoadModule ibm_app_server_http_module/opt/IBM/WebSphere/Express51/Plugins/bin/mod_ibm_app_serve WebSpherePluginConfig /opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml
Nota:Araizdainstalaçãopodevariardeacordocoma plataformado sistemaoperacional.Porexemplo,araiz dainstalaçãodoAIXé /opt/IBM/WebSphere/Express51/Plugins/paraa Versão5. v Plataformas Windows:
LoadModule ibm_app_server_http_module <Raiz_de_Inst_dos_plugins>\bin\mod_ibm_app_server_http.dl
WebSpherePluginConfig <Raiz_de_Inst_dos_plugins>\config\cells\plugin-cfg.xml
2. ConfigurarEntradasdeArquivo doIBMHTTPServer2.0httpd.conf. Utilizeasentradasa seguircomoummodelo paraa configuraçãodeseu arquivo.
v PlataformabaseadaemUNIX:
LoadModule was_ap20_module/opt/IBM/WebSphere/Express51/Plugins/bin/mod_was_ap20_http.so WebSpherePluginConfig /opt/IBM/WebSphere/Express51/plugins/config/cells/plugin-cfg.xml
Nota:Araizdainstalaçãopodevariardeacordocoma plataformado sistemaoperacional.Porexemplo,araiz dainstalaçãodoAIXé /opt/IBM/WebSphere/Express51/Plugins/paraa Versão5. v Plataformas Windows:
LoadModule was_ap20_module <Raiz_de_Instalação_dos_plugins>\bin\mod_was_ap20_http.dll
WebSpherePluginConfig <Raiz_de_Inst_dos_plugins>\config\cells\plugin-cfg.xml
Nota:Sea diretrizdoIBMHTTPServer1.3.26,LoadModule
Utilizeasentradasa seguircomoummodeloparaa configuraçãodeseu arquivo.
v PlataformabaseadaemUNIX:
LoadModule app_server_http_module/opt/IBM/WebSphere/Express51/Plugins/bin/mod_app_server_htt WebSpherePluginConfig /opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml
AmaioriadosservidoresdaWebApacheWebnão sãocompiladoscom suporte deEAPI(APIestendida).Seaparecerumamensagemcomoa seguinteaoiniciaroservidordaWebcomomódulodo plug-in mod_app_server_http.so,utilizea versãoEAPIdomodulo.
[Tue Jul 2 13:20:14 2002] [warn] Loaded DSO /opt/IBM/WebSphere/AppServer/bin/mod_app_server uses plain Apache 1.3 API, this module might crash under EAPI!
(please recompile it with -D EAPI)
ParautilizaromóduloEAPI,configureoarquivohttpd.confparaapontar paramod_app_server_http_eapi.so,emvezde paramod_app_server_http.so:
LoadModule app_server_http_module/opt/IBM/WebSphere/Express51/Plugins/bin/mod_app_server_htt WebSpherePluginConfig /opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml
Nota:Araizdainstalaçãopodevariardeacordocoma plataformado sistemaoperacional.Porexemplo,araiz dainstalaçãodoAIXé /opt/IBM/WebSphere/Express51/Plugins/paraa Versão5. v Plataformas Windows:
LoadModule app_server_http_module <Raiz_de_Instalação_dos_plugins>\bin\mod_app_server_http.d
WebSpherePluginConfig <Raiz_de_Inst_dos_plugins>\config\cells\plugin-cfg.xml
AmaioriadosservidoresdaWebApacheWebnão sãocompiladoscom suporte deEAPI(APIestendida).Seaparecerumamensagemcomoa seguinteaoiniciaroservidordaWebcomomódulodo plug-in mod_app_server_http.dll,utilizeaversãoEAPIdomodulo.
[Tue Jul 2 13:20:14 2002] [warn] Loaded DSO C:\WebSphere\AppServer\bin\mod_app_server_http. uses plain Apache 1.3 API, this module might crash under EAPI!
(please recompile it with -D EAPI)
ParautilizaromóduloEAPI,configureoarquivohttpd.confparaapontar paramod_app_server_http_eapi.dllemvezdepara
mod_app_server_http.dll:
LoadModule app_server_http_module <Raiz_de_Instalação_dos_plugins>\bin\mod_app_server_http_e
WebSpherePluginConfig <Raiz_de_Inst_dos_plugins>\config\cells\plugin-cfg.xml
4. ConfigurarEntradasdoLotusDominoWebServer
Sigaesteprocedimentoparaativaro plug-inde transporteHTTPpara
funcionarcomoDominoVersão 5.05ou5.06.Oassistenteparainstalaçãonão realizaessamodificação. Executeesteprocedimentomanual.
a. Inicieoservidor Domino.
b. Acesseoarquivo/webadmin.nsfutilizandoseunavegadordaWeb(por exemplo,http://hokie2ks.raleigh.ibm.com/webadmin.nsf).Onavegador solicitaumasenha.Forneça onomecurtoeasenha doadministrador. c. CliqueemConfiguration nolado esquerdodapágina.
d. CliqueemServersnocentro,napartesuperioresquerda,dapágina. e. Dêumcliqueduplonoservidor quevocê queroperandocomoWebSphere
ApplicationServer, Versão5.
f. CliqueemEditServernaparte superioresquerdadajanelacentral. g. CliqueemInternetProtocolsnomeiodapágina.
h. EmDSAPI,naparte direitadomeiodapágina,adicioneocaminhoparao plug-indoDomino,queestáinstaladonodiretóriobindo WebSphere ApplicationServer.
Nota:Sejáhouverarquivosdefiltro DSAPI(DominoWebServer
ApplicationProgramming Interface)especificados,utilizeumespaçopara limitaro arquivodeplug-indoWebSphereApplicationServer.
i. CliqueemSave eClosenaparte superioresquerda dajanelacentral. j. Definaa localizaçãodo arquivodeconfiguraçãoplugin-cfg.xml.
v PlataformasbaseadasemUNIX:
Definaa variávelde ambienteWAS_HOMEparaapontarparaodiretórioraiz deinstalaçãodo WebSphereApplicationServer.
v PlataformasWindows:
Adicionea variávelPluginConfignoregistronocaminho
HKEY_LOCAL_MACHINE>SOFTWARE>IBM>WebSphere Application Server>5.1.0.0.Definaovalordessa variávelparaa localizaçãodoarquivoplugin-cfg.xml,queé
<Raiz_de_Instalação_dos_plugins>\config\cells\plugin-cfg.xml.
Emque<Raiz_de_Instalação_dos_plugins>é odiretórioraizdeinstalação dosplug-insdoWebSphereApplicationServer-Express.
k. Inicieoservidor Dominonovamente.Quandooservidor foriniciado,uma mensagemsemelhantesa seguinteaparecerá:
02/12/2001 03:05:09 PM JVM: Java virtual machine initialized WebSphere Application Server DSAPI filter loaded
02/12/2001 03:05:10 PM HTTP Web Server started
5. ConfigurarEntradasdoSun ONE(iPlanet)WebServer
Utilizeasentradasa seguircomoummodelo paraa configuraçãodeseu arquivo.
v PlataformabaseadaemUNIXparaSunONE4.1: Inclua essasdiretrizes noarquivoobj.conf:
Init fn=“load-modules” funcs=“as_init,as_handler,as_term” shlib=“/opt/IBM/WebSphere/Express51/P Init fn=“as_init” bootstrap.properties=“ /opt/IBM/WebSphere/Express51/Plugins/config/cells/plug Service fn=“as_handler”
Nota:Araizdainstalaçãopodevariardeacordocoma plataformado sistemaoperacional.Porexemplo,araiz dainstalaçãodoAIXé /opt/IBM/WebSphere/Express51/Plugins/paraa Versão5. v PlataformabaseadaemUNIXparaSunONE6.0:
Adicione umadiretrizaoarquivoobj.confdepoisde “<Object name=default>”:
Service fn=“as_handler”
Inclua duasdiretrizesnofinaldoarquivomagnus.conf:
Init fn=“load-modules” funcs=“as_init,as_handler,as_term” shlib=“/opt/IBM/WebSphere/Express51/P Init fn=“as_init” bootstrap.properties=“/opt/IBM/WebSphere/Express51/Plugins/config/cells/plugi
Nota:Araizdainstalaçãopodevariardeacordocoma plataformado sistemaoperacional.Porexemplo,araiz dainstalaçãodoAIXé /opt/IBM/WebSphere/Express51/Plugins/paraa Versão5. v PlataformaWindowsparaSun ONE4.1:
Init fn=“load-modules” funcs=“as_init,as_handler,as_term” shlib=“<Raiz_de_Inst_dos_plugins>\ Init fn=“as_init” bootstrap.properties=“ <Raiz_de_Inst_dos_plugins>\config\cells\plugin-cfg.
Service fn=“as_handler”
v Plataformas WindowsparaSunONE6.0:
Adicioneumadiretrizaoarquivoobj.confdepoisde “<Object name=default>”:
Service fn=“as_handler”
Inclua duasdiretrizesnofinaldoarquivomagnus.conf:
Init fn=“load-modules” funcs=“as_init,as_handler,as_term” shlib=“<Raiz_de_Inst_dos_plugins>\ Init fn=“as_init” bootstrap.properties=“ <Raiz_de_Inst_dos_plugins>:\config\cells\plugin-cfg
6. ConfigurarEntradasdoInternetServiceManagerWeb Server
Sigaesteprocedimentoparareproduzirmanualmente comooassistentepara instalaçãoconfiguraoservidordaWebdoIIS(Internet ServiceManager): a. InicieoaplicativoIIS.
b. Crieumnovodiretóriovirtual paraainstânciadoWebsitequevocêdeseja queopere comoWebSphereApplicationServer.Paracriar essediretório comumainstalaçãopadrão,expandaa árvoreà esquerdaatévisualizar
DefaultWeb Site.CliquecomobotãodireitodomouseemDefault Web Sitee selecioneNew>VirtualDirectory.Noassistenteparainclusãode umdiretóriovirtual,façaoseguinte:
1) DigitesePluginsnocampoAliastobeusedtoAccessVirtual Directory.
2) Procure odiretóriobindoWebSphereApplicationServernocampo
Enterthephysicalpathofthedirectorycontainingthecontentyou wantto publish.
3) Selecioneacaixadeopções AllowExecute AccessnocampoWhat accesspermissiondo youwanttosetforthisdirectory.
4) Cliqueem FinishparaincluirodiretóriosePluginsem seuWebsite padrão.
c. Incluaofiltro daISAPI(InternetServicesApplicationProgramming Interface)emsuaconfiguraçãodoIIS.Cliquecomobotãodireitononome dohostna árvoreà esquerdaecliqueem Properties.No diálogoProperties, façaoseguinte:
1) VáparaaguiaInternetInformationServices.
2) Cliqueem WWWServicenajanelaMaster Properties.
3) Cliqueem EditparaabrirajanelaWWWServiceMasterProperties. 4) Cliqueem ISAPIFilters >Addparaabrira janelaFilterProperties. 5) DigiteiisWASPluginnocampoFilterName.
6) Cliqueem BrowsenocampoExecutable.
7) Navegueatéodiretóriobindaraizde instalaçãodo WebSphere ApplicationServer.
8) CliquenoarquivoiisWASPlugin_http.dll.
9) Cliqueem OKatéquetodasasjanelasabertasestejamfechadas. d. Adicionea variávelPluginConfigno registrono caminho
HKEY_LOCAL_MACHINE>SOFTWARE>IBM>WebSphere
ApplicationServer>5.1.0.0.Defina ovalorparaalocalizaçãodoarquivo deconfiguração,queé
<Raiz_de_Instalação_dos_plugins\config\cells\plugin-cfg.xml.
Emque<Raiz_de_Instalação_dos_plugins>éo diretórioraiz deinstalação dosplug-ins doWebSphereApplicationServer -Express.
Modificando
o
Arquivo
de
Configuração
do
Plug-in
(plugin-cfg.xml)
É necessáriogerarnovamenteoarquivode configuraçãodo plug-in, plugin-cfg.xml, apósaimplementaçãodosaplicativosparaoWebSphere ApplicationServer -Express.
Como WebSphereApplicationServer -Expressversão5.1.0,utilizeoscript genPluginCfgparagerarnovamenteoarquivoplugin-cfg.xmlcombase na configuraçãoatual deseuWebSphereExpressApplicationServer.
v Pequenasmodificaçõespodemser necessáriasnoarquivogeradoantesque possaserutilizado peloservidor daWeb.Casocontrário,ainicializaçãodo servidordaWebfalharáseoarquivoplugin-cfg.xmlnãopuder seranalisado comsucessopeloseuservidordaWeb.
v Alocalizaçãopadrãodo arquivoplugin-cfg.xmlgeradoé <Dir_de_Inst_do_Express>/AppServer/config/cells.
Emque<Dir_de_Inst_do_Express>é odiretórioraizdeinstalaçãodoWebSphere ApplicationServer -Express
v Todososcaminhosnoarquivoplugin-cfg.xmlgerado novamenteprecisamser atualizadosparafinsdeprecisãoparasuamáquinadoservidordaWebquando oservidorestiver emumamáquinadiferentedadoservidor deaplicativo. v QuandooseuservidorWebestáinstaladoemumamáquinadiferentedado
WebSphereApplicationServer -Express,oarquivoplugin-cfg.xmlgeradodeve sermovidoparao diretório<Raiz_de_Instalação_dos_Plugins/config/cells localizadonamáquinadoservidor Web.
Emque<Raiz_de_Instalação_do_Plugin>éodiretórioraizde instalaçãodos plug-insdoWebSphereApplicationServer-Express.
As situaçõesa seguirexigemediçãomanualdoarquivoplugin-cfg.xml:
v SeoservidordaWebeoarquivoplugin-cfg.xmlestiverem instaladosemum sistemaremoto separado,énecessário alteraroscaminhosnoplugin-cfg.xmlse: – Oplug-infoigerado emumsistemaWin32eprecisasercopiadoparaum
sistemaUNIXremotocomum HTTPServer eumplug-indoWebSphere ApplicationServerVersão 5.
– Oplug-infoigerado emumsistemaUNIXeprecisasercopiadoparaum sistemaWin32remoto comumHTTPServer eumplug-indoWebSphere ApplicationServerVersão 5.
– Oplug-infoigerado emumadistribuiçãoUNIXeprecisaser copiadopara um sistemaUNIXremoto queéumadistribuiçãodiferente.Porexemplo,o plug-infoigeradoemumsistemaquetemumainstalaçãoemAIXno caminho padrãoeoHTTPServerremotoe oplug-inestãoinstaladoem uma distribuiçãoSolaris ouLinuxcomoplug-ininstaladoemumalocalização padrão.
Arquivo
plugin-cfg.xml
de
Amostra
<?xml version=“1.0” encoding=“ISO-8859-1” ?> <Config>
<Log LogLevel=“Error” Name=“C:\Arquivos de Programas\IBM\WebSphere\Express51\Plugins\logs\http_plug <VirtualHostGroup Name=“default_host”>
<VirtualHost Name=“*:7080” /> <VirtualHost Name=“*:80” /> <VirtualHost Name=“*:7443” />
<Transport Hostname=“myHostname.raleigh.ibm.com” Port=“7443” Protocol=“https”> <Property name=“keyring” value=“
C:\Arquivos de Programas\IBM\WebSphere\Express51\Plugins\etc\plugin-key.kdb” /> <Property name=“stashfile” value=“
C:\Arquivos de Programas\IBM\WebSphere\Express51\Plugins\etc\plugin-key.sth” /> </Transport> </Server> <PrimaryServers> <Server Name=“DefaultNode_server1” /> </PrimaryServers> </ServerCluster> <UriGroup Name=“default_host_server1_DefaultNode_Cluster_URIs”>
<Uri AffinityCookie=“JSESSIONID” AffinityURLIdentifier=“jsessionid” Name=“/UTC/*” />
<Uri AffinityCookie=“JSESSIONID” AffinityURLIdentifier=“jsessionid” Name=“/CustomHomePageExample <Uri AffinityCookie=“JSESSIONID” AffinityURLIdentifier=“jsessionid” Name=“/YourCoExpressExample/