Utilitaire d'importation de topologie

La commande import récupère les données de topologie exportées au préalable pour le domaine spécifié à partir d'un fichier.

Paramètres de la commande d'importation

La commande import accepte les paramètres suivants :

domain

La valeur du paramètre domain est le nom du domaine dont la topologie va être importée. Si aucun domaine n'est spécifié, tous les domaines sont importés.

domainmode

La valeur du paramètre domainmode détermine si de nouveaux domaines sont ou non créés à partir de la topologie importée. Si sa valeur est follow (complet), la topologie des groupes et des domaines est importée dans la topologie courante, et de nouveaux domaines peuvent être créés. Si sa valeur est ignore (restreint), seuls les groupes et les entités sont importés dans le domaine cible spécifié.

filename

La valeur de filename est le nom du fichier duquel les informations de topologie doivent être extraites.

nodemode

La valeur du paramètre nodemode détermine si la topologie importée remplace ou non celle existante. Si la valeur du paramètre nodemode est replace, les données en conflit sont remplacées par les valeurs importées. Si la valeur du paramètre nodemode est ignore, les données en conflit ne sont pas mises à jour.

Une affectation explicite dans la ligne de commande remplace toute affectation similaire dans le fichier des paramètres. Par exemple, si mode=ignore est fixé dans la ligne de commande et mode=follow dans le fichier de paramètres, mode=ignore est utilisé.

Exemple 19–1 Importation de données de topologie à partir d'un fichier

Dans l'exemple suivant, la topologie exportée au préalable est importée du fichier /home/examples/snapshot. Les nouveaux domaines sont créés comme nécessaires, et les données conflictuelles sont remplacées par la topologie importée.

> import filename=/home/examples/snapshot domainmode=follow \
nodemode=replace

Messages de confirmation

L'utilitaire d'importation vous invite à répondre à différents messages avant d'effectuer l'opération ou en cas de conflit au niveau des données :

• Message d'avertissement demandant confirmation – Le message suivant vous demande de confirmer l'opération d'importation.

  The data being used is exported by <user name> on <mm/dd/yyyy>. The import operation will modify your topology database, are you sure you want to do this? [Yes/No]

  Entrez y pour Yes (Oui) ou n pour No (Non).

• Conflits de données – Le message suivant vous demande de décider que faire avec les données en conflit.

  The entity <entity name> already exists in your topology hierarchy, do you want to replace it? [Replace(r)/replace All(a)/Ignore(i)/iGnore all(g)/Stop(s)]

  Les réponses possibles à ce message incluent les options suivantes :

  r

  Remplace les données en conflit par de nouvelles valeurs.

  a

  Remplace toutes les données en conflit par de nouvelles valeurs.

  i

  Ne met pas à jour les données en conflit.

  g

  Tous les conflits sont ignorés et laissés tels quels.

  s

  Arrête l'opération d'importation.

Messages de sortie de la commande d'importation

Cette section décrit les messages qui peuvent apparaître suite à la commande d'importation.

import: Done.

Origine :

Réussite

Description :

Opération achevée avec succès.

nom-fichier: No such file.

Origine :

Le fichier n'existe pas.

Description :

Le fichier indiqué n'existe pas. Deux fichiers peuvent être utilisés par la ligne de commande : le fichier de données qui constitue la source des données à importer et un fichier de paramètres qui contient une liste de paramètres.

import: Cannot open nomfichier.

Origine :

Autorisation refusée.

Description :

Le fichier ne peut pas être ouvert pour être lu.

import: File format is not supported.

Origine :

Format erroné.

Description :

Le fichier source n'est pas un fichier de données d'exportation de base de données valide.

import: File out-of-date ( xxdays).

Origine :

Données obsolètes.

Description :

Les données que vous utilisez sont obsolètes.

import: Authentication failed.

Origine :

Echec de l'authentification.

Description :

L'utilisateur courant n'est pas autorisé à créer des objets dans la hiérarchie topologique.

import: Wrong parameter file.

Origine :

Erreur au niveau du fichier de paramètres.

Description :

Le fichier de paramètres devrait être une liste de couples nom = valeur. Si ce n'est pas le cas, l'application génère un message d'erreur et s'arrête.

import: illegal parameter - < para>.

Use -h option to get usage.

Origine :

Paramètre non-admis.

Description :

Un paramètre non-admis est transféré à l'opération d'importation. Utilisez import -h pour afficher les options et les paramètres disponibles.