MIGRAO DO GLASSFISH 2 PARA O GLASSFISH 3 (5.8.5)

Tpicos do documento:

1. Introduo.2. Cenrios nos quais se aplicam e no se aplicam este documento.3. Apresentao das principais etapas do processo de migrao.4. Apresentao das ferramentas desenvolvidas para auxiliar na migrao.5. Problemas mais frequentes encontrados durante a migrao.

Introduo:

A partir da verso 5.8.6 apenas a verso 3.1.2.2 do Glassfish ser homologada pela Senior. Todas asoutras verses sero removidas do FTP. Portanto, caso o cliente utilize uma verso anterior, como porexemplo o Glassfish 2.1, e deseja futuramente atualizar para a verso 5.8.6 ou posterior obrigatriorealizar a migrao para o Glassfish 3.1.2.2 antes de atualizar o sistema. Ao migrar para o Glassfish 3 no necessrio atualizar para uma verso posterior a 5.8.5, porm o SeniorUpdater dever ser executado pararealizar o deploy no Glassfish 3.

Este documento tem como objetivo apresentar as principais etapas do processo de migrao, bemcomo as ferramentas que foram desenvolvidas para auxiliar no processo. Estas ferramentas estarodisponveis separadamente no FTP da Senior, portanto no sero liberadas na mdia. Por fim, seroapresentados os problemas mais frequentes que podem ocorrer durante a migrao.

Cenrios nos quais se aplicam este documento:

- A Instalao Senior est na verso 5.8.5, utiliza o Glassfish 2 e deseja-se utilizar o Glassfish 3.

Cenrios nos quais no se aplicam este documento:

- A instalao Senior no utiliza o Glassfish 2.- A instalao Senior utiliza o Glassfish 2, porm deseja-se atualizar para a verso 5.8.6 ou posterior.

Principais etapas do processo de migrao:

Abaixo esto ilustradas e descritas as principais etapas que devem ser concludas para que ainstalao Senior deixe de utilizar o Glassfish 2 e passe a utilizar o Glassfish 3.

1 Instalar o Glassfish 3:

O primeiro passo instalar o Glassfish 3.1.2.2 no servidor, conforme documentao disponvel em:Ferramentas Administrativas > Informaes Tcnicas > Servidor Java EE > Glassfish > Instalao do GlassFish.

Lembrando que no obrigatrio instalar o Glassfish 3 no mesmo servidor do Glassfish 2, pormser necessrio ter acesso ao diretrio do Glassfish 2 durante o processo de migrao. Durante a instalaoum domnio criado, porm o mesmo pode ser excludo aps a instalao do Glassfish.

2 Recriar os domnios no Glassfish 3:

Aps finalizar a instalao, deve-se criar no Glassfish 3 os domnios que a instalao Senior utiliza noGlassfish 2. Os domnios podem ser criados manualmente ou atravs da ferramenta.

A criao dos domnios pode ser feita manualmente, conforme documentado em: FerramentasAdministrativas > Informaes Tcnicas > Servidor Java EE > Glassfish > Outros > Ambiente em ArquiteturasDiferentes.

Outra alternativa utilizar a ferramenta GlassfishDomainCreator, que foi desenvolvida para auxiliarna criao desses domnios. O seu funcionamento apresentado mais adiante neste documento. Aferramenta permite criar os domnios no Glassfish 3 com base nas configuraes dos domnios existentes noGlassfish 2. Apenas algumas configuraes, detalhadas na seo que descreve a ferramenta, so utilizadaspara a criao dos domnios. Sendo assim, configuraes adicionais feitas no Glassfish 2, como por exemploa instalao de certificados digitais, no sero feitas ou exportadas pela ferramenta.

3 Ajustar configuraes adicionais

