Migrando um perfil de agente administrativo e seu conjunto registrado de servidores de aplicativos base gerenciados

Os perfis de agentes administrativos gerenciam vários servidores de aplicativos base em ambientes como desenvolvimento, teste de unidade ou aquela parte de uma server farm que reside em uma única máquina. Antes de migrar servidores de aplicativos base gerenciados da versão 7.0 ou posterior para a versão 9.0, é necessário primeiro migrar o agente administrativo.

Antes de Começar

Configurações suportadas:

Este tópico é sobre a migração da configuração do perfil. Para migrar seus aplicativos para a versão mais recente, use o WebSphere® Application Server Migration Toolkit.

Revise as informações de planejamento de migração. Consulte a Coleção de Conhecimento: Planejamento da migração para WebSphere Application Server.

Dica: em vez de especificar parâmetros individuais nos comandos de migração, você pode especificar o -properties file_name.properties parâmetro para inserir um arquivo de propriedades. Para obter mais informações, consulte Definindo sua migração por meio de propriedades.

Sobre esta Tarefa

Um servidor de aplicativos base torna-se gerenciado quando ele é registrado com um único agente administrativo. Um agente administrativo pode gerenciar um ou mais servidores de aplicativos base e deve estar no mesmo nível de liberação e na mesma máquina que os servidores de aplicativos base que ele está gerenciando. Devido a essa restrição, os agentes administrativos tanto na liberação antiga quanto na nova são executados simultaneamente até que todos os servidores de aplicativos base gerenciados sejam migrados. A migração de um agente administrativo não leva adiante seus valores de porta antigos, no entanto, todos os outros dados de configuração são migrados.

Acesse o console do agente administrativo da versão 9.0 usando as portas WC_adminhost ou WC_adminhost_secure, conforme definido no novo arquivo do agente administrativo da versão serverindex.xml 9.0. Além disso, o agente administrativo do Version 7.0 ou posterior não deve ser desligado ou desativado durante este procedimento.

Para migrar o servidor de aplicativos base gerenciado em um ambiente de gerenciamento flexível, certifique-se de que os nomes dos nós sejam os mesmos na versão 9.0 e nas versões anteriores.

Evite problemas: certifique-se de que a configuração para o número máximo de arquivos abertos seja 10.000 ou superior. Se o número de arquivos abertos for muito baixo, isto poderá causar uma variedade de falhas de migração.

Procedimento

Instale a versão WebSphere Application Server 9.0 no host de destino em um novo diretório.

Para obter informações adicionais, consulte a documentação de instalação.

Crie um perfil de agente administrativo da versão 9.0 que será o destino da migração do agente administrativo.

Execute o comando manageprofiles com os parâmetros apropriados para criar um novo perfil de agente administrativo.

Por exemplo:

C:\WebSphere\AppServer90\bin>manageprofiles.bat -create -profileName 90AdminAgent01 -profilePath 
C:\WebSphere\AppServer90\profiles\AdminAgent01 -templatePath C:\WebSphere\AppServer90\profileTemplates\management 
-serverType ADMIN_AGENT -nodeName AdminAgentNode01 -cellName AdminAgentCell01 -hostName mydmgrhost.company.com

Assegure-se de que todas as tarefas em andamento estejam concluídas nos perfis gerenciados.
Pare de pesquisar o gerenciador de tarefas em perfis que estão recebendo tarefas do gerenciador de tarefas.

Antes de iniciar a pesquisa de tarefas, conclua WASPreUpgrade e WASPostUpgrade para o perfil gerenciado. Para obter mais informações, consulte Grupo de comandos ManagedNodeAgent para o objeto AdminTask usando o script wsadmin.
Salve a configuração atual do agente administrativo no diretório de backup de migração executando o WASPreUpgrade comando a partir do diretório bin raiz da nova instalação do WebSphere Application Server.

O comando WASPreUpgrade não faz nenhuma mudança na configuração antiga.
1. Execute o WASPreUpgrade comando, especificando o diretório de backup da migração e o diretório raiz da instalação da versão 7.0 ou posterior.
  
  Para obter informações sobre os parâmetros do comando, consulte o comando WASPreUpgrade.
  Por exemplo:
