import コマンドは、特定ドメインにエクスポートされたトポロジデータを、ファイルから取り出します。
import コマンドは、次のパラメータを使用します。
domain パラメータの値は、インポートされるトポロジのドメイン名となります。ドメイン名の指定がない場合は、全てのドメインがインポートされます。
domainmode パラメータの値は、インポートされたトポロジから新規ドメインを作成するかどうかを決定します。この値が follow の場合は、グループとドメイントポロジが現在のトポロジにインポートされ、新規のドメインが作成されます。また、この値が ignore の 場合は、グループとエンティティが指定ドメインにインポートされます。
filename パラメータの値は、トポロジ情報を取り出すファイルの名前です。
nodemode パラメータの値は、インポートされたトポロジが既存トポロジを上書きするかどうかを決定します。この nodemode パラメータ値が replaceの場合、重複データはインポート値に置き換えられます。また、nodemode パラメータ値が ignore の場合、重複データは更新されません。
コマンド行の明示的な割り当ては、パラメータファイルの同一の割り当てに優先されます。例えば、mode=ignore がコマンド行に割り当てられ、mode=follow がパラメータファイルに割り当てられた場合、mode=ignore が使用されます。
次の例では、すでにエクスポートされたトポロジを /home/examples/snapshot ファイルからインポートします。必要に応じて新規ドメインが作成され、重複データがインポートされたトポロジに置き換わります。
> import filename=/home/examples/snapshot domainmode=follow \ nodemode=replace |
インポートユーティリティは、操作の実行前またはデータが重複すると、次のようなプロンプトを出します。
確認を求める警告メッセージ – インポート操作を確認するために、次のメッセージが表示されます。
<ユーザ名> によって <mm/dd/yyyy> にエクスポートされたファイルです。 インポートによってトポロジデータベースが変更されます。続行してもよろしいですか? |
「はい」の場合は y を、「いいえ」の場合は n を入力します。
データ重複 – 重複したデータの扱いを決定するために、次のメッセージが表示されます。
オブジェクト <オブジェクト名> はすでに存在します。書き換えてよろしいですか? |
このメッセージには次の値を選択できます。
重複データを新規データに置き換える
全ての重複データを新規データに置き換える
重複データを更新しない
全ての重複データを無視してそのまま残す
インポート操作を中止する
この節では、インポートコマンドの結果として表示されるメッセージについて説明します。
import: Done.
成功しました。
説明:エクスポートに成功しました。
インポート: ファイル (ファイル名) が存在しません。
ファイルが存在しません。
説明:指定されたファイルが存在しません。コマンド行が、インポートデータソースを提供するデータファイルと、パラメータリストを提供するパラメータファイルの両方に使用されている可能性があります。
インポート: アクセス権がありません。
アクセス権がありません。
説明:ファイルを開いて読み込むことができません。
インポート: 不正なファイル形式です。
フォーマットが不正です。
説明:ソースファイルが、データのエクスポートに有効なデータベースファイルではありません。
インポート: 追加しようとしているファイルは期限切れです。
データが期限切れです。
説明:期限切れのデータを使用しています。
import: Authentication failed.
認証に失敗しました。
説明:現在のユーザには、トポロジ階層でオブジェクトを作成する権限がありません。
import: Wrong parameter file.
パラメータファイルエラー
説明:パラメータファイルは、name = 値r のペアで構成されなければなりません。ファイル形式が不正の場合、エラーメッセージが表示されて操作が停止されます。
import: illegal parameter - < para>.
Use -h option to get usage.
パラメータが不正です。
説明:インポート操作に不正なパラメータが指定されました。import -h で、使用可能なオプションとパラメータを確認してください。