Exécution de Prerequisite Scanner à partir de la ligne de commande

Vous pouvez exécuter IBM® Prerequisite Scanner depuis la ligne de commande et spécifier les paramètres d'entrée associés pour le script.

Avant de commencer

Recherchez dans la documentation d'installation ou les notes techniques de votre produit les étapes supplémentaires qui doivent être réalisées avant d'exécuter Prerequisite Scanner.

Déterminez si votre offre utilise des variables d'environnement qui indiquent à l'outil l'ensemble de prérequis à analyser en fonction du composant en cours d'installation ou du scénario de déploiement de l'offre, comme présenté dans le Tableau 1.

Tableau 1. Variables d'environnement Prerequisite Scanner pour les offres
Version, plateforme, système d'exploitation de l'offre	Option d'installation	Variable d'environnement
Tivoli Network Manager IP Edition Version 4.1.1	Le programme d'installation ITNM installe OMNIbus	`tnmEVENTS`
	ITNM installe la fonctionnalité CORE lors de l'installation.	`tnmCORE`
	Le programme d'installation ITNM installe la fonctionnalité GUI, y compris le portail TIP (Tivoli Integrated Portal)	`tnmGUI`
	ITNM installe DB2 en tant que base de données de topologie locale de l'installation.	`tnmDB`
Tivoli Business Service Manager version 6.1.1	Installation du serveur de données uniquement	`TBSM_PREREQ_DATA`
	Installation du serveur du tableau de bord uniquement	`TBSM_PREREQ_DASH`
	Installation combinée du serveur du tableau de bord et du serveur de données	`TBSM_PREREQ_BOTH`
Tivoli Netcool/Impact version 6.1.1	Installation du serveur de l'interface graphique uniquement	`IMPACT_PREREQ_GUI`
	Installation du serveur Impact uniquement	`IMPACT_PREREQ_IMPACT`
	Installation combinée du serveur de l'interface graphique et du serveur Impact	`IMPACT_PREREQ_BOTH`
Jazz for Service Management version 1.1.0.1 et version 1.1.0.2	Installation nouvelle ou mise à jour d'une installation existante	`JazzSM_FreshInstall`
Registry Services in Jazz for Service Management Conseil : Jazz for Service Management utilise des scripts de commodité pour exécuter l'outil et définir ces variables d'environnement. Définissez uniquement ces dernières, si vous souhaitez exécuter l'outil en utilisant le fichier de configuration Registry Services.	Installation complète	`JazzSM_TYPICAL`
	Installation personnalisée, installation du serveur DB2 uniquement	`FRS_DBSERVER`
	Installation personnalisée, installation du serveur d'applications uniquement	`FRS_BACKENDSERVER`
Tivoli Netcool Configuration Manager versions 6.4.0 et 6.4.1 Conseil : Utilisez le script `ips_root`/NCM.sh pour exécuter l'analyse pour Tivoli Netcool Configuration Manager. Vous êtes invité à sélectionner les composants pour lesquels lancer l'analyse, et les variables d'environnement sont automatiquement définies.	Installation du coeur de conformité	`TNCM_COMPLIANCE_CORE`
	Installation du moteur d'évaluation de conformité	`TNCM_COMPLIANCE_EVALUATION`
	Installation du serveur (interface graphique) de présentation	`TNCM_PRESENTATION_SERVER`
	Installation de Tivoli Common Reporting	`TNCM_REPORTING`
	Installation du serveur Worker	`TNCM_WORKER_SERVER`

Procédure

Ouvrez la fenêtre de commande et accédez au répertoire ips_root.
Si votre offre utilise des variables d'environnement pour indiquer le composant à installer sur la machine cible, définissez la valeur de la variable d'environnement appropriée sur True, par exemple :

Option Description

Systèmes Windows set ENV_NAME=True

Systèmes UNIX export ENV_NAME=True

Option	Description
Systèmes Windows	`set ENV_NAME=True`
Systèmes UNIX	`export ENV_NAME=True`

Exécutez le fichier script Prerequisite Scanner, prereq_checker, comme suit :

Systèmes UNIX

