Identification et résolution des problèmes de reconnaissance sur IBM i

Disponible à partir de la version 9.2.5. La présente section répertorie les problèmes les plus courants que vous pourriez rencontrer lors de la découverte de l'inventaire matériel et logiciel avec le scanner déconnecté. L'objectif principal du traitement des incidents est de déterminer la raison d'un dysfonctionnement et d'expliquer comment résoudre le problème.

Fichiers journaux

Les fichiers journaux du scanner se trouvent dans les répertoires suivants :
  • /Installation directory/logs/*.
  • /etc/cit/logs/*
Le répertoire d'installation par défaut est /cit.

Transfert de fichiers à partir des systèmes IBM i

La structure de fichier interne des systèmes IBM i affichée lors de la connexion via FTP est très complexe. Cependant, vous pouvez utiliser l'une des commandes suivantes afin de leur conférer un aspect similaire à UNIX. Après vous être connecté via FTP, émettez l'une des commandes suivantes :
cd /
site NAMEFMT 1
Conseil : Pour plus d'informations, voir Utilisation de la sous-commande FTP : NAMEFMT.
Définissez ensuite le mode approprié pour le transfert de vos fichiers, binaire ou texte. Utilisez le mode binaire pour transférer les résultats d'analyse, et le mode texte pour obtenir les fichiers journaux du scanner.

Optimisation de l'utilisation du processeur

Par défaut, l'utilisation du processeur n'est pas limitée lors de l'analyse. Vous pouvez l'optimiser en définissant un seuil d'UC.
Remarque : La définition du seuil ne garantit pas que la consommation d'unité centrale reste sous la valeur spécifiée. Elle fluctue autour de cette valeur et peut être supérieure ou inférieure. Des pics temporaires sont à prévoir. La définition d'un seuil risque d'augmenter la durée de l'analyse.
  1. éditez le fichier sw_config.xml que vous avez téléchargé avec le scanner.
  2. Ajoutez deux nouveaux attributs cpuThreshold, un pour FSScanner et un autre pour Signatures. Par exemple :
    <BigFix>
    <CIT>
    <XSE version="1.0">
    <Plugins>
    <Plugin name="FSScanner">
    <Attribute name="cpuThreshold" value="20:2:150:850"/>
    (...)
    <Attribute name="interruptOnTimeout" value="true"/>
    </Plugin>
    </Plugins>
    <Signatures>
    <Attribute name="cpuThreshold" value="20:2:150:850"/>
    </Signatures>
    </XSE>
    </CIT>
    </IBM>
  3. Indiquez l'une des valeurs suivantes :
    Utilisation souhaitée Value
    5 % 10:2:50:950
    10 % 20:2:100:900
    15% 20:2:150:850
    20% 30:2:200:800
    25% 30:2:250:750
    50% 50:2:300:500
  4. Sauvegardez le fichier.

Exclusion de répertoires de l'analyse

Vous pouvez exclure des répertoires de l'analyse pendant l'analyse des balises ISO et l'analyse basée sur catalogue. Pour ce faire, éditez le fichier sw_config.xml. Définissez les attributs excludeDirectory sur les répertoires.
  • Pour exclure le répertoire :/tmp
    <Attribute name="excludeDirectory" value="/tmp/"/> 
  • Pour exclure tous les répertoires nommés tmp, par exemple /tmp et :/dir/tmp
    <Attribute name="excludeDirectory" value="*/tmp/"/> 

Fourniture des packages défaillants au support BigFix

L'importation d'un package échoue
Si vous voyez les erreurs suivantes dans le journal d'importation, fournissez le package d'analyse complet.
2015-11-06 08:31:07 INFO: Processing scan package: 201511041200-9.128.0.223.zip from: /disconnected/.
2015-11-06 08:31:08 INFO: ETL from FileSystem - SAM::DisconnectedScan 
(0x00000000563C63FF - 0x00000000563C6514): Failed
2015-11-06 08:31:08 ERROR: Sequel::UniqueConstraintViolation: 
Java::ComIbmDb2JccAm::SqlIntegrityConstraintViolationException: One or more values in the INSERT statement, 
UPDATE statement, or foreign key update caused by a DELETE statement are not valid because the primary key, 
unique constraint or unique index identified by "1" constrains table "DBO.RAW_DATASOURCE_FILES" from having 
duplicate values for the index key.. SQLCODE=-803, SQLSTATE=23505, DRIVER=3.64.104
L'importation d'un seul fichier échoue
L'importation d'un fichier unique du package d'analyse est défaillant si le journal d'importation contient le message suivant :
2015-11-06 10:48:07 WARN: An error occurred parsing XML file 2 in file isotagsearch_0_375.zip. 
Install path value was not found.
Vous devez fournir un tel fichier avec son chemin d'accès long. Pour déterminer le chemin d'accès, procédez comme suit :
  1. Accédez au répertoire d'installation de BigFix Inventory.
  2. Recherchez le fichier défaillant :
    find -name "isotagsearch_0_375.zip"

    Résultat de la commande devant être fourni au support :

    ./wlp/usr/servers/server1/tmp/datasources/2/UploadManager/sha1/75/375/isotagsearch_0_375.zip

Problèmes courants

