Interface ILC d'importation et d'exportation

Vous pouvez appeler les utilitaires d'importation et d'exportation depuis l'ILC avec les commandes suivantes :

# /opt/SUNWsymon/sbin/es-cli
> login
Host: nom-serveur
Login: nom-utilisateur
Password: mot-de-passe
Login successful!
> export paramètre
> import paramètre

Pour toute information sur les paramètres de commande appropriés, reportez-vous à Paramètres de la commande d'importation et à Paramètres de la commande d'exportation.

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.

Utilitaire d'exportation de topologie

La commande export enregistre les données de topologie pour un ou tous les domaines, dans un fichier.

Paramètres de la commande d'exportation

La commande export accepte les paramètres suivants :

comment

La valeur du paramètre comment est une remarque à inclure dans le fichier.

domain

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

filename

La valeur de filename est le nom du fichier dans lequel les informations de topologie doivent être exportées.

mode

La valeur du paramètre mode détermine comment les informations de topologie sont incorporées dans le fichier. Si sa valeur est append (ajout), les données sont ajoutées au contenu du fichier. Si sa valeur est overwrite (surécriture), le contenu précédent du fichier est remplacé par les nouvelles données.

validity

La valeur du paramètre validity est la durée en jours pendant laquelle les données sont valides. Les valeurs suivantes sont les valeurs admises par le paramètre validity :

• Unlimited ;

• 7 ;

• 15 ;

• 30 ;

• 90.

Exemple 19–2 Exportation de la topologie du domaine par défaut dans un fichier

Dans l'exemple suivant, le Domaine par défaut est enregistré dans un fichier nommé cliché. Le contenu d'origine de cliché est écrasé par les nouvelles données. On assume que la durée de validité des nouvelles données est illimitée. Les commentaires spécifient que ces données sont relatives au groupe des tests système.

> export filename=/home/examples/cliché \
domain="Domaine par défaut" mode=overwrite validity=Unlimited \
comment="Groupe des tests système"

Commentaires sur l'exportation

Après avoir appelé la commande d'exportation, il vous est demandé d'entrer des commentaires. L'invite est >. Appuyez sur la touche Retour pour aller à la ligne. Appuyez deux fois sur Retour pour mettre fin à vos commentaires.

Exemple 19–3 Commentaires lors d'une exportation via l'ILC

> export -p domain=ALL mode=append <return>
Please enter comments for the export:
> Ligne de texte de commentaire 1 <Retour>
>Ligne de texte de commentaire2 <Retour>
> <Retour>
<
State = OK
message = Done.
>

Messages de sortie de la commande d'exportation

La liste suivante reprend les messages qui peuvent apparaître suite à la commande d'exportation.

export: Done.

Origine :

Réussite

Description :

Opération achevée avec succès.

export: Cannot open fichier.

Origine :

Le fichier n'existe pas.

Description :

Le fichier de paramètres n'existe pas.

nom-fichier: Permission denied.

Origine :

Erreur du fichier.

Description :

Le fichier ne peut pas être créé ni ouvert pour l'écriture.

export: File format not supported.

Origine :

Format erroné.

Description :

L'erreur s'est produite suite à l'ajout des données d'exportation à un fichier qui n'est pas un fichier de données d'exportation valide.

export: The domain < nomdomaine> does not exist.

Origine :

Erreur objet.

Description :

Le domaine que l'utilisateur veut exporter n'existe pas.

export: Wrong parameter file.

Origine :

Erreur au niveau du fichier de paramètres.

Description :

Le fichier des paramètres contient une liste de couples nom = valeur. Si le format du fichier est incorrect, l'application vous avertit et s'arrête.

export: The current user is different from the last one.

Origine :

Conflit d'utilisateurs.

Description :

L'erreur est survenue lorsque vous avez essayé de surécrire ou d'ajouter des données à un fichier existant créé par un tiers. Vous ne pouvez pas modifier ni surécrire des données d'exportation créées par un tiers.

export: Data is out-of-date.

Origine :

Données trop anciennes.

Description :

Vous vous servez d'un fichier d'exportation obsolète. Ce message ne survient que dans le cadre de l'exportation de données en mode ajout.

export: illegal parameter - < para>.

Please use -h option to get usage.

Origine :

Paramètre non-admis.

Description :

Un paramètre non-admis a été transféré à l'opération d'exportation.