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


Comando installver_wbi

Utilize o comando installver_wbi para computar uma soma de verificação nos arquivos instalados e comparar a soma de verificação com a lista de materiais fornecida para o produto.

Finalidade

O comando installver_wbi desempenha duas funções principais. Ele calcula uma soma de verificação nos arquivos instalados e compara a soma de verificação à lista de materiais fornecida para o produto. O comando installver_wbi também pode calcular uma nova soma de verificação de nível base para cada arquivo no inventário de um sistema configurado a ser utilizado para identificar alterações no arquivo em comparações posteriores.

O arquivo de registro padrão é o arquivo install_root/logs/installver.log. É possível redirecionar a saída utilizando o parâmetro -log e um argumento. Utilize o parâmetro -log sem o argumento do arquivo para gerar o arquivo de registro padrão.

Computando a soma de verificação: O comando installver_wbi computa uma soma de verificação para cada arquivo instalado no produto. O comando compara cada soma de verificação calculada com a soma de verificação correta para o arquivo. As somas de verificação corretas foram enviadas nos arquivos de nota de materiais. Um arquivo de nota de materiais existe para cada componente.

A ferramenta analisa o arquivo de nota de materiais para cada componente para localizar o valor total de verificação correto para cada arquivo do componente. Cada arquivo do produto tem uma entrada em algum arquivo de nota de materiais. A entrada de um arquivo do produto lista o caminho de arquivo do produto e o valor total de verificação correto.

Arquivos de nota de materiais enviados: Cada arquivo de nota de materiais é denominado files.list. Cada componente tem um arquivo files.list. Cada arquivo files.list está em um dos diretórios install_root/properties/version/nif/backup/component_name. Existe um diretório component_name para cada componente.

Por exemplo, o arquivo files.list para o componente de atividade está no diretório install_root/properties/version/nif/backup/component_name. O arquivo é semelhante ao exemplo a seguir:

<?xml version="1.0" encoding="UTF-8"?>

<componentfiles componentname="activity">
       <file>
              <relativepath>properties/version/activity.component</relativepath>
              <checksum>1a20dc54694e81fccd16c80f7c1bb6b46bba8768</checksum>
              <permissions>644</permissions>
              <installoperation>remove</installoperation>
       </file>
       <file>
              <relativepath>lib/activity.jar</relativepath>
              <checksum>2f056cc01be7ff42bb343e962d26328d5332c88c</checksum>
              <permissions>644</permissions>
              <installoperation>remove</installoperation>
       </file>
</componentfiles>

Comparando o checksum computado ao checksum correto: À medida que a ferramenta processa cada arquivo do produto de cada arquivo de nota de materiais, a ferramenta também computa o valor real do checksum do arquivo do produto instalado correspondente. A ferramenta, então, compara a soma de verificação do arquivo do produto ao valor total de verificação correto no arquivo de nota de materiais. Em seguida, a ferramenta relata quaisquer diferenças.

Local do Arquivo de Comandos:

O arquivo de comandos installver_wbi está localizado no diretório bin do diretório raiz da instalação:
  • For i5/OS operating system Em plataformas i5/OS: install_root/bin/installver_wbi
  • For Linux operating systemFor UNIX operating system Em plataformas Linux® e UNIX®: install_root/bin/installver_wbi.sh
  • For Windows operating system Em plataformas Windows®: install_root\bin\installver_wbi.bat
Altere os diretórios para o diretório bin para iniciar a ferramenta installver_wbi a partir da linha de comandos. A ferramenta é executada em qualquer sistema operacional suportado, exceto no z/OS. Por exemplo, utilize o seguinte comando para iniciar a ferramenta em um sistema Linux ou em um sistema UNIX:
./installver_wbi.sh
For i5/OS operating system Nota: No i5/OS, você precisa chamar o QShell utilizando o comando QSH ou STRQSH a partir da janela Comando do i5/OS nativa antes de poder executar estes scripts.

Sintaxe para Exibição de Informações Sobre como Utilizar o Comando

  • For i5/OS operating system Em plataformas i5/OS: ./installver_wbi -help
  • For Linux operating systemFor UNIX operating system Em plataformas Linux e UNIX: ./installver_wbi.sh -help
  • For Windows operating system Em plataformas Windows: installver_wbi.bat -help

