Guide de l'administrateur système APTARE IT Analytics

Description

Importe des relations d'hôte à groupe d'hôtes à partir d'un fichier délimité par des virgules. Vous pouvez choisir de contrôler le mouvement de l'hôte qui enregistre les détails lorsqu'un hôte est supprimé, ajouté ou déplacé.

Se reporter à Exemple de fichier d'audit (sortie de load_package.loadGroupMemberFile).

Utilisation

execute load_package.loadGroupMemberFile('<file_name>',
'<recycle_group>', <remove_old_entries>,'<audit_pathname>',
'<audit_output_file>', <do_log>);

Où :

file_name est le chemin d'accès qualifié complet au fichier csv. Par exemple :

/opt/aptare/database/hosts.csv

recycle_group est le chemin d'accès complet au groupe dans lequel les hôtes supprimés seront déplacés (c'est-à-dire la 'corbeille').

remove_old_entries vous permet de supprimer des relations dans la base de données de rapports qui ne figurent pas dans le fichier. S'il est défini sur 1 et qu'il existe des hôtes ayant une relation précédente avec un groupe d'hôtes et où cette relation n'est plus représentée dans le fichier, l'utilitaire déplace ces hôtes vers le groupe de recyclage. S'il est défini sur 0, l'utilitaire ne supprime pas ces hôtes.

audit_pathname est le chemin d'accès complet au fichier d'audit, à l'exclusion du nom de fichier.

audit_output_file est le nom du fichier d'audit où les résultats d'audit seront stockés.

do_logenables vous permet d'activer la fonction d'audit afin que tous les mouvements d'hôte soient enregistrés dans le fichier audit_output_file. Saisissez un chiffre : 0 ou 1, où 0 = Non, 1 = Oui.

Exemple de commande :

exécuter load_package.loadgroupmemberfile ('/opt/aptare/database/movehosts.csv','/Global1/Recycle',1,'/opt/aptare/database','movehosts.out',1) ;

Charger les spécifications du fichier

La spécification du fichier délimité par des virgules est la suivante :

path_to_host_group, internal_name1, internal_name2, 
internal_name3, etc.

Où path_to_host_group est le chemin d'accès complet au groupe d'hôtes dans lequel les hôtes doivent être ajoutés, et internal_name1 est le nom interne d'un hôte dans la hiérarchie des groupes d'hôtes existante.

Exemple :

/APTARE/Test, testhost01, testhost02
/APTARE/Infrastructure, testhost02, testhost03

Les spécifications détaillées pour chaque champ sont les suivantes :

internal_name              CHAR(64)    NOT NULL

Contraintes de données

Le premier champ, path_to_host_group, doit être le chemin d'accès complet à un groupe d'hôtes existant. S'il n'existe aucun groupe d'hôtes dans la valeur du champ path_to_host_group, l'utilitaire les crée.

Les valeurs de champ ne peuvent pas contenir de virgules intégrées.

Le fichier csv doit exister et être lisible.

Le dossier du groupe de recyclage doit exister.

Chaque ligne doit avoir au moins un hôte spécifié, sinon la ligne ne sera pas traitée.

Conditions logiques

Si vous répertoriez les hôtes après le champ path_to_host_group et que ces hôtes se trouvent dans la hiérarchie des groupes d'hôtes existante, l'utilitaire ajoute ces groupes d'hôtes au groupe d'hôtes spécifié.

Si un hôte avec le nom interne spécifié n'existe pas dans la hiérarchie, la relation ne sera pas ajoutée. L'hôte doit déjà être configuré dans la base de données de rapports.

S'il n'existe aucun groupe d'hôtes dans la valeur du champ path_to_host_group, l'utilitaire les crée.

Si le paramètre removeOldEntries est défini sur 1, l'utilitaire suppose que ce fichier contiendra toutes les relations requises. En d'autres termes, pour tous les groupes d'hôtes que vous spécifiez dans le fichier, seuls ces hôtes seront dans ce groupe après l'exécution de cet utilitaire. Si le groupe d'hôtes contenait auparavant d'autres hôtes qui ne sont plus répertoriés dans le fichier, l'utilitaire supprime ces hôtes du groupe d'hôtes et les déplace vers le dossier de recyclage.

L'utilitaire ne supprime pas les groupes d'hôtes de la base de données de rapports ; il supprime uniquement les membres d'un groupe d'hôtes.

Si un groupe d'hôtes dans la base de données de rapports n'est pas répertorié dans le fichier, l'utilitaire n'entreprend aucune action de traitement à l'encontre de ce groupe d'hôtes.

Les groupes d'hôtes avec plusieurs hôtes peuvent être divisés en plusieurs lignes pour faciliter la maintenance des fichiers - par exemple, le groupe d'hôtes et certains hôtes apparaissent sur la première ligne, puis le même groupe d'hôtes et d'autres hôtes apparaissent sur les lignes suivantes.

Enregistrement

L'utilitaire enregistre tous les ajouts, mises à jour, avertissements et erreurs dans le fichier scon.log, qui se trouve dans /tmp par défaut sur les systèmes Linux et C:\opt\oracle\logs sur les systèmes Windows. Les chaînes d'enregistrement sont généralement au format suivant :

Date -> Time -> Level -> load_package:sub_routine -> Action

Où :

Le niveau est DBG, INFO, WARN ou ERR.

sub_routine est la sous-routine en cours d'exécution (par exemple, loadServerLine).

Action est l'action qui faisait l'objet d'un rapport.

Exemple :

14-MAY 19:00:06 ERR  load_package:loadServerGroupMembers: 
Host group /APTARE/Business Views/Regional Offices/
Connecticut does not exist on line 6 of the data load file