WebSphere Enterprise Service Bus, Versão 6.2.0 Sistemas Operacionais: AIX, HP-UX, i5/OS, Linux, Solaris, Windows


Utilitário de Linha de Comandos WBIPostUpgrade

Utilize o comando WBIPostUpgrade para WebSphere ESB para recuperar a configuração do perfil que foi salva pelo comando WBIPreUpgrade no backupDirectory que você especificou.

For i5/OS operating system Importante: O i5/OS será suportado apenas se você estiver migrando da versão 6.1.x para a versão 6.2.
Nota: Se estiver migrando em uma plataforma i5/OS, o nome do perfil de destino deve corresponder com o nome do perfil de origem que está sendo migrado.

Detalhes

O script WBIPostUpgrade para WebSphere ESB lê a configuração a partir do backupDirectory para migrar para WebSphere ESB versão 6.2 e inclui todos os aplicativos migrados para o diretório profile_root/installedApps para a nova instalação do WebSphere ESB.

Local

O arquivo de comando está localizado e deve ser executado no diretório install_root/bin.

Sintaxe

A sintaxe é a seguinte:

For i5/OS operating system
WBIPostUpgrade backupDirectory
                     [-username userID]
                     [-password password]
                     [-scriptCompatibility true | false]
                     [-portBlock número_inicial_de_porta]
                     [-backupConfig true | false]
                     [-replacePorts true | false]
                     [-keepDmgrEnabled true | false]
                     [-keepAppDirectory true | false]
                     [-appInstallDirectory user_specified_directory]
                     [-traceString trace_spec [-traceFile file_name]]
                     [-createTargetProfile]	
Nota: O parâmetro -profileName não é suportado na plataforma i5/OS. Se ele for utilizado, será lançada uma exceção de parâmetro inválido.

For Linux operating systemFor UNIX operating system
WBIPostUpgrade.sh backupDirectory
                     [-username userID]
                     [-password password]
                     [-oldProfile profile_name]
                     [-profileName profile_name]
                     [-scriptCompatibility true | false]
                     [-portBlock número_inicial_de_porta]
                     [-backupConfig true | false]
                     [-replacePorts true | false]
                     [-keepAppDirectory true | false]
                     [-keepDmgrEnabled true | false]
                     [-appInstallDirectory user_specified_directory]
                     [-traceString trace_spec [-traceFile file_name]]
                     [-createTargetProfile]

For Windows operating system
WBIPostUpgrade.bat backupDirectory
                     [-username userID]
                     [-password password]
                     [-oldProfile profile_name]
                     [-profileName profile_name]
                     [-scriptCompatibility true | false]
                     [-portBlock número_inicial_de_porta]
                     [-backupConfig true | false]
                     [-replacePorts true | false]
                     [-keepAppDirectory true | false]
                     [-keepDmgrEnabled true | false]
                     [-appInstallDirectory user_specified_directory]
                     [-traceString trace_spec [-traceFile file_name]]
                     [-createTargetProfile]
Nota: O parâmetro -oldProfile deve preceder o parâmetro -profileName (novo perfil).

Parâmetros

Os parâmetros são os seguintes:

backupDirectory
Este é um parâmetro obrigatório. O valor backupDirectory especifica o caminho do diretório de backup no qual a ferramenta WBIPreUpgrade armazenou a configuração salva e os arquivos e a partir do qual a ferramenta WBIPostUpgrade lê a configuração e os arquivos.
-username
Este é um parâmetro opcional que será necessário se a segurança administrativa estiver configurada na versão anterior do WebSphere ESB. O valor userID especifica o nome de usuário administrativo da instalação atual do WebSphere ESB (antes da migração).
-password
Este é um parâmetro opcional que será necessário se a segurança administrativa estiver configurada na versão anterior do WebSphere ESB. O valor password especifica a senha para o nome de usuário administrativo da instalação atual do WebSphere ESB (antes da migração).
-oldProfile
Restrição: Este parâmetro não está disponível em plataformas i5/OS.
Esse é um parâmetro opcional para migrar as instâncias ou perfis das versões anteriores. A instância ou o perfil já deve existir no diretório de backup de migração antes de executar esse comando.

Se o parâmetro -oldProfile não for especificado, será utilizado o perfil padrão. Se nenhum perfil padrão for localizado, o sistema relatará um erro.

-profileName
For UNIX operating systemFor Linux operating systemFor Windows operating system
Nota: Este parâmetro não é suportado na plataforma i5/OS. Se for utilizado será lançada uma exceção de parâmetro inválido.
Esse é um parâmetro opcional para migração para perfis específicos. O valor profile_name especifica o nome do perfil, já criado na versão mais recente do WebSphere ESB, para o qual o script migra sua configuração. Você já deve ter criado esse perfil antes de chamar o comando WBIPostUpgrade.