Aps a criao dos domnios deve-se migrar manualmente para o Glassfish 3 as configuraesadicionais existentes nos domnios do Glassfish 2. Sendo assim, pode-se instalar os certificados digitais einstalar o Portal (conforme documentao disponvel em: Ferramentas Administrativas > Atualizao >Passo a passo para converso > Pr-requisitos por produto > Performance Corporativa > Portal Corporativo> Convertendo o Liferay 5 para o 6).

4 Alterar configuraes da instalao:

Aps os domnios do Glassfish 3 estarem devidamente criados e configurados deve-se alterar asconfiguraes da instalao Senior para utilizar os domnios recm criados. Para realizar esses ajustes deve-se utilizar a ferramenta GlassfishDomainConfigurator, que foi desenvolvida para esse propsito. O seufuncionamento est descrito mais ainda neste documento. Aps a execuo da ferramenta a instalaoSenior deixar de utilizar o Glassfish 2 e passar a utilizar o Glassfish 3.

5 Executar SeniorUpdater:

Aps a execuo da ferramenta GlassfishDomainConfigurator a instalao Senior estarinconsistente, pois estar utilizando os domnios do Glassfish 3, sendo que o deploy dos recursos ainda nofoi feito nesses domnios. Portanto, deve-se executar o SeniorUpdater para realiz-lo . Ao executar oSeniorUpdater ser feita uma atualizao normal de release, sendo consistida a base de dados, atualizadosos arquivos de sistema e por fim feito o deploy dos recursos nos domnios do Glassfish 3. Aps a execuodo atualizador a instalao Senior estar utilizando o Glassfish 3.

Ferramentas desenvolidas para auxiliar no processo:

Para auxiliar no processo de migrao foram desenvolvidas duas ferramentas, conforme citadasanteriormente. A primeira ferramenta chama-se GlassfishDomainCreator e tem como objetivo auxiliar nacriao de domnios no Glassfish 3. A segunda a GlassfishDomainConfigurator, que altera as configuraesda instalao Senior para utilizar os novos domnios do Glassfish 3. Esta ferramenta s poder ser utilizadana verso 5.8.5.

importante lembrar que ambas sero liberadas separadamente no FTP da Senior, portanto noestaro disponveis na mdia. A seguir ser apresentado o funcionamento das duas ferramentas.

Ferramenta para recriar os domnios no Glassfish 3:

A ferramenta GlassfishDomainCreator cria os domnios no Glassfish 3 com base nas configuraesdos domnios do Glassfish 2, sendo que apenas os valores das portas, thread-count e parmetros de JVMlistados abaixo so utilizados.

As portas obtidas e utilizadas para a criao do domnio so: - Porta de Administrao- HTTP (Hypertext Transfer Protocol)- HTTPS (Hypertext Transfer Protocol Secure)- JMX (Java Management Extensions)- JMS (Java Message Service)- ORB (CORBA Object Request Broker)- ORB SSL- ORB SSL Mutual Authentication.

J os parmetros de JVM (jvm-options) obtidos so: -Xmx-Xms-Xmn-Xrs-XX:SurvivorRatio-XX:MaxPermSize-XX:+CMSParallelRemarkEnabled-XX:+UseConcMarkSweepGC-XX:NewRatio-client-server

Caso o domnio do Glassfish 2 no possua um dos parmetros de JVM o mesmo ser ignorado.Estas so as nicas configuraes obtidas para a criao do domnio. Sendo assim, as demais configuraesdevero ser exportadas manualmente do Glassfish 2 para o Glassfish 3, como por exemplo a instalao doscertificados digitais.

A ferramenta no depende da instalao Senior, portanto no altera arquivos da instalao.Entretanto, deve ser executada em cada um dos servidores que possuem a instalao do Glassfish 3, poisnecessita de permisso para criar os domnios e diretrios compartilhados. Antes de execut-la deve-severificar se as portas utilizadas pelos domnios que sero criados no esto sendo utilizadas, pois uma portano pode ser usada por mais de um programa ou domnio simultaneamente. Portanto, caso o Glassfish 3 foiinstalado no mesmo servidor do Glassfish 2 e deseja-se utilizar as mesmas portas do Glassfish 2 deve-separar os domnios que esto executando antes de iniciar a ferramenta. Para verificar se uma porta estsendo utilizada pode-se executar no Prompt de Comando do Windows a seguinte linha de comando: netstat -ano | find "porta" (Ex.: netstat -ano | find "8080", onde 8080 a porta que deseja-se verificar).

