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.

Autoridade

Para executar este script de comando, seu perfil do usuário deve ter a autoridade *ALLOBJ.

Sintaxe

WASPreUpgrade backupDirectory 
              currentWebSphereDirectory
              [-traceString trace_spec [-traceFile file_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 da instância ou do diretório-raiz de perfil para o perfil da instância atual do WebSphere Application Server Versão 7.0 que você deseja migrar.
  • Na Versão 7.0, a raiz do perfil pode ser um valor exclusivo escolhido durante a criação de perfil, mas os diretórios a seguir são os padrões:
    • Para a Versão 7.0 (base): /QIBM/UserData/WebSphere/AppServer/V7/Base/profiles/profile
    • Para a Versão 7.0 WebSphere Application Server, Network Deployment: /QIBM/UserData/WebSphere/AppServer/V7/ND/profiles/profile
-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.

-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.
  • 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-iseries&topic=rmig_WASPreUpgrade
Nome do arquivo: rmig_WASPreUpgrade.html