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

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]
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


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:
- Modifique seus scripts de administração para utilizar todas as
configurações do
versão 6.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.
- -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.