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