```
C:\WebSphere\AppServer90\bin>WASPreUpgrade.bat C:\WAS70AdminAgentbackup C:\WebSphere\AppServer70 -oldProfile 70AdminAgent01 
-traceString *=all=enabled -tracefile C:\WAS70AdminAgentbackup\logs\WASPreMigrationSummary.log
```
2. Verifique os avisos ou erros na saída do console e WASPreUpgrade nos registros.
  Após a conclusão do WASPreUpgrade comando, verifique a saída do console paraFailed with errorsouCompleted with warningsmensagens. Em seguida, verifique os arquivos de log a seguir em busca de quaisquer avisos ou erros:
  - migration_backup_dir/logs/WASPreMigrationSummary.log
  - WASPreUpgrade.timestamp.log
  - WASPreUpgrade.trace
  Se houver erros, corrija os erros e execute o comando WASPreUpgrade novamente. Verifique se os avisos afetam outras atividades de migração ou tempo de execução na versão 9.0.
  
  Se o comando for concluído com sucesso, não será necessário verificar os logs em busca de erros ou avisos.
Restaure a configuração anterior do agente administrativo executando o WASPostUpgrade comando a partir do novo diretório bin raiz de instalação do WebSphere Application Server.
1. Execute o WASPostUpgrade comando para restaurar a configuração salva do agente administrativo no novo perfil do agente administrativo da versão 9.0.
  Por exemplo:
```
C:\IBM\WebSphere\AppServer90\bin>WASPostUpgrade.bat C:\WAS70AdminAgentbackup -oldProfile 70AdminAgent01 -profileName 90AdminAgent01 
-traceString *=all=enabled -tracefile C:\WAS70AdminAgentbackup\logs\WASPostMigrationSummary.log -username myuser -password mypass
```
2. Revise os avisos ou erros na saída do console e nos logs do WASPostUpgrade.
  Após a conclusão do WASPostUpgrade comando, verifique a saída do console paraFailed with errorsouCompleted with warningsmensagens. Em seguida, verifique os arquivos de log a seguir em busca de quaisquer avisos ou erros:
  - migration_backup_dir/logs/WASPostMigrationSummary.log
  - WASPostUpgrade.target_profile_name.timestamp.log
  - WASPostUpgrade.target_profile_name.trace
  Se houver erros, corrija os erros e execute o comando WASPostUpgrade novamente. Verifique se os avisos afetam outras atividades de migração ou tempo de execução na versão 9.0.
  
  Se o comando for concluído com sucesso, não será necessário verificar os logs em busca de erros ou avisos.
Inicie o agente administrativo da versão 9.0 e certifique-se de que os agentes administrativos da versão 7.0 ou posterior e da versão 9.0 estejam em execução.
1. Altere para o novo diretório de bin perfis de agente administrativo da versão 9.0.
2. Execute o startServer adminagent comando.
3. Verifique o SystemOut.log arquivo em busca de avisos ou erros.
  
  Observação: este tópico faz referência a um ou mais arquivos de log do servidor de aplicativos. Como alternativa recomendada, você pode configurar o servidor para usar a infraestrutura de log e rastreamento HPEL (High Performance Extensible Logging) em vez de usar os SystemOut.log arquivos activity.log , SystemErr.log trace.log, e em sistemas distribuídos e IBM® i. Você também pode usar o HPEL em conjunto com seus recursos nativos de registro do z/OS®. Se estiver usando o HPEL, é possível acessar todas as suas informações de rastreamento e log usando a ferramenta de linha de comandos LogViewer no diretório bin do perfil do servidor. Consulte as informações sobre como usar o HPEL para solucionar problemas em aplicativos para obter mais detalhes sobre o uso do HPEL.
Migre os servidores de aplicativos base gerenciados.
Evite problemas: Para que a migração seja bem-sucedida:
- Os servidores de aplicativos base gerenciados devem estar localizados na mesma máquina que o agente administrativo associado.
- Os nomes dos nós devem ser os mesmos na versão 9.0 e nas versões anteriores.
- Desligue o servidor do AppSrv antes de executar uma migração, caso utilize uma plataforma Windows e pretenda migrar um componente SIB.
Para cada servidor de aplicativos base gerenciado que você planeja migrar para a versão 9.0, execute as seguintes etapas:
1. Crie o perfil do servidor de aplicativos base de destino. Execute o manageprofiles comando com os parâmetros apropriados para criar um novo perfil gerenciado.
  Por exemplo:
```
C:\WebSphere\AppServer90\bin>manageprofiles.bat -create -profileName 90AppSrv01 
-profilePath C:\WebSphere\AppServer90\profiles\AppSrv01
-templatePath C:\WebSphere\AppServer90\profileTemplates\default 
-serverType APPLICATION_SERVER -nodeName AppSrv01Node01 
-cellName AppSrv01Cell01 -hostName mynode1host.company.com
```
2. Execute o WASPreUpgrade comando para salvar as informações atuais do servidor de aplicativos base gerenciado em um diretório de backup de migração. Escolha um novo diretório para os arquivos de backup.
  Por exemplo:
