Comando WASPreUpgrade

O comando WASPreUpgrade para WebSphere Application Server Versão 9.0 salva a configuração de uma versão instalada anteriormente do WebSphere Application Server em um diretório de backup específico da migração.

Location

O arquivo de comando está localizado no diretório Versão 9.0 app_server_root/bin e deve ser executado a partir dele.

Sintaxe

[AIX][HP-UX][Linux][Solaris]
WASPreUpgrade.sh backupDirectory 
                 currentWebSphereDirectory
                 [-traceString trace_spec [-traceFile file_name]]
                 [-machineChange true | false]
                 [-oldProfile profile_name]
                 [-workspaceRoot profile1=user_workspace_folder_name_1;profile2=user_workspace_folder_name_2]
                 [-username < user name >]
                 [-password < password >]
                 [-javaoption < -Xms...m > -javaoption < -Xmx...m > ]
                 [-requireEmbeddedDBMigration true | false]
                 [-keepDmgrEnabled true | false]
[Windows]
WASPreUpgrade.bat backupDirectory 
                  currentWebSphereDirectory
                  [-traceString trace_spec [-traceFile file_name]]
                  [-machineChange true | false]
                  [-oldProfile profile_name]
                  [-workspaceRoot profile1=user_workspace_folder_name_1;profile2=user_workspace_folder_name_2]
                  [-username < user name >]
                  [-password < password >]
                  [-javaoption < -Xms...m > -javaoption < -Xmx...m > ]
                  [-requireEmbeddedDBMigration true | false]
                  [-keepDmgrEnabled true | false]

Executar Como

O comando possui os parâmetros a seguir:

backupDirectory
Este é um parâmetro necessário e deve ser o primeiro parâmetro especificado. O valor backupDirectory especifica o nome do diretório no qual o script de comando armazena a configuração salva.
Evitar Problemas Evitar Problemas: Os diretórios raiz WAS_INSTALL e USER_INSTALL são diretórios inválidos para o local do diretório de backup do WebSphere Application Server.gotcha

Este também é o diretório a partir do qual o comando WASPostUpgrade lê a configuração.

Se o diretório não existir, o script de comando WASPreUpgrade o criará.

currentWebSphereDirectory
Este é um parâmetro necessário e deve ser o segundo parâmetro especificado. Esta pode ser qualquer edição do WebSphere Application Server Versão 7.0 para a qual a migração é suportada.

O valor currentWebSphereDirectory especifica o nome do diretório-raiz de instalação para a instalação atual do WebSphere Application Server Versão 7.0.

-traceString
Este é um parâmetro opcional. O valor trace_spec especifica as informações de rastreio que deseja coletar.

Para reunir todas as informações de rastreio, especifique "*=all=enabled" (com aspas).

Se não especificar o parâmetro -traceString ou -traceFile, o comando criará um arquivo de rastreio por padrão e o colocará no diretório backupDirectory/logs.

-traceFile
Este é um parâmetro opcional. O valor file_name especifica o nome do arquivo de saída para informações de rastreio.

Se não especificar o parâmetro -traceString ou -traceFile, o comando criará um arquivo de rastreio por padrão e o colocará no diretório backupDirectory/logs.

-machineChange
Este é um parâmetro opcional usado para uma migração que envolve sistema operacional cruzado e limites da máquina. Se especificado como true, este parâmetro fornecerá suporte para alterar o hardware físico ao migrar fazendo backup de itens que são armazenados fora da instalação do WebSphere Application Server ou da hierarquia de pastas do perfil. Se especificado como false, somente arquivos armazenados sob a pasta de instalação do WebSphere Application Server ou as pastas de perfil serão copiados no diretório de backup durante a migração.

O padrão é false.

Quando este valor é false, a migração assume que as instalações do WebSphere Application Server nova e antiga estão na mesma máquina física com acesso compartilhado ao sistema de arquivos. Portanto, quaisquer arquivos localizados fora dos diretórios do WebSphere são comuns e podem ser compartilhados. A migração não copia arquivos fora da árvore do WebSphere Application Server no diretório de backup quando -machineChange é false. False é a única opção ao usar o Assistente de Migração. Se selecionar -machineChange=false, você deverá executar o comando WASPostUpgrade no mesmo hardware físico.

Se pretende executar o comando WASPostUpgrade em uma máquina ou um sistema de arquivos diferente, você deverá executar o comando WASPreUpgrade com -machineChange=true. Se você selecionar -machineChange=true, a migração criará um subdiretório adicional (/migrated/) no diretório de backup de migração que contém quaisquer arquivos referenciados pela configuração do WebSphere Application Server que residem fora dos diretórios de perfil ou do produto. Ao executar o comando WASPostUpgrade, estes arquivos são retornados para seus caminhos originais na nova máquina.

Considerações de Desempenho:

Se você migrar com barramentos Service Integration Bus (SIB) configurados com repositórios de armazenamento de arquivos do sistema de arquivos, poderá requerer espaço adicional em seu heap de migração e em seu diretório de backup de migração. Cada barramento possui três valores de armazenamento de arquivos — um log, um espaço temporário e um repositório. Estes três arquivos variam em tamanho, mas podem ter no máximo 100 a 500 MB cada. Quando a migração está em execução, ela faz backup de qualquer armazenamento de arquivos que esteja na árvore do WebSphere Application Server durante o processo de pré-upgrade. Precisa haver espaço suficiente no sistema de arquivos para permitir isto. Se já existirem armazenamentos de arquivos no local de destino durante o processo pós-upgrade, a migração fará backup dos armazenamentos de arquivos na memória para suportar o retrocesso.

