![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
Migrando Células Usando as Ferramentas de Linha de Comandos
Antes de Iniciar

Este artigo trata da migração da configuração de perfil. Para migrar seus aplicativos para a versão mais recente, use o Kit de Ferramentas de Migração do WebSphere Application Server. Para obter mais informações, consulte o Kit de ferramentas de migração no WASdev.
sptcfgRevise as informações de planejamento de migração em Coleção de Conhecimento: Planejamento de migração para o WebSphere Application Server.
Este cenário cobre as células de migração no mesmo host. Se pretende migrar células para um host diferente, consulte Migrando Configurações de Células para Novas Máquinas Host Usando a Ferramenta de Linha de Comandos.
Sobre Esta Tarefa
É possível usar as ferramentas de linha de comandos para migrar uma célula de uma versão anterior do WebSphere Application Server para Versão 9.0. A configuração da célula consiste em um gerenciador de implementação com um ou mais nós, um servidor da web e um aplicativo cliente. Todas as portas são migradas em direção à nova configuração. Este procedimento assume que a configuração anterior está em execução.


- WebSphere Extended Deployment Compute Grid ou Feature Pack for Modern Batch
- WebSphere Virtual Enterprise ou Intelligent Management
Procedimento
- Faça backup do gerenciador de implementação e de todos os nós antigos.
No caso de falha durante a migração, salve o gerenciador de implementação e a configuração do nó atual em um arquivo que você pode usar posteriormente para propósitos de recuperação, usando o comando backupConfig. Para obter informações adicionais, consulte Comando backupConfig.
- Altere para o diretório deployment_manager_profile_root/bin.
- Execute o comando backupConfig com os parâmetros apropriados e salve a configuração do perfil atual em um arquivo. Por exemplo:
/opt/WebSphereV70/profiles/v70dmgr01/bin/backupConfig.sh /mybackupdir/v70dmgr01backupBeforeV90migration.zip -username myuser -password mypass -nostop
/QIBM/UserData/WebSphere/AppServer/V7/ND/profiles/v70dmgr01/bin/backupConfig /mybackupdir/ v70dmgr01backupBeforeV90migration.zip -username myuser -password mypass -nostop
- Para cada nó na configuração, altere para o diretório node_profile_root/bin.
- Execute o comando backupConfig com os parâmetros apropriados e salve a configuração do perfil atual em um arquivo. Por exemplo:
/opt/WebSphereV70/profiles/v70node01/bin/backupConfig.sh /mybackupdir/ v70node01backupBeforeV90migration.zip -username myuser -password mypass -nostop
/QIBM/UserData/WebSphere/AppServer/V7/ND/profiles/v70node01/bin/backupConfig /mybackupdir/v70node01rbackupBeforeV90migration.zip -username myuser -password mypass -nostop
- Instale o WebSphere Application Server
Versão 9.0.
- Instale WebSphere Application Server Versão 9.0 em cada host de destino em um novo diretório. Para obter informações adicionais, consulte a documentação de instalação.
- Crie o perfil do gerenciador de implementação de destino.
O perfil de gerenciador de implementação de destino é um novo perfil de gerenciador de implementação que será o destino da migração.
Evitar Problemas: O nodeName e cellName do perfil Versão 9.0 devem corresponder ao nodeName e cellName do Versão 7.0 ou posterior. Se nodeName e cellName do gerenciador de implementação do Versão 9.0 forem diferentes, a migração falhará. gotcha
- Execute o comando manageprofiles com os parâmetros apropriados para criar um novo perfil do gerenciador de implementação. Por exemplo:
/opt/WebSphereV90/bin/manageprofiles.sh -create -profileName v70toV90dmgr01 -templatePath /opt/WebSphereV90/profileTemplates/management -serverType DEPLOYMENT_MANAGER -nodeName currentDmgrNodeName -cellName currentCellName -hostName mydmgrhost.company.com
/QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/manageprofiles -create -profileName currentDmgrProfileName -templatePath /QIBM/ProdData/WebSphere/AppServer/V9/ND/ profileTemplates/management -serverType DEPLOYMENT_MANAGER -nodeName currentDmgrNodeName -cellName currentCellName -hostName mydmgrhost.company.com
- Execute o comando manageprofiles com os parâmetros apropriados para criar um novo perfil do gerenciador de implementação. Por exemplo:
- Salve a configuração do gerenciador de implementação atual no diretório de backup
de migração ao executar o comando WASPreUpgrade a partir do diretório
bin do novo perfil do gerenciador de implementação.
O comando WASPreUpgrade não muda a configuração do Versão 7.0 ou posterior. Para obter mais informações, consulte Comando WASPreUpgrade.
Nota: Se você estiver migrando a partir da Versão 8.0 ou posterior para o Versão 9.0 e seu perfil for um gerenciador de implementação, o perfil da Versão 8.0 é parado ao executar o comando WASPreUpgrade. O gerenciador de implementação é iniciado antes do WASPreUpgrade ser concluído apenas se você fornecer -keepDmgrEnabled true na linha de comandos ou especificar a opçãocorrespondente no assistente de migração.- Execute o comando WASPreUpgrade. Exemplo
/opt/WebSphereV90/bin/WASPreUpgrade.sh /mybackup/v70toV90dmgr01 /opt/WebSphereV70 -oldProfile 70dmgr01
/QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/WASPreUpgrade /mybackup/v70toV90dmgr01 /QIBM/UserData/WebSphere/AppServer/V9/ND/profiles/myCurrentDmgrProfile
- Revise avisos ou erros na saída de console e nos logs de WASPreUpgrade. Após o comando WASPreUpgrade ser concluído, verifique na saída de console se há a ocorrência das mensagens Falhou com erros ou Concluído com avisos. Em seguida, verifique os arquivos de log WASPreUpgrade.old_Profile.timestamp.log e WASPreUpgrade.trace para a ocorrência de quaisquer avisos ou erros. Se houver erros, corrija os erros e execute o comando
WASPreUpgrade novamente. Verifique se os avisos afetam qualquer outra atividade de migração ou de tempo de execução no
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.
- Execute o comando WASPreUpgrade. Exemplo
- Restaure a configuração do gerenciador de implementação anterior que você salvou no
diretório de backup da migração, execute o comando WASPostUpgrade.
Se usar as opções que são mostradas no exemplo a seguir, todas as portas são transferidas, o gerenciador de implementação antigo é encerrado e desativado e todos os aplicativos são instalados.
Para obter mais informações, consulte Comando WASPostUpgrade.
- Execute o comando WASPostUpgrade. Exemplo
/opt/WebSphereV90/bin/WASPostUpgrade.sh /mybackup/v70toV90dmgr01 -profileName v70toV90dmgr01 -oldProfile 70dmgr01 -resolvePortConflicts incrementCurrent -backupConfig TRUE -includeApps TRUE -scriptCompatibility TRUE -keepDmgrEnabled FALSE -username myuser -password mypass
Ao criar perfis, somente um perfil é considerado o perfil padrão por instalação./QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/WASPostUpgrade /mybackup/v70toV90dmgr01 -profileName myCurrentDmgrProfile -oldProfile myCurrentDmgrProfile -resolvePortConflicts incrementCurrent -backupConfig TRUE -includeApps TRUE -scriptCompatibility TRUE -keepDmgrEnabled FALSE -username myuser -password mypass
Se os parâmetros 0-oldProfile ou -profileName não forem especificados, o comando WASPostUpgrade migra o perfil padrão para as instalações de origem e de destino.
É possível identificar os perfis padrão consultando o arquivo profileRegistry.xml no diretório WAS_HOME/properties. A profileRegistry.xml de origem é copiado para o diretório de backup da migração como parte do comando WASPreUpgrade.Evitar Problemas:
- Sempre especifique os parâmetros -oldProfile e -profileName ao executar o comando WASPostUpgrade.
- O sinalizador de compatibilidade do script em seu gerenciador de implementação deve ser igual ao sinalizador usado em seus nós. Salve o valor do sinalizador de compatibilidade do script para uso posterior.
- Revise os avisos ou erros na saída do console e nos logs do
WASPostUpgrade. Após o comando WASPostUpgrade ser concluído, verifique a saída do console para a ocorrência de mensagens Falhou com erros ou Concluído com avisos. Em seguida, verifique os arquivos de log migration_backup_dir/logs/WASPostUpgrade.target_profile_name.timestamp.log e migration_backup_dir/logs/WASPostUpgrade.target_profile_name.trace para a ocorr~encia de quaisquer avisos ou erros. Se houver erros, corrija os erros e execute o comando WASPostUpgrade novamente. Verifique se os avisos afetam qualquer outra atividade de migração ou de tempo de execução no
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.
- Execute o comando WASPostUpgrade. Exemplo
- Faça backup da configuração do gerenciador de implementação do Versão 9.0 em um arquivo ao executar o comando
backupConfig no gerenciador de implementação do Versão 9.0.
Evitar Problemas: Esta é uma etapa importante no plano de migração da célula. Se houver quaisquer falhas de migração de nó, é possível restaurar a configuração da célula para o ponto antes da falha, aplique ações reparatórias e tente a migração do nó novamente.gotcha
- Altere para o diretório deployment_manager_profile_root/bin
- Execute o comando backupConfig com os parâmetros apropriados. Por exemplo:
/opt/WebSphereV90/profiles/v70toV90dmgr01/bin/backupConfig.sh /mybackupdir/ v70toV90dmgr01backupMigratedDmgrOnly.zip -username myuser -password mypass
/QIBM/UserData/WebSphere/AppServer/V9/ND/profiles/myCurrentDmgrProfile/bin/ backupConfig.sh /mybackupdir/v70toV90dmgr01backupMigratedDmgrOnly.zip -username myuser -password mypass
- Inicie o gerenciador de implementação do Versão 9.0.
Assegure que a versão anterior do gerenciador de implementação não esteja em execução.
- Altere para o novo diretório bin do perfil de gerenciador de implementação do Versão 9.0.
- Execute o comando startManager.
- Enquanto o gerenciador de implementação estiver em execução, verifique o arquivo SystemOut.log para avisos ou erros. Nota: Esse tópico faz referência a um ou mais arquivos de log do servidor de aplicativos. Como uma recomendação alternativa, é possível configurar o servidor para usar a infraestrutura de log e rastreio do High Performance Extensible Logging (HPEL) em vez de usar os arquivos SystemOut.log , SystemErr.log, trace.log e activity.log em sistemas distribuídos e IBM® i. Também é possível usar HPEL em conjunção com os recursos de criação de log z/OS nativos. Se você estiver usando HPEL, será possível acessar todas as informações de log e rastreio usando a ferramenta de linha de comandos LogViewer a partir do diretório bin do perfil do servidor. Consulte as informações sobre a utilização do HPEL para resolução de problemas dos aplicativos para obter mais informações sobre o uso do HPEL.
- Verifique todos os logs do servidor de aplicativos e do agente do nó do nó para obter novos avisos ou erros. Se a sincronização automática estiver ativada, permita que o nó seja sincronizado, permita que os aplicativos sejam reiniciados e, em seguida, verifique os logs para novos avisos ou erros.
- Migre os plug-ins para servidores da web.
- Assegure que o gerenciador de implementação do Versão 9.0 esteja em execução.
- Faça upgrade da versão do plug-in do servidor da web que é usado na célula.
- Consulte as informações de apoio que são aplicáveis para seu tipo e sua versão do servidor da web.
- Migre instalações do aplicativo cliente.
Migre recursos do cliente para recursos no nível do Versão 9.0.
- Instale o aplicativo cliente do WebSphere Versão 9.0.
Para obter informações adicionais, consulte a documentação de instalação.
- Execute o
comando Versão 9.0
WASPreUpgrade para salvar as configurações de segurança do aplicativo clientepara um diretório de backup de migração. Exemplo
/opt/AppClientV90/bin/WASPreUpgrade.sh /mybackup/v70clientToV90 /opt/AppClientV70
- Execute o comando Versão 9.0
WASPostUpgrade para restaurar as configurações de segurança do aplicativo
cliente para o novo cliente do Versão 9.0. Exemplo
/opt/AppClientV90/bin/WASPostUpgrade.sh /mybackup/v70clientToV90
- Instale o aplicativo cliente do WebSphere Versão 9.0.
- Migre os nós.
Use as ferramentas de migração para migrar as versões anteriores dos nós na configuração para o Versão 9.0. Execute o procedimento a seguir para cada nó que planeja migrar para o Versão 9.0.
Evitar Problemas: Deve-se usar o mesmo nome de nó de origem, mas um nome de célula temporário diferente para cada nó que você migrou para o Versão 9.0. gotcha
- Assegure que o gerenciador de implementação do Versão 9.0 esteja em execução.
- Crie o perfil do nó de destino. Execute o comando manageprofiles com os parâmetros apropriados para criar um novo perfil gerenciado. Por exemplo:
/opt/WebSphereV90/manageprofiles.sh -create -profileName node1 -templatePath /opt/WebSphereV90/profileTemplates/managed -nodeName currentNode1Name -cellName currentCellName -hostName mynode1host.company.com
/QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/manageprofiles -create -profileName currentNode1Name -templatePath /QIBM/ProdData/WebSphere/AppServer /V9/ND/profileTemplates/managed -nodeName currentNode1Name -cellName currentCellName -hostName mynode1host.company.com
- Execute o comando WASPreUpgrade para salvar as informações de configuração do nó X atual em um diretório de backup de migração. Escolha
um novo diretório para os arquivos de backup. Por exemplo:
/opt/WebSphereV90/bin/WASPreUpgrade.sh /mybackup/v70toV90node1 /opt/WebSphereV70 -oldProfile 70node1
/QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/WASPreUpgrade /mybackup/ v70toV90node1 /QIBM/UserData/WebSphere/AppServer/V7/ND/profiles/currentNode1Name
- Se o comando WASPreUpgrade tiver sido concluído com Sucesso, então, não será necessário verificar os logs para erros ou avisos.
- Verifique a saída de console do WASPreUpgrade para a ocorrência das mensagens a seguir: Falhou com erros ou Concluído com avisos.
- Consulte os logs a seguir para obter avisos ou erros:
- migration_backup_dir/logs/WASPreUpgrade.old_profile.timestamp.log
- migration_backup_dir/logs/WASPreUpgrade.trace
- Pare o agente do nó. Se você tiver nós Versão 7.0 ou posterior em execução durante uma migração para o Versão 9.0, deve-se parar o agente do nó no nó que está sendo migrado. Se não parar o agente do nó, você poderá encontrar problemas de danificação.
- Execute o comando WASPostUpgrade para restaurar a configuração salva do nó X no novo perfil gerenciado do Versão 9.0. Por exemplo:
/opt/WebSphereV90/bin/WASPostUpgrade.sh /mybackup/v70toV90node1 -profileName v70toV90node1 -oldProfile 70node1 -resolvePortConflicts incrementCurrent -backupConfig TRUE -scriptCompatibility TRUE -username myuser -password mypass
/QIBM/ProdData/WebSphere/AppServer/V9/ND/bin/WASPostUpgrade /mybackup/ v70toV90node1 -profileName currentNode1Name -resolvePortConflicts incrementCurrent -backupConfig TRUE -scriptCompatibility TRUE -username myuser -password mypass
Evitar Problemas: O sinalizador de compatibilidade do script em seu gerenciador de implementação deve ser igual ao sinalizador usado em seus nós.gotcha
- Se o comando foi concluído com Sucesso, não é necessário verificar os logs para obter erros ou avisos.
- Verifique a saída de console do WASPostUpgrade em busca das mensagens Falhou com erros ou Concluído com avisos.
- Consulte os logs a seguir para obter erros ou avisos:
- migration_backup_dir/logs/WASPostUpgrade.target_profile.timestamp.log
- migration_backup_dir/logs/WASPostUpgrade.target_profile.trace
Nota: Se o comando WASPostUpgrade falhar, pode ser necessário restaurar o gerenciador de implementação do Versão 9.0 a partir do arquivo backupConfig. Se o processamento de WASPostUpgrade executou o comando syncNode, o gerenciador de implementação está ciente de que o nó X foi migrado. O nó X não pode ser migrado novamente até o gerenciador de implementação ser restaurado para o estado antes da migração do nó X. - Verifique o arquivo SystemOut.log do gerenciador de implementação do Versão 9.0 para avisos ou erros. Nota: Esse tópico faz referência a um ou mais arquivos de log do servidor de aplicativos. Como uma recomendação alternativa, é possível configurar o servidor para usar a infraestrutura de log e rastreio do High Performance Extensible Logging (HPEL) em vez de usar os arquivos SystemOut.log , SystemErr.log, trace.log e activity.log em sistemas distribuídos e IBM i. Também é possível usar HPEL em conjunção com os recursos de criação de log z/OS nativos. Se você estiver usando HPEL, será possível acessar todas as informações de log e rastreio usando a ferramenta de linha de comandos LogViewer a partir do diretório bin do perfil do servidor. Consulte as informações sobre a utilização do HPEL para resolução de problemas dos aplicativos para obter mais informações sobre o uso do HPEL.
- Inicie o agente do nó X Versão 9.0 migrado.
- Verifique o arquivo SystemOut.log do gerenciador de implementação e do nó X do Versão 9.0 para avisos ou erros.
- Sincronize a célula.
- Pare todos os servidores de aplicativos no nó X migrado da Versão 9.0.
- Inicie os servidores de aplicativos apropriados no nó X migrado da Versão 9.0.
- Salve a configuração de perfil do Versão 9.0 em um arquivo executando o comando backupConfig com os parâmetros apropriados. Por exemplo:
/opt/WebSphereV90/profiles/v70toV90node1/bin/backupConfig.sh /mybackupdir/ v70toV90node1.zip -username myuser -password mypass -nostop
Toda vez que você executar o comando backupConfig, use um novo nome de arquivo de backup./QIBM/UserData/WebSphere/AppServer/V9/profiles/v70toV90node1/bin/backupConfig /mybackupdir/v70toV90node1.zip -username myuser -password mypass -nostop
- Salve a configuração do gerenciador de implementação em um arquivo executando o comando
backupConfig com os parâmetros apropriados. Antes de executar o comando, altere para o diretório deployment_manager_profile_root/bin no host do gerenciador de implementação do Versão 9.0.Nota: Para cada nó migrado, faça backup da configuração do gerenciador de implementação do Versão 9.0 para um novo arquivo de backup.Exemplo
/opt/WebSphereV90/profiles/v70toV90dmgr01/bin/backupConfig.sh /mybackupdir/ v70toV90dmgr01backupMigratedDmgrPlusNodeX.zip -username myuser -password mypass
/QIBM/UserData/WebSphere/AppServer/V9/profiles/currentDmgrName/bin/ backupConfig.sh /mybackupdir/v70toV90dmgr01backupMigratedDmgrPlusNodeX.zip -username myuser -password mypass
Nota: Se estiver migrando um nó para um host diferente, consulte as informações sobre a migração de nós em Migrando Configurações de Células para Novas Máquinas Host Usando a Ferramenta de Linha de Comandos.
Resultados
Você migrou de uma versão anterior para o WebSphere Application Server Versão 9.0 usando as ferramentas de migração.


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tmig_migrate_cells_commandline
Nome do arquivo: tmig_migrate_cells_commandline.html