Se o parâmetro -profileName não for especificado, será utilizado o perfil padrão. Se nenhum perfil padrão for localizado, o sistema relatará um erro.

Nota: Para assegurar que o perfil correto seja migrado, especifique o nome do perfil utilizando este parâmetro e não considere o padrão.
-scriptCompatibility
Nota: Este parâmetro é ignorado para migração do WebSphere ESB versão 6.1.x para versão 6.2.
Esse é um parâmetro opcional usado para especificar se a migração deve criar as seguintes definições de configuração versão 6.0.2.x:
  • Transporte
  • ProcessDef
  • SSL para 6.0.2
em vez de as seguintes definições de configuração da versão 6.2:
  • Canais
  • ProcessDefs
  • SSL para versão 6.2

O padrão é true.

Especifique true para este parâmetro para minimizar impactos em scripts de administração existentes. Se você tiver scripts ou programas wsadmin existentes que utilizam APIs de configuração de terceiros para criar ou modificar as definições de configuração da versão 6.0.2.x, por exemplo, poderá desejar especificar true para essa opção durante a migração.

Nota: Isso é temporário, até que todos os nós no ambiente estejam no nível versão 6.2. Quando eles estiverem no novo nível, você deve executar as seguintes ações:
  1. Modifique seus scripts de administração para utilizar todas as configurações do versão 6.2.
  2. Utilize o comando convertScriptCompatability para converter suas configurações para corresponder a todas as configurações do versão 6.2.

    Para obter informações adicionais, consulte o Comando convertScriptCompatibility.

-portBlock
Este é um parâmetro opcional. O valor port_starting_number especifica o primeiro de um bloco de números de portas consecutivas a serem designadas quando o script de comando é executado.
-replacePorts
Esse parâmetro opcional é utilizado para especificar como mapear valores de porta para hosts virtuais e portas de transporte de contêiner de Web.
  • False
    Não substitua as definições de porta da versão 6.0.x ou 6.1.x durante a migração.
    • A configuração da versão anterior é deixada sozinha – nenhum canal é excluído.
    • Os quatro canais nomeados a seguir são configurados com valores equivalentes aos configurados para o release anterior:
      • WC_adminhost
      • WC_defaulthost
      • WC_adminhost_secure
      • WC_defaulthost_secure
    • O processo de migração cria transportes ou canais, com base na configuração -scriptCompatibility, para quaisquer portas no release anterior.
    • O processo de migração configura todas as portas que não são de contêiner de Web com os valores configurados para o release anterior.
    • Conflitos de porta podem surgir se o processo de migração criar um transporte ou canal que seja igual ao definido no contêiner de Web.

    Esse é o padrão.

  • True

    Substitua todas as configurações de porta do alias do host virtual durante a migração com definições de porta do versão 6.2.

    Por padrão, o processo de migração inclui dados de configuração do ambiente anterior nos dados no novo ambiente do WebSphere ESB. Em alguns casos, no entanto, isso pode não ser um comportamento desejado para esses valores de porta. Por exemplo, definições de porta existentes do release anterior podem ter sido cuidadosamente configuradas para evitar conflitos de porta com outros produtos; em tais casos, é provável que você quisesse migrar essas configurações para a configuração da nova versão. Especifique true para esse parâmetro para que quaisquer portas de hosts virtuais correspondentes sejam removidas da configuração da versão mais recente antes de novos valores serem incluídos.
    • Todos os canais de transporte associados com o contêiner de Web são excluídos, exceto os quatro canais nomeados a seguir, que são configurados com valores equivalentes aos configurados para o release anterior:
      • WC_adminhost
      • WC_defaulthost
      • WC_adminhost_secure
      • WC_defaulthost_secure
    • O processo de migração cria transportes ou canais, com base na configuração -scriptCompatibility, para quaisquer portas no release anterior.
    • O processo de migração configura todas as portas que não são de contêiner de Web com os valores configurados para o release anterior.
-keepAppDirectory
Nota: Este parâmetro é ignorado para migração do WebSphere ESB versão 6.1 para a versão 6.2.
Esse é um parâmetro opcional utilizado para especificar se irá instalar todos os aplicativos nos mesmos diretórios em que eles estão atualmente localizados. O padrão é falso.

Se esse parâmetro for especificado como true, cada aplicativo individual manterá seu local.

