![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
Comando WASPostUpgrade
O comando WASPostUpgrade para WebSphere Application Server recupera a configuração salva que foi criada pelo comando WASPreUpgrade a partir do backupDirectory especificado. O script WASPostUpgrade para WebSphere Application Server lê a configuração deste diretório para migrar para WebSphere Application Server Versão 9.0 e inclui todos os aplicativos migrados no diretório app_server_root/installedApps para a instalação do Versão 9.0.
Location

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.
sptcfgO arquivo de comando está localizado no diretório app_server_root/bin e deve ser executado a partir dele.
![[IBM i]](../images/iseries.gif)
Autoridade
Para executar este script de comando, seu perfil do usuário deve ter a autoridade *ALLOBJ.
Sintaxe
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
WASPostUpgrade.sh backupDirectory
[-username userID]
[-password password]
[-oldProfile profile_name]
[-profileName nome_do_perfil]
[-scriptCompatibility true | false]
[-setPorts useOld | generateNew | port_starting_number]
[-resolvePortConflicts incrementCurrent | port_starting_number]
[-backupConfig true | false]
[-includeApps true | false | script]
[-keepDmgrEnabled true | false]
[-requestTimeout seconds]
[-javaoption -Xms...m -javaoption -Xmx...m]
[[-appInstallDirectory user_specified_directory] | [-keepAppDirectory true | false]]
[-traceString trace_spec [-traceFile file_name]]
![[Windows]](../images/windows.gif)
WASPostUpgrade.bat backupDirectory
[-username userID]
[-password password]
[-oldProfile profile_name]
[-profileName nome_do_perfil]
[-scriptCompatibility true | false]
[-setPorts useOld | generateNew | port_starting_number]
[-resolvePortConflicts incrementCurrent | port_starting_number]
[-backupConfig true | false]
[-includeApps true | false | script]
[-keepDmgrEnabled true | false]
[-requestTimeout seconds]
[-javaoption -Xms...m -javaoption -Xmx...m]
[[-appInstallDirectory user_specified_directory] | [-keepAppDirectory true | false]]
[-traceString trace_spec [-traceFile file_name]]
![[IBM i]](../images/iseries.gif)
WASPostUpgrade backupDirectory
[-username userID]
[-password password]
[-profileName nome_do_perfil]
[-scriptCompatibility true | false]
[-setPorts useOld | generateNew | port_starting_number]
[-resolvePortConflicts incrementCurrent | port_starting_number]
[-backupConfig true | false]
[-includeApps true | false | script]
[-keepDmgrEnabled true | false]
[-requestTimeout seconds]
[-javaoption -Xms...m -javaoption -Xmx...m]
[[-appInstallDirectory user_specified_directory] | [-keepAppDirectory true | false]]
[-traceString trace_spec [-traceFile file_name]]
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
WASPostUpgrade.sh backupDirectory
[-oldAdminAgentProfilePath path to old admin agent]
[-oldAdminAgentSoapPort soap port of old admin agent]
[-oldAdminAgentHostname hostname of old admin agent, defaults to localhost ]
[-oldAdminAgentUsername login username for old admin agent, if admin security is enabled ]
[-oldAdminAgentPassword login password for old admin agent, if admin security is enabled ]
[-newAdminAgentProfilePath path to new admin agent ]
[-newAdminAgentSoapPort soap port of new admin agent ]
[-newAdminAgentHostname hostname of new admin agent, defaults to localhost ]
[-newAdminAgentUsername login username for new admin agent, if admin security is enabled ]
[-newAdminAgentPassword login password for new admin agent, if admin security is enabled ]
![[Windows]](../images/windows.gif)
WASPostUpgrade.bat backupDirectory
[-oldAdminAgentProfilePath path to old admin agent]
[-oldAdminAgentSoapPort soap port of old admin agent]
[-oldAdminAgentHostname hostname of old admin agent, defaults to localhost ]
[-oldAdminAgentUsername login username for old admin agent, if admin security is enabled ]
[-oldAdminAgentPassword login password for old admin agent, if admin security is enabled ]
[-newAdminAgentProfilePath path to new admin agent ]
[-newAdminAgentSoapPort soap port of new admin agent ]
[-newAdminAgentHostname hostname of new admin agent, defaults to localhost ]
[-newAdminAgentUsername login username for new admin agent, if admin security is enabled ]
[-newAdminAgentPassword login password for new admin agent, if admin security is enabled ]
![[IBM i]](../images/iseries.gif)
WASPostUpgrade backupDirectory
[-oldAdminAgentProfilePath path to old admin agent]
[-oldAdminAgentSoapPort soap port of old admin agent]
[-oldAdminAgentHostname hostname of old admin agent, defaults to localhost ]
[-oldAdminAgentUsername login username for old admin agent, if admin security is enabled ]
[-oldAdminAgentPassword login password for old admin agent, if admin security is enabled ]
[-newAdminAgentProfilePath path to new admin agent ]
[-newAdminAgentSoapPort soap port of new admin agent ]
[-newAdminAgentHostname hostname of new admin agent, defaults to localhost ]
[-newAdminAgentUsername login username for new admin agent, if admin security is enabled ]
[-newAdminAgentPassword login password for new admin agent, if admin security is enabled ]
Executar Como
O comando possui os parâmetros a seguir:
- Este é um parâmetro obrigatório. O valor backupDirectory especifica o nome do diretório no qual a ferramenta WASPreUpgrade armazena a configuração e os arquivos salvos e a partir do qual a ferramenta WASPostUpgrade lê a configuração e os arquivos.
- Este é um parâmetro opcional. O valor userID especifica o nome do usuário administrativo da instalação atual do WebSphere Application Server Versão 7.0 ou posterior. Este é um parâmetro necessário se as condições a seguir são verdadeiras:
- Este é um parâmetro opcional. O valor password especifica a senha para o nome do usuário administrativo da instalação atual do WebSphere Application Server Versão 7.0 ou posterior.Este é um parâmetro necessário se as condições a seguir são verdadeiras:
Dica: Quando é necessário especificar uma senha no Assistente de Migração ou quando você usa o comando WASPostUpgrade com o parâmetro -password na linha de comandos, é possível digitar a senha em texto simples ou usar o valor xor-ciphered. Para usar o valor cifrado por xor, digite a cifra inteira, incluindo o prefixo {xor} como o valor para o parâmetro. Este valor cifrado por xor pode ser especificado em qualquer um dos vários arquivos de configuração do WebSphere Application Server para sua configuração anterior, incluindo os arquivos soap.client.props, ssl.client.props e security.xml.
Dica: Ao usar o comando WASPostUpgrade com o parâmetro -password na linha de comandos, é possível digitar a senha em texto simples ou usar o valor cifrado por xor. Para usar o valor cifrado por xor, digite a cifra inteira, incluindo o prefixo {xor} como o valor para o parâmetro. Este valor cifrado por xor pode ser especificado em qualquer um dos vários arquivoss de configuração do WebSphere Application Server para sua configuração anterior, incluindo os arquivos soap.client.props, ssl.client.props e security.xml.
Este é um parâmetro opcional para migrar instâncias ou perfis de várias versões do WebSphere Application Server. A instância ou perfil já deve existir no diretório de backup de migração antes de executar este comando.
Se o parâmetro -oldProfile não for especificado, o perfil padrão será usado. Se nenhum perfil padrão for localizado, o sistema relatará um erro.Evitar Problemas: Se você não especificar o nome do perfil específico em -oldProfile, qualquer perfil "padrão" designado será migrado. Pode ser necessário migrar cada perfil no backup obtido em pré-migração, usando o comando pós-migração WASPostUpgrade especificando os parâmetros -oldProfile e -profileName para cada e todo perfil que o cliente deseja no novo ambiente do Versão 9.0. Se o perfil antigo contiver aplicativos instalados (installedApps) além do aplicativo de amostra e dos aplicativos de sistema, o processo de migração migrará automaticamente esses aplicativos.gotcha
- Este é um parâmetro opcional para migrar para perfis específicos
no WebSphere Application Server Versão 9.0. O valor profile_name especifica
o nome do perfil do Versão 9.0
para o qual o script migra sua configuração. Você já deve ter
criado este perfil antes de chamar o comando WASPostUpgrade. Se o parâmetro -profileName não for especificado, o perfil padrão será usado. Se nenhum perfil padrão for localizado, o sistema relatará um erro.
Evitar Problemas: Se você não especificar o nome do perfil específico em -profileName, qualquer perfil "padrão" designado será migrado. Pode ser necessário migrar cada perfil no backup obtido na pré-migração, usando o comando pós-migração WASPostUpgrade especificando os parâmetros -oldProfile e -profileName para cada e todo perfil que o cliente deseja no novo ambiente. Se o perfil antigo contiver aplicativos instalados (installedApps) além do aplicativo de amostra e dos aplicativos de sistema, o processo de migração migrará automaticamente esses aplicativos.gotcha
Nota: Ao migrar um servidor de aplicativos independente a partir do Versão 9.0, é possível escolher um nó do servidor de aplicativos independente que já foi registrado com um agente administrativo como o destino da migração. - Este é um parâmetro opcional usado para especificar se a migração deve
ou não criar as definições de configuração da versão 7.x a seguir: em vez das definições de configuração do Versão 9.0 a seguir:
O valor padrão é true.
Especifique true para este parâmetro para minimizar o impacto nos scripts de administração existentes. Se você tiver scripts ou programas wsadmin existentes que usam APIs de configuração de terceiro para criar ou modificar as definições de configuração da versão 7.x, por exemplo, talvez deseje especificar true para esta opção durante a migração.
Se desejar usar uma célula que contém nós da Versão 7.x, você deverá especificar true para esta variável.
Nota: Isto destina-se a fornecer uma transição temporária até todos os nós no ambiente estarem no nível de Versão 9.0. Quando todos eles estiverem no nível do Versão 9.0, modifique os scripts de administração para usar todas as configurações do Versão 9.0. - Este é um parâmetro opcional usado para especificar se a configuração do WebSphere Application Server Versão 9.0 existente é
salva antes de quaisquer mudanças serem feitas pela ferramenta WASPostUpgrade.
O padrão é true — ou seja,
usar o comando backupConfig para salvar uma cópia
da configuração atual no diretório profile_name/temp.
Use o comando restoreConfig para restaurar essa configuração conforme necessário. Para obter informações adicionais, consulte Comando restoreConfig.
- Este é um parâmetro opcional que especifica como configurar as portas para o novo perfil. O parâmetro utiliza os valores a seguir:
Se um valor for especificado para este parâmetro, qualquer nova porta que seja designada será configurada com base neste valor. Toda vez que um novo valor de porta for necessário, a porta será criada com base neste valor e o valor inicial será incrementado para o próximo uso. Nenhuma porta duplicada será designada.
- Este parâmetro opcional é usado para especificar como mapear valores de porta. Quando uma porta não puder ser usada, seu valor será incrementado a partir de um valor inicial, até que uma porta disponível seja localizada.
- É possível incluir aplicativos, ativos e unidades de composição
no nível de negócios como parte da migração. É possível, opcionalmente, migrar estes itens
usando o parâmetro -IncludeApps no comando WASPostUpgrade.
Este é um parâmetro opcional que pode ser especificado das seguintes
maneiras:
Os aplicativos de sistema do WebSphere Application Server são migrados independentemente do valor configurado por este parâmetro.
- Este é um parâmetro opcional usado para especificar se o gerenciador de implementação do existente do WebSphere Application Server Versão 7.0 ou posterior deve ser desativado. O padrão é falso.
Se esse parâmetro for especificado como verdadeiro, será possível usar o gerenciador de implementação existente do Versão 7.0 ou posterior enquanto a migração é concluída. Ele é válido apenas quando estiver migrando um gerenciador de implementação; ele é ignorado em todas as outras migrações.
Cuidado: Use este parâmetro com cautela. - Este é um parâmetro opcional usado para especificar se deve instalar
todos os aplicativos para os mesmos diretórios nos quais eles estão
localizados atualmente. O padrão é falso.
Se este parâmetro for especificado como true, cada aplicativo individual reterá seu local.
Se especificar esse parâmetro, não é possível especificar o parâmetro -appInstallDirectory.
Restrições: Se esse parâmetro for especificado como verdadeiro, o local será compartilhado pela instalação existente do WebSphere Application Server Versão 7.0 ou posterior e a instalação do Versão 9.0. Se você mantiver os aplicativos migrados nos mesmos locais que aqueles da versão anterior, as restrições a seguir se aplicarão: - Este é um parâmetro opcional que é usado para transmitir o nome de
diretório para uso ao instalar todos os aplicativos durante a migração. O
padrão de profile_name\installedApps é
usado se este parâmetro não é especificado.
Se você especificar este parâmetro, não poderá especificar o parâmetro -keepAppDirectory.
Aspas devem ser usadas ao redor do nome de diretório se houver um ou mais espaços no nome.
Se usar este parâmetro, as ferramentas de migração investigarão as variáveis no nível do nó para obter o nó que está sendo migrado no diretório de backup (variáveis para a liberação antiga) e no perfil de destino (variáveis da nova liberação). Se o caminho fizer parte de qualquer uma das variáveis a seguir em qualquer uma destas liberações, as ferramentas reduzirão as informações de caminho para usar a variável relacionada:
Exemplo:MIGR0341W: Diretório de instalação do aplicativo foi atualizado para {0}.
ouMIGR0341W: Diretório de instalação do aplicativo foi atualizado para ${USER_INSTALL_ROOT}\customAppDirectory.
MIGR0341W: Diretório de instalação do aplicativo foi atualizado para ${APP_INSTALL_ROOT}\ cellName\customAppDirectory\.
- 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 seconds se refere ao número de segundo que a migração esperará antes de falhar para conexões de wsadmin tentadas.
Este valor também é usado como o parâmetro de tempo limite durante a migração do aplicativo.
- Este é um parâmetro opcional. O valor path to old admin agent se refere ao caminho do sistema de arquivos do diretório de perfil do agente administrativo original.
Este parâmetro é necessário apenas se o servidor de aplicativos que está sendo migrado for gerenciado pelo agente administrativo.
- Este é um parâmetro opcional. O valor soap port of old admin agent se refere à porta SOAP usada pelo agente administrativo original para conexões administrativas.
Este parâmetro é requerido apenas se o servidor de aplicativos que está sendo migrado for gerenciado por um agente administrativo.
- Este é um parâmetro opcional. O valor hostname of old admin agent se refere ao local do nome do host do agente administrativo original. Se o parâmetro não for especificado, o valor é configurado por padrão para "localhost".
Este parâmetro é requerido apenas se o servidor de aplicativos que está sendo migrado for gerenciado por um agente administrativo.
- Este é um parâmetro opcional. O valor login username for old admin agent se refere ao nome de usuário para o agente administrativo original.
Este parâmetro é necessário apenas se o servidor de aplicativo que está sendo migrado for gerenciado por um agente administrativo que tenha segurança administrativa ativada.
- Este é um parâmetro opcional. O valor path to new admin agent se refere ao caminho do sistema de arquivos para o Agente Administrativo recém-migrado.
Este parâmetro é requerido apenas se o servidor de aplicativos que está sendo migrado for gerenciado por um agente administrativo.
- Este é um parâmetro opcional. O valor soap port of old admin agent se refere à porta SOAP usada pelo Agente Administrativo recém-migrado para conexões administrativas.
Este parâmetro é requerido apenas se o servidor de aplicativos que está sendo migrado for gerenciado por um agente administrativo.
- Este é um parâmetro opcional. O valor hostname of old admin agent se refere ao local do nome do host do novo Agente Administrativo. Se o parâmetro não for especificado, o valor é configurado por padrão para "localhost".
Este parâmetro é requerido apenas se o servidor de aplicativos que está sendo migrado for gerenciado por um agente administrativo.
- Este é um parâmetro opcional. O valor login username for old admin agent se refere ao nome do usuário para o novo Agente Administrativo.
Este parâmetro é necessário apenas se o servidor de aplicativo que está sendo migrado for gerenciado por um agente administrativo que tenha segurança administrativa ativada.
- Este é um parâmetro opcional. O valor login password for old admin agent se refere ao nome do usuário para o novo Agente Administrativo.
Este parâmetro é necessário apenas se o servidor de aplicativo que está sendo migrado for gerenciado por um agente administrativo que tenha segurança administrativa ativada.
- Este é um parâmetro opcional. Use este parâmetro para especificar os tamalhos de memória para o heap Java usado pelo WASPostUpgrade.
O valor "-Xms...m" especifica o tamanho de heap inicial. Substitua o "..." pelo tamanho em megabytes que necessita. Por exemplo, se o tamanho de heap inicial é para ser 128 MB, especifique o parâmetro como: -javaoption -Xms128m
O valor "-Xmx...m" especifica o tamanho de heap máximo. Substitua o "..." pelo tamanho em megabytes que necessita. Por exemplo, se o tamanho de heap máximo é para ser 1024 MB, especifique o parâmetro como: -javaoption -Xmx1024m
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Criação de Log
A ferramenta WASPostUpgrade exibe o status na tela durante a execução. Esta ferramenta também salva um conjunto mais extensivo de informações de criação de log no arquivo WASPostUpgrade.time_stamp.log localizado no diretório backupDirectory/logs. É possível visualizar o arquivo WASPostUpgrade.time_stamp.log com um editor de texto.
Considerações de Segurança
O sistema de destino deve ter a segurança desativada antes da migração. Se você migrar de uma configuração de origem que possui a segurança ativada, o comando WASPostUpgrade ativará automaticamente a segurança para a configuração de destino do Versão 9.0 durante a migração.
Arquivo java.security
Durante WASPostUpgrade, uma cópia do arquivo java.security é feita na instalação do WAS de destino antes de migrar o arquivo. A presença desta cópia, denominada java.security.premigration, indica para migrações futuras que o arquivo já foi migrado. Além disso, a cópia fornece uma chance de referenciar as configurações da Versão 8.0 padrão e determinar se você deseja fazer mudanças no arquivo java.security migrado.
?security.provider.* - inclua um prefixo na lista do provedor de origem antes da lista do provedor de destino e renumere a lista do provedor de destino, removendo duplicatas. Além disso, assegure que o provedor de segurança com.ibm.crypto.pkcs11impl.provider.IBMPKCS11Impl seja colocado antes do provedor de segurança com.ibm.crypto.provider.IBMJCE na ordem de preferência se ambos estiverem presentes no arquivo migrado.
?networkaddress.cache.ttl
?networkaddress.cache.negative.ttl
?ocsp.enable
?ocsp.responderURL
?ocsp.responderCertSubjectName
?ocsp.responderCertIssuerName
?ocsp.responderCertSerialNumber
Se o perfil de origem estiver configurado para usar a JVM clássica, o arquivo java.security não será migrado. Isto ocorre porque a Versão 8.0 suporta apenas a JVM j9 e o conteúdo do arquivo java.security não é compatível entre as JVM clássica e j9.
- Se o comando WASPreUpgrade for executado com a opção machineChange=true, os sistemas operacionais de origem e destino serão verificados antes de migrar o arquivo java.security. Se o sistema operacional de origem for HP ou Sun, e o sistema operacional de destino não for o mesmo, o arquivo não será migrado. Se o sistema operacional de destino for HP ou Sun, e o sistema operacional de origem não for o mesmo, o arquivo não será migrado. Isto ocorre porque o conteúdo do arquivo java.security não é compatível entre os diferentes sistemas operacionais.
- Se a cópia do arquivo java.security para java.security.premigration não puder ser feita, o arquivo não será migrado.
- Se o arquivo java.security não for gravável, ele não será migrado.
- Se o arquivo java.security não for localizado no diretório de backup, o arquivo não será migrado. Se você usar um diretório de backup antigo, ou se houver um problema com a instalação antiga, este problema poderá ocorrer.