インポートとエクスポートのコマンド行インタフェース

インポートユーティリティーとエクスポートユーティリティーは、コマンド行インタフェース (CLI ) から次のコマンドで起動できます。

# /opt/SUNWsymon/sbin/es-cli
> login
Host: servername
Login: username
Password: password
Login successful!
> export parameter
> import parameter

適切なコマンドパラメータについては、「インポートコマンドパラメータ」および 「エクスポートコマンドパラメータ」を参照してください。

トポロジのインポートユーティリティー

import コマンドは、特定ドメインにエクスポートされたトポロジデータを、ファイルから取り出します。

インポートコマンドパラメータ

import コマンドは、次のパラメータを使用します。

domain

domain パラメータの値は、インポートされるトポロジのドメイン名となります。ドメイン名の指定がない場合は、すべてのドメインがインポートされます。

domainmode

domainmode パラメータの値は、インポートされたトポロジから新規ドメインを作成するかどうかを決定します。この値が follow の場合は、グループとドメイントポロジが現在のトポロジにインポートされ、新規のドメインが作成されます。また、この値が ignore の場合は、グループとエンティティーが指定ドメインにインポートされます。

filename

filename パラメータの値は、トポロジ情報を取り出すファイルの名前です。

nodemode

nodemode パラメータの値は、インポートされたトポロジが既存トポロジを上書きするかどうかを決定します。この nodemode パラメータ値が replaceの場合、重複データはインポート値に置き換えられます。また、nodemode パラメータ値が ignore の場合、重複データは更新されません。

コマンド行の明示的な割り当ては、パラメータファイルの同一の割り当てに優先されます。たとえば、mode=ignore がコマンド行に割り当てられ、mode=follow がパラメータファイルに割り当てられた場合は、mode=ignore が使用されます。

例 19–1 トポロジデータをファイルからインポートする

次の例では、すでにエクスポートされたトポロジを /home/examples/snapshot ファイルからインポートします。必要に応じて新規ドメインが作成され、重複データがインポートされたトポロジに置き換わります。

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

確認メッセージ

インポートユーティリティーは、操作の実行前またはデータが重複すると、次のようなプロンプトを出します。

• 確認を求める警告メッセージ – インポート操作を確認するために、次のメッセージが表示されます。

  <ユーザー名> によって<mm/dd/yyyy> にエクスポートされたファイルです。 インポートによってトロポジデータベースが変更されます。続行してもよろしいですか ? [Yes/No]

  「はい」の場合は y を、「いいえ」の場合は n を入力します。

インポートコマンドメッセージの出力

ここでは、インポートコマンドの結果として表示されるメッセージについて説明します。

import: Results 1/1

State=Success

Message=The topology data is successfully imported.

原因:

成功しました。

説明:

エクスポートに成功しました。

filename: No such file.

原因:

ファイルが存在しません。

説明:

指定されたファイルが存在しません。コマンド行が、インポートデータソースを提供するデータファイルと、パラメータリストを提供するパラメータファイルの両方に使用されている可能性があります。

import: Cannot open filename.

原因:

Permission denied.

説明:

ファイルを開いて読み込むことができません。

import: File format is not supported.

原因:

フォーマットが不正です。

説明:

ソースファイルが、データのエクスポートに有効なデータベースファイルではありません。

import: File out-of-date (xx days).

原因:

データが期限切れです。

説明:

期限切れのデータを使用しています。

import: Authentication failed.

原因:

Authentication failed.

説明:

現在のユーザーには、トポロジ階層でオブジェクトを作成する権限がありません。

import: Wrong parameter file.

原因:

パラメータファイルエラー

説明:

パラメータファイルは、 name = value のペアで構成されなければなりません。ファイル形式が不正の場合、エラーメッセージが表示されて操作が停止されます。

import: illegal parameter - <para>.

Use -h option to get usage.

原因:

パラメータが不正です。

説明:

インポート操作に不正なパラメータが指定されました。import -h で、使用可能なオプションとパラメータを確認してください。

トポロジのエクスポートユーティリティー

export コマンドは、単一ドメインまたは全ドメインのトポロジデータをファイルに保存します。

エクスポートコマンドパラメータ

export コマンドでは、次のパラメータを使用します。

comment

comment パラメータの値は、ファイルに含まれる注釈です。

domain

domain パラメータの値は、エクスポートされるトポロジのドメイン名です。ドメインの指定がない場合は、すべてのドメインがエクスポートされます。

filename

filename パラメータの値は、トポロジ情報のエクスポート先のファイル名です。

mode

mode パラメータの値は、トポロジ情報をファイルに組み込む方法を決定します。この値が append の場合、データはファイル内容のあとに追加されます。overwrite の場合は、ファイルの既存情報が新規データに置き換わります。

validity

validity パラメータの値は、データが有効な日数です。選択可能な日数は、次のとおりです。

• Unlimited

• 7

• 15

• 30

• 90

例 19–2 デフォルトトポロジをファイルへエクスポートする

次は、Default Domain が snapshotファイルに保存される例です。 snapshot の元の内容は、新規データによって上書きされます。新規データは無期限に有効と仮定され、システムテストグループ用のデータであることがコメントで指定されます。

> export filename=/home/examples/snapshot \
domain="Default Domain" mode=overwrite validity=Unlimited \
comment="System Test Group"

エクスポートコマンドの出力メッセージ

エクスポートコマンドの結果として、次のようなメッセージが表示されます。

Export: Results 1/1

State=Success

Message=The topology data is successfully exported.

原因:

成功しました。

説明:

エクスポートに成功しました。

export: Cannot open file.

原因:

ファイルが存在しません。

説明:

パラメータファイルが存在しません。

filename: Permission denied.

原因:

ファイルエラー

説明:

ファイルを作成できないか、開いて書き込むことができません。

export: File format not supported.

原因:

フォーマットが不正です。

説明:

エクスポートデータを不正なファイルのあとに追加しようとしてエラーが発生しました。

export: The domain <domainname> does not exist

原因:

オブジェクトエラー

説明:

エクスポートするドメインが存在しません。

export: Wrong parameter file.

原因:

パラメータファイルエラー

説明:

パラメータファイルは、 name = value のペアで構成されなければなりせん。ファイル形式が不正の場合、エラーメッセージが表示されて操作が停止されます。

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

原因:

ユーザー競合

説明:

ほかのユーザーが作成したデータファイルに対して、データを上書きまたは最後に追加しようとするとエラーが発生します。自分以外のユーザーが作成したエクスポートデータを変更したり上書きしたりすることはできません。

export: Data is out-of-date.

原因:

データが古すぎます。

説明:

期限切れのエクスポートファイルを使用しています。このメッセージは、追加モードでデータをエクスポートする場合にのみ表示されます。

export: illegal parameter - <para>.

Please use -h option to get usage.

原因:

パラメータが不正です。

説明:

エクスポート操作に不正なパラメータが指定されました。