Le package est ignoré pendant l'importation bien que conforme aux exigences
Ce problème peut survenir si vous importez plusieurs packages à partir d'un nœud final. BigFix Inventory importe toujours le package le plus récent et omet tous les packages précédents. Le message suivant indiquant que le package a été omis est lié aux packages non pertinents et peut être ignoré :
2015-11-05 09:35:22 WARN: Skipping file: package_scan.xml from: 201510101200-2inarow.zip. 
The data was already processed.
2015-11-05 09:35:22 INFO: Skipping file: package_scan.xml. 
Unsupported file in: 201510101200-2inarow.zip.
L'importation peut échouer si vous utilisez les mêmes résultats de l'analyse de capacité dans des packages différents
Ce problème peut se produire si vous réutilisez les résultats de l'analyse de capacité à des fins de test. Si les résultats d'analyse sont identiques pour plusieurs nœuds finaux, l'importation échoue et le message suivant s'affiche :
ERROR:  (ImportCapacity-Thread:3) doInsert com.ibm.db2.jcc.am.SqlIntegrityConstraintViolationException:
One or more values in the INSERT statement, UPDATE statement, or foreign key update caused 
by a DELETE statement are not valid because the primary key, unique constraint or unique 
index identified by "1" constrains table "ADM.LAST_IMPORTED_SCAN" from having duplicate values 
for the index key.. SQLCODE=-803, SQLSTATE=23505, DRIVER=3.64.104

Assurez-vous que vous exécutez l'analyse de capacité pour chacun de vos nœuds finaux et utilisez les résultats appropriés.

L'analyse de logiciels ou de balises ISO échoue et aucun résultat n'est créé
Exécutez la commande suivante dans QSH, puis renouvelez l'analyse.
export QIBM_MULTI_THREADED=Y
Le logiciel est découvert et regroupé, mais il n'y a pas de calculs de PVU
Le problème peut provenir d'une époque incorrecte qui pointe sur une date future. L'époque fait partie des noms de fichier des résultats de l'analyse de capacité, par exemple tlm_hw_201603021330_1456969683.xml. Ouvrez l'archive capacity.zip et vérifiez si les époques sont correctes. Si ce n'est pas le cas, vous devrez convertir l'époque en une date normale. Sous Linux, vous pouvez effectuer cette conversion à l'aide de la commande date -d @epoch.
Le nom d'hôte d'un nœud final fourni par le scanner déconnecté est différent de celui attendu
Le nom d'hôte fourni par le scanner déconnecté et celui d'un scanner régulier peuvent être différents. Le scanner régulier utilise le nom d'hôte fourni par BigFix, tandis que le scanner déconnecté vérifie le nom d'hôte en exécutant la commande hostname ou, si cette dernière n'est pas disponible, par l'intermédiaire de la vérification du scanner.
Ouverture d'un dossier de support
Si aucune des solutions ci-dessus ne fonctionne, ouvrez un dossier de support et envoyez les fichiers suivants au support BigFix :
  • Le package avec les résultats d'analyse
    • /Installation directory/run_hw_std.log
    • /Installation directory/run_sw_and_pack_std.log
  • /Installation directory/warning*.xml file
  • journaux du scanner depuis /etc/cit/logs
  • La sortie de la console d'une étape échouée en mode débogage, si possible. L'exemple ci-dessous génère le fichier /cit/failure.log avec la sortie :
    export QIBM_MULTI_THREADED=Y
    /qsys.lib/qtivcit.lib/wscansw.pgm -s -c /cit/sw_config.xml -i /cit/CIT_catalog_I5OS.xml
    -o /cit/catalog_scan_man.xml -e /cit/warning_man.xml -debug
    >/cit/failure.log 2>&1

Surveillance du journal d'importation

Lorsque vous importez un package avec les résultats d'analyse dans BigFix Inventory, le journal d'importation (Gestion > Importation de données) affiche des messages d'information et d'avertissement concernant votre package. Si le package ou son contenu ne répond pas aux exigences, il se peut qu'il soit ignoré pendant l'importation et les résultats d'analyse ne seront pas affichés dans BigFix Inventory. Lors de la surveillance du journal d'importation, les messages suivants peuvent s'afficher :
info : Processing scan package: package from: directory. info: Nom de fichier non valide. The scan package must match the pattern YYYYMMDDHHMM-*.zip. Skipping package: package. info: Invalid Catalog version property in the computer.yml file: version. The property must match the pattern <Number>.<Number>. The catalog might be reported as outdated. warn: The disconnected scans location does not exist: directory. warn: Nom de fichier non valide. The scan date must be later than year 2000. Skipping package: package. warn: Skipping corrupted scan package: package. L'erreur suivante s'est produite : error. warn: Missing computer.yml file. Skipping package: package. warn: Missing property: property in the computer.yml file. Skipping package: package. warn: Invalid computer.yml file. Skipping package: package. L'erreur suivante s'est produite : error. warn: The value of the endpointID property in the computer.yml file is longer than 512 characters. Skipping package: package. warn: The value of the endpointID property in the computer.yml file is empty. Skipping package: package. warn: Missing property: endpointID in the computer.yml file. Skipping package: package. warn: Importing older scan package from: date for computer: computer_id. This computer already has data from: date. warn: The file is larger than 2097150 bytes. Skipping file: scan_file from: package for computer: computer_id. warn: The following error occurred when processing the package_scan.xml file: error. warn: The insertion of the operating_system package data into the database failed on record content. L'erreur suivante s'est produite : error.