Restrições: Se esse parâmetro tiver especificado como true, o local será compartilhado pela instalação nova e pela existente do WebSphere ESB. Se você mantiver os aplicativos migrados nos mesmos locais que os da versão anterior, as seguintes restrições se aplicam:
  • As limitações de suporte a nós mistos da versão 6.2 devem ser obedecidas. Isso significa que o seguinte suporte não pode ser utilizado ao chamar o comando wsadmin:
    • Pré-compilar JSP
    • Utilizar Configuração Binária
    • Implementar EJB
  • Você arrisca perder os aplicativos migrados de forma não-intencional se posteriormente excluir os aplicativos desses locais ao administrar (desinstalar, por exemplo) a instalação existente.
-keepDmgrEnabled
Nota: Este parâmetro é ignorado para migração do WebSphere ESB versão 6.1 para a versão 6.2.
Esse é um parâmetro opcional utilizado para especificar se é necessário desativar o gerenciador de implementação existente do WebSphere ESB. O padrão é falso.

Se esse parâmetro for especificado como true, você pode utilizar o gerenciador de implementação existente enquanto a migração é concluída. Ele será válido apenas quando você estiver migrando um gerenciador de implementação; ele será ignorado em todas as outras migrações

Cuidado: Utilize esse parâmetro com cuidado.
  • Geralmente, as configurações existentes do gerenciador de implementação do WebSphere ESB são interrompidas e desativadas para impedir que vários gerenciadores de implementação gerenciem os mesmos nós. Você deve parar o gerenciador de implementação existente antes de começar a utilizar o gerenciador de implementação da versão nova. As condições de erro que mais provavelmente ocorrerão, se isso não for feito, serão conflitos de portas quando a segunda instância do gerenciador de implementação for iniciada.
  • Especificar true para esse parâmetro significa que todas as alterações de configuração feitas na configuração antiga durante a migração poderão não ser migradas.
-appInstallDirectory
Nota: Este parâmetro é ignorado para migração do WebSphere ESB versão 6.1 para a versão 6.2.
Esse é um parâmetro opcional utilizado para transmitir o nome do diretório a ser utilizado ao instalar todos os aplicativos durante a migração. O padrão de profile_name\installedApps será utilizado se esse parâmetro não for especificado.

Aspas devem ser utilizadas no nome de diretório se um ou mais espaços em branco estiverem no nome.

Dica: Você pode incluir a variável ${USER_INSTALL_ROOT} em seu argumento. Esta variável se expande para <WPS HOME>\profiles\<profile name>. Por exemplo, se o WebSphere ESB, versão 6.2 estiver instalado em C:\wps\ e o perfil de destino for ProcSrv01, ${USER_INSTALL_ROOT} representará C:\wps62\profiles\ProcSrv01.
-traceString
Nota: Este parâmetro é ignorado para a migração do WebSphere ESB versão 6.0.2.xpara o versão 6.2.
Este é um parâmetro opcional. O valor trace_spec especifica as informações de rastreio que você deseja coletar.

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

Importante: Se você especificar este parâmetro, também deverá especificar o parâmetro -traceFile. Se você especificar o parâmetro -traceString mas não especificar o parâmetro -traceFile, o comando criará um arquivo de rastreio por padrão e o colocará no diretório backupDirectory/logs.
-traceFile
Nota: Este parâmetro é ignorado para a migração do WebSphere ESB versão 6.0.2.xpara o versão 6.2.
Este é um parâmetro opcional. O valor file_name especifica o nome do arquivo de saída para informações de rastreio.
Importante: Se você especificar este parâmetro, também deverá especificar o parâmetro -traceString. Se você especificar o parâmetro -traceFile mas não especificar o parâmetro -traceString, o comando utilizará a profundidade de rastreio padrão e armazenará o arquivo de rastreio no local especificado.
-createTargetProfile

Esse parâmetro opcional cria um novo perfil com as definições de configuração corretas para fins de migração.

Criação de Log

O comando WBIPostUpgrade exibe o status na tela durante sua execução. Este comando também salva um conjunto mais extensivo de informações sobre criação de log no arquivo WBIPostUpgrade.timestamp.log localizado no diretório backupDirectory/logs. Você pode visualizar o arquivo WBIPostUpgrade.profileNametimestamp.log com um editor de texto.


reference Tópico de Referência

Termos de Uso | Feedback


Ícone de registro de data e hora Última Atualização: 01 julho 2010


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/doc/rmig_wbipostupgrade.html
Copyright IBM Corporation 2005, 2010. Todos os Direitos Reservados.
Este Centro de Informações foi desenvolvido com tecnologia Eclipse (http://www.eclipse.org).