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