Anda di halaman 1dari 22

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 as
outras verses sero removidas do FTP. Portanto, caso o cliente utilize uma verso anterior, como por
exemplo o Glassfish 2.1, e deseja futuramente atualizar para a verso 5.8.6 ou posterior obrigatrio
realizar 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 para
realizar o deploy no Glassfish 3.
Este documento tem como objetivo apresentar as principais etapas do processo de migrao, bem
como as ferramentas que foram desenvolvidas para auxiliar no processo. Estas ferramentas estaro
disponveis separadamente no FTP da Senior, portanto no sero liberadas na mdia. Por fim, sero
apresentados 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 a
instalao 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, porm
ser necessrio ter acesso ao diretrio do Glassfish 2 durante o processo de migrao. Durante a instalao
um 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 no
Glassfish 2. Os domnios podem ser criados manualmente ou atravs da ferramenta.
A criao dos domnios pode ser feita manualmente, conforme documentado em: Ferramentas
Administrativas > Informaes Tcnicas > Servidor Java EE > Glassfish > Outros > Ambiente em Arquiteturas
Diferentes.
Outra alternativa utilizar a ferramenta GlassfishDomainCreator, que foi desenvolvida para auxiliar
na criao desses domnios. O seu funcionamento apresentado mais adiante neste documento. A
ferramenta permite criar os domnios no Glassfish 3 com base nas configuraes dos domnios existentes no
Glassfish 2. Apenas algumas configuraes, detalhadas na seo que descreve a ferramenta, so utilizadas
para a criao dos domnios. Sendo assim, configuraes adicionais feitas no Glassfish 2, como por exemplo
a 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 configuraes
adicionais existentes nos domnios do Glassfish 2. Sendo assim, pode-se instalar os certificados digitais e
instalar 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 as
configuraes da instalao Senior para utilizar os domnios recm criados. Para realizar esses ajustes devese utilizar a ferramenta GlassfishDomainConfigurator, que foi desenvolvida para esse propsito. O seu
funcionamento est descrito mais ainda neste documento. Aps a execuo da ferramenta a instalao
Senior 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 estar
inconsistente, pois estar utilizando os domnios do Glassfish 3, sendo que o deploy dos recursos ainda no
foi feito nesses domnios. Portanto, deve-se executar o SeniorUpdater para realiz-lo. Ao executar o
SeniorUpdater ser feita uma atualizao normal de release, sendo consistida a base de dados, atualizados
os arquivos de sistema e por fim feito o deploy dos recursos nos domnios do Glassfish 3. Aps a execuo
do 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 citadas
anteriormente. A primeira ferramenta chama-se GlassfishDomainCreator e tem como objetivo auxiliar na
criao de domnios no Glassfish 3. A segunda a GlassfishDomainConfigurator, que altera as configuraes
da instalao Senior para utilizar os novos domnios do Glassfish 3. Esta ferramenta s poder ser utilizada
na verso 5.8.5.
importante lembrar que ambas sero liberadas separadamente no FTP da Senior, portanto no
estaro 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 configuraes
dos domnios do Glassfish 2, sendo que apenas os valores das portas, thread-count e parmetros de JVM
listados 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 configuraes
devero ser exportadas manualmente do Glassfish 2 para o Glassfish 3, como por exemplo a instalao dos
certificados 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, pois
necessita de permisso para criar os domnios e diretrios compartilhados. Antes de execut-la deve-se
verificar se as portas utilizadas pelos domnios que sero criados no esto sendo utilizadas, pois uma porta
no pode ser usada por mais de um programa ou domnio simultaneamente. Portanto, caso o Glassfish 3 foi
instalado no mesmo servidor do Glassfish 2 e deseja-se utilizar as mesmas portas do Glassfish 2 deve-se
parar os domnios que esto executando antes de iniciar a ferramenta. Para verificar se uma porta est
sendo 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 do
Glassfish 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. O


