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 WBIPreUpgrade

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.
  • For i5/OS operating system 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.
  • For i5/OS operating system 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

For i5/OS operating system Para executar este script de comando, seu perfil de usuário deve ter a autoridade *ALLOBJ.

Sintaxe

A sintaxe é a seguinte:

For i5/OS operating system
WBIPreUpgrade backupDirectory 
                currentProfileDirectory
                [-username userID]
                [-password password]
                [-traceString trace_spec [-traceFile file_name ]]
Nota: Se você estiver migrando do versão 6.0.2.x para o versão 6.2, o parâmetro -profileName não será suportado.
For Linux operating systemFor UNIX operating system
WBIPreUpgrade.sh backupDirectory 
                currentWebSphereDirectory
                [-profileName profile_name]
                [-username userID]
                [-password password]
                [-traceString trace_spec [-traceFile file_name ]]
For Windows operating system
WBIPreUpgrade.bat backupDirectory 
                currentWebSphereDirectory
                [-profileName profile_name]
                [-username userID]
                [-password password]
                [-traceString trace_spec [-traceFile file_name ]]

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.
For i5/OS operating system 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.

For UNIX operating systemFor Linux operating systemFor Windows operating system 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
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.
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.


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_wbipreupgrade.html
Copyright IBM Corporation 2005, 2010. Todos os Direitos Reservados.
Este Centro de Informações foi desenvolvido com tecnologia Eclipse (http://www.eclipse.org).