```
C:\WebSphere\AppServer90\bin>WASPreUpgrade.bat C:\WAS70Appserver01backup 
C:\WebSphere\AppServer70 -oldProfile 70AppSrv01 -traceString *=all=enabled 
-summaryLogName C:\WAS70Appserver01backup\logs\WASPreMigrationSummary.log
```
3. Verifique os avisos ou erros na saída do console e WASPreUpgrade nos registros.
  Após a conclusão do WASPreUpgrade comando, verifique a saída do console paraFailed with errorsouCompleted with warningsmensagens. Em seguida, verifique os arquivos de log a seguir em busca de quaisquer avisos ou erros:
  - migration_backup_dir/logs/WASPreMigrationSummary.log
  - WASPreUpgrade.timestamp.log
  - WASPreUpgrade.trace
  Se houver erros, corrija os erros e execute o comando WASPreUpgrade novamente. Verifique se os avisos afetam outras atividades de migração ou tempo de execução na versão 9.0.
  
  Se o comando for concluído com sucesso, não será necessário verificar os logs em busca de erros ou avisos.
4. Execute o WASPostUpgrade comando para restaurar a configuração salva do perfil do servidor de aplicativos gerenciado no novo perfil do servidor de aplicativos base da versão 9.0.
  
  Evite problemas: este comando requer parâmetros adicionais e o exemplo a seguir pressupõe que a segurança está ativada em ambos os agentes administrativos.
  Por exemplo:
```
C:\IBM\WebSphere\AppServer90\bin>WASPostUpgrade.bat C:\WAS70Appserver01backup 
-oldProfile 70AppSrv01 -profileName 90AppSrv01 -traceString *=all=enabled 
-summaryLogName C:\WAS70Appserver01backup\logs\WASPostMigrationSummary.log 
-oldAdminAgentProfilePath C:\WebSphere\Appserver70\profiles\70AdminAgent01
-oldAdminAgentHostname myhostname -oldAdminAgentSoapPort 8879 
-oldAdminAgentUsername myusername -oldAdminAgentPassword mypassword 
-newAdminAgentProfilePath C:\WebSphere\AppServer90\profiles\90AdminAgent01 
-newAdminAgentHostname myhostname -newAdminAgentSoapPort 8887 
-newAdminAgentUsername myusername1 -newAdminAgentPassword mypassword1
```
5. Revise os avisos ou erros na saída do console e nos logs do WASPostUpgrade.
  Após a conclusão do WASPostUpgrade comando, verifique a saída do console paraFailed with errorsouCompleted with warningsmensagens. Em seguida, verifique os arquivos de log a seguir em busca de quaisquer avisos ou erros:
  - migration_backup_dir/logs/WASPostMigrationSummary.log
  - WASPostUpgrade.target_profile_name.timestamp.log
  - WASPostUpgrade.target_profile_name.trace
  Se houver erros, corrija os erros e execute o comando WASPostUpgrade novamente. Verifique se os avisos afetam outras atividades de migração ou tempo de execução na versão 9.0.
  
  Se o comando for concluído com sucesso, não será necessário verificar os logs em busca de erros ou avisos.
6. Inicie o servidor de aplicativos gerenciado pela versão migrada 9.0.
7. Verifique se há avisos ou erros no arquivo SystemOut.log do servidor de aplicativos gerenciado 9.0.
  
  Observação: este tópico faz referência a um ou mais arquivos de log do servidor de aplicativos. Como uma alternativa recomendada, é possível configurar o servidor para usar a infraestrutura de rastreio e o log High Performance Extensible Logging (HPEL), em vez de usar os arquivos SystemOut.log, SystemErr.log, trace.log e activity.log nos sistemas distribuídos e IBM i. É possível também utilizar HPEL em conjunto com os recursos de criação de logs z/OS nativos. Se estiver usando o HPEL, é possível acessar todas as suas informações de rastreamento e log usando a ferramenta de linha de comandos LogViewer no diretório bin do perfil do servidor. Consulte as informações sobre como usar o HPEL para solucionar problemas em aplicativos para obter mais detalhes sobre o uso do HPEL.

Resultados

Você migrou um perfil de agente administrativo e seus servidores de aplicativos base gerenciados associados de WebSphere Application ServerVersão 7.0 ou posterior para Versão 9.0 usando as ferramentas de migração. Você pode interromper o agente administrativo da versão 7.0 ou posterior e atribuir as portas da versão 7.0 ou posterior ao agente administrativo da versão 9.0.