Cisco CNS Network Registrar CLI リファレンス ガイド Release 6.2.1
偏向のない言語
この製品のマニュアルセットは、偏向のない言語を使用するように配慮されています。このマニュアルセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザーインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブランゲージに対する取り組みの詳細は、こちらをご覧ください。
翻訳について
このドキュメントは、米国シスコ発行ドキュメントの参考和訳です。リンク情報につきましては、日本語版掲載時点で、英語版にアップデートがあり、リンク先のページが移動/変更されている場合がありますことをご了承ください。あくまでも参考和訳となりますので、正式な内容については米国サイトのドキュメントを参照ください。
- Updated:
- 2017年5月31日
章のタイトル： nrcmd プログラムについて
nrcmd プログラムについて
DNS サーバ、DHCP サーバ、および TFTP サーバを設定して管理するには、Web ベースのユーザ インターフェイス（Web UI）、または nrcmd コマンドライン インターフェイス（CLI）を使用できます。この章では、 nrcmd コマンドライン インターフェイスの使用方法について説明します。具体的には、次のトピックについて説明します。
nrcmd コマンドの起動
nrcmd コマンドは、バッチ モードでコマンドを使用したスクリプトを実行して使用、または対話モードで nrcmd コマンド プロンプトにコマンドを入力して使用します。デフォルトでは、 nrcmd コマンドの位置は、Windows では C:\Program Files\Network Registrar\Local\bin、Solaris および Linux では /opt/nwreg2/usrbin です。
（注） Windows で、インストール パスの外側から nrcmd プログラムを実行する場合は、CNR_HOME 環境変数を設定する必要があります。
Windows では、 nrcmd コマンド ウィンドウを Start メニューから次のようにして起動できます。
Start > Programs > Network Registrar 6.2 > Network Registrar 6.2 CLI
この方法では、ユーザ名とパスワードの入力を求めるプロンプトが表示されます。Solaris および Linux では（さらに Windows でも同様に）、コマンド プロンプトから次の構文を使用してコマンドを起動できます。
表1-1 は、コマンド プロンプトから起動するときの一般的なオプションについて説明しています。「nrcmd コマンドの使用」 では、コマンドおよびコマンド固有のオプションについて説明します。
|
|
|
|---|---|
クラスタ（ cluster は、Network Registrar サーバが動作しているマシンの名前です）。指定しない場合は、クラスタ名はデフォルトで localhost になります。 |
|
バッチ ファイル（ file .txt は、バッチ モードで実行する nrcmd コマンドのファイル名です。1 行ごとに読み取られ、プロンプトの後に新しい行が出力されます）。 |
（注） 接続先のクラスタによって、クラスタ上で動作する Network Registrar のリリースで表示される使用可能な CLI アトリビュートが決まります。この『 CLI リファレンス』では、現在のリリースのアトリビュートについて説明します。以前のリリースで使用可能なアトリビュートについては、そのリリースの『CLI リファレンス』を参照してください。
バッチ モード
コマンドラインで関数コマンドや -b< file .txt オプションを入力すると、プログラムはバッチ モードに入ります。テキスト ファイルには、 nrcmd コマンドを任意の数だけ指定できます。また、シャープ記号（#）を行頭に付けて、コメント行として指定できます。バッチ モードでは、通常のシステム プロンプトに戻ります。バッチ モードでの表示は、外部プログラムによる解析を目的としているため、値を持つコマンド アトリビュートのみが表示されます。
（注） 入力ファイル内のコードの最終行には、末尾に行末文字が必要です。また、コードの最終行に、exit コマンドを明示的に指定することをお勧めします。
対話モード
nrmcd コマンドだけを入力した場合、または cluster 、 user 、 password オプションのいずれかを入力した場合は、プログラムが対話モードに入ります。CLI を対話モードで実行するには、次のように入力します。
この構文では、対話型の nrcmd> プロンプトが表示されます。プロンプトには、関数コマンドおよびオプション パラメータを入力します。
複数のアトリビュート値を続けて入力するには、カンマ（,）で区切ります。カンマの後に空白を入れないでください。値が空白を含む文字列の場合は、引用符で囲みます。
対話セッションを終了するには、 exit コマンドを入力します。オンライン ヘルプを表示するには、 help コマンドを入力します。
レジストリおよび環境変数
Network Registrar は、一般的なオプションを省略した場合はレジストリまたは環境変数から取得します。Network Registrar がパラメータの値を検出できない場合は、入力を求めるプロンプトが表示されます。Network Registrar サーバがインストールされているシステム上のクラスタ名を省略した場合、 nrcmd プログラムは、 localhost へのアクセスを前提とします。プロンプトは表示されません。
nrcmd プログラムが認識する設定可能な環境変数では、CNR_NAME が名前、CNR_PASSWORD がパスワード、CNR_CLUSTER がクラスタ名です。
コマンド構成
nrcmd コマンドは、オブジェクト クラスを指定します。オブジェクト クラスは作成、削除、または一覧表示できます。オブジェクトには、それぞれアトリビュートがあり、データ タイプに応じて、イネーブル、ディセーブル、設定、取得、および設定解除ができます。オブジェクトには、共通メソッドもあります。共通メソッドはオブジェクト タイプに固有で、アトリビュート グループに対して操作を実行できます。
nrcmd コマンドを使用して Network Registrar を設定すると、次の操作を実行できます。
•
クラス：スコープ、ポリシー、ゾーンなどのように、作成、削除、表示、または一覧表示するもの。
– create ：エントリを作成します。エントリがすでに存在する場合は、コマンドがエラーを返します。
– list ：指定したタイプのすべてのオブジェクトを、アトリビュートも含めてすべて表示します。
– listnames ：指定したタイプのオブジェクトの名前だけをすべて表示します。
• アトリビュート：イネーブルまたはディセーブルにできるもの。または、共通メソッドを使用して値を設定または表示できるもの。
– enable ：ブール タイプのアトリビュートをイネーブルにします。
– disable ：ブール タイプのアトリビュートをディセーブルにします。
– get ：明示的に定義されたアトリビュートの値を表示します。
– unset ：アトリビュートが値を持たないようにします。必須アトリビュートは設定解除できません。
（注） nrcmd を使用して、暗黙的に定義されたアトリビュートの値を get することはできません。これには、暗黙的に定義されたデフォルト値も含まれます。
アトリビュートを設定するには、次の 3 つの方法があります。
–オブジェクトの作成に必須のアトリビュートの場合は、値を create コマンドの構文内で所定の位置に指定する必要があります。たとえば、ハイ アベイラビリティ（HA）DNS サーバ ペアを作成するには、作成時にメイン サーバとバックアップ サーバのクラスタおよび IP アドレスを指定できます。
–オブジェクトを作成した後、 set コマンドまたは enable コマンドを使用します。たとえば、作成した HA DNS ペアにメイン サーバとバックアップ サーバへのクラスタ参照だけを設定できます。
– attribute = value のペアを create コマンドの末尾に追加します。
位置の値と attribute = value ペアの両方を create コマンドラインで同じアトリビュートに使用した場合、 attribute = value ペアが後になるため、これが実際に使用される値になります。
Network Registrar 6.0 では、デフォルト値を持つアトリビュートは、対話モードで attribute = [default= value ] という形式で表示されます。対話モードでは、すべてのアトリビュートが表示されます。バッチ モードでは、値を持つアトリビュートだけが表示され、デフォルト値は表示されません。バッチ モードでの表示は、ユーザにとってはあまり見やすくはありませんが、プログラムによって解析をするのに適しています。次の例は、対話モードでの出力とバッチモードでの出力を示して比較しています。
• その他のカスタム メソッド：オブジェクトに対して実行できる特定の操作。アトリビュートの編集以上の操作です。IP アドレス範囲のスコープへの追加、ゾーンからのホストの削除などがあります。
コマンドの使用方法
一連の引数を指定する方法は、使用するコマンドの種類によって異なります。この項では、 create 、 set 、および enable の各コマンドの使用方法の違いを説明します。
create キーワード
create キーワードを使用する場合は、必須の引数を指定する必要があります。また、追加の引数も指定できます。必須の引数は指定された順序で指定する必要があります。一方、オプションの引数は、 attribute = value という構文にしたがって、任意の順序で指定できます。
スコープの作成時には IP アドレスとマスクを指定する必要があります。スコープのその他のアトリビュートはオプションで指定できます。
次の例では、IP アドレスに 192.168.50.0、マスクに 255.255.255.0 を指定して、testScope というスコープを作成します。
アトリビュート定義は同一の行にも指定できます。次の例では、上と同じスコープを作成しますが、DHCP クライアントのホスト名の追加先である DNS ゾーンの名前を併せて指定します。
create キーワードがオブジェクトを作成し、指定したすべてのパラメータをオブジェクトに割り当てると、必須アトリビュートに値（デフォルトまたはユーザ指定）がすべて設定されているかどうか確認されます。必要なアトリビュートが省略されている場合は、Network Registrar がエラーを返します。
set キーワード
set キーワードは、すでに作成されているアトリビュートに値を設定するのに使用します。DNS サーバや IP アドレスなど、複数の値のリストを設定する場合は、値をカンマで区切ります。また set キーワードを使用して、同じ行で複数のアトリビュートを設定できます。アトリビュートと値を指定し、空白を 1 つ挿入して、次のアトリビュートと値の組を指定します。
次の例では、DHCP クライアントのホスト名の追加先である DNS ゾーンの名前を指定します。
次の例では、ゾーンに対してゾーン転送のための IP アドレスのリストを指定します。
次の例では、クライアントのクライアントクラスとドメイン名を設定します。
unset キーワードは、アトリビュートを未定義の状態にします。 get キーワードは、アトリビュートの値を表示します。
enable キーワード
enable キーワードは、ブール アトリビュートをイネーブルにします。ブール アトリビュートをイネーブルにすると、それに関連するアトリビュートの設定も必要になります。ブール アトリビュートをディセーブルにするには、 disable キーワードを使用します。 unset キーワードを使用すると、イネーブルまたはディセーブルの状態のブール アトリビュートを削除できます。
次の例では、DNS サーバの差分転送処理をイネーブルにします。
差分転送処理がイネーブルである場合に、期限満了インターバルを変更する例を示します。
（注） set と enable を同じコマンドラインで使用することはできません。
アトリビュート フラグ
• 必須：アトリビュートはオブジェクトにとって必須であり、通常、 create コマンドラインで構文上の位置が決まっています。アトリビュートを設定するか、またはデフォルトを使用する必要があります。値は修正可能です。必須アトリビュートは、 unset キーワードを使って未定義に設定することはできません。未定義に設定しようとすると、「386 - Required attribute cannot be deleted」というエラーメッセージが返されます。
• オプション：アトリビュートはオプションであり、値は必須ではありません。アトリビュートは設定および再設定できます。また、 unset キーワードを使用して未定義に設定できます。
• 読み取り専用：アトリビュートは不変で、読み取り専用です。 get キーワードは使用できますが、set または unset は使用できません。読み取り専用アトリビュートに set または unset を使用しようとすると、「385 - Read-only attribute cannot be modified」というエラー メッセージが返されます。
変更の保存
Network Registrar 6.2 で導入された新規コマンドの場合、 nrcmd は加えられた変更をすぐに適用します（Network Registrar 6.2 で導入されたコマンドの一覧は、『Release Notes』に示されています）。以前のリリースのコマンドでは、CLI は次のいずれかのイベントが発生するのを待ってから、変更をデータベースに保存します。
CLI キャッシュのリフレッシュとクリア
CLI は、読み取ったコンフィギュレーション オブジェクトの多くをキャッシュします。複数のユーザが同時に変更を加えている場合、CLI インスタンスが古いバージョンのオブジェクトをキャッシュしている場合があります。 session cache refresh コマンドは、修正されていないすべてのオブジェクトのローカル キャッシュを CLI がクリアし、コンフィギュレーション データベースから CLI がオブジェクトを再度読み込みます。 session cache clear コマンドでは、保存されていない変更がある場合でも、キャッシュされたすべてのデータが CLI によってクリアされます。
ナビゲーション キー
表1-2 は、 nrcmd コマンドの入力時に役立つキーボード ナビゲーション キーの一覧です。
|
|
|
|---|---|
コマンド一覧
表1-3 は、 nrcmd コマンドのアルファベット順の一覧です。コマンドは、コマンドラインで使用することも、スクリプトに挿入することもできます。
|
|
|
|---|---|
フィードバック