-
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.