Sintaxe para Listar Todos os Componentes

  • For i5/OS operating system Em plataformas i5/OS: ./installver_wbi -listcomponents
  • For Linux operating systemFor UNIX operating system Em plataformas Linux e UNIX: ./installver_wbi.sh -listcomponents
  • For Windows operating system Em plataformas Windows: installver_wbi.bat -listcomponents

Sintaxe para Comparar Arquivos de Produto a Arquivos de Nota de Materiais

Utilize a sintaxe do comando a seguir para verificar automaticamente a nota de materiais em relação ao sistema de arquivos instalado.

  • For i5/OS operating system Em plataformas i5/OS: install_root/bin/installver_wbi
  • For Linux operating systemFor UNIX operating system Em plataformas Linux e UNIX: install_root/bin/installver_wbi.sh
  • For Windows operating system Em plataformas Windows: install_root\bin\installver_wbi.bat

Consulte Verificando a Lista de Materiais para obter exemplos de como utilizar o comando para comparar os arquivos instalados com os arquivos da lista de materiais do produto.

Exemplo de Comparações e Uso de Comando

Compare as somas de verificação e inclua arquivos especificados somente na comparação:
  • For i5/OS operating system Em plataformas i5/OS: ./installver_wbi -include fn1;fn2;fn3
  • For Linux operating systemFor UNIX operating system Em plataformas Linux e UNIX: ./installver_wbi.sh -include fn1;fn2;fn3
  • For Windows operating system Em plataformas Windows: installver_wbi.bat -include fn1;fn2;fn3

Consulte Comparando Somas de Verificações de Arquivos e Componentes Específicos para obter exemplos de utilização do comando para comparar apenas arquivos ou componentes que você especificar.

Compare as somas de verificação e inclua componentes especificados somente na comparação:
  • For i5/OS operating system Em plataformas i5/OS: ./installver_wbi -includecomponent comp1;comp2;comp3;...
  • For Linux operating systemFor UNIX operating system Em plataformas Linux e UNIX: ./installver_wbi.sh -includecomponent comp1;comp2;comp3;...
  • For Windows operating system Em plataformas Windows: installver_wbi.bat -includecomponent comp1;comp2;comp3;...
Compare as somas de verificação e exclua determinados componentes da comparação:
  • For i5/OS operating system Em plataformas i5/OS: ./installver_wbi -excludecomponent comp1;comp2;comp3;...
  • For Linux operating systemFor UNIX operating system Em plataformas Linux e UNIX: ./installver_wbi.sh -excludecomponent comp1;comp2;comp3;...
  • For Windows operating system Em plataformas Windows: installver_wbi.bat -excludecomponent comp1;comp2;comp3;...

Consulte Excluindo Arquivos de uma Comparação de Soma de Verificação para obter exemplos de como utilizar o comando para excluir arquivos da comparação.

Compare as somas de verificação e ignore os arquivos excluídos pelo usuário:
  • For i5/OS operating system Em plataformas i5/OS: ./installver_wbi -ignoreuserexclude
  • For Linux operating systemFor UNIX operating system Em plataformas Linux e UNIX: ./installver_wbi.sh -ignoreuserexclude
  • For Windows operating system Em plataformas Windows: installver_wbi.bat -ignoreuserexclude
Compare as somas de verificação e ignore os arquivos excluídos pela IBM:
  • For i5/OS operating system Em plataformas i5/OS: ./installver_wbi -ignoreibmexclude
  • For Linux operating systemFor UNIX operating system Em plataformas Linux e UNIX: ./installver_wbi.sh -ignoreibmexclude
  • For Windows operating system Em plataformas Windows: installver_wbi.bat -ignoreibmexclude
Liste somente todos os componentes:
  • For i5/OS operating system Em plataformas i5/OS: ./installver_wbi -listcomponents
  • For Linux operating systemFor UNIX operating system Em plataformas Linux e UNIX: ./installver_wbi.sh -listcomponents
  • For Windows operating system Em plataformas Windows: installver_wbi.bat -listcomponents