usurio deve selecionar os domnios que deseja recriar no Glassfish 3 e pressionar o boto Avanar. A
ferramenta verifica as configuraes dos domnios selecionados, analisando o arquivo domain.xml,
localizado em <glassfish_dir>\<domain_dir>\config\domain.xml, de cada domnio. Este arquivo armazena
as 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 do


primeiro 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 do
compartilhamento, que por padro o mesmo nome do domnio. Tambm deve ajustar o usurio e senha
do domnio, que esto preenchidos com o valor 'admin' e 'adminadmin'. Alm disso, possvel alterar o
valor das portas utilizadas. Caso o domnio seja do CSM Center apresentado tambm o campo Diretrio
da 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 so
descritas 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 os
parmetros de JVM que sero importados atravs do comando delete-jvm-options. Em seguida adiciona os
parmetros lidos anteriormente do domnio do Glassfish 2 atravs do comando create-jvm-options. Caso o
domnio seja do CSM Center esta etapa no executada.
- Habilitao do secure-admin, executando o comando enable-secure-admin, para que a utilizao do SSL
seja 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 <DOMAINDIR_GF2>\lib\ para <DOMAINDIR_GF3>\lib.
Caso no encontre o arquivo jtds-1.2.8.jar ou ojdbc5.jar no diretrio de origem, copia do diretrio
<SENIORDIR>InstFiles\Deploy\lib.
- Excluso do arquivo sqljdbc.jar do diretrio <DOMAINDIR_GF3>\lib caso existir.
- Copia dos diretrios:
<DOMAINDIR_GF2>\config\scripts\windows para <DOMAINDIR_GF3>\config\scripts\windows
<DOMAINDIR_GF2>\config\scripts\linux para <DOMAINDIR_GF3>\config\scripts\linux
<DOMAINDIR_GF2>\docroot para <DOMAINDIR_GF3>\docroot
- Execuo do bat <SENIORDIR>\InstFiles\Deploy\scripts\CreateDomain\CreateDomainCSMCenter.bat.
possvel cancelar a execuo pressionando o boto Cancelar. Aps cancelar a execuo, os
domnios e compartilhamentos criados devem ser removidos manualmente, pois a ferramenta no restaura
o que j foi feito.
A ferramenta salva o log no diretrio onde a ferramenta est 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.
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 um
domnio 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 as
configuraes 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 os
domnios 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-se
executar o SeniorUpdater logo aps a sua execuo.
Em seguida ser apresentado o seu funcionamento, mostrando as etapas necessrias para migrar as
configuraes 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. Para
prosseguir 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. Em
seguida deve clicar no boto Avanar.

Na prxima tela deve-se informar as configuraes dos domnios do Glassfish 3. Sendo assim, o
usurio deve informar qual o usurio e senha que foram informados ao criar o domnio do Glassfish 3, bem
como o nome do compartilhamento e do servidor onde o Glassfish 3 est instalado. Alm disso, deve
ajustar a URL de acesso. Tambm so apresentadas nesta tela o identificador do domnio e as portas de
administrao, 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 domnios
selecionados forem configurados ser apresentada a tela abaixo. Esta tela lista todos os recursos que sero
impactados com a alterao de configuraes dos domnios da instalao Senior. O usurio deve conferir se
realmente deseja aplicar as alteraes e clicar no boto Avanar.

Em seguida so feitos os ajustes nas configuraes dos recursos, alterando os arquivos da instalao
para 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 so
copiados para o seguinte diretrio: <SENIOR>\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 o
seguinte diretrio: <SENIOR>\InstFiles\temp\Glassfish\<DOMNIO>\<APLICACAO_WEB50>. 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 nas
mensagens das etapas do processo ser apresentada a seguinte mensagem: Execuo finalizada com
sucesso. Execute o atualizador para republicar as aplicaes no Glassfish 3. Neste momento pode-se fechar
a ferramenta e iniciar a execuo do SeniorUpdater para realizar a atualizao que far o deploy dos
recursos nos novos domnios do Glassfish 3.
Assim como a ferramenta GlassfishDomainCreator, esta ferramenta salva o log no diretrio onde
est 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 verso
5.8.5 no Servidor de Aplicativos. Lembrando que os domnios devem estar iniciados para que seja possvel
realizar o deploy dos recursos. Ao executar o atualizador ser consistida a base de dados, atualizados os
arquivos 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 assim
os recursos estaro utilizando os domnios do Glassfish 3. Lembrando que se um domnio no foi
selecionado ao alterar as configuraes pela ferramenta GlassfishDomainConfigurator o mesmo ainda
estar utilizando o Glassfish 2.