A seguir ser demonstrado como utilizar a ferramenta, sendo que aps o trmino da sua execuo,caso tudo ocorra normalmente, os domnios estaro criados no Glassfish 3.

Ao abr-la a tela abaixo apresentada, onde deve-se informar os diretrios da instalao doGlassfish 2 e 3. No caso do Glassfish 2 pode-se informar o diretrio compartilhado.

A ferramenta verifica quais so os domnios existentes no Glassfish 2 e apresenta-os em uma lista. Ousurio deve selecionar os domnios que deseja recriar no Glassfish 3 e pressionar o boto Avanar. Aferramenta verifica as configuraes dos domnios selecionados, analisando o arquivo domain.xml,localizado em \\config\domain.xml, de cada domnio. Este arquivo armazenaas configuraes do domnio. So obtidas as portas, o thread-count e os parmetros de JVM (jvm-options)listados anteriormente. Nesta etapa tambm verificado se o domnio do CSM Center.

Aps verificar as configuraes dos domnios selecionados, so apresentadas as configuraes doprimeiro domnio para que o usurio possa editar.

O usurio pode ajustar o nome do domnio, que por padro o mesmo do Glassfish 2, o nome docompartilhamento, que por padro o mesmo nome do domnio. Tambm deve ajustar o usurio e senhado domnio, que esto preenchidos com o valor 'admin' e 'adminadmin'. Alm disso, possvel alterar ovalor das portas utilizadas. Caso o domnio seja do CSM Center apresentado tambm o campo Diretrioda instalao Senior. Neste campo deve-se informar o diretrio onde est localizada a instalao Senior.

Aps configurar todos os domnios, iniciada a criao dos mesmos. As etapas executadas sodescritas na tela, sendo que quando a execuo terminar ou for cancelada o boto Sair ser habilitado,permitindo sair da ferramenta.

Para a criao de cada domnio so executadas as seguintes etapas:- Criao do domnio no Glassfish 3, executando o comando create-domain com o utilitrio asadmin.- Criao do diretrio compartilhado.- Inicializao do domnio, executando o comando start-domain.- Ajuste dos parmetros de JVM (jvm-options): a ferramenta exclui do domnio que est sendo criado osparmetros de JVM que sero importados atravs do comando delete-jvm-options. Em seguida adiciona osparmetros lidos anteriormente do domnio do Glassfish 2 atravs do comando create-jvm-options. Caso odomnio seja do CSM Center esta etapa no executada.- Habilitao do secure-admin, executando o comando enable-secure-admin, para que a utilizao do SSLseja habilitada.- O domnio parado, executando o comando stop-domain.

Caso o domnio seja do CSM Center tambm so executadas as etapas abaixo:- Copia dos arquivos jtds-1.2.8.jar e ojdbc5.jar de \lib\ para \lib.Caso no encontre o arquivo jtds-1.2.8.jar ou ojdbc5.jar no diretrio de origem, copia do diretrioInstFiles\Deploy\lib.- Excluso do arquivo sqljdbc.jar do diretrio \lib caso existir.- Copia dos diretrios:

\config\scripts\windows para \config\scripts\windows\config\scripts\linux para \config\scripts\linux\docroot para \docroot

- Execuo do bat \InstFiles\Deploy\scripts\CreateDomain\CreateDomainCSMCenter.bat.

possvel cancelar a execuo pressionando o boto Cancelar. Aps cancelar a execuo, osdomnios e compartilhamentos criados devem ser removidos manualmente, pois a ferramenta no restaurao que j foi feito.