Crie gabarito (para arquivos excluídos da listagem) somente:
  • For i5/OS operating system Em plataformas i5/OS: ./installver_wbi -createtemplate
  • For Linux operating systemFor UNIX operating system Em plataformas Linux e UNIX: ./installver_wbi.sh -createtemplate
  • For Windows operating system Em plataformas Windows: installver_wbi.bat -createtemplate

Parâmetros para Comparar Somas de Verificação em Relação à Nota de Materiais

Os parâmetros a seguir são associados ao comando quando as somas de verificação de arquivos de produto são comparadas às somas de verificação corretas nos arquivos de nota de materiais.

-componentdir directory_1;directory_2;directory_n
Parâmetro opcional que identifica o nome do diretório no qual os produtos do WebSphere Application Server armazenam as listas de materiais individuais para cada componente.

O valor padrão é o diretório install_root/properties/version/nif/backup.

-createtemplate [file_name ]
Cria um arquivo de propriedades de gabarito para excluir arquivos da comparação de soma de verificação. Edite o arquivo de propriedades de gabarito para incluir uma linha para cada arquivo que deseja excluir da verificação.

Sem um arquivo de argumento de especificação, a ferramenta installver_wbi cria o arquivo install_root/properties/ivu_user.template.

Se você especificar um nome de arquivo, a ferramenta installver_wbi criará o arquivo no diretório de trabalho, que é o diretório install_root/profiles/profile_name/bin por padrão.

  • For i5/OS operating system Em plataformas i5/OS: digite o seguinte na linha de comandos:
    1. cdinstall_root/bin
    2. ./installver_wbi -createtemplate
  • For Linux operating systemFor UNIX operating system Em plataformas Linux e UNIX: Digite o seguinte na linha de comandos:
    1. cdinstall_root/bin
    2. ./installver_wbi.sh -createtemplate
  • For Windows operating system Em plataformas Windows: Digite o seguinte na linha de comandos:
    1. cdinstall_root\bin
    2. installver_wbi.bat -createtemplate

A ferramenta installver_wbi cria o arquivo de propriedades de modelo no diretório properties do perfil padrão:

  • For i5/OS operating system Em plataformas i5/OS: default_profile_root/properties/ivu.user.template
  • For Linux operating systemFor UNIX operating system Em plataformas Linux e UNIX: default_profile_root/properties/ivu.user.template
  • For Windows operating system Em plataformas Windows: default_profile_root\properties\ivu.user.template
-exclude file1;file2;file3; ...
Exclui arquivos da verificação.

Utilize ponto-e-vírgula (;) ou dois-pontos (:) para delimitar os nomes dos arquivos.

-excludecomponent component1;component2;component3; ...
Exclui componentes da verificação.

Utilize ponto-e-vírgula (;) ou dois-pontos (:) para delimitar os nomes dos componentes.

-filelist file_name
Parâmetro opcional que identifica o nome do arquivo que a IBM® utiliza para identificar as somas de verificações corretas de arquivos de produtos em um determinado componente do produto.

O valor padrão é files.list.

-help

Exibe informações de uso.

-ignoreuserexclude

Ignora o arquivo install_root/properties/ivu_user.template padrão, se o arquivo existir, e compara os arquivos listados no modelo.

Se você utilizar o parâmetro -createtemplate com uma especificação do arquivo para criar um arquivo de gabarito em outro local, o parâmetro -ignoreusertemplate não terá efeito.

-ignoreibmexclude

Compara somas de verificação para todos os arquivos no diretório raiz da instalação. A IBM especifica determinados arquivos para exclusão da verificação por padrão. Você pode fazer a ferramenta installver_wbi verificar esses arquivos e também utilizar o parâmetro -ignoreibmexclude.

-include file1;file2;file3; ...
Inclui arquivos na verificação e exclui todos os outros arquivos.

Utilize ponto-e-vírgula (;) ou dois-pontos (:) para delimitar os nomes dos arquivos.

-includecomponent component1;component2;component3; ...
Inclui componentes na verificação e exclui todos os outros componentes.

Utilize ponto-e-vírgula (;) ou dois-pontos (:) para delimitar os nomes dos componentes.

-installroot directory_name
Substitui o diretório raiz da instalação padrão.
-listcomponents

Exibe uma lista de componentes do produto. Cada componente deve ter um arquivo files.list.

