Comando installver_wbi

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

Objetivo

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.

Calculando a Soma de Verificação: O comando installver_wbi calcula 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/install.wbi/6.0.0.0/backup/ component_name. Existe um diretório component_name para cada componente.

Por exemplo, o arquivo files.list para o componente da atividade no diretório install_root /properties/version/install.wbi/6.0.0.0/backup/activity. 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:
  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX: install_root/bin/installver_wbi.sh
  • Icon indicating Windows platforms 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 o z/OS. Por exemplo, utilize o seguinte comando para iniciar a ferramenta em um sistema Linux ou em um sistema UNIX:
./installver_wbi.sh

Sintaxe para Exibir Informações de Uso

  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX: ./installver_wbi.sh -help
  • Icon indicating Windows platforms Em plataformas Windows: installver_wbi.bat -help

Sintaxe para Listar Todos os Componentes

  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX: ./installver_wbi.sh -listcomponents
  • Icon indicating Windows platforms 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.

  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX: install_root/bin/installver_wbi.sh
  • Icon indicating Windows platforms 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.

Compare as somas de verificação e inclua arquivos especificados somente na comparação:
  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX: ./installver_wbi.sh -include fn1;fn2;fn3
  • Icon indicating Windows platforms Em plataformas Windows: installver_wbi.bat -include fn1;fn2;fn3

Consulte Comparando Somas de Verificação de Arquivos e de Componentes Específicos para obter exemplos de como utilizar o comando para comparar apenas arquivos ou componentes especificados.

Compare as somas de verificação e inclua componentes especificados somente na comparação:
  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX: ./installver_wbi.sh -includecomponent comp1;comp2;comp3;...
  • Icon indicating Windows platforms Em plataformas Windows: installver_wbi.bat -includecomponent comp1;comp2;comp3;...
Compare as somas de verificação e exclua determinados componentes da comparação:
  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX: ./installver_wbi.sh -excludecomponent comp1;comp2;comp3;...
  • Icon indicating Windows platforms 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:
  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX: ./installver_wbi.sh -ignoreuserexclude
  • Icon indicating Windows platforms Em plataformas Windows: installver_wbi.bat -ignoreuserexclude
Compare as somas de verificação e ignore os arquivos excluídos pela IBM:
  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX: ./installver_wbi.sh -ignoreibmexclude
  • Icon indicating Windows platforms Em plataformas Windows: installver_wbi.bat -ignoreibmexclude
Liste somente todos os componentes:
  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX: ./installver_wbi.sh -listcomponents
  • Icon indicating Windows platforms Em plataformas Windows: installver_wbi.bat -listcomponents
Crie gabarito (para arquivos excluídos da listagem) somente:
  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX: ./installver_wbi.sh -createtemplate
  • Icon indicating Windows platforms 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
O parâmetro opcional que identifica o nome do diretório onde os produtos WebSphere Application Server armazenam as listas de notas de materiais individuais para cada componente.

O valor padrão é o diretório install_root /properties/version/install.wbi/6.0.0.0/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 argumento de especificação de arquivo, a ferramenta installver_wbi cria o arquivo install_root/profiles/profile_name/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.

  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX: Execute o seguinte procedimento:
    1. cd install_root/bin
    2. ./installver_wbi.sh -createtemplate
  • Icon indicating Windows platforms Em plataformas Windows: Execute o seguinte procedimento:
    1. cd install_root\bin
    2. installver_wbi.bat -createtemplate

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

  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX: default_profile_root/properties/ivu.user.template
  • Icon indicating Windows platforms 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
O parâmetro opcional que identifica o nome do arquivo que a IBM utiliza para identificar as somas de verificação corretas dos arquivos do produto em um determinado componente do produto.

O valor padrão é files.list.

-help

Exibe informações de uso.

-ignoreuserexclude

Ignora o arquivo install_root/profiles/profile_name/properties/ivu_user.template padrão se o arquivo existir e compara os arquivos listados no gabarito.

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 a serem excluídos 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_wbi.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:
  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX: ./installver_wbi.sh -createinventory [path/file_name], como ./installver_wbi.sh -createinventory /tmp/system.inv
  • Icon indicating Windows platforms Em plataformas Windows: installver_wbi.bat -createinventory [path/file_name], 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:
  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX: ./installver_wbi.sh -compare /path/file_name
  • Icon indicating Windows platforms Em plataformas Windows: installver_wbi.bat -compare path\file_name
Compare e exiba os resultados de rastreio:
  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX: ./installver_wbi.sh -compare /path/file_name -trace
  • Icon indicating Windows platforms Em plataformas Windows: installver_wbi.bat -compare /path/file_name -trace
Exiba as informações de uso:
  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX: ./installver_wbi.sh -help
  • Icon indicating Windows platforms Em plataformas Windows: installver_wbi.bat -help
Compare e exclua os arquivos especificados da comparação de inventário:
  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX: ./installver_wbi.sh -compare /path/file_name -exclude fn1;fn2;fn3;...
  • Icon indicating Windows platforms 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:
  • Icon indicating Linux platforms Icon indicating UNIX platforms Em plataformas Linux e UNIX: ./installver_wbi.sh -compare /path/file_name -include fn1;fn2;fn3;...
  • Icon indicating Windows platforms 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_name/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_wbi.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.

Problemas de Exemplos

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.

Os arquivos sobrepostos são um possível problema no produto ou uma 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 IBM para o seguinte problema

Se aparecer alguma mensagem com o seguinte formato, entre em contato com o suporte IBM:
W CWNVU0280W: [ivu] Component mismatch: expected ... but found ...

Para obter informações atuais disponíveis do Suporte IBM sobre problemas conhecidos e sua resolução, consulte esta página IBM Support.

A página IBM Support traz documentos que podem lhe economizar tempo ao coletar informações necessárias para resolver este problema. Antes da abertura de um PMR, consulte esta página IBM Support.

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

Próximo

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

Tarefas relacionadas
Utilizando as Ferramentas de Verificação de Instalação com o WebSphere Process Server
Calculando uma Nova Soma de Verificação de Nível Base para um Inventário de Arquivos Configurados
Alterando o Algoritmo de Compilação de Mensagem Padrão
Verificando a Lista de Materiais
Excluindo Arquivos de uma Comparação de Soma de Verificação
Comparando Somas de Verificação de Arquivos e de Componentes Específicos
Tratando Situações de Falta de Memória

(c) Copyright IBM Corporation 2005, 2006.
Este centro de informações é desenvolvido em tecnologia Eclipse (http://www.eclipse.org)