Se você executar o comando WASPreUpgrade com -machineChange=true, resultando em um diretório de backup que contém objetos de armazenamento de arquivos compartilhados, poderá descobrir que o processo pós-upgrade sofre de exceções de falta de memória porque o heap máximo padrão é muito pequeno para conter os backups de armazenamento de arquivos no suporte do retrocesso. Para resolver este problema, execute uma das três tarefas a seguir:
  • Se os armazenamentos de arquivos no local do sistema forem válidos, exclua as cópias do diretório de backup antes de executar o comando WASPostUpgrade.

    Excluindo o subdiretório /migrated/ inteiro do diretório de backup de migração antes de executar o comando WASPostUpgrade, você converte essencialmente seu backup pré-upgrade de -machineChange=true para -machineChange=false.

  • Se as cópias dos armazenamentos de arquivos no diretório de backup foram válidas, exclua as versões no local de destino.

    Isto altera o suporte de retrocesso para que os arquivos de destino não existam e não ocupem espaço na memória durante a migração.

  • Se requerer o suporte de retrocesso e precisar dos arquivos no diretório de backup bem como dos arquivos no sistema de arquivos, aumente seu tamanho de heap máximo para o processo pós-upgrade para algum valor grande o suficiente para suportar todos os arquivos SIB que estão em conflito.
-oldProfile
Este é um parâmetro opcional usado para migrar uma instância ou um perfil específico de uma versão anterior do WebSphere Application Server.
-workspaceRoot
Este é um parâmetro opcional. O valor user_workspace_folder_name_x especifica o local das configurações de "Minhas Tarefas" customizadas do console administrativo para um ou mais perfis.
-username
Este é um parâmetro opcional. O valor de user name especifica o nome do usuário administrativo da instalação atual do WebSphere Application Server.
Este é um parâmetro necessário se as condições a seguir são verdadeiras:
  • Você está migrando um gerenciador de implementação.
  • A segurança administrativa ou global está ativada na instalação de origem.
  • A instalação do WebSphere Application Server que está sendo migrada é Versão 8.0 ou superior.
-password
Este é um parâmetro opcional. O valor de password especifica a senha administrativa da instalação atual do WebSphere Application Server.
Este é um parâmetro necessário se as condições a seguir são verdadeiras:
  • Você está migrando um gerenciador de implementação.
  • A segurança administrativa ou global está ativada na instalação de origem.
  • A instalação do WebSphere Application Server que está sendo migrada é Versão 8.0 ou superior.
-javaoption
Este é um parâmetro opcional. Use esse parâmetro para especificar tamanhos de memória para o heap Java™ usado pelo comando WASPreUpgrade.

O valor "-Xms...m" é o parâmetro especificado para indicar o tamanho de heap inicial. Substitua o "..." pelo tamanho em Megabytes que você pretende usar. Por exemplo, se o tamanho de heap inicial precisar ser 128 MB, especifique o parâmetro como: -javaoption -Xms128m

O valor "-Xmx...m" é o parâmetro especificado para indicar o tamanho de heap máximo. Substitua o "..." pelo tamanho em Megabytes que você pretende usar. Por exemplo, se o tamanho de heap máximo precisar ser 1024 MB, especifique o parâmetro como: -javaoption -Xmx1024m

-requireEmbeddedDBMigration
Esse é um parâmetro opcional para migrar bancos de dados integrados.

Se o valor for especificado como true, qualquer exceção que ocorra ao migrar os bancos de dados integrados causa a falha do comando WASPreUpgrade. Se o valor for especificado como false, qualquer exceção que ocorra ao migrar os bancos de dados integrados será registrada no arquivo de rastreio e o comando WASPreUpgrade continua.

O valor padrão é true.

-keepDmgrEnabled
Esse é um parâmetro opcional usado para migrar um perfil do gerenciador de implementação Versão 8.0.

Quando WASPreUpgrade for executado, perfis do gerenciador de implementação Versão 8.0 são interrompidos. Por padrão, o gerenciador de implementação permanece parado. Se o valor for especificado para true, WASPreUpgrade inicia o gerenciador de implementação antes que o comando conclua a execução.

O valor padrão é false.

Criação de Log

A ferramenta WASPreUpgrade exibe o status na tela enquanto ela é executada. A ferramenta também salva um conjunto mais extensivo de informações de criação de log no arquivo WASPreUpgrade.time_stamp.log gravado no diretório backupDirectory, em que backupDirectory é o valor especificado para o parâmetro backupDirectory. É possível visualizar o arquivo WASPreUpgrade.time_stamp.log com um editor de texto.

Recursos Migrados

WASPreUpgrade salva todos os seus recursos, mas não migra entidades em seu diretório classes.

A migração salva os arquivos a seguir no diretório backupDirectory.
  • classes
  • config
  • properties

Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=rmig_WASPreUpgrade
Nome do arquivo: rmig_WASPreUpgrade.html