-log [file_path_and_file_name_of_log_file]

O arquivo de registro padrão é o arquivo install_root/logs/installver.log. É possível redirecionar a saída utilizando o parâmetro -log e um argumento.

-profilehome directory_name
Substitui o diretório profiles padrão no diretório raiz da instalação.
-trace

Fornece saída de rastreio do que a ferramenta verifica e do que a ferramenta descobre.

Sintaxe para Criar e Utilizar uma Nova Soma de Verificação de Nível Base para um Inventário de Arquivos Configurados

Utilize a sintaxe a seguir para criar e comparar um inventário dos arquivos configurados aos arquivos instalados atualmente.

Crie uma lista de inventário dos arquivos que estão atualmente instalados no diretório raiz da instalação:
  • For i5/OS operating system Em plataformas i5/OS: ./installver_wbi -createinventory [path/file_name], tal como ./installver_wbi -createinventory /tmp/system.inv
  • For Linux operating systemFor UNIX operating system Em plataformas Linux e UNIX: ./installver_wbi.sh -createinventory [path/file_name], tal como ./installver_wbi.sh -createinventory /tmp/system.inv
  • For Windows operating system Em plataformas Windows: installver_wbi.bat -createinventory [path\file_name], tal como installver_wbi.bat -createinventory C:\temp\system.inv
Compare a lista de inventário aos arquivos atualmente instalados no diretório raiz da instalação:
  • For i5/OS operating system Em plataformas i5/OS: ./installver_wbi -compare /path/file_name
  • For Linux operating systemFor UNIX operating system Em plataformas Linux e UNIX: ./installver_wbi.sh -compare /path/file_name
  • For Windows operating system Em plataformas Windows: installver_wbi.bat -compare path\file_name
Compare e exiba os resultados de rastreio:
  • For i5/OS operating system Em plataformas i5/OS: ./installver_wbi -compare /path/file_name -trace
  • For Linux operating systemFor UNIX operating system Em plataformas Linux e UNIX: ./installver_wbi.sh -compare /path/file_name -trace
  • For Windows operating system Em plataformas Windows: installver_wbi.bat -compare /path/file_name -trace
Exiba as informações de uso:
  • For i5/OS operating system Em plataformas i5/OS: ./installver_wbi -help
  • For Linux operating systemFor UNIX operating system Em plataformas Linux e UNIX: ./installver_wbi.sh -help
  • For Windows operating system Em plataformas Windows: installver_wbi.bat -help
Compare e exclua os arquivos especificados da comparação de inventário:
  • For i5/OS operating system Em plataformas i5/OS: ./installver_wbi -compare /path/file_name -exclude fn1;fn2;fn3;...
  • For Linux operating systemFor UNIX operating system Em plataformas Linux e UNIX: ./installver_wbi.sh -compare /path/file_name -exclude fn1;fn2;fn3;...
  • For Windows operating system Em plataformas Windows: installver_wbi.bat -compare \path\file_name -exclude fn1;fn2;fn3;...
Compare e inclua somente os arquivos especificados na comparação de inventário:
  • For i5/OS operating system Em plataformas i5/OS: ./installver_wbi -compare /path/file_name -include fn1;fn2;fn3;...
  • For Linux operating systemFor UNIX operating system Em plataformas Linux e UNIX: ./installver_wbi.sh -compare /path/file_name -include fn1;fn2;fn3;...
  • For Windows operating system Em plataformas Windows: installver_wbi.bat -compare /path/file_name -include fn1;fn2;fn3;...

Parâmetros para Criar e Utilizar Somas de Verificação para um Inventário de Arquivos

Os seguintes parâmetros estão associados a esse comando.

-compare file_path_and_file_name_of_existing_inventory_file
Compara a lista de inventário existente aos arquivos existentes para determinar as alterações.

Primeiro utilize o parâmetro -createinventory para criar uma lista de inventários. Em seguida, utilize o parâmetro -compare para comparar a lista de inventários aos arquivos reais que existem no sistema na hora da comparação.

O resultado da comparação mostra classes alteradas, arquivos alterados, arquivos ausentes e arquivos incluídos. Tal comparação é muito útil para verificar a falta de arquivos de vírus, por exemplo.

