IBM WebSphere Application Server - Express Versão 5.1
Guia de Migração
SextaEdição(Dezembrode2003) Nota!
Antesdeutilizarestasinformaçõeseoprodutosuportadoporelas,certifique-sedeler asinformaçõesgeraisnos“Avisos”napágina63.
Índice
Capítulo1.Visão Geraldo Guiade Migração doWebSphereApplication
Server- Express . . . . . . . . . . . 1
Capítulo2.Migrando o Servidorde Produção . . . . . . . . . . . . . . 3
Migração . . . 3
MigrandoeCoexistindo . . . 4
FerramentasdeMigração . . . 5
ComandoWASPreUpgrade . . . 5
ComandoWASPostUpgrade . . . 6
MapeamentodeConfiguraçãoduranteaMigração . 8 MigrandoDadosdeConfiguraçãoManualmente . . 10
MigrandodaV3.5.xparaaV5.1 . . . 11
MigrandoaV3.5.xparaumaMáquinaV5.1Remota 13 MigrandodaV5.0.xparaaV5.1 . . . 15
MigrandodaMáquinaV5.0.xparaumaMáquina V5.1Remota . . . 15
MigrandodeumSistemaOperacional Não-Suportado . . . 17
Capítulo3.Migrando do IBM WebSphere StudioSite Developer Versão5.1 . . . . . . . . . . . . . 19
MigrandoProjetosJ2EEparaUtilizaroSuportedo ServerTargeting. . . 19
CompatibilidadeReversacomoSuporteAtivado doServerTargeting. . . 19
AGeraçãodoAssistenteRequerumPacoteJava paraJDK1.4 . . . 20
Capítulo4.Migrando do IBM WebSphere StudioSite Developer Versão5 ouVersão 5.0.1. . . . . . . 21
WebSphereStudioWorkbenchnaVersão5,na Versão5.0.1enaVersão5.1 . . . 21
UtilizandooEspaçodeTrabalhodoIBMWebSphere StudioSiteDeveloperVersão5.1.1comaVersão5.0. 21 MigrandoProjetosJavadaVersão5oudaVersão 5.0.1. . . 22
CompartilhandoProjetosentreaVersão5oua Versão5.0.1eaVersão5.1.1UtilizandoumSistema SCM(SourceCodeManagement) . . . 22
MigrandoProjetosdaWeb . . . 24
ConvertendoProjetosdaWebparaoStruts1.1 . . 24
AlteraçõesnasFerramentasdeServiçosdaWeb . . 25
AlteraçõesFeitasnasFerramentasdeCriaçãode Perfil . . . 25
ProblemasConhecidosdeCompatibilidadedo AssistenteparaGabarito . . . 26
Capítulo5. Migrandodo IBM WebSphere StudioSite Developer Versão4.0.x . . . . . . . . . . . . 27
DiferençasentreIBMWebSphereStudioSite DeveloperVersão4.0.xeVersão5. . . 27
AlteraçõesdoWebSphereApplicationServere FerramentasdeConversãodoServlet/JSP . . . . 28
AlteraçõesInternasdaVersão4.0.3 . . . 28
AsDependênciasdeProjetosCircularesNão SerãoCompiladasporPadrão . . . 28
OsProjetosdaWebdaVersão5Sãode LocalizaçãodeOrigemCompatívelcomaVersão 4.0.3. . . 29
EstruturasdeProjetosdaWebdoIBM WebSphereStudioSiteDeveloper . . . 29
ProjetosdaWebEstáticosversusDinâmicos . . 29
DistinçõesentreHTMLeJSP . . . 30
MigrandoProjetosUtilizandoumSistemaSCM (SoftwareConfigurationManagement) . . . 30
MigrandoProjetosUtilizandoCVSouRational ClearCase . . . 30
RemoçãoPós-migraçãodasReferênciasde CaminhoAbsolutodoEARedoServidorde Configuração. . . 32
MigrandoProjetosUtilizandoOutrosSCMs . . 32
MigrandoosProjetosporExportaçãoeMigração. . 32
MigrandoProjetosUtilizandoumEspaçode TrabalhoExistentedaVersão4.0.x. . . 33
RemoçãoPós-migraçãodasReferênciasde CaminhoAbsolutodoEARedoServidorde Configuração. . . 33
ProblemaseLimitaçõesConhecidos . . . 34
MigrandoDadosRelacionaisnosProjetosdaWeb de4.0.3. . . 35
ErrosWSDLApósaImportaçãodeumArquivo deServiçosdaWebde4.0.x. . . 35
MigrandoEstruturasdeProjetosdoJ2EEe/ou NíveisdeEspecificaçãodoJ2EE . . . 35
Capítulo6. Migrandodo WebSphere Studio ″Classic″para oIBM WebSphere StudioSite Developer. . . 37
CriandoumaNovaEtapadeServidorÚnicopara Migração . . . 38
CriandoumArquivoDescritordeConfiguraçãoda Web. . . 38
ExportandoumArquivoJARdeMigração . . . . 38
ImportandooArquivoJARdeMigraçãoparaoIBM WebSphereStudioSiteDeveloper . . . 38
TestandooAplicativoMigradoemumServidorde Teste. . . 39
Capítulo7.Migrando do VisualAge paraJavaparao IBM WebSphere
StudioSite Developer . . . . . . . . 41
DiferençasentreVisualAgeparaJavaeIBM
WebSphereStudioSiteDeveloper . . . 41 MigrandodoVisualAgeparaJava. . . 42
ExportandoseusArquivosJavaeArquivosde RecursosdoProjetodoVisualAgeparaJava . . 42 IniciandooIBMWebSphereStudioSite
DevelopereCriandoNovosProjetosparaConter oCódigo . . . 43 ImportandoosArquivosJavaeArquivosde
RecursosparaoIBMWebSphereStudioSite
Developer. . . 43 UtilizandooEditorweb.xmlparaAssegurarque osServletsEstãoDefinidosCorretamente
(SomenteProjetodaWeb) . . . 43 MigrandoDefiniçõesdeProjetoeEspaçode
Trabalho . . . 44 ConfigurandooAmbientedeTestedo
WebSphereV4eTestandoo(s)Aplicativo(s)
Migrados(s) . . . 45 ImplementandoAplicativosdoIBMWebSphere StudioSiteDeveloperparaoWebSphere
ApplicationServerRemoto . . . 45 CompartilhandoasDefiniçõesdeProjetosdo IBMWebSphereStudioSiteDeveloperentre
VáriosDesenvolvedores(MigraçãoPosterior) . . 46 SuportedeEquipenoIBMWebSphereStudioSite Developer. . . 46
Capítulo8.Migrando do VisualAge paraJavaVisual CompositionEditor
parao VisualEditorpara Java . . . . 47
SalvandoMetadadosdeTempodeDesign
AprimoradodoVisualAgeparaJava. . . 47 ConcluindoaMigração(Importandoparao
WebSphereStudio). . . 48
Capítulo9.Configuração da
Compilação (Biblioteca,JARs,JARs Dependentes deProjeto, Compilações Ant) . . . . . . . . . . . . . . . . 49
JARsdaBibliotecaJavaeJARsExternosdeTerceiros 49
AManeiraRecomendadadeUtilizarumJARde TerceirosemumProjetodaWeb . . . 49 AManeiraRecomendadadeUtilizarumJARde TerceirosparaUsoemVáriosProjetosWeb. . . 49 AManeiraAlternativadeUtilizarArquivosJAR Externos(CompilaçãoGlobaleClasspathdo
Servidor) . . . 50 OtimizandoCompilaçõesdeVáriosProjetos
UtilizandoJARsDependentesdeProjeto . . . . 51 CompilaçõesdeProduçãoAutomatizadaUtilizando Ant . . . 51
Capítulo10. Exemplosde Migração . . 53
Exemplo:VisualAgeparaJavaJSP/Amostrade
Servlet(LeapYear) . . . 53 ExportandoArquivosdoVisualAgeparaJava. . 53 CriandoumNovoProjetoWebdoIBM
WebSphereStudioSiteDeveloper . . . 54 ImportandoosArquivosJavaedeRecursosdo ProjetoparaoProjetodoIBMWebSphereStudio SiteDeveloper . . . 54 DefinindoQualquerServleteFazendoQualquer AlteraçãodoAplicativoReestruturado . . . . 55 CriandoumProjetodoServidordoIBM
WebSphereStudioSiteDeveloper . . . 55 TestandooAplicativoLeapYearMigrado . . . 56 Exemplo:AplicativodaWebdoWebSphereStudio
″Classic″Versão4.0(YourCo)(Windows). . . 56 IniciandooWebSphereStudio″Classic″Versão 4.0eCriandoumaNovaEtapadeMigração . . 57 CriandoumArquivoDescritordeConfiguração daWeb. . . 57 CriandoumArquivodeMigração. . . 57 IniciandooIBMWebSphereStudioSite
DevelopereImportandooArquivoWAR . . . 57 CriandoumProjetodoServidordoIBM
WebSphereStudioSiteDeveloper . . . 58 TestandooAplicativoYourCoMigrado . . . . 58
Capítulo11. LeituraAdicional. . . . . 61
Avisos. . . . . . . . . . . . . . . 63
InformaçõessobreInterfacedeProgramação . . . 65 MarcasComerciaiseMarcasdeServiço . . . 65
Capítulo 1. Visão Geral do Guia de Migração do WebSphere Application Server - Express
Nesta versãodo IBM®WebSphere®ApplicationServer-Express Versão5.1,é possível migrarocódigoapartirdo:
v VisualAgeparaJava
v IBMWebSphereApplicationSingleServer EditionVersão 3.5 v IBMWebSphereApplicationServer-ExpressVersão 5.0,5.0.1,5.0.2 v WebSphereStudio ″Classic″
v IBMWebSphereStudioSiteDeveloper
v IBMWebSphereStudioSiteDeveloperVersão5 Beta,Disponibilidade AntecipadaouDisponibilidadeGeral
v IBMWebSphereStudioSiteDeveloperVersão5.0.1 v IBMWebSphereStudioSiteDeveloperVersão5.1
OWebSphereApplicationServer-Express 5.1éformadopeloWebSphere
ApplicationServer5.1epeloWebSphereStudioSiteDeveloper5.1.1.Esseprimeiro capítuloa seguir,aborda amigraçãodorecursodoservidor doWebSphere
ApplicationServer-Express. Orestante desseGuiadeMigraçãoédestinadoà migraçãodocódigodediferentesversõesdoWebSphereStudio SiteDeveloper.
Nota Importantea RespeitodaMigraçãodo Servidor:
Amigraçãodaconfiguraçãodo servidorapenasésignificativa, sevocê estiver administrandooservidor utilizandooAdministrativeConsole--normalmente,em um ambientedeprodução.Nesse modode operação,a configuraçãodoservidor e osaplicativosimplementados sãoarmazenadosnodiretóriodeconfiguraçãodo servidor. Oprocesso demigraçãomigraessesarquivosdeconfiguraçãoede aplicativo.Se,poroutrolado,vocêestiver utilizandooWebSphereStudio Site Developerparaconfigurareimplementaraplicativosnoservidorremoto,não há necessidadedemigrar osarquivosdeconfiguraçãodoservidor. Issoacontece porque osarquivosdeconfiguraçãoede aplicativosãotodosmantidosnoespaço de trabalhodoStudio SiteDeveloper.Oespaçodetrabalho serámigradopelo Studio SiteDeveloper.Emseguida,vocêpode definirumanovainstânciadeum servidor doWebSphereApplicationServer-Express 5.1econtinuara configuração e implementaçãodosaplicativosapartirdoStudioSite Developer.
Esteguiaestáorganizadonosseguintescapítulos:
v MigrandooServidordeProdução
v MigrandodoIBMWebSphereStudioSite DeveloperVersão5.1
v MigrandodoIBMWebSphereStudioSite DeveloperVersão5ou Versão5.0.1 v MigrandodoIBMWebSphereStudioSite DeveloperdaVersão 4.0.x
v Migrando doWebSphereStudio ″Classic″paraoIBM WebSphereStudio SiteDeveloper
v MigrandodoVisualAgeparaJavaparaoIBMWebSphereStudioSite Developer v MigrandodoVisualAgeparaJavaVisualCompositionEditorparaoVisual
EditorparaJava
v ConfiguraçãodaCompilação (BibliotecaJARs,JARsDependentesdeProjeto, CompilaçõesAnt)
v ExemplosdeMigração v LeituraAdicional
InformaçõessobrecomoutilizaroWebSphereApplicationServer-Expresspodem ser localizadasnoguiaIntroduçãoenaajudaon-line.LeiaoGuiade Instalaçãoantes de instalaroWebSphereApplicationServer-Express. Depoisdeinstalarcomêxito o WebSphereApplicationServer -Express,leiaoguiaIntroduçãoeexecuteos tutoriais deIntrodução.Ostutoriaisoapresentarão aoworkbench,ao
desenvolvimento Java™eaosserviços daWeb.Apósaconclusãodostutoriais, leia esteguiaparamigrarosrecursosdoaplicativoparaoWebSphereApplication Server -Express.
Esseguia estádisponívelnasversõesHTMLeAcrobatPDF, nodiretório/readme.
Ambasasversõescontêminformaçõesidênticas.Vocêpodeabriroarquivo migrate.html emqualquernavegadordaWeb.Paraabriroarquivomigrate.pdf, você deveterosoftwareAcrobatReaderinstalado,oqualpode sertransferidopor downloada partirdoendereçowww.adobe.com/products/acrobat/readstep2.html.
EsteGuiadeMigraçãoutilizaasconvençõesdoWindows® emtodoo processo.Por exemplo,o″WS_Installdir\″noWindows éequivalenteao″WS_Installdir/″no Linux.
Paraobter atualizaçõesfuturasdesteguia,consulte
www.ibm.com/websphere/developer/zones/studio/transition.html.
Capítulo 2. Migrando o Servidor de Produção
Migração
Migraçãoéumaatividadenaqual vocêsebeneficiademateriaisexistentes.As tarefase ferramentasdemigraçãoajudamnoupgradedo produtoedeseus pré-requisitos, nareutilizaçãodecomponentes doaplicativoexistentequando possível enatransferênciadeconfiguraçõesadministrativasde suaversãoanterior paraumaatual.
Amigraçãodeprodutosdo WebSphereApplicationServer érelativaaalavancaro ambiente eaplicativosexistentesealterá-losparaquesejamcompatíveiscoma versãodoprodutoatual.
Asfunçõesde migraçãodo produtosãofornecidaspelasferramentasdemigração noIBM WebSphereApplicationServer -Express,Versão5.1.Asferramentasde migraçãosuportamamigraçãodo:
v IBMWebSphereApplicationServer-ExpressVersão 5.0,5.0.1,5.0.2 v IBMWebSphereApplicationSingleServer EditionVersão3.5
OassistenteparainstalaçãodoprodutodetectaráversõesanterioresdoIBM WebSphereApplicationServer-Express eforneceráumaopçãoparaexecutaras ferramentas demigraçãoduranteainstalaçãodaVersão5.1.Paramigrar doIBM WebSphereApplicationServerVersão 3.5,énecessário executaressasferramentas diretamente.
Redbook deMigração
Migrating toWebSphereV5:AnEnd-to-End MigrationGuideestádisponívelapartir do Websitede Redbooksnoendereçohttp://www.ibm.com/redbooks.Para localizar oRedbook,procureonúmerododocumento SG24-6910-00.ORedbook forneceumacoberturamaiorqueesseartigo,incluindoinformações sobre
planejamentocomdetalhes adicionaisparamigraçãodeaplicativoe ferramentase amostrasdo WebSphereStudioApplicationDeveloper.
MigraçãodaVersão3.5:MovendoparaoModeloJ2EE
Os usuáriosdaV3.5.xfazendoupgradeparaV5estãomovendoparauma plataformaqueébaseadanasespecificaçõesJ2EE.AtecnologiaJ2EEsepara claramenteo desenvolvimentoea criaçãode aplicativosdaadministração, implementaçãoegerenciamentodoaplicativo.AmigraçãodaV3.5envolve alteraçõesnasestruturas,desenvolvimento eimplementaçãodeaplicativos.
Asferramentas demigraçãoajudamna transiçãodaVersão3.5.xparaa Versão5, atravésdamigraçãode configuraçõesdosistemaedacriaçãodeartefatos J2EE, incluindo omapeamento defunçõesdesegurançaJ2EE.Asferramentasde migraçãocriamaplicativoscorporativosJ2EEiniciaiscombasenasconfigurações daVersão3.5.x.Noentanto,devido àalteraçãosignificativaemestruturasde aplicativos, planejecuidadosamenteoteste eoajustedosaplicativosmigrados, utilizandoasferramentasde desenvolvimentoede implementação,para determinarexatamentecomoosaplicativosfuncionam nonovoambiente.
OmodeloJ2EEpermiteodesenvolvimentode aplicativosindependentemente do ambiente deimplementaçãofinal.Essa separaçãode tarefasimplificao processode promoverumaplicativo dodesenvolvimentoinicial atravésdaprodução,oude movimento deumaplicativode umservidorparaoutro.Aintençãoéalterar apenas osparâmetrosde implementaçãodeaplicativoenão ocódigodo aplicativo.
Migrando e Coexistindo
Antesdeiniciar, determinesevocê temumaversãoexistentedo WebSphere ApplicationServer instaladanamáquinaemqueplanejainstalaroprodutoVersão 5.1. Sevocêtiverumaversãoanterior, seránecessário planejarsepretendecopiara configuraçãoe aplicativosdaversãoanteriorparaaversãonova,queéamigração.
Amigraçãonãodesinstalaa versãoanterior. Orelease anterioraindaé funcional.
Sevocê executá-loaomesmotempo quea instalaçãodaVersão5.1, asduasversões serão coexistentes.Paraexecutarambasasversõesaomesmotempo,vocêprecisará configurarasportasdemodoqueelasnão entrememconflito.Observequea operaçãode migraçãoapenas migraasdefiniçõesdeportanoestadoem quese encontram,a fimdequeasdefiniçõessejamasmesmasemambasasversões.O WebSphereApplicationServer contémferramentas demigraçãoquefornecemtoda funcionalidadedemigração. Oassistenteparainstalaçãopodechamar as
ferramentas demigraçãoouvocêpode chamá-lasmanualmente maistarde.
Em resumo,a migraçãodoIBM WebSphereApplicationServer -ExpressV5.0.x paraV5.1érotinahabitual. Épossívelutilizaroinstaladorparamigrar eterum poucoou nenhumajuste demigraçãoposteriora serdesempenhado.Ouvocê pode utilizarasferramentasdemigraçãomanualmenteparasalvarosdados de configuraçãoV5.0.0, V5.0.1ouV5.0.2,desinstalara V5.0.0,V5.0.1ouV5.0.2, instalar a V5.1e utilizarasferramentasde migraçãonovamentepararestaurarosdadosde configuração.
Em resumo,a migraçãodoIBM WebSphereApplicationServer V3.5paraIBM WebSphereApplicationServer -Express V5.1envolve alteraçõessignificativasem estruturas,desenvolvimento eimplementaçãodeaplicativo.Asferramentasde migraçãoajudamnessatransiçãoatravésdamigraçãodeconfiguraçõesdosistema e dacriaçãodeartefatos J2EE,incluindoo mapeamentodedefiniçõesde segurança anterioresparafunçõesdesegurança J2EE.Essesmapeamentosde segurança permitemo acessoarecursosmigradosdurante atransição.Asferramentasde migraçãocriamaplicativoscorporativosJ2EEiniciaiscombasenasconfigurações daVersão3.5.x.Noentanto,devidoasalteraçõessignificativasnasestruturasdo aplicativo,teste eajustecomcuidadoosaplicativosmigradosutilizandoas ferramentas dedesenvolvimentoe deimplementação.
Amigraçãosalvaosarquivosa seguirnodiretóriobackup.
Paraa Versão3.5.x
v bin/setupCmdLine.sh(oubin/setupCmdLine.batparaplataformas Windows)
v classes(nãosalvas paraoiSeries) v hosts
v properties v servlets Paraa Versão5.0.x
v classes(nãosalvas paraoiSeries)
v config
v installableApps v installedApps v properties
Ferramentas de Migração
Essetópico apresentaasferramentas demigraçãoqueoWebSphereApplication Server fornece.Todasasferramentasde migraçãosãoenviadasparaodiretório /migrationnoCD-ROMdoproduto.Éimportanteutilizaressasferramentasparaa versãodoApplicationServer queestásendoinstalada.Elassãoalteradasotempo todo.AsferramentasnoCD-ROMdoprodutofornecema funçãonecessáriapara migraçãodeum releaseanteriordoApplicationServerparaorelease noCD-ROM do produto.AsqueseencontramnoCD-ROMcorrespondemaoprodutono CD-ROM.Sevocê utilizarasferramentas demigraçãode umreleaseanteriordo ApplicationServer,provavelmenteencontraráumproblema comamigração.
WASPreUpgrade.sh (eWASPreUpgrade.bat)
Salvaosdados deaplicativosedeconfiguraçãodeumainstalaçãoanterior do WebSphereApplicationServer paraumdiretóriodebackup.Oscript WASPostUpgraderestauraosdadosdeconfiguraçãodo diretórioparaa novainstalação.OinstaladorchamaoscriptWASPreUpgrade.shdurantea instalação,sevocê selecionara migração.Épossíveltambémutilizaro comandoparadesempenharumamigraçãomanual,apósinstalara nova versão.
WASPostUpgrade.sh(e WASPostUpgrade.bat)
Restaura osdadosde configuraçãodeumreleaseanterior.
WASPostUpgradelêosdadosdodiretóriodebackupondeoscript WASPreUpgradearmazenouosdados.Oinstaladorchamaoscript WASPostUpgrade.sh duranteainstalação,sevocê selecionara migração.É possíveltambém utilizaro comandoparadesempenharumamigração manual,apósinstalaranovaversão.
Comando WASPreUpgrade
OscriptWASPreUpgrade.sh(ouWASPreUpgrade.bat)é umaferramentademigração paramigraçãodaconfiguraçãoe deaplicativosde versõesoureleasesanteriores paraumApplicationServer-ExpressVersão 5.1.
Oarquivodecomandosestálocalizadonosubdiretório AppServer/bindaraizde instalaçãoapósa instalação.Eletambémestádisponíveldiretamenteapartirdo CD nosubdiretório migration.
Sintaxe
WASPreUpgrade backupDirectory currentWASDirectory [adminNodeName]
[-nameServiceHost host_name [-nameServicePort port_number ]]
[-traceString trace_spec [-traceFile file_name ]]
Parâmetros
Os primeirosdoisargumentossãonecessárioseposicionais.
Os argumentossuportados incluem:
backupDirectory
Nomeposicionalnecessáriododiretórionoquala ferramenta
WASPreUpgradearmazenaaconfiguraçãoeosarquivossalvosea partir do qualaferramentaWASPostUpgradelêaconfiguraçãoeosarquivos posteriormente.AferramentaWASPreUpgradecriaessediretório,seele ainda nãoexistir.
currentWASDirectory
Nomeposicionalnecessáriodaraizdeinstalaçãoparaa instalaçãoatual V3.5.xouV5.0.x.Essa versãopodeser WebSphereApplicationServer Standard Edition,V3.5.x,WebSphereApplicationServer -ExpressV5.0.x.
adminNodeName
Opcional, nomeposicionaldo nóquecontémoservidoradministrativo paraoprodutoatualmente instalado.Ovalor desseargumentodeve corresponderaonomedo nódeterminado naárvoredeTopologiasnaguia Topologydoconsoleadministrativoparaoprodutoatualmenteinstalado.A ferramentaWASPreUpgradechamaa ferramentaXMLConfigutilizando esseparâmetro.Esseparâmetroapenasénecessário noupgradedo WebSphereApplicationServerStandard Edition,Versão3.5.x.
-nameServiceHost-nameServicePort
Quando especificado,aferramentaWASPreUpgradetransmiteesses parâmetros opcionaisparaaferramentaXMLConfig.Utilizeesses parâmetros parasubstituir onomedo hosteonúmerodaportapadrão utilizadospelaferramentaXMLConfig.
-traceString-traceFile
Parâmetros opcionaisparareunirinformaçõesderastreioparaopessoalde ServiçoIBM.Determineumaespecificaçãode rastreio″*=all=enabled″
(comaspas)parareunirtodasasinformações derastreio.
Registro
AferramentaWASPostUpgradeexibeostatusparaatelaenquantoestásendo executada. Elatambémsalvaumconjuntode informaçõessobreregistromais amplo nodiretóriobackup.Vocêpode exibiroarquivoWASPreUpgrade.logcomum editordetexto.
Comando WASPostUpgrade
OscriptWASPostUpgrade.sh (ouWASPostUpgrade.bat)é umaferramentade migraçãoparamigraçãodaconfiguraçãoedeaplicativosdeversõesoureleases anterioresparaumApplicationServer -ExpressVersão5.1.
OarquivodecomandosestálocalizadonodiretórioAppServer/bindaraizde instalação.
AferramentaWASPostUpgradeinstalatodososaplicativosmigradosnodiretório AppServer/installedAppsparaa instalaçãodaVersão 5.1.Aferramentainclui aplicativosdodiretóriodebackupqueaferramentaWASPreUpgradecria.A ferramentaWASPreUpgradecopiaosaplicativosdodiretórioinstalledAppse outros diretóriosnaversãooureleaseanterior.
Sintaxe
WASPostUpgrade backupDirectory
[-serverName server_name]
[-webModuleAdditionalClasspath classpath]
[-documentRootLimit number]
[-substitute "key1=value1[;key2=value2;[...]]"]
[-portBlock port_starting_number]
[-backupConfig true | false]
[-replacePorts true | false]
[[-traceString trace_spec [-traceFile file_name]]
Parâmetros
Oprimeiroargumentoénecessário.Osargumentossuportadosincluem:
serverName
Nomedainstânciadoservidor opcional.Assumeo padrãoserver1.
backupDirectory
Nomenecessário dodiretórionoqualaferramentaWASPreUpgrade armazenaa configuraçãoeosarquivossalvosea partirdo quala
ferramentaWASPostUpgradelêaconfiguraçãoeosarquivos.Aferramenta WASPreUpgradecriaessediretório,seeleaindanão existir.
-backupConfig
Parâmetroopcionalutilizadoparafazerbackupdaconfiguraçãoexistente antesdaconfiguraçãoser alteradapelasferramentasde migração.O padrãoé true,parafazerbackupdaconfiguração.
-documentRootLimit
Parâmetroopcionalparaespecificaronúmerodearquivosqueoprograma copiadocampodocument-rootdoaplicativodaWeb.Eleéapenas
aplicável paraupgrades Versão3.5.x.Senãoforespecificado, opadrãoserá 300.
-portBlock
Parâmetroopcionalutilizadoparaespecificarovalor iniciala serutilizado nacriaçãodeportas.
-substitute
Argumentoopcionaltransmitidoparaa ferramentaXMLConfig.
Especifiqueosvaloresparaasvariáveisdesegurançaaseremsubstituídas (porexemplo,-substitute
″NODE_NAME=admin_node;APP_SERVER=default_server″).
Noarquivode dadosXMLdeentrada,cadachave aparececomo$key$
parasubstituição.Esseargumentosubstitui qualquerocorrência de
$NODE_NAME$ poradmin_nodee$APP_SERVER$pordefault_servernoarquivo XMLdeentrada.
Sea cadeiadesubstituiçãocontiverpontos-e-vírgulas,utilize$semiColon$
parasepará-lado delimitador″;″.EmplataformasUNIX,adicioneum caracterede escapea cadacifrão($) nacadeiadesubstituição(por exemplo,\$semiColon\$).
Esseparâmetroéaplicável paraconfiguraçõessalvas doAdvancedEdition, Versão 3.5.x.
-traceString-traceFile
Parâmetros opcionaisparareunirinformaçõesderastreioparaopessoalde ServiçoIBM.Determineumaespecificaçãode rastreio″*=all=enabled″ (comaspas)parareunirtodasasinformações derastreio.
-webModuleAdditionalClasspath
Parâmetroopcionalparaespecificarocaminho ouocaminhoeosnomes de arquivosde diretóriosouarquivosespecíficosquevocênãodesejaque sejamcopiadosnoarquivoWAR(Webarchive).Emvez disso,oprograma adiciona oscaminhosearquivosaoatributo(ibm-web-ext.xmi)
additionalClassPath deextensãode MódulodaWeb.Issoapenasé aplicável namigraçãode umainstalaçãodaVersão3.5.x.
Registro
AferramentaWASPostUpgradeexibeostatusparaatelaenquantoestásendo executada. Elatambémsalvaumconjuntode informaçõessobreregistromais amplo nodiretóriologs.Vocêpode exibiro arquivoWASPostUpgrade.logcomum editordetexto.
Mapeamento de Configuração durante a Migração
Essetópico descreveo queéalteradodurantea migração,quesempreenvolve umaúnicamáquina, comoporexemploumambientede desenvolvimentoemuma máquinaindependente.
MigraçãodaVersão3.5paraVersão5.x
Asferramentas demigraçãoajudamnatransiçãodaVersão3.5.xparaa Versão 5,atravésdamigraçãodeconfiguraçõesdosistemaedacriaçãode artefatos J2EE,incluindo omapeamentode funçõesdesegurançaJ2EE.As ferramentas demigraçãocriamaplicativoscorporativosJ2EEiniciaiscom base nasconfiguraçõesdaVersão3.5.x.Noentanto,devido àalteração significativaemestruturasde aplicativos,planejecuidadosamenteoteste e o ajustedosaplicativosmigrados,utilizandoasferramentas de
desenvolvimento edeimplementação,paradeterminarexatamentecomo osaplicativosfuncionam nonovoambiente.
Analiseo arquivoWASPostUpgrade.logparaobterinformaçõesdetalhadas sobreosbeanscorporativosmigrados.Omodelo deprogramaçãoJ2EE especificaumaarquiteturasobrecomoosaplicativossãocriadose implementados.Comoosaplicativosna Versão3.5.xnãotêm amesma arquitetura,a ferramentaWASPostUpgraderecriaosaplicativos.Elacria todososrecursoseosbeanscorporativosdaWebmigradosem aplicativos J2EE. ElamapeiatodososaplicativoscorporativosdainstalaçãodaVersão 3.5.x emaplicativosJ2EEcomomesmonome,implementados nomesmo servidor.
AferramentaWASPostUpgrademapeiarecursosdaWebqueestão
incluídosem umaplicativocorporativo,emum aplicativoJ2EEpadrãoque inclui onomedoservidor.AferramentamapeiaaplicativosdaWebpara arquivosWARJ2EE. Elacombinarecursosemum arquivoWARJ2EEeos implementanaconfiguraçãodaVersão5.
Mapeando DetalhesdaMigraçãodaV3.5.xparaaVersão5.x v datasources.xml
Vocêpodeutilizarumarquivodatasources.xmldaVersão3.5.xpara aumentarasdefiniçõesde configuraçãodo DataSource.AVersão3.5.x armazenao arquivonodiretórioproperties.Asferramentasde
migraçãomigramumarquivodatasources.xml existente,combinandoas propriedadesnoarquivona configuraçãodo datasourceedodriver JDBC.
v AplicativosCorporativos
Asentradas doaplicativocorporativoVersão3.5.x sãoopcionais,elassão mais freqüentementeutilizadasparaorganizarconjuntos deobjetos juntosparadefiniçõesdeSegurança. Obeancorporativoeaspartesde aplicativosdaWebdoaplicativocorporativoapontamparasuas respectivas entradasemoutraspartesdoarquivoxml.Cadaaplicativo corporativo éprocessadoparacriarumaplicativoJ2EEcomomesmo nome.Asentradasdobeancorporativoede aplicativosdaWebsão utilizadascomo ponteirosparaasdefiniçõesdebeanscorporativose de aplicativosdaWeb.Osdetalhes dessasentradassãoutilizados,em seguida,paraconstruirumaplicativoJ2EE.
Paraarquivosdo beancorporativo,a definiçãodearquivoJARé utilizadaparalocalizarosarquivosJARparareimplementareadicionar aoaplicativoJ2EE.Asentradasraiz dedocumentosde aplicativosda Web sãoutilizadasparalocalizarosrecursosutilizadosnoaplicativoda Web (HTML,páginasJSPe assimpordiante). Essesarquivossão
copiados paraoarquivoWAR dentrodo aplicativoJ2EE.Asentradasde classpath deaplicativosdaWebsãoutilizadasparalocalizarservletse arquivosJARcopiadosparaoarquivoWARnoaplicativoJ2EE.
Os aplicativoscorporativossãocriadosduranteamigraçãodaVersão 3.5.x.Esses sãocriadoscomoaplicativoscorporativoscompatíveiscom J2EE1.2econtêmosmódulos deníveldoServlet2.2eJSP1.1.Isso fornecea compatibilidadediretae permitea interoperabilidadecom versõesanterioresdoWebSphereApplicationServer.
v SegurançaJ2EE
Omodelode autorizaçãodesegurançanaversão3.5.xébaseadona noção deAplicativo CorporativoeGruposdeMétodos.Oproduto cruzadodo aplicativocorporativoeosgruposdemétodos representa umapermissãodoWebSphereApplicationServer.Aespecificação J2EE inclui ummodelode autorizaçãocombaseemfunções.
Paraconverterdo modelodepermissãodo WebSphereApplication Server naversão3.5.xparaafunçãocombasenomodelo deautorização na Versão5,asferramentasdemigraçãocriamumarelaçãoum paraum de umapermissãodo WebSphereApplicationServer paraumanova função desseaplicativo.Portanto,paracadaaplicativocorporativoe cadagrupo demétodosnaVersão3.5.x,asferramentasde migração criamumafunçãonaVersão5,contida nodescritordeimplementação de aplicativoJ2EE.Os assuntosautorizadosparacadafunçãoestão contidos emumatabeladeautorizaçãolocalizadanaligaçãode aplicativo J2EE.
Aespecificação J2EEinclui ummodelode autorizaçãocombaseem funções.OWebSphereApplicationServerinterpretaa funçãopara significar umconjuntodepermissõesde acessoaumrecurso.Nocaso de umachamadademétododobeancorporativo,apermissãodeacesso aométodoemumbeanespecíficoéespecificadapelapermissãoaum método. Essapermissãode métodoéassociada aumaoumais funções nodescritordeimplementaçãonoarquivoJARdobean.
Nocasodeacessoa recursosdaWeb,a permissãodeacessoa umaURI daWebede chamadaaummétodoHTTPnessaURIé especificadaem termosdecoletas derecursosdaWebelimitaçõesdesegurançana especificação J2EE.OdescritordeimplementaçãodoarquivoWARde aplicativosdaWebcontémaslimitaçõesdesegurança ecoletasde recursos daWeb.
v NíveisdeJSP
AVersão 5executaobjetosJSP1.0e1.1comoobjetosJSP1.2,queéo úniconívelsuportado.
v RedirecionadordeServlet
AVersão 5nãosuportaoRedirecionadorde Servletde versões anteriores.Asferramentasdemigraçãoignoramessesobjetos.
v AlteraçõesdeNomesdePacotesdo ServletduranteaMigraçãoda V3.5.xparaV5.x
SeaconfiguraçãodaVersão3.5.xdefiniroservletSimpleFileServlet,o servletnãoserámigrado.Asferramentasdemigraçãodefinemo atributoFileServingEnablednoarquivodemódulo da
Webibm-web-ext.xmicomotrue.
SeaconfiguraçãodaVersão3.5definiroservletInvokerServlet, oservlet nãoserámigrado.Asferramentasdemigraçãodefinemo atributo ServeServletsByClassnameEnablednoarquivodemódulodaWev ibm-web-ext.xmicomotrue.
SeaconfiguraçãodaVersão3.5.xdefiniroservletDefaultErrorReporter, oservletnãoserámigradonoarquivodemódulo daWebweb.xml.A migraçãoutilizaonovopacoteparadefiniro nomedaclasse.
v Transportes
Otipo detransportepadrão doServletEnginenaVersão3.5.x éOSE (OpenServletEngine).Comoa Versão5não maissuportaotransporte OSE,asferramentasdemigraçãomapeiamessestransportespara transportesHTTP,utilizandoasmesmasatribuiçõesdeporta. Vocêdeve adicionarmanualmenteasentradasdoaliasVirtualHostparacadaporta.
Migrando Dados de Configuração Manualmente
Você podemigrarasconfiguraçõesadministrativascomo assistenteparainstalação ou manualmente,comoessatarefadescreve.Sedecidirmigrarmanualmente,não selecione acaixadeopçõesmigration nopainelinstallationwizardmigration.
Sevocê utilizarumaversãoanteriordoWebSphereApplicationServer, o
administrador dosistemapodeterváriosaplicativosbemajustadosedefiniçõesdo servidor paraseuambiente.Éimportanteterumaestratégiaparamigraçãodessas definições comomáximodeeficiênciaeomínimode perda.
É possíveldesempenharváriasvezesa migraçãomanual incrementalpelachamada dasferramentas demigração,todavezqueespecificarumarquivode configuração diferente.Hádiversosmotivosparaaexistênciademúltiplosarquivosde
configuração.Sejaqualforo motivo,amigraçãodeumarquivodeconfiguração por vezpermitequeaplicativossejamtestadosincrementalmente, antesde continuarcomo próximoarquivodeconfiguração.
Antesdeutilizarasferramentasde migração,consulteodocumento Notassobreo ReleaseV5.xparaentenderquaiscorreçõessãonecessáriasaplicarem versões anteriores.Aaplicaçãodecorreçõesemumaversãoanteriortambémpode aplicar correçõesem arquivosquetêmumafunçãonamigração.Apliquequaisquer correçõesparagarantira migraçãomais eficientedeconfiguraçõeseaplicativos possíveis.
Amigraçãomanualforneceumaabordagemde migraçãomais incrementaldoque a migraçãocompletafornecidapeloassistenteparainstalação.AIBMforneceum conjuntode ferramentasdemigraçãoparamigrarconfiguraçõesadministrativas paraoprodutoWebSphereApplicationServer -Expressdequalquerediçãoda
V3.5.xou V5.0.x.Oprocessode migraçãototalserveparafazerbackupda configuraçãoatual edearquivosnecessárioscoma ferramentademigração WASPreUpgrade, desinstalaroreleaseanterior, instalaroprodutoVersão 5sem selecionar aopção demigraçãoautomáticaerestaurara configuraçãodo release anteriorcomaferramentade migraçãoWASPostUpgrade.
Selecionequalquerumdessescenáriosde migração,paraobterinformaçõessobre como migrardadosdeconfiguraçãoparaumnóde basedoWebSphere
ApplicationServer:
v “MigrandodaV3.5.xparaaV5.1”
v “Migrandoa V3.5.xparaumaMáquinaV5.1Remota” napágina13 v “MigrandodaV5.0.xparaaV5.1”napágina 15
v “MigrandodaMáquinaV5.0.xparaumaMáquinaV5.1Remota” napágina15 v “Migrandode umSistemaOperacionalNão-Suportado”na página17
Migrando da V3.5.x para a V5.1
É possívelutilizarasferramentas demigraçãoparamigrardados deconfiguração daVersão3.5doWebSphereApplicationServerparaa Versão5.1doWebSphere ApplicationServer-Express.
Normalmente, vocêutilizariaasferramentasdemigraçãoWASPreUpgradee WASPostUpgrade daV5.1doWebSphereApplicationServerparafazerupgradeda V3.5paraaV5.1namesmamáquina. Seocenárioincluir amigraçãodeuma configuraçãodaV3.5em umamáquinaparaoWebSphereApplicationServer- Express V5.1em outramáquina,utilizeoprocedimento alternativodescritoem
“Migrandoa V3.5.xparaumaMáquinaV5.1Remota” napágina13.
Essetópico descreveo usodeferramentas demigraçãoV5.1aseremmigradas:
v WebSphereApplicationServer SingleServer Edition,V3.5
AferramentaWASPreUpgradesalvaaconfiguraçãodaV3.5existente emum diretóriode migration-specific-backup.AferramentaWASPostUpgradeutilizaesse diretórioparaadicionarasdefiniçõesdeconfiguraçãoantigasaonovoambiente V5.1.
Etapas paraEstaTarefa
1. ObtenhaoCD-ROMdo produtoV5.1.
Nesse CDencontra-seodiretóriomigration/bin.Essediretóriocontémum ambienteespecialquevocê podeutilizarparaexecutaraferramenta WASPreUpgradeseminstalaraV5.1.
2. Salvea configuraçãoatualutilizandooscriptWASPreUpgradedodiretório /migration/bindoCD-ROMdo produtoV5.1.
Salvea configuraçãonodiretóriomigration-specific-backup:
WASPreUpgrade /usr/tmp/migration-specific-backup /usr/websphere/appserver yourNodeName Verifique seoservidor administrativodo ambienteexistenteestásendo
executado.AferramentaWASPreUpgradeforneceostatusparaatelaepara arquivosdolognodiretóriomigration-specific-backup.Osnomesde
arquivosdelogsASCIIcomeçamcomaferramentaWASPreUpgradedetextoe incluem umadataehora.
AferramentaWASPreUpgradesalva todososarquivosdosdiretóriosa seguir naconfiguraçãoV3.5.xexistente nodiretóriode backup:
Paraa Versão3.5.x v bin v classes v hosts v properties v servlets
AferramentaWASPreUpgradesalva osarquivosselecionadosdodiretório/bin V3.5.x.Elatambémexportaa configuraçãodoApplicationServer existentedo repositórioV3.5.x.EssaferramentachamaaXMLConfig paraexportaro repositórioV3.5existenteparaoarquivowebsphere_backup.xmlnodiretório migration-specific-backup.
Seocorremerrosdurante aexecuçãodaferramentaWASPreUpgrade,podeser precisoaplicar correçõesàinstalaçãodaV3.5paraconcluircomêxitoaetapa deexportação. Consultea páginaIBMSupportparaobterascorreçõesmais recentespossíveisde seremaplicadas.Naexibiçãodessasinformaçõesdo InfoCenter,cliqueemSupportparaefetuarolinkcoma páginaIBM Support.
3. Instalea V5.1doprodutoWebSphereApplicationServer-Express Version.
Nãoselecionea opçãode migração,seelaaparecer.
ApóscadausodaferramentaWASPostUpgrade,verifiqueasdefiniçõesde porta daV5em doisarquivos:
v Verifique aatribuiçãodaporta BOOTSTRAP_ADDRESSparaserver1noarquivo serverindex.xml
Sea portaBOOTSTRAP_ADDRESSdaversãoanteriorfor900,amigração mapeiaissopara7809.Seaporta BOOTSTRAP_ADDRESSdaversãoanterior não for900,amigraçãomapeiaovalorparaserver1em umamigração Advanced Editionou paraonomedoservidor realem umamigração Advanced SingleServer Edition.
v Verifique asatribuiçõesdaporta HTTPTransportno arquivoserver.xml OprocessamentodeWASPostUpgrade adicionaasportasHTTPTransportda versãoanteriornoarquivoserver.xmldaVersão5. Issosignificaqueo server1 contématribuiçõesduplicadasdaportaHTTPTransport,apartirdo painelde coexistênciae daversãoanteriordo ServidorPadrão.
4. Migreaconfiguraçãoanteriorparaanovainstalaçãocomaferramenta
WASPostUpgradenodiretórioAppServer/bindo diretórioraiz deinstalaçãoda V5.1.
AferramentaWASPostUpgrademigraasinformaçõesde configuraçãoda V3.5.xcriadaspelaferramentaWASPreUpgradeparaainstalaçãodaV5.1.
ComooprodutoV5.1adereaomodelode programaçãoJ2EEeoproduto V3.5.xnãoadere, asalteraçõessignificativassãonecessáriasparaaplicaçãoda configuraçãodaV3.5.xemumainstalaçãodaV5.1.
AferramentaWASPostUpgradenãomigraAmostrasouoaplicativo deconsole administrativo, poisjáháAmostraseumaplicativo doconsoleadministrativo naV5.1.
AferramentaWASPostUpgraderegistrainformaçõesdetalhadas emcadabean corporativoimplementado,noarquivoWASPostUpgrade.log.
5. Pareo servidoradministrativodaversãoanteriorseeleestiversendo executado,antesdeexecutaronódaVersão5.
6. AconfiguraçãodoWebSphereApplicationServerapósa migraçãoéumaforma deverificar osresultadosdasferramentasdemigração. Épossíveltambém utilizaromapeamento deConfiguraçãodurantea migração,paraverificaros resultadosdamigração. Otópico possuiumadescriçãodetalhadadecomo as ferramentasde migraçãomigramobjetoseo quevocê deveverificar.
Migrando a V3.5.x para uma Máquina V5.1 Remota
Você podeutilizarasferramentasdemigraçãoparadesempenharumamigração manual entreduasmáquinas.
Normalmente, vocêutilizariaasferramentasdemigraçãoWASPreUpgradee WASPostUpgrade daV5.1doWebSphereApplicationServer-Expressparafazer upgradedaV3.5paraa V5.1na mesmamáquina.
Noentanto,háalgunscenáriosondevocê devemigrar aconfiguraçãodaV3.5em umamáquinaparaaV5.1emumamáquinadiferente.Umdessescenáriosé a instalaçãode novasmáquinasnoambientedaV5.1maisrecente,mas há necessidadedemigrar aconfiguraçãodaV3.5existenteem outrasmáquinas.
Essetópico descreveo usodeferramentas demigraçãoV5.1aseremmigradas:
v WebSphereApplicationServer SingleServer Edition,V3.5
AferramentaWASPreUpgradesalvaaconfiguraçãodaV3.5existente emum diretóriode migration-specific-backup.AferramentaWASPostUpgradeutilizaesse diretórioparaadicionarasdefiniçõesdeconfiguraçãoantigasaonovoambiente V5.1.
Etapas paraEstaTarefa
1. ObtenhaoCD-ROMdo produtoV5.1.
Nesse CDencontra-seodiretóriomigration/bin.Essediretóriocontémum ambienteespecialquevocê podeutilizarparaexecutaraferramenta WASPreUpgradeseminstalaraV5.1.
2. Salvea configuraçãoatualutilizandooscriptWASPreUpgradedodiretório /migration/bindoCD-ROMdo produtoV5.1,quedeveser montadana máquinaV3.5.
Salvea configuraçãonodiretóriomigration-specific-backup namáquinaV3.5.
WASPreUpgrade /opt/tmp/migration-specific-backup /opt/websphere/appserver adminNodeName Verifique seoservidor administrativodo ambienteexistenteestásendo
executado.
AferramentaWASPreUpgradeforneceostatusparaa telae paraarquivosdo lognodiretório/migration-specific-backup.Osnomesdearquivosdelogs ASCIIcomeçamcomaferramentaWASPreUpgradedetextoeincluem uma dataehora.
AferramentaWASPreUpgradesalva osarquivosselecionadosdodiretório/bin V3.5.x.Elatambémexportaa configuraçãodoApplicationServerexistente do repositórioV3.5.x.EssaferramentachamaaXMLConfig paraexportar o repositórioV3.5existenteparaoarquivowebsphere_backup.xmlnodiretório migration-specific-backup.
Seocorremerrosdurante aexecuçãodaferramentaWASPreUpgrade,podeser precisoaplicar correçõesàinstalaçãodaV3.5paraconcluircomêxitoaetapa deexportação. Consultea páginaIBMSupportparaobterascorreçõesmais recentespossíveisde seremaplicadas.Naexibiçãodessasinformaçõesdo InfoCenter,cliqueemSupportparaefetuarolinkcoma páginaIBM Support.
3. Copieo diretório/migration-specific-backupdamáquinaV3.5paraa máquinaV5.1.
Utilizeo ftp,oarmazenamentocompartilhadooualgumoutromecanismo para copiaroarquivoparaa novamáquina.
Desempenheasetapas aseguirnamáquinacomaV5.1doWebSphere ApplicationServer-Express..
4. Copieo arquivo/migration-specific-backup/websphere_backup.xmlou /migration-specific-backup/config/server-cfg.xmle armazene-oem um localdesuaescolha,parapreservaracópiacomoumarchive.
Vocêestácopiandooarquivoporque oarquivooriginalseráeditadona próximaetapa.
5. Editeoarquivo/migration-specific-backup/websphere_backup.xmlou
/migration-specific-backup/config/server-cfg.xmlparacorrigirasdefinições dependentesdemáquinascorretas.
Façaessasalteraçõesnoarquivo:
a. Altereo nomedonó noarquivo/migration-specific-
backup/websphere_backup.xml.Nãohánenhumnome denónoarquivo /migration-specific-backup/config/server-cfg.xml.
Sevocêestiver utilizandoomesmonomedonóparaa máquinaV5.1 utilizadaparaa configuraçãodaV3.5original,nãoaltereonome.Do contrário,vocêdeve alterartodasasocorrênciasdonome donódaV3.5 paraonomedonósendoutilizadoparaoWebSphereApplicationServer V5.1.Onomedonóocorreemmuitas sub-rotinasXMLportodooarquivo.
Afalhanaalteraçãode todasasocorrênciasresultaemumamigração incompletadedados.
b. Altereosnomesdecaminhosnoarquivo/migration-specific- backup/websphere_backup.xmlou/migration-specific-
backup/config/server-cfg.xml.
Oarquivodeconfiguraçãorefere-se anomesdecaminhosemmuitas sub-rotinasXMLportodooarquivo.Atualizequalquerreferênciaa um arquivoforadaestruturadediretóriosV3.5paraodiretórioequivalentena novamáquina,mesmosefornecessáriocriarum diretórioequivalente.A implicaçãodeconfiguraçãodeumambiente correspondentesignificaque podeser precisocopiarodiretóriooriginalparaa máquinaV5.1.Oupode serpreciso instalarosoftwareapropriado.
c. Corrijaosestilosdeespecificaçãodosnomesdecaminhosquesão dependentesnosistemaoperacional.
Énecessáriocorrigirasespecificaçõesde caminho,seelasdiferirem daquelasquefuncionamnamáquinaqueestáexecutando aV5.1.Por exemplo,sevocêestiver mudandodaV3.5emumaplataformaWindows paraaV5.1emumaplataformaLinux,alterequalquercaminhoespecífico doWindows noarquivodeconfiguração,parautilizaroestilodecaminho doLinux.Mude de″c:\mystuff\somepath″para″/opt/mystuff/somepath″.
d. AltereosIDsdeusuáriosesenhasparacorresponderemaos requisitosde segurança.
Podeser precisoalterarosIDsdeusuáriosesenhas,seelesnãoforem idênticosàquelesemusona máquinaV5.1.
Paraalterarumasenhacodificadaparaumasenhade textolimpo,mude
<password>{xor}LCoxayht</password>para
<password>mypassword</password>.
e. Altereoutras informaçõesespecíficasdamáquina.
Aconfiguraçãopodesereferir aoutrosprodutos ouconfiguraçõesde softwarequenãoexistemnanovamáquina.Porexemplo,amáquinaantiga podeterumbanco dedados.Possivelmente,a configuraçãodaV5.1ainda deveapontarparaobanco dedadosnamáquinaantiga.Modifiqueo datasourceparaapontarparaobanco dedadosnamáquinaV3.5.
6. Instalea V5.1doWebSphereApplicationServersemselecionara opçãode migração.
7. Adicionea configuraçãodaV3.5àconfiguraçãodaV5.1.
Utilizea ferramentaWASPostUpgradenodiretórioAppServer/bindodiretório raizde instalaçãodaV5.1,paraadicionar aconfiguraçãodaV3.5à
configuraçãodaV5.1.
WASPostUpgrade /opt/tmp/migration-specific-backup
AferramentaWASPostUpgraderegistrainformaçõesdetalhadasespecíficas a cadabeancorporativo implementado,noarquivo/migration-specific- backup/WASPostUpgrade.log.
Migrando da V5.0.x para a V5.1
Você podeutilizaroprogramade instalaçãodaV5.1paramigrar doWebSphere ApplicationServer-Express V5.0.xparaV5.1.
Etapas paraestatarefa:
1. PareoApplicationServerV5.0.x.
Utilizeo scriptstopServer.sh(oustopServer.bat)do diretórioAppServer/binda raizde instalação:
stopServer.sh server1
Vocêpode migrarumnódaV5.0.xsempará-lo.Noentanto,nãoénecessário executaronóparamigrarsuaconfiguração.Asferramentasde migração podemrecuperartodososdadosde configuraçãoenquantoonóestáparado.E alémdisso,é necessáriopararonóantesde iniciaronódaV5.1queestásendo instalado.Portanto,vocêpode pararo nóagora.
2. InstaleoprodutoV5.1.
Selecioneaopção demigração,quandoelaaparecer.
3. Verifique ainstalaçãodoApplicationServer V5.1.
Utilizea ferramentaFirstStepsquandoelaaparecernofinaldainstalaçãodo produtoouexecutevocê mesmootestede verificaçãodeinstalação,sea ferramentaFirstStepsnãoaparecerporalgummotivo.
Você podedesinstalaroservidor V5.0.xparasuacomodidade.
Migrando da Máquina V5.0.x para uma Máquina V5.1 Remota
Você podeutilizarasferramentasdemigraçãoparamigrarentreduasmáquinas.
AntesdeComeçar
Normalmente, vocêutilizariaasferramentasdemigraçãoWASPreUpgradee WASPostUpgrade daV5.1doWebSphereApplicationServerparafazerupgradeda V5.0.xparaa V5.1namesmamáquina.
Noentanto,háalgunscenáriosondevocê devemigraraconfiguraçãodaV5.0.x em umamáquinaparaa V5.1emumamáquinadiferente.Umdessescenárioséa instalaçãode novasmáquinasnoambientedaV5.1maisrecente, mashá
necessidadedemigrar aconfiguraçãodaV5.0.xexistenteemoutrasmáquinas.
Essa tarefadescrevecomoutilizarasferramentasde migraçãodaV5.1para desempenhara migração.
AferramentaWASPreUpgradesalvaaconfiguraçãodaV5.0.xexistenteem um diretóriode migration-specific-backup.AferramentaWASPostUpgradeutilizaesse diretórioparaadicionarasdefiniçõesde configuraçãoantigasaonovoambiente V5.1.
Etapas paraEstaTarefa
1. ObtenhaoCD-ROMdo produtoV5.1.
Nesse CDencontra-seodiretóriomigration/bin.Essediretóriocontémum ambienteespecialquevocê podeutilizarparaexecutara ferramenta WASPreUpgradeseminstalaraV5.1.
2. Salvea configuraçãoatualutilizandooscriptWASPreUpgradedodiretório /migration/bindoCD-ROMdo produtoV5.1,quedeveser montadana máquinaV5.0.x.
Salvea configuraçãonodiretóriomigration-specific-backup namáquina V5.0.x.
WASPreUpgrade /opt/tmp/migration-specific-backup /opt/websphere/appserver AferramentaWASPreUpgradeforneceostatusparaa telaeparaarquivosdo lognodiretório/migration-specific-backup.Osnomesdearquivosdelogs ASCIIcomeçamcomaferramenta″WASPreUpgrade″detextoeincluem uma dataehora.
3. Copieo diretório/migration-specific-backupdamáquinaV5.0.xparaa máquinaV5.1.
Utilizeo ftp,oarmazenamentocompartilhadooualgumoutromecanismo para copiaroarquivoparaa novamáquina.
4. Instalea V5.1doWebSphereApplicationServersemselecionara opçãode migração.
5. Adicionea configuraçãodaV5.0.xà configuraçãodaV5.1.
Utilizea ferramentaWASPostUpgradenodiretórioAppServer/bindodiretório raizde instalaçãodaV5.1,paraadicionar aconfiguraçãodaV5.0.xà
configuraçãodaV5.1.
WASPostUpgrade /opt/tmp/migration-specific-backup
AferramentaWASPostUpgraderegistrainformaçõesdetalhadas específicasa cadabeancorporativoimplementado,noarquivo/migration-specific- backup/WASPostUpgrade.log.
6. Modifiqueaconfiguraçãoutilizandoasinterfacesdeadministraçãodo WebSphereApplicationServer5.1.
Façaestasalterações:
a. AltereosIDsdeusuáriosesenhasparacorresponderemaos requisitosde segurança.
Podeser precisoalterarosIDsdeusuáriosesenhas,seelesnãoforem idênticosàquelesemusona máquinaV5.0.x.
b. Altereoutras informaçõesespecíficasdamáquina.
Aconfiguraçãopodesereferir aoutrosprodutos ouconfiguraçõesde softwarequenãoexistemnanovamáquina.Porexemplo,amáquinaantiga podeterumbanco dedados.Modifiqueodatasourceparaapontarparao bancodedados namáquinaantiga.
7. Vocêpode desinstalaroservidorV5.0.xparasuacomodidade.
Migrando de um Sistema Operacional Não-Suportado
Você podemigrarumaversãoanteriordorelease doWebSphereApplicationServer Versão 3.5.xouVersão5.0.xqueestásendoexecutadaemum sistemaoperacional queaVersão 5.1não suporta.
Etapas paraEstaTarefa
1. Inicieo WebSphereApplicationServer Versão3.5.xouVersão5.0.x AdministrativeServer.
2. Executeaferramentade migraçãodalinhade comandosWASPreUpgrade.
Háduasopções.Vocêpode executarocomandododiretóriomigration\bin(ou migration/bin)noplatform_root doCD-ROMVersão5.1. Ou,pode copiaros arquivosnodiretóriodoCD-ROMparaumdiretóriocriadonaunidadede discorígido.
Identifiqueorelease Versão3.5.xou5.0.x eidentifiqueumdiretóriodebackup ondeocomandoarmazenaarquivosdeconfiguraçãoeaplicativosdemigração daversãoanterior.Consulte otópicoWASPreUpgradeparaobtera sintaxede comando.
a. Executeocomandoa partirdo diretóriomigration\bin (oumigration/bin) noplatform_rootdoCD-ROMVersão 5.1.
Identifiqueodiretóriodebackupeolocaldosarquivosdeconfiguração.
Unidade_de_CD:\WASPreUpgrade backupDirectory filepath\WebSphere\AppServer yourNodeName Seissofuncionar,váparaa Etapa4.Senãofuncionarporalgum motivo,
desempenheasetapas 2Bà 2F.
b. Crieumdiretóriomigrationem suaunidadede discorígido.
c. CopieosarquivosWASPreUpgrade.bat(ouWASPreUpgrade.sh)e
setupCmdLine.bat(ousetupCmdLine.sh)dodiretóriomigration\bin\(ou migration/bin/)noplatform_rootdoCD-ROMVersão5.1, paraodiretório criadoemsuaunidadedediscorígido.
d. EditeoarquivosetupCmdLine.bat(ousetupCmdLine.sh)nonovodiretório.
Altereasseguintes variáveis:
v WAS_HOMEparaapontarparaocaminho completodo diretóriode migraçãocriado
v JAVA_HOMEparaapontarparaocaminhocompletododiretórioIBM DeveloperKitouJava
e. Assegurequeobitexecutávelestejaativadoparaosarquivos setupCmdLine.sheWASPreUpgrade.shnodiretóriomigration/binno UNIX-based_platform_rootdo CD-ROMVersão5.1,sevocêestiver fazendo backupdeumainstalaçãocombase noUNIX.
f. Executeo comandoa partirdodiretóriomigration criado.
Identifiqueodiretóriodebackupeolocaldosarquivosdeconfiguração.
yourMigrationDirectory\WASPreUpgrade backupDirectory filepath\WebSphere\AppServer yourNodeName 3. Encerre oWebSphereApplicationServer Versão3.5.xouVersão 5.0.x.
4. Compactecomo comandotarouzipodiretóriode backupeenvie-oporFTP paraoutrosistema.
5. Instaleonovosistemaoperacional,mantendoomesmonome dohost.
Sepossível,mantenhao mesmonomedosistemaesenhasdosistemaantigo.
Coloquetodososarquivosdobanco dedadosrelacionadosaaplicativosque estãosendomigrados,nomesmocaminho queosistemaanterior.Em geral, tentemanterosmesmoscaminhos. Noentanto,nãoinstale aVersão5.1no mesmodiretórioqueaversãoanterior.Sevocênão alteraroscaminhose nomes, poderáeditarosarquivosdeconfiguraçãoXMLpararefletir as
alterações. FaçataisalteraçõesantesdeexecutarocomandoWASPostUpgrade a seguir.
6. EnvieporFTPodiretóriode backupdo outrosistemaedescompacte-o.
7. InstaleoWebSphereApplicationServer-Express,Versão5.1. Nãoselecionea opção demigração,seelaaparecer.
8. Executeaferramentade migraçãodalinhade comandosWASPostUpgrade,a partirdodiretóriobindaraiz_de_instalaçãodaVersão5.1.
Especifiqueodiretóriodebackup(equalquernomedearquivodeconfiguração quenãosejapadrãonodiretório)criadopelocomandoWASPreUpgrade.
Consulteo tópicoWASPostUpgradeparaobter asintaxedecomandocorreta.
install_root\bin\WASPostUpgrade WAS_HOME\migration
Capítulo 3. Migrando do IBM WebSphere Studio Site Developer Versão 5.1
Estecapítulocobreosseguintestópicosdemigração:
v MigrandoProjetosJ2EEparaUtilizar oSuportedoServer Targeting v Ageração doassistenterequerumpacoteJava paraJDK1.4
Migrando Projetos J2EE para Utilizar o Suporte do Server Targeting
NoIBMWebSphereStudioSite DeveloperVersão5.1.1,há umanovafunçãoServer Targetingadicionada.Porpadrão,essafunçãoestádesativada,vocêprecisaativá-la na páginaPreferencesdoJ2EEselecionandoWindow >Preferences>J2EE.
Detalhesfuncionaissobrea funçãoServerTargetingpodemserlocalizadosna documentaçãodoprodutoIBM WebSphereStudio SiteDeveloper.Quandoa funçãoestiver ativada,vocêterá aopçãode atingirumdeterminadoservidor de aplicativos. Esserecursofoiimplementadoparasuportaro JDK1.4,queéoJRE paraoWebSphereApplicationServerVersão 5.1fornecido comoIBMWebSphere Studio SiteDeveloperVersão5.1.1.OsprojetosEJBquesebeneficiam dosuporte Server Targetingnãotêmcompatibilidadereversacomasversõesanterioresdo IBM WebSphereStudio SiteDeveloper,porisso,nãopodemser compartilhadoscom usuáriosquetrabalhamem versõesanterioresdoIBM WebSphereStudio Site Developer(porexemplo,IBMWebSphereStudioSite DeveloperVersão5.1,IBM WebSphereStudioSite DeveloperVersão5.0.1).OIBM WebSphereStudio Site Developerofereceumamaneiradeobter compatibilidadereversacomesserecurso ativadoe édescritoem “CompatibilidadeReversacomoSuporteAtivadodo Server Targeting”napágina 19.Omotivodessa incompatibilidadeéqueafunção do ServerTargetingalteraoarquivo.classpathemumprojetodoJ2EEeasnovas entradas doarquivo.classpathnãopodemserreconhecidas porversõesanteriores do WebSphereApplicationServer -Express.
Compatibilidade Reversa com o Suporte Ativado do Server Targeting
Como suporteativadodoServer Targeting,osprojetosJ2EEcomservidores alcançados podemserrevertidosparanãoutilizaremo suportedoServer Targeting, modificandooservidor dedestinoparaumaopção Notargetserver specified disponívelnodiálogoModifyTargetServer.OdiálogoModifyTarget Server éativadoapartirdomenupop-up (TargetServer>Modify)emumprojeto J2EEnaexibição ResourceNavigatorouJ2EEPerspective.Oservidordedestino também podeser modificadoparaumservidor Semdestinoespecificadonapágina de propriedadesdo J2EE(Properties>J2EE)paraprojetosEAR,EJB,Application Cliente Connector.ParaumprojetodaWeb,a definiçãodoservidorde destino encontra-se napáginadepropriedadesdaWeb(Properties>WEB).Detalhes funcionaissobreafunçãode modificaçãode DestinodoServidorpodemser localizadosna documentaçãodo IBMWebSphereStudioSiteDeveloper.Quandoa opção Notargetserverspecified éutilizada,oarquivo.classpathérevertidopara o estilocompatívelcom asversõesanterioresdoIBMWebSphereStudioSite Developere o.serveré removidodoprojeto.
Nota: SomenteprojetosdoJ2EEdoServer Targetedpodemserimplementados no WebSphereApplicationServer Versão5.1eexplorarosuportedo JDK1.4.
A Geração do Assistente Requer um Pacote Java para JDK 1.4
Devidoa umaalteraçãonoJDK1.4, ousuáriodeveespecificarumpacote Java quandoutilizarosassistentesparaPáginasdaWebdoBancode Dadose doJava Beanparagerarpáginasparaa seremexecutadasnoIBMWebSphereStudioSite DeveloperVersão 5.1.1.Esseproblema ocorrerá,seogabaritoViewBeanfor utilizado paraoassistenteparaPáginasdaWebdoJavaBeanouparaoPadrãode DetalhesPrincipaisdo JavaBeansdoIBMDatabaseAccess.Issoseaplicaa
projetosquecontêmpáginase arquivos.javaanteriormentegeradoscomesses assistentesquenãoespecificaramumpacote duranteacriação. Paraocódigoque foianteriormentegerado,movaosarquivos.javaparaumpacote.Emseguida, atualize osarquivos.jsp,atualize asinstruções deimportaçãoe asinformações sobreclasses.Noarquivoweb.xmldoprojeto,atualizea entradaservlet-class.
Capítulo 4. Migrando do IBM WebSphere Studio Site Developer Versão 5 ou Versão 5.0.1
Estecapítulocobreosseguintestópicosdemigração:
v WSWB(WebSphereStudio Workbench)naVersão5, naVersão5.0.1enaVersão 5.1
v UtilizandooEspaçodeTrabalho doWebSphereStudio Versão5.1.1coma Versão 5.0
v MigrandoProjetosJavadaVersão5ou daVersão5.0.1
v CompartilhandoProjetosentrea Versão5ou Versão5.0.1eaVersão 5.1 UtilizandoumSistema SCM(Source CodeManagement)
v MigrandoProjetosdaWeb
v ConvertendoProjetosdaWebparaStruts1.1
v FunçãodeMigraçãoAdicionadaà Migraçãode ProjetosJ2EE v AlteraçõesnasFerramentasde ServiçosdaWeb
v AlteraçõesFeitasnasFerramentasdeCriaçãodePerfil
v Problemasde CompatibilidadeConhecidosdoAssistentedeGabarito
WebSphere Studio Workbench na Versão 5, na Versão 5.0.1 e na Versão 5.1
OIBM WebSphereStudioSite DeveloperVersão5.1.1ébaseadononovoWSWB (WebSphereStudioWorkbench) 2.1.2combasenoEclipse.Háalgumasdiferenças entreasversões2.1.2e2.0.3ou 2.0.2.Paraobterumainformaçãodetalhadasobre asdiferenças, consulteoarquivoleia-melocalizadonodiretório
WS_Installdir\eclipse\readme(emqueWS_Installdiréo caminhoondevocê instalou oIBMWebSphereStudioSiteDeveloper.
OIBM WebSphereStudioSite DeveloperVersão5.0foibaseadonoWSWB2.0.2 combase noEclipseeoIBMWebSphereStudioSiteDeveloperVersão 5.0.1foi baseadonoWSWB2.0.3combasenoEclipse.Nãohádiferençassignificativasentre o 2.0.2e o2.0.3.Orelease doIBMWebSphereStudioSiteDeveloperVersão 5.0.1 eraumfixpack doGerenciadordeAtualizaçãoinstaladona partesuperiordoIBM WebSphereStudioSite DeveloperVersão5.0.
Utilizando o Espaço de Trabalho do IBM WebSphere Studio Site Developer Versão 5.1.1 com a Versão 5.0
Quando oIBMWebSphereStudioSiteDeveloperVersão 5.1.1éiniciadopela primeira vezutilizandoumespaçodetrabalhodo IBMWebSphereStudioSite DeveloperVersão 5.0existente,apareceumacaixade diálogomostrandouma maneira demigrardaVersão5.0.Cliqueem OKparamigrardoespaçode
trabalho daVersão 5.0oucliqueem CancelparapararoiníciodoIBMWebSphere Studio SiteDeveloper.
Quando oespaçodetrabalhoémigradoaindaépossívelutilizá-lo comaVersão 5.0, poisosmetadadosdosnovosrecursosdeprojetosãoignoradose podemser lidos pelaVersão5.0.Nãoé possívelfazernenhumaalteraçãona Versão5.0aos
projetosnoespaçodetrabalho queteriamefeitosobreosmetadadosou sobrescreveriamosmetadadosdonovorecursodeprojetoparaprojetos.
Migrando Projetos Java da Versão 5 ou da Versão 5.0.1
Migrar projetosJava daVersão 5oudaVersão5.0.1émuitosimpleseautomático.
Quando osprojetossãocarregadosnoespaçodetrabalho daVersão5.1.1,não ocorremalteraçõesdemetadadosnos arquivos.classpathou .project,amenosque você tenteutilizarosnovosrecursosdisponíveisna Versão5.1.1.
Compartilhando Projetos entre a Versão 5 ou a Versão 5.0.1 e a Versão 5.1.1 Utilizando um Sistema SCM (Source Code Management)
É necessáriocuidadoespecialquandoumprojetoemum repositóriodeequipeestá sendocarregadoeoperadopordesenvolvedoresutilizandooIBMWebSphere Studio SiteDeveloperVersão5 eIBMWebSphereStudioSite DeveloperVersão 5.1.1.Oproblemageralé quea existência,oconteúdoea interpretaçãode arquivosde metadadosnosespaçosdetrabalho podemser específicosparaum recursoespecíficoouversãodeplug-inediferirentreasversões.Asgarantiasde compatibilidadede espaçosdetrabalhocobrem apenasoscasosem quetodosos desenvolvedoresfazemupgradedosespaçosde trabalhodoIBMWebSphere Studio SiteDevelopernaetapatravada.Nessescasosnãodevehaverproblemas commetadados compartilhados.Noentanto,quandoalguns desenvolvedoresestão trabalhandonoIBMWebSphereStudioSiteDeveloperVersão 5.1enquantooutros estãotrabalhandonoIBMWebSphereStudioSite DeveloperVersão 5,nãoexistem essasgarantias.Estaseçãoaconselha sobreoquefazereoquenãofazer.
Omododefalhatípicaéreconhecidopelousuáriodo IBMWebSphereStudioSite DeveloperVersão 5.1.1.OsmetadadosdaVersão5.1.1sãoperdidosquandoum usuário daVersão 5salvaalteraçõeseconsolidaosarquivosdemetadados atualizados norepositório.Aseguir,vejaalgumascoisas quepodemdarerrado:
v UmusuáriotrabalhandonoIBM WebSphereStudio SiteDeveloperVersão5.1.1 criaoumodifica umprojetode umamaneira queresultaemalteraçõesemum arquivodemetadadoscompartilhadoquesebaseiaem informaçõesespecíficas daVersão5.1.1.Emseguida,ousuário consolidaosarquivosde projeto atualizados,incluindooarquivodemetadadoscompartilhado,norepositório compartilhado.
v OutrousuáriotrabalhandonoIBMWebSphereStudioSiteDeveloperVersão 5 compartilhaesseprojetoa partirdo mesmorepositório.Asinformações específicasdaVersão5.1.1noarquivodemetadados compartilhadonãosão compreendidaspeloIBMWebSphereStudio SiteDeveloperVersão5 e geralmentesãodescartadasouignoradassemaviso.Ousuáriomodifica o projetodeumamaneiraqueresultaemalteraçõesnoarquivode metadados compartilhado,fazendocomqueoarquivode metadadoscompartilhadoseja regravadosemasinformaçõesespecíficas daV5.1.1. Ousuário consolidaos arquivosdeprojetoatualizados,incluindo oarquivode metadados
compartilhado,norepositóriocompartilhado.Geralmente ousuárionãoestá cientedequeinformações compartilhadasforamperdidascomoresultadode suasações.
v UmusuáriotrabalhandonoIBM WebSphereStudio SiteDeveloperVersão5.1.1 obtémasalteraçõesparaumprojetodo repositóriocompartilhado,incluindo o arquivodemetadadoscompartilhadoatualizado.Ousuário podenãoestar cientedequefoiexecutadaumaetaparetrógradaatéascoisascomeçarema apresentarproblemasposteriormente.
Segueumalistadedetalhes aseremobservadosquandooprojetofor
compartilhadoentreusuáriosdoIBM WebSphereStudio SiteDeveloperVersão 5.1.1eVersão 5ouVersão 5.0.1:
v Pastasearquivoscompartilhados
EssesuportefoiadicionadonoIBMWebSphereStudioSite DeveloperVersão 5.1.1.Asinformaçõessobreosrecursosvinculadosestãogravadasnoarquivo .project.
Recomendação:Nãoutilize.Melhor ainda,desativeosrecursosvinculados utilizandoapáginade preferênciasWorkbench>LinkedResources.
v Construtoresdeferramentaexterna(Ant)
Asinformaçõessobreconstrutoresdeferramentas externasestãogravadasno arquivo.project. Oformatodasinformaçõesalteradasentrea Versão5ea Versão 5.1.1.OsconstrutorescriadosoualteradosnaVersão 5.1.1utilizamonovo formato,quenãoécompreendidoporumespaçodetrabalhodaVersão5.Os construtorescriadosna Versão5utilizamo formatoantigoecontinuam funcionandonaVersão5.1.1.
Recomendação:Semprecrieouediteconstrutoresde ferramentasexternasa partirdeum espaçode trabalhodaVersão5.
v PadrõesdeexclusãoopcionalementradasdeorigemJavano caminhoda classedecompilação
Essesuportefoiadicionado.Essasinformaçõesestãogravadasnoarquivo .classpath.
Recomendação:Nãoespecifiquepadrõesde exclusão.Melhor ainda,desativeos padrõesdeexclusãoutilizandoapágina depreferênciasJava>Compiler>
BuildPath.
v Pastasdesaídaassociadas àentradasdeorigemJavano caminhodaclassede compilação
Essesuportefoiadicionado.Essasinformaçõesestãogravadasnoarquivo .classpath.
Recomendação:Nãoespecifiquenadadiferentedapastadesaídapadrão(para todooprojeto).Melhor ainda,desativeasdiversaslocalizaçõesde saída utilizandoapáginade preferênciasJava>Compiler>Build Path.
v CaminhodaraizanexadeorigemassociadaàsentradasdabibliotecaJavano caminhodaclassedecompilação
AoconectarumarquivoZIPdeorigemaumabibliotecaJARnocaminhode construçãoJava, oprefixodocaminhoraiz daorigemédeduzido
automaticamente.Issofoialteradoa partirdaVersão5,emqueoprefixopodia serdefinidoexplicitamenteatravésinterfacecomousuário eexplicitamente gravadonoarquivo.classpath.Conseqüentemente,umprojetoJavacriadoem umespaçodetrabalho5.1.1pode nãolocalizara origemconectada.
UtilizeaVersão 5paraespecificarocaminhode raizanexade origem.Na Versão5.1.1,é fornecidaflexibilidadeadicionaldeconexãodaorigem.Vocêpode fornecerumapastaem vezdeumarquivoJARouZIPcomoconexãodaorigem epodeconectaraorigema umapastadearquivosdeclasse;essa funcionalidade nãoestádisponívelnaVersão5 (naqualasinformaçõesdaVersão5.1.1são ignoradas).
v ContêineresdecaminhodaclassePDEparaplug-insdependentes
Autilização doPDEporcontêineresdocaminhode classefoiadicionada.Os contêineresdocaminhodeclasse estãogravadosnoarquivo.classpath.Seos contêineresdocaminhodeclasse PDEforemutilizados,umespaçodetrabalho daVersão5 teráentradasdo caminhodeclasse não-resolvidase,portanto,a
maioriadascapacidadesJava (incluindocompilação, pesquisa,execução, depuração)nãoproduziráosresultadosesperados.
Recomendação:Assegure-sedequeadefiniçãonapágina depreferências Plug-inDevelopment> JavaBuildPathControlparaautilizaçãode contêineresdocaminhodeclasse estejadesativadaantesdecriarquaisquer novosprojetosde plug-in(ou fragmento).
Migrando Projetos da Web
Os nomesdepastassãoJavaSourceeWebContent.Osnomesdaspastaspadrão paranovosprojetosdaWebsãoconfiguráveispormeiodeumapáginade
preferências(Window> Preferences>WebTools>NewProject).Osnomes padrão agorasãoJavaSourceeWebContent.Essesnomespadrãoserãoutilizados apenas paranovosprojetosdaWeb.OsprojetosdaWebcriadosem versões anterioresa essereleasecontinuarãoafuncionarutilizandoosnomesantigos.O mesmo acontececomosprojetosEstáticosdaWeb.
Sevocê optarporalterar osnomesdaspastasdeorigem paraprojetos4.0.xe 5.0 na Versão5.1.1,utilizea açãodo menupop-upRenamenaexibiçãoNavigator.A açãodo menupop-upRenamerenomeiaosnomesdaspastasecorrige ocaminho de construçãoJavaparaosprojetosdaWeb4.0.xe5.0.x.
Paraa pastaJavaSource,a açãodomenupop-upRenamefuncionanaexibição Project NavigatorenaexibiçãoPackages.Paraapasta WebContent,aaçãodo menu pop-upRenamefuncionana exibiçãoResourceNavigatore naexibição Project Navigator.
Seum projetodaWebdeumaversãoanterioraesserelease forsalvoemum repositório SCMe,emseguida,carregadonaVersão5.1, elemanteráa estrutura antiga comaspastassourceewebApplication.Qualquerumadasduasestruturas seráconstruída corretamente.
Nota: SeosusuáriosoptaremporrenomearosnomesdaspastasJavaSourcee WebContent,elesdeverãoatualizarmanualmentequaisquerscripts de construçãoautomatizados;deverãoalterá-losparautilizarosnovosnomes daspastas.
Convertendo Projetos da Web para o Struts 1.1
Otempo deexecuçãodasferramentasdoStrutsfoiatualizadodaVersão1.1Beta2 na Versão5paraa Versão1.1.NoIBMWebSphereStudioSiteDeveloperVersão 5 (DisponibilidadeGeral),aocriarumprojetodaWeb,você temaopção de
adicionar osuportea Strutsaoprojeto.Você podeoptarpeloStruts1.0.2oupelo Struts1.1Beta2.NoIBM WebSphereStudio SiteDeveloperVersão5.1.1,aúltima opção ésubstituídapeloStruts1.1.SetivercriadoprojetosdaWebdoStruts1.1 Beta2 noIBM WebSphereStudio SiteDeveloperVersão5.0, vocêpode convertê-los paraoStruts1.1, porémissonão énecessário,poisoStruts1.1Beta2ainda é suportado.CasopossuaprojetosdaWebdoStruts1.1Beta2 quedesejaconverter paraoStruts1.1, seránecessárioprocederdaseguinteforma:
1. CarregueosprojetosdoStruts1.1Beta2 emumespaçodetrabalho doIBM WebSphereStudioSiteDeveloperVersão 5.1.1.
2. CrieumnovoprojetodaWebdoStruts1.1denominadoStruts11.Istofornece acessoconvenienteaosartefatos doStruts1.1queserãonecessáriosdurantea conversãode projetosreais.Vocêpode excluiresseprojetoquandotiver concluído.
3. Paracadaprojetodo Struts1.1Beta2quevocêdesejaconverterparaoStruts 1.1, procedadaseguinteforma:
a. Excluaosseguintesarquivos.jardo diretórioWebContent/WEB-INF/libdo seuprojeto: commons-*.jarestruts.jar.
b. Copieosseguintesarquivos.jardo diretórioStruts11/WebContent/WEB- INF/libparaodiretórioWebContent/WEB-INF/lib doseuprojeto:
commons-*.jarestruts.jar.
c. Excluaosseguintesarquivos.tlddodiretórioWebContent/WEB-INFdo seuprojeto:struts-*.tld.
d. Copieosseguintesarquivos.tldfilesdodiretório
Struts11/WebContent/WEB-INFparaodiretórioWebContent/WEB-INFdo projeto:struts-*.tld.
Todasasinformaçõesacimatambém serãoaplicáveissevocêestiver movendoum projetodaWebdoStruts1.1Beta3noIBM WebSphereStudio SiteDeveloper Versão 5.0.1parao Struts1.1.
Alterações nas Ferramentas de Serviços da Web
Asferramentas deserviçosdaWebadicionaramdoisnovosprotocolosde tempo de execuçãodoIBMWebSphereApplicationServerVersão 5.0.2quesão
executadossomentenoWebSphereApplicationServer Versão5.0.2.Nãodeve havermigraçãoobrigatória,poisoIBMWebSphereStudioSiteDeveloperVersão 5.1eoWebSphereApplicationServerVersão 5.0.2suportarãoosprotocolosde tempo deexecuçãonovoseantigos.OIBMWebSphereStudioSiteDeveloper Versão 5.1irágerareimplementartrês protocolosde tempodeexecuçãode artefatos deserviçosdaWeb:oantigoprotocolodetempo deexecução″IBM SOAP″queé executadonoWebSphereApplicationServer Versão4.xeVersão5.x;
o novoprotocolode tempodeexecução″IBM WebSphere5.0.2runtime″ queé executado apenasnoWebSphereApplicationServer Versão5.0.2eonovo protocolo detempode execução″ApacheAxis1.0″queéexecutado apenasno WebSphereApplicationServerVersão 5.0.2.
Os usuáriosdevemser capazesde reutilizarosarquivosEARe WARrelacionados a serviçosdaWebeprojetosdaVersão5semnenhumaalteraçãonaVersão5.1.1.
ParaqueconvertamosclienteseserviçosdaWebparaonovoprotocolo detempo de execuçãodoIBMWebSphere5.0.2etiremvantagemdospadrõesJSR101,109, WS-IeWS-Security,elesterãoquesergeradosnovamenteatravésdo assistente paraserviços daWeb.Oexploradordeserviços daWebcontinuará
automaticamentea lerosfavoritosdo usuário,emboraoarquivodedadosfísicos sejamovidoautomaticamenteparaumanovalocalização.
Alterações Feitas nas Ferramentas de Criação de Perfil
Aomigrarum espaçode trabalhodaVersão5,vocêreceberá umamensagemde erropop-up″Problemsoccurredrestoringworkbench″.Essamensagemaparecerá seaperspectiva Profilingestiverabertanomomentodamigraçãoeseasexibições Heap ouInstanceStatisticestiverem visíveisna perspectivaProfiling.Issoocorre porque asexibiçõesHeapeInstanceStatisticexistentesna Versão5foram removidas.Essamensagemtambémapareceráseaperspectiva Profilingestiver aberta noespaçode trabalhonomomentodamigração.Amensagemdeerropode ser ignoradacomsegurança clicandoemOK.