A ferramenta salva o log no diretrio onde a ferramenta est sendo executada. O log contm oscomandos que foram executados pela ferramenta. Sendo assim, pode-se verific-lo caso deseja-seidentificar a causa de um problema.

Lembrando que a ferramenta no migra outras configuraes feitas no Glassfish 2. Tambm no possvel utiliz-la para criar domnios no Glassfish 2 ou domnios avulsos no Glassfish 3, pois depende de umdomnio base existente no Glassfish 2 para ler suas configuraes.

Ferramenta para alterar configuraes da instalao:

A ferramenta GlassfishDomainConfigurator foi desenvolvida com o objetivo de alterar asconfiguraes da instalao Senior para deixar de utilizar o Glassfish 2 e comear a utilizar o Glassfish 3.Deve ser executada no Servidor de Aplicativos, pois ir ajustar as configuraes da instalao para utilizar osdomnios criados no Glassfish 3. A ferramenta deve ser executada a partir do diretrio da instalao Senior.

Aps a sua execuo a instalao Senior estar inconsistente, pois estar utilizando o Glassfish 3,sendo que o deploy dos recursos ainda no ter sido feito nos novos domnios. Por este motivo, deve-seexecutar o SeniorUpdater logo aps a sua execuo.

Em seguida ser apresentado o seu funcionamento, mostrando as etapas necessrias para migrar asconfiguraes da instalao para utilizar o Glassfish 3.

A primeira tela da ferramenta contm duas listas com os domnios utilizados pela instalao Senior.A primeira lista contm os domnios do Glassfish 2, enquanto que a segunda contm os do Glassfish 3.Apenas as configuraes dos domnios da primeira lista podem ser alteradas por esta ferramenta. Paraprosseguir o usurio deve selecionar na primeira lista os domnios que deseja alterar as configuraes.Lembrando que os domnios que no forem selecionados no tero suas configuraes alteradas. Emseguida deve clicar no boto Avanar.

Na prxima tela deve-se informar as configuraes dos domnios do Glassfish 3. Sendo assim, ousurio deve informar qual o usurio e senha que foram informados ao criar o domnio do Glassfish 3, bemcomo o nome do compartilhamento e do servidor onde o Glassfish 3 est instalado. Alm disso, deveajustar a URL de acesso. Tambm so apresentadas nesta tela o identificador do domnio e as portas deadministrao, JMX e ORB. Na mesma tela, so listados tambm os recursos (Browser Access, Web Services,Web 5.0, SeniorTools e Java EE) que sero impactados com a alterao das configuraes do domnio.

Aps configurar o domnio deve-se clicar no boto Avanar. Depois que todos os domniosselecionados forem configurados ser apresentada a tela abaixo. Esta tela lista todos os recursos que seroimpactados com a alterao de configuraes dos domnios da instalao Senior. O usurio deve conferir serealmente deseja aplicar as alteraes e clicar no boto Avanar.

Em seguida so feitos os ajustes nas configuraes dos recursos, alterando os arquivos da instalaopara utilizar os domnios do Glassfish 3. As etapas do processo de alterao so listados na tela abaixo.

Durante o processo feito o backup dos arquivos que sero alterados. O inst.ctrl e ambiente.cfg socopiados para o seguinte diretrio: \InstFiles\temp\ e salvos com os seguintes nomes:inst.ctrl.gf_bkp e ambiente.cfg.gf_bkp. Tambm feito o bakcup dos HTMLs das aplicaes Web 5.0 para oseguinte diretrio: \InstFiles\temp\Glassfish\\. Sendo assim,caso ocorra algum problema pode-se restaurar os arquivos.