-createinventory directory_name
Cria a nova soma de verificação por padrão no arquivo sys.inv no diretório de trabalho atual, como o diretório profile_root/bin. Você pode especificar um caminho de arquivo e um nome de arquivo. Crie o arquivo fora do diretório raiz da instalação ou exclua o arquivo das comparações.

Você pode apontar a ferramenta installver_wbi em qualquer diretório. O diretório padrão é o diretório raiz da instalação.

É possível excluir arquivos ou componentes do inventário.

A ferramenta installver_wbi calcula uma soma de verificação para cada arquivo. Cada entrada de arquivo no inventário tem o seguinte padrão geral:

checksum|relativepath/file_name|file_size|last_modified_time

Após criar uma lista de inventário, utilize o parâmetro -compare para comparar a lista de arquivos reais que existem no sistema na hora da comparação.

-exclude file1;file2;file3;...
Exclui arquivos da comparação.

Utilize ponto-e-vírgula (;) ou dois-pontos (:) para delimitar os nomes dos arquivos.

-help
Exibe informações de uso.
-include file1;file2;file3; ...
Inclui arquivos na comparação e exclui todos os outros arquivos.

Utilize ponto-e-vírgula (;) ou dois-pontos (:) para delimitar os nomes dos arquivos.

-installroot directory_name
Substitui o diretório raiz da instalação padrão.
-log [file_path_and_file_name_of_log_file]

O arquivo de registro padrão é o arquivo install_root/logs/installver.log. É possível redirecionar a saída utilizando o parâmetro -log e um argumento.

-trace
Fornece saída de rastreio do que a ferramenta verifica e do que a ferramenta descobre.

Exemplo

Os exemplos a seguir mostram problemas que podem ocorrer durante a execução do comando installver_wbi para comparar somas de verificação.

Ignore as entradas para incompatibilidades de soma de verificação introduzidas de propósito, como podem ocorrer quando você estende um componente

As somas de verificação diferem para cada arquivo alterado:
I CWNVU0470I: [ivu] Starting to analyze: regularcomponentsample
I CWNVU0440I: [ivu] The following file is different: lib/different.jar
I CWNVU0410I: [ivu] fc19318dd13128ce14344d066510a982269c241b is the checksum in 
  the bill of materials.
I CWNVU0420I: [ivu] 517d5a7240861ec297fa07542a7bf7470bb604fe is the checksum on 
  the file system.
I CWNVU0390I: [ivu] Component issues found : 1
I CWNVU0480I: [ivu] Done analyzing: regularcomponentsample

Ignore problemas que são mensagens informativas (I) óbvias

Algumas mensagens indicam desvios do resultado normalmente esperado, mas não são indicadores de um problema grave:
I CWNVU0360I: [ivu] The following bill of materials issue is found for component
  nullvaluesample: 
  Hash must not be null or an empty string.

Arquivos sobrepostos são um problema do produto em potencial ou possível violação na lista de materiais fornecida pela IBM

I CWNVU0470I: [ivu] Starting to analyze: overlapbinarycomponentsample
W CWNVU0422W: [ivu] The following file is overlapped: lib/binaryTest.jar
W CWNVU0425W: [ivu] The overlap is caused by: _binarycomponentsample
I CWNVU0390I: [ivu] Component issues found : 1
I CWNVU0480I: [ivu] Done analyzing: overlapbinarycomponentsample

Entre em contato com o suporte da IBM para o seguinte problema

Se você receber qualquer mensagem com o seguinte formato, entre em contato com o suporte da IBM:
W CWNVU0280W: [ivu] Component mismatch: expected ... but found ...

Para obter informações atuais disponíveis a partir do Suporte IBM sobre problemas conhecidos e suas resoluções, consulte esta página de Suporte da IBM.

O Suporte da IBM possui documentos que podem economizar tempo na reunião de informações necessárias para resolver este problema. Antes de abrir um PMR, consulte esta página de Suporte da IBM.

Se você não encontrar um problema conhecido de instalação parecido com o seu, ou se as informações fornecidas não resolverem seu problema, entre em contato com o suporte da IBM para obter assistência adicional.

Avançar

Depois de verificar sua instalação, você poderá criar perfis ou implementar um aplicativo em um perfil existente.


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