Utilize o comando WBIPreUpgrade
do WebSphere ESB para salvar
a configuração de uma versão do WebSphere ESB instalada
anteriormente em um diretório de backup específico da migração.
Detalhes
O comando WBIPreUpgrade salva os arquivos
selecionados nos diretórios install_root
e profile_root em um
diretório de backup especificado. O padrão para profile_root é profiles/profile_name. Os arquivos copiados
estarão em vários subdiretórios, todos copiados por WBIPreUpgrade para o
diretório de backup especificado. Além disso, é criado um subdiretório logs,
que contém novos arquivos de log correspondentes à instância atual
de execução do comando WBIPreUpgrade.
Dependendo
da versão da qual você está migrando, o comando
WBIPreUpgrade faz backup
de perfis existentes no
WebSphere Enterprise Service Bus
todos de uma vez ou um de cada vez.
- Se estiver migrando da versão 6.0.2.x,
o comando WBIPreUpgrade fará backup de todos os perfis existentes
no WebSphere Enterprise Service Bus
de uma vez.
- Se estiver migrando da versão 6.1.x,
o comando WBIPreUpgrade fará backup dos perfis existentes,
um de cada vez e apenas dos perfis identificados utilizando o parâmetro -profileName.
Restrições
- Se
estiver migrando do versão 6.1.x,
o comando WBIPreUpgrade herdará as seguintes limitações
dos utilitários backupConfig do WebSphere
Application Server Network Deployment, versão 6.1:
- Por padrão, todos os servidores no nó param antes de o backup ser feito para que
as informações sincronizadas parcialmente não sejam salvas.
- É necessário ter propriedade de administrador para desempenhar a migração.
- Em um ambiente UNIX® ou Linux®, o comando backupConfig
não salva a permissão do arquivo ou informações de propriedade.
- Ao restaurar um arquivo, o comando restoreConfig utiliza
o umask e o effective user ID (EUID) atuais para configurar a permissão e propriedade.
- É necessário parar o gerenciador de implementação de origem antes de iniciar a migração. Se você não parar o gerenciador de implementação de origem, o comando WBIPreUpgrade
o parará automaticamente.
Se
você estiver migrando em uma plataforma i5/OS, o nome do perfil de destino deverá
corresponder ao nome do perfil de origem que está sendo migrado.
Se você estiver migrando em uma plataforma i5/OS, o backUpConfig
não salva nenhuma autoridade privada nos arquivos e diretórios que você
possa ter configurado no perfil de origem. Portanto, você deve anotar
qualquer autoridade privada que possa existir nos arquivos e diretórios
sob a árvore de configuração do perfil de origem e, em seguida, deve restaurar
estas autoridades privadas manualmente no perfil de destino após o comando WBIPostUpgrade
ter sido executado e a migração do perfil ser concluída.
Local
O arquivo de comando está localizado no, e deve
ser executado a partir do, diretório install_dir/bin.
Autoridade
Para executar este script de
comando, seu perfil de usuário deve ter a autoridade *ALLOBJ.
Parâmetros
Os parâmetros
são os seguintes:
- 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 e os logs salvos
criados durante WBIPreUpgrade e WBIPostUpgrade.
Este
também é o diretório a partir do qual o comando WBIPostUpgrade
lê a configuração.
Se o diretório não existir, o script de comando WBIPreUpgrade
o criará.
- currentWebSphereDirectory
- Este é um parâmetro necessário e deve ser o segundo parâmetro
especificado. Isto pode ser qualquer edição do WebSphere ESB pela
qual a migração é suportada.

O valor
currentWebSphereDirectory especifica
o nome do diretório raiz do perfil para o perfil do
WebSphere ESB existente
que você deseja migrar. No
i5/OS, o formato deste
caminho de diretório é o seguinte:
user_data_root/profiles/profile_name,
em que
profile_name é o nome do perfil e
user_data_root é
o diretório de dados do usuário padrão para
WebSphere ESB (
/QIBM/UserData/WebSphere/ESB). Os perfis e subdiretórios profileRegistry são criados
neste diretório quando você instala o produto.
Nota: A plataforma i5/OS será suportada
apenas se você estiver migrando do versão 6.1.x para o versão 6.2.


O valor currentWebSphereDirectory especifica
o nome do diretório raiz da instalação para a instalação do WebSphere ESB existente.
Os seguintes diretórios são os padrões para
WebSphere ESB versão 6.1.x.
Pode ter sido utilizado
um caminho diferente, não padrão para sua instalação.
- Se, para a instalação anterior, o WebSphere Application Server e o WebSphere ESB foram
instalados juntos durante o mesmo processo de instalação: /QIBM/UserData/WebSphere/ProcServer/profiles/profile_name.
- Se, para a instalação anterior, o WebSphere Application Server já estava
instalado e WebSphere ESB foi
instalado sobre ele: /QIBM/UserData/WebSphere/AppServer/V61/ND/profiles/profile_name.
- -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).
- -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.
Este é um parâmetro
opcional para migração de perfis específicos. O valor profile_name especifica
o nome do perfil criado na versão anterior do WebSphere ESB,
a partir do qual o script sua configuração. Se o parâmetro -profileName não for
especificado, o perfil padrão será utilizado. 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.
- -traceFile
Nota: Este parâmetro é ignorado para a migração do WebSphere ESB versão 6.1.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.
- -traceString
Nota: Este parâmetro é ignorado para a migração do WebSphere ESB versão 6.1.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.
- -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).
Criação de Log
O comando WBIPreUpgrade
exibe o status na tela durante sua execução. Ele também salva um conjunto
mais extensivo de informações de criação de log no arquivo WBIPreUpgrade.timestamp.log
gravado no diretório backupDirectory/logs,
em que backupDirectory é o valor especificado para
o parâmetro backupDirectory. Você pode visualizar o arquivo WBIPreUpgrade.profileName.timestamp.log
com um editor de texto.