Ao finalizar a execuo, caso tudo ocorra normalmente, o boto Fechar ser habilitado e nasmensagens das etapas do processo ser apresentada a seguinte mensagem: Execuo finalizada comsucesso. Execute o atualizador para republicar as aplicaes no Glassfish 3. Neste momento pode-se fechara ferramenta e iniciar a execuo do SeniorUpdater para realizar a atualizao que far o deploy dosrecursos nos novos domnios do Glassfish 3.

Assim como a ferramenta GlassfishDomainCreator, esta ferramenta salva o log no diretrio ondeest sendo executada. O log contm os comandos que foram executados pela ferramenta, sendo assim,pode-se verific-lo caso deseja-se identificar a causa de um problema.

Execuo do SeniorUpdater

Para fazer o deploy nos novos domnios do Glassfish 3 deve-se executar o SeniorUpdater da verso5.8.5 no Servidor de Aplicativos. Lembrando que os domnios devem estar iniciados para que seja possvelrealizar o deploy dos recursos. Ao executar o atualizador ser consistida a base de dados, atualizados osarquivos do sistema e por fim realizado o deploy nos domnios conforme demonstrado na imagem abaixo:

Aps o fim da execuo do atualizador a migrao para o Glassfish 3 estar concluda, sendo assimos recursos estaro utilizando os domnios do Glassfish 3. Lembrando que se um domnio no foiselecionado ao alterar as configuraes pela ferramenta GlassfishDomainConfigurator o mesmo aindaestar utilizando o Glassfish 2.

Problemas mais frequentes:

Em seguida sero apresentados os problemas mais frequentes que podem ocorrer durante amigrao para o Glassfish 3. Primeiro sero apresentados os problemas que podem ocorrer ao utilizar aferramenta de criao de domnio, em seguida os da ferramenta que altera as configuraes da instalao epor fim os problemas que podem ocorrer ao executar o SeniorUpdater para realizar a atualizao.

Problemas ao criar os novos domnios (GlassfishDomainCreator):

Domnio inconsistente:

Caso a ferramenta no consiga buscar a configurao de um domnio apresentada umamensagem informando a situao. Nesse caso, deve-se verificar se o domnio est consistente. Pode-setentar inici-lo manualmente (start-domain), verificando se o mesmo inicia corretamente. Caso estejainconsistente provavelmente ocorrer um erro ao tentar inici-lo. O usurio deve verificar a causa doproblema, ajustar e tentar novamente, clicando no boto No, ou ignorar a criao do(s) domnio(s)listado(s), clicando no boto Sim.

Nome do domnio ou compartilhamento j utilizado:

Caso for informado o nome de um domnio ou compartilhamento j existente apresentada umamensagem informando a situao. Nesse caso, pode-se utilizar outro nome de domnio/compartilhamentoou excluir o domnio/compartilhamento existente.

Porta j utilizada:

Se o valor informado para uma porta estiver sendo utilizada por outra porta, domnio ou programa apresentada uma mensagem informando a situao. Nesse caso, deve-se utilizar outro valor para essaporta ou alterar o valor da porta do domnio ou programa que est utilizando para que utilize outro valor.

Problema com o diretrio da instalao Senior:

Caso o diretrio da instalao Senior no exista ou no esteja acessvel apresentada umamensagem informando a situao. Ao informar o diretrio verificado pela ferramenta se alguns arquivosnecessrios para a criao do domnio existem. Caso algum desses arquivos no exista apresentada amensagem abaixo. Neste caso deve-se verificar se o arquivo existe e est acessvel.

Problema ao criar domnio:

Caso ocorra algum erro durante a criao de um domnio apresentada uma mensagem indicandoo que ocorreu. A mensagem apresenta trs opes: Tentar novamente , Ignorar ou Cancelar execuo.

