Guia de Iniciação Rápida do IBM Prerequisite Scanner Versão 1.2.0.18

Versões Traduzidas: Para obter o Guia de Iniciação Rápida em outros idiomas, acesse os arquivos PDF no Portal de Suporte IBM.

Visão Geral da Ferramenta

O Prerequisite Scanner é uma ferramenta de varredura que executa a identificação, a verificação e a verificação de pré-requisitos do software especificado antes que a implementação real ocorra. Ele verifica os pré-requisitos de hardware e de software com base nos valores configurados para as propriedades de pré-requisito. A ferramenta exibe os resultados da varredura na interface da linha de comandos e também salva os resultados no texto e, opcionalmente, nos arquivos XML. Também grava mensagens informativas e de depuração nos arquivos de log.

Etapa 1: Acesse o software e a documentação

O Prerequisite Scanner pode ser fornecido com a mídia de sua oferta ou é possível fazer download da versão mais recente da ferramenta a partir do Portal de Suporte IBM (http://www-933.ibm.com/support/fixcentral/swg/selectFixes?product=ibm/Tivoli/Prerequisite+Scanner&release=1.2.0.18&platform=All&function=all). É preciso fornecer o ID e a senha IBM para fazer o download.

Cada pacote contém um arquivo leia-me que descreve o que há de novo na liberação, propriedades de pré-requisito novas ou modificadas, arquivos de configuração novos ou modificados, além dos recursos descontinuados.

Para obter a documentação da ferramenta, consulte a página Prerequisite Scanner na Central da Documentação do Tivoli (https://www.ibm.com/developerworks/community/wikis/home?lang=en#!/wiki/Tivoli%20Documentation%20Central/page/IBM%20Prerequisite%20Scanner)

Etapa 2: Avaliar a configuração do hardware e do sistema

O Prerequisite Scanner é executado em todos os sistemas operacionais e hardware das ofertas suportadas.

Etapa 3: Instalar o Prerequisite Scanner

Se você tiver feito o download da ferramenta a partir doIBM Support Portal, extraia o conteúdo do arquivo compactado para a plataforma relevante para a localização preferida, referida como ips_root. Você deve extrair o conteúdo do arquivo compactado em cada sistema de destino que você pretende instalar a oferta.

Etapa 4: Executar o Prerequisite Scanner

É possível executar o Prerequisite Scanner a partir da linha de comandos. O script do Prerequisite Scanner, prereq_checker, utiliza um conjunto de parâmetros obrigatórios e opcionais e um sinalizador de comando para parâmetros opcionais adicionais.

1. Abra a janela de comando e altere para o diretório ips_root.
2. Se a oferta utilizar variáveis de ambiente para indicar ao Prerequisite Scanner qual componente está planejado para instalação no computador de destino, configure o valor da variável de ambiente relevante para Verdadeiro, por exemplo:
   • Em sistemas Windows: configure ENV_NAME=True
   • Em sistemas UNIX: exporte ENV_NAME=True
   Nota: O Jazz for Service Management Versão 1.1.0.1 e fix packs mais recentes também usam uma variável de ambiente para indicar se é uma instalação nova do Jazz for Service Management, JazzSM_FreshInstall=True, ou uma atualização existente do Jazz for Service Management, JazzSM_FreshInstall=False.
3. Execute o arquivo de script do Prerequisite Scanner, prereq_checker, com os parâmetros relevantes. Para mais informações sobre o conjunto completo de parâmetros e códigos de produtos válidos, consulte Parâmetros e Referência dos Códigos do Produto.

   Windows

   prereq_checker.bat 
   "Product_Code [Product_Version][,Product_CodeN [Product_VerN]...]" 
   [outputDir="ips_output_dir"]
   [xmlResult]
   [configHomeDir="config_files_home"]
   [detail|detail -s|detail -a]
   [prereq_checker.bat version |-listcodes]

   UNIX

   ./prereq_checker.sh 
   "Product_Code [Product_Version][,Product_CodeN [Product_VerN]...]" 
   [outputDir="ips_output_dir"]
   [xmlResult]
   [configHomeDir="config_files_home"]
   [detail|detail -s|detail -a]
   [prereq_checker.bat version |-listcodes]

Exemplo 1

Ele também define o local inicial dos arquivos de configuração para o caminho config_files_home que é especificado pelo parâmetro opcional configHomeDir.

Windows

 prereq_checker.bat 
"KZE 06020300" 
outputDir="%TEMP%\ips"
configHomeDir="C:\MyCfgFiles\cfgfiles"
detail -s

UNIX

./prereq_checker.sh 
"KZE 06020300" 
outputDir="/tmp/ips"
configHomeDir="/usr/myname/MyCfgFiles/cfgfiles"
detail -s

A ferramenta produz os arquivos result.txt file eprecheck.log nos seguintes locais:

• Nos sistemas Windows: D:\temp\ips em que TEMP é a variável de ambiente para a pasta temporária.
• Nos sistemas UNIX: /tmp/ips

Exemplo 2

É possível executar a ferramenta para verificar os pré-requisitos para diversas ofertas, por exemplo, IBM Tivoli Business Service Manager e IBM Tivoli Netcool/Impact, especificando diversos códigos do produto.

Windows

set TBSM_PREREQ_BOTH=True
set IMPACT_PREREQ_BOTH=True
prereq_checker.bat 
"BSM 06010100,NCI 06010100" 

UNIX

export TBSM_PREREQ_BOTH=True
export IMPACT_PREREQ_BOTH=True
./prereq_checker.sh 
"BSM 06010100,NCI 06010100"

Parâmetros

É possível executar o Prerequisite Scanner a partir da linha de comandos. O script do Prerequisite Scanner, prereq_checker, utiliza um conjunto de parâmetros obrigatórios e opcionais e um sinalizador de comando para parâmetros opcionais adicionais. Os parâmetros primários são os seguintes:

Product_Code [Product_Version][,Product_CodeN [Product_VerN]...]

Parâmetro obrigatório

Você deve configurar pelo menos um parâmetro Product_Code para identificar a oferta ou componente para os qual executar a verificação do pré-requisito e o arquivo de configuração associado.

O parâmetro Product_Version opcional para o parâmetro Product_Code associado indica a versão da oferta. É o código de 8 dígitos para representar a versão, a liberação, a modificação e o nível, com 2 dígitos para cada parte do código; por exemplo, 7.3.21 é 07032100.

É possível configurar um ou vários parâmetros Product_Code com o parâmetro Product_Version opcional, cada um separado por uma vírgula.

Consulte Referência dos Códigos do Produto.

[detail|detail -s|detail -a]

Parâmetro opcional

O parâmetro opcional e sua opção opcional indicam o nível de detalhes dos resultados na janela de comando. Se você especificou o parâmetro detail, os resultados detalhados de saídas de ferramentas para a janela de comando, incluindo o resultado geral e o resultado da verificação para cada propriedade de pré-requisito. Se você especificar o parâmetro detail com a opção -s, a ferramenta exibirá os resultados encurtados, incluindo o resultado geral e apenas as propriedades de pré-requisitos com os resultados FAIL ou WARN. Se o parâmetro detail for especificado com a opção -a, a ferramenta oculta a seção de agregação da saída.

[outputDir="ips_output_dir"]

Parâmetro opcional

Ele indica que você deseja configurar o diretório de saída para os resultados da varredura e os arquivos de log para o Prerequisite Scanner conforme especificado pelo valor de ips_output_dir.

[xmlResult]

Parâmetro opcional

Indica que você deseja produzir os resultados para o arquivo de resultados XML, ips_output_dir/result.xml, além do arquivo de resultado de texto simples.

[configHomeDir="config_files_home"]

Parâmetro opcional

Indica o local inicial dos arquivos de configuração, conforme especificado pelo caminho config_files_home. Quando a ferramenta verifica o ambiente de destino, ela usa os arquivos de configuração neste local. Se este parâmetro de entrada não estiver especificado, o local padrão a seguir é usado:

• Em sistemas UNIX: ips_root/UNIX_Linux
• Em sistemas Windows: ips_root\Windows

Atenção: O local inicial pode ser um CD montado, um DVD ou um sistema de arquivos somente leitura e uma unidade de rede. Você deve ter permissões de leitura para ler a partir do config_files_home; caso contrário, o Prerequisite Scanner falha. Os nomes dos arquivos para os arquivos de configuração neste local inicial devem seguir a convenção de nomeação de arquivo padrão conforme segue:

product_code[_<version>].cfg

em que:

• product_code

  É a variável para representar um código do produto nos sistemas Windows ou UNIX. Os códigos do produto identificam o produto e, opcionalmente, a versão do sistema operacional que é suportada por esse produto. Eles estão armazenados no arquivo codename.cfg. Um produto que suporta diversas plataformas pode possuir diversos códigos do produto, com cada um identificando um produto, uma plataforma e uma versão do sistema operacional, conforme necessário.

• <version> é o código de 8 dígitos para representar a versão, a liberação, a modificação e o nível, com 2 dígitos para cada parte do código; por exemplo, 7.3.21 é 07032100.

[PATH="product_root"]

Parâmetro opcional

Ele indica os diretórios de instalação para as ofertas que serão instaladas.

Se o parâmetro não estiver especificado, o caminho padrão é:

• Em sistemas UNIX: opt/IBM/ITM se a propriedade do pré-requisito Disk estiver especificada em um arquivo de configuração
• Em sistemas Windows: C:\IBM\ITM

version|-v

Parâmetro Necessário apenas ao verificar a versão da ferramenta

Você deve definir apenas este parâmetro quando quiser verificar a versão da ferramenta. Se você especificá-lo ao executar a ferramenta para verificar se há pré-requisitos, a ferramenta será executada apenas para a varredura. Ele produz uma mensagem de informações sobre o uso do parâmetro de entrada da versão, mas não de saída dos detalhes da versão.

Sistemas UNIX

./prereq_checker.sh version

Sistemas Windows

prereq_checker.bat version

Para obter a lista completa dos parâmetros, acesse o tópico prereq_checker e na versão mais recente disponível do documento, que poderá ser acessada na página Prerequisite Scanner na Central de Documentação do Tivoli.

Variáveis de ambiente

Mais Informações

Para obter informações adicionais, consulte os seguintes recursos:

• Acesse a página IBM Prerequisite Scanner no Portal de Suporte IBM.
• Acesse a comunidade do Prerequisite Scanner no Service Management Connect. Sinta-se à vontade para contribuir com esses tópicos.