この製品のマニュアルセットは、偏向のない言語を使用するように配慮されています。このマニュアルセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザーインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブランゲージに対する取り組みの詳細は、こちらをご覧ください。
このドキュメントは、米国シスコ発行ドキュメントの参考和訳です。リンク情報につきましては、日本語版掲載時点で、英語版にアップデートがあり、リンク先のページが移動/変更されている場合がありますことをご了承ください。あくまでも参考和訳となりますので、正式な内容については米国サイトのドキュメントを参照ください。
DNS サーバ、DHCP サーバ、および TFTP サーバを設定して管理するには、Web ベースのユーザ インターフェイス(Web UI)、または nrcmd コマンドライン インターフェイス(CLI)を使用できます。この章では、 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.1 > Network Registrar 6.1 CLI
この方法では、ユーザ名とパスワードの入力を求めるプロンプトが表示されます。Solaris および Linux では(さらに Windows でも同様に)、コマンド プロンプトから次の構文を使用してコマンドを起動できます。
表 1-1 は、コマンド プロンプトから起動するときの一般的なオプションについて説明しています。「nrcmd コマンドの使用」 では、コマンドおよびコマンド固有のオプションについて説明します。
|
|
---|---|
cluster は、Network Registrar サーバが動作しているマシンの名前です。指定しない場合は、クラスタ名はデフォルトで localhost になります。 |
|
file .txt は、バッチ モードで実行する nrcmd コマンドのファイル名です。1 行ごとに読み取られ、プロンプトの後に新しい行が出力されます。 |
コマンドラインで関数コマンドや -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 :ブール タイプのアトリビュートをディセーブルにします。
– unset :アトリビュートが値を持たないようにします。必須アトリビュートには、unset は使用できません。
Network Registrar 6.0 では、デフォルト値を持つアトリビュートは、対話モードで attribute = [default= value ] という形式で表示されます。対話モードでは、すべてのアトリビュートが表示されます。バッチ モードでは、値を持つアトリビュートだけが表示され、デフォルト値は表示されません。バッチ モードでの表示は、ユーザにとってはあまり見やすくはありませんが、プログラムによって解析をするのに適しています。次の例は、対話モードでの出力とバッチモードでの出力を示して比較しています。
• その他のカスタム メソッド:オブジェクトに対して実行できる特定の操作。アトリビュートの編集以上の操作です。IP アドレス範囲のスコープへの追加、ゾーンからのホストの削除などがあります。
一連の引数を指定する方法は、使用するコマンドの種類によって異なります。この項では、 create 、 set 、および enable の各コマンドの使用方法の違いを説明します。
create キーワードを使用する場合は、必須の引数を指定する必要があります。また、追加の引数も指定できます。必須の引数は指定された順序で指定する必要があります。一方、オプションの引数は、 attribute = value という構文にしたがって、任意の順序で指定できます。
スコープの作成時には IP アドレスとマスクを指定する必要があります。スコープのその他のアトリビュートはオプションで指定できます。
次の例では、IP アドレスに 192.168.50.0、マスクに 255.255.255.0 を指定して、testScope というスコープを作成します。
アトリビュート定義は同一の行にも指定できます。次の例では、上と同じスコープを作成しますが、DHCP クライアントのホスト名の追加先である DNS ゾーンの名前を併せて指定します。
create キーワードがオブジェクトを作成し、指定したすべてのパラメータをオブジェクトに割り当てると、必須アトリビュートに値(デフォルトまたはユーザ指定)がすべて設定されているかどうか確認されます。必要なアトリビュートが省略されている場合は、Network Registrar がエラーを返します。
set キーワードは、すでに作成されているアトリビュートに値を設定するのに使用します。DNS サーバや IP アドレスなど、複数の値のリストを設定する場合は、値をカンマで区切ります。また set キーワードを使用して、同じ行で複数のアトリビュートを設定できます。アトリビュートと値を指定し、空白を 1 つ挿入して、次のアトリビュートと値の組を指定します。
次の例では、DHCP クライアントのホスト名の追加先である DNS ゾーンの名前を指定します。
次の例では、ゾーンに対してゾーン転送のための IP アドレスのリストを指定します。
次の例では、クライアントのクライアントクラスとドメイン名を設定します。
unset キーワードは、アトリビュートを未定義の状態にします。 get キーワードは、アトリビュートの値を表示します。
enable キーワードは、ブール アトリビュートをイネーブルにします。ブール アトリビュートをイネーブルにすると、それに関連するアトリビュートの設定も必要になります。ブール アトリビュートをディセーブルにするには、 disable キーワードを使用します。 unset キーワードを使用すると、イネーブルまたはディセーブルの状態のブール アトリビュートを削除できます。
次の例では、DNS サーバの差分転送処理をイネーブルにします。
差分転送処理がイネーブルである場合に、期限満了インターバルを変更する例を示します。
(注) enable コマンドラインには、set キーワードを追加できません。ブール アトリビュートをイネーブルにしてから、次のコマンドラインで関連するアトリビュートを設定する必要があります。
• 必須:アトリビュートは、オブジェクトに必須です。アトリビュートを設定するか、またはデフォルトを使用する必要があります。値は修正可能です。必須アトリビュートは、 unset キーワードを使って未定義に設定することはできません。未定義に設定しようとすると、「386 - Required attribute cannot be deleted」というエラー メッセージが返されます。
• オプション:アトリビュートはオプションであり、値は必須ではありません。アトリビュートは設定および再設定できます。また、 unset キーワードを使用して未定義に設定できます。
• 読み取り専用:アトリビュートは不変で、読み取り専用です。 get キーワードは使用できますが、set または unset は使用できません。読み取り専用アトリビュートに set または unset を使用しようとすると、「385 - Read-only attribute cannot be modified」というエラー メッセージが返されます。
CLI は、読み取ったコンフィギュレーション オブジェクトの多くをキャッシュします。複数のユーザが同時に変更を加えている場合、CLI インスタンスが古いバージョンのオブジェクトをキャッシュしている場合があります。 session cache refresh コマンドを使用すると、修正されていないすべてのオブジェクトのローカル キャッシュを CLI がクリアし、コンフィギュレーション データベースから CLI がオブジェクトを再度読み込みます。 session cache clear コマンドでは、保存されていない変更がある場合でも、キャッシュされたすべてのデータが CLI によってクリアされます。
表 1-2 は、 nrcmd コマンドの入力時に役立つキーボード ナビゲーション キーの一覧です。
|
|
---|---|
表 1-3 は、 nrcmd コマンドのアルファベット順の一覧です。コマンドは、コマンドラインで使用することも、スクリプトに挿入することもできます。
|
|
---|---|