Se a opo Cancelar execuo for selecionada, a execuo de todo o processo cancelada. Caso ousurio identifique o problema, o mesmo deve ajustar e selecionar a opo Tentar novamente. Dessa formaa etapa onde ocorreu o problema ser executada novamente. Por fim h a opo Ignorar. Ao selecionar estaopo, ignorada a etapa onde ocorreu o problema, iniciando assim a prxima etapa da criao dodomnio. Caso uma etapa for ignorada dever ser executada manualmente aps a execuo da ferramenta.Caso o erro ocorra na primeira etapa (criao do domnio) e for ignorado, iniciada a criao do prximodomnio.

Problema ao copiar arquivo:

Ao criar o domnio do CSM Center alguns arquivos so copiados. Caso ocorra algum problema aocopi-los apresentada a mensagem abaixo.

Problemas ao alterar configuraes da instalao (GlassfishDomainConfigurator):

No foi possvel encontrar o arquivo de controle da instalao:

Se a mensagem abaixo for apresentada ao abrir a ferramenta significa que no foi possvelencontrar o arquivo de controle da instalao (inst.ctrl). Este arquivo sempre deve estar presente nodiretrio da instalao Senior.

Ferramenta deve ser executada no Servidor de Aplicativos:

Esta ferramenta deve ser executada no Servidor de Aplicativos. Sendo assim, caso seja apresentadaa mensagem abaixo deve-se executar a ferramenta a partir do diretrio onde a instalao Senior estlocalizada.

Nenhum servidor do Glassfish 2 cadastrado:

Caso a instalao Senior no utilize nenhum domnio do Glassfish 2 apresentada a mensagemabaixo. Neste caso, no h a necessidade de utilizar a ferramenta.

Arquivo SeniorInstaller.exe no existe:

Se for apresentada a mensagem abaixo ao abrir a ferramenta significa que no foi possvelencontrar o arquivo SeniorInstaller.exe no diretrio da instalao Senior. Neste caso deve-se verificarporque o arquivo no est presente.

Verso 5.8.5:

Para executar esta ferramenta a instalao Senior deve estar na verso 5.8.5. Portanto, caso estejaem uma verso diferente da esperada apresentada a mensagem abaixo. Neste caso deve ser feita umaatualizao para a verso 5.8.5 antes de continuar com o processo.

No foi possvel carregar o arquivo de configuraes do Glassfish:

Ao importar as configuraes do domnio pressionando o boto "Importar configuraes doGlassfish" o arquivo domain.xml selecionado verificado. Caso ocorra algum erro ao obter as configuraesdo arquivo apresentada a mensagem de erro abaixo. Neste caso deve-se verificar se realmente foiselecionado o arquivo domain.xml do domnio do Glassfish 3. Se foi selecionado o arquivo correto deve-severificar se o domnio e o arquivo esto consistentes. Pode-se fazer um teste inicializando o domniomanualmente, utilizando o comando start-domain.

Problema ao alterar configuraes:

Caso ocorra algum erro durante as alteraes nas configuraes apresentada uma mensagem deerro indicando o que ocorreu. A mensagem apresenta as opes Tentar novamente e Cancelar execuo.

Se a opo Cancelar execuo for selecionada, a execuo da ferramenta cancelada. Caso ousurio identifique o problema, pode-se ajustar e selecionar a opo Tentar novamente. Dessa forma aetapa onde ocorreu o problema ser executada novamente. Dependendo do problema encontrado serapresentada tambm a opo Ignorar. Ao selecionar esta opo, ignorada a etapa onde ocorreu oproblema, iniciando assim a prxima etapa dos ajustes.

Problemas ao executar o SeniorUpdater para fazer o deploy no Glassfish 3:

No foi possvel autenticar no servidor Java EE:

Se for apresentada a mensagem de erro abaixo deve-se verificar se o domnio est inicializado eacessvel. Caso ainda no tenha sido inicializado deve-se inici-lo atravs do comando start-domain. Apsiniciar o domnio pode-se clicar no boto Tentar novamente. Se for selecionada a opo Ignorar o deploydos recursos no ser feito neste domnio. Neste caso dever ser feito posteriormente para que sejapossvel utilizar os recursos.