./prereq_checker.sh 
"Product_Code [Product_Version][,Product_CodeN [Product_VerN]...]" 
[detail|detail -s] 
[outputDir="ips_output_dir"]
[xmlResult]
[configHomeDir="config_files_home"]
[PATH="product_root"] 
[-p Product_Code.instance.parameter=value,...]

Systèmes Windows

prereq_checker.bat 
"Product_Code [Product_Version][,Product_CodeN [Product_VerN]...]" 
[detail|detail-s] 
[outputDir="ips_output_dir"]
[xmlResult]
[configHomeDir="config_files_home"]
[PATH="product_root"] 
[-p Product_Code.instance.parameter=value,...]

Résultats

Les résultats possibles de l'exécution de Prerequisite Scanner dans l'environnement cible se présentent comme suit :

Fail (Echec)

Si l'environnement cible ne satisfait pas une ou plusieurs vérifications des prérequis, Prerequisite Scanner renvoie un résultat FAIL général pour l'environnement. L'outil affiche les résultats de l'analyse pour les propriétés de prérequis individuelles dans la fenêtre de commande.

Si Prerequisite Scanner renvoie ce résultat, effectuez les actions appropriées. Par exemple, installez les modules manquants du système d'exploitation, augmentez l'espace disque pour les systèmes de fichiers ou modifiez les paramètres de configuration de l'environnement cible afin qu'ils correspondent aux valeurs attendues dans les résultats de l'analyse.

Warning (Avertissement)

Si l'environnement cible ne satisfait pas une ou plusieurs vérifications de prérequis ayant un niveau de gravité avertissement, Prerequisite Scanner renvoie un résultat WARNING global pour l'environnement ; s'il n'y a pas de résultat FAIL pour une autre propriété de prérequis, le résultat global est FAIL. L'outil affiche les résultats de l'analyse pour les propriétés de prérequis individuelles dans la fenêtre de commande.

Si Prerequisite Scanner renvoie ce résultat WARNING, vous pouvez installer le produit ou le composant, mais les performances ou l'environnement d'exécution risque d'être impacté(es) par les prérequis manquants ou incorrects. Vous devez effectuer les actions appropriées pour ces propriétés prérequises ayant renvoyé un résultat WARNING.

Pass (Réussite)

Si l'environnement cible répond à toutes les vérifications de prérequis, Prerequisite Scanner renvoie un résultat PASS général pour l'environnement.

Si Prerequisite Scanner renvoie ce résultat, vous pouvez installer le produit.

Exemples

L'exemple suivant exécute Prerequisite Scanner pour plusieurs offres, Tivoli Business Service Manager version 6.1.1 et Tivoli Netcool/Impact version 6.1.1, en spécifiant plusieurs codes produit, BSM et NCI.

Systèmes UNIX

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

Systèmes Windows

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

L'exemple suivant présente comment exécuter Prerequisite Scanner pour IBM Tivoli zEnterprise Monitoring Agent en utilisant le code de produit KZE. Il définit l'emplacement des résultats et des fichiers journaux dans le système de fichiers ips_output_dir à l'aide du paramètre facultatif outputDir. Le paramètre detail-s est utilisé pour signifier que l'outil génère les résultats raccourcis dans la fenêtre de commande, en affichant le résultat global et toutes les propriétés prérequises comportant des résultats de type FAIL ou WARN.

Important : Vous devez utiliser le paramètre outputDir pour indiquer un emplacement si vous choisissez d'exécuter Prerequisite Scanner depuis un CD, DVD monté, ou un système de fichiers en lecture seule et une unité réseau. Vous devez disposer des droits en écriture sur ips_output_dir ; sinon, l'exécution de Prerequisite Scanner échoue.

Il définit également l'emplacement d'origine des fichiers de configuration dans le chemin config_files_home à l'aide du paramètre facultatif configHomeDir.

Systèmes UNIX

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

Systèmes Windows

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

Dans cet exemple, l'outil crée les fichiers result.txt et precheck.log aux emplacements suivants :

Sous Windows : D:\temp\ips où TEMP est la variable d'environnement du dossier temporaire
Sur UNIX : /tmp/ips

Important : Si le répertoire de sortie n'existe pas, Prerequisite Scanner le crée. Vous devez disposer des droits d'écriture pour créer un fichier ou écrire dans le répertoire de sortie dans lequel Prerequisite Scanner enregistre les fichiers.