Problemas mais frequentes:


Em seguida sero apresentados os problemas mais frequentes que podem ocorrer durante a
migrao para o Glassfish 3. Primeiro sero apresentados os problemas que podem ocorrer ao utilizar a
ferramenta de criao de domnio, em seguida os da ferramenta que altera as configuraes da instalao e
por 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 uma
mensagem informando a situao. Nesse caso, deve-se verificar se o domnio est consistente. Pode-se
tentar inici-lo manualmente (start-domain), verificando se o mesmo inicia corretamente. Caso esteja
inconsistente provavelmente ocorrer um erro ao tentar inici-lo. O usurio deve verificar a causa do
problema, 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 uma
mensagem informando a situao. Nesse caso, pode-se utilizar outro nome de domnio/compartilhamento
ou 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 essa
porta 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 uma
mensagem informando a situao. Ao informar o diretrio verificado pela ferramenta se alguns arquivos
necessrios para a criao do domnio existem. Caso algum desses arquivos no exista apresentada a
mensagem 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 indicando
o 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 o
usurio identifique o problema, o mesmo deve ajustar e selecionar a opo Tentar novamente. Dessa forma
a etapa onde ocorreu o problema ser executada novamente. Por fim h a opo Ignorar. Ao selecionar esta
opo, ignorada a etapa onde ocorreu o problema, iniciando assim a prxima etapa da criao do
domnio. 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 prximo
domnio.

Problema ao copiar arquivo:


Ao criar o domnio do CSM Center alguns arquivos so copiados. Caso ocorra algum problema ao
copi-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 possvel
encontrar o arquivo de controle da instalao (inst.ctrl). Este arquivo sempre deve estar presente no
diretrio da instalao Senior.

Ferramenta deve ser executada no Servidor de Aplicativos:


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

Nenhum servidor do Glassfish 2 cadastrado:


Caso a instalao Senior no utilize nenhum domnio do Glassfish 2 apresentada a mensagem
abaixo. 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 possvel
encontrar o arquivo SeniorInstaller.exe no diretrio da instalao Senior. Neste caso deve-se verificar
porque 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 esteja
em uma verso diferente da esperada apresentada a mensagem abaixo. Neste caso deve ser feita uma
atualizao 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 do
Glassfish" o arquivo domain.xml selecionado verificado. Caso ocorra algum erro ao obter as configuraes
do arquivo apresentada a mensagem de erro abaixo. Neste caso deve-se verificar se realmente foi
selecionado o arquivo domain.xml do domnio do Glassfish 3. Se foi selecionado o arquivo correto deve-se
verificar se o domnio e o arquivo esto consistentes. Pode-se fazer um teste inicializando o domnio
manualmente, utilizando o comando start-domain.

Problema ao alterar configuraes:


Caso ocorra algum erro durante as alteraes nas configuraes apresentada uma mensagem de
erro 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 o
usurio identifique o problema, pode-se ajustar e selecionar a opo Tentar novamente. Dessa forma a
etapa onde ocorreu o problema ser executada novamente. Dependendo do problema encontrado ser
apresentada tambm a opo Ignorar. Ao selecionar esta opo, ignorada a etapa onde ocorreu o
problema, 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 e
acessvel. Caso ainda no tenha sido inicializado deve-se inici-lo atravs do comando start-domain. Aps
iniciar o domnio pode-se clicar no boto Tentar novamente. Se for selecionada a opo Ignorar o deploy
dos recursos no ser feito neste domnio. Neste caso dever ser feito posteriormente para que seja
possvel utilizar os recursos.

Anda mungkin juga menyukai