Chapter1. 新機能および変更された機能に関する情報

- 新機能および変更された機能に関する情報

新機能および変更された機能に関する情報

Cisco APICリリース 4.2(1) 以降、すべての NX-OS スタイル CLI の手順は、Cisco Application Policy Infrastructure Controller（APIC）ドキュメンテーション ページにあるさまざまな構成ガイドに記載されています。

https://www.cisco.com/c/en/us/support/cloud-systems-management/application-policy-infrastructure-controller-apic/tsd-products-support-series-home.html

Chapter2. APIC CLI の使用

APIC リリース 6.1(2) 以降、Cisco APIC NX-OS スタイル CLI の構成モードはサポートされなくなりました。EXEC モードや UNIX CLI など、APIC CLI の他の機能は引き続き使用できます。

- NX-OS スタイル CLI へのアクセス

- APIC 用 NX-OS スタイル CLI の使用

- NX-OS との使用方法の違い

- ユーザー インターフェイスの混在に関する制限

NX-OS スタイル CLI へのアクセス

（注）

Cisco APIC リリース 1.0 からリリース 1.2 まででは、デフォルト CLI は管理対象オブジェクト（MO）および管理情報モデルのプロパティから上で直接動作するコマンドの Bash シェルでした。Cisco APIC リリース 1.2 以降のデフォルト CLI は NX-OS スタイル CLI です。オブジェクト モデル CLI は、最初の CLI プロンプトで bash コマンドを入力することにより使用できます。

手順

ステップ 1

セキュア シェル（SSH）クライアントから、username@ip-address の APIC への SSH 接続を開きます。

初期設定時に設定した管理者のログイン名とアウトオブバンド管理 IP アドレスを使用します。たとえば、admin@192.168.10.1 などがこれに該当します。

ステップ 2

プロンプトが表示されたら、管理者パスワードを入力します。

次のタスク

NX-OS スタイル CLI を入力する場合、最初のコマンド レベルは EXEC レベルになります。このレベルから、次の構成モードに到達できます。

- NX-OS スタイル CLI で続行するには、EXEC モードのままにするか、configure を入力して、グローバル構成モードに入ります。

これらのコマンドの詳細については、 『Cisco APIC NX-OS スタイル CLI コマンド資料』を参照してください。

- オブジェクト モデル CLI にアクセスするには、 bash と入力します。

オブジェクト モード CLI コマンドの詳細については、『 Cisco APIC Command-Line Interface User Guide, APIC Releases 1.0 and 1.1』を参照してください。

APIC 用 NX-OS スタイル CLI の使用

CLI コマンド モードの使用

NX-OS スタイル CLI は、ルートに EXEC モードを持つコマンド モードの階層にまとめられており、グローバル構成モードで始まる構成サブモードのツリーが含まれます。使用可能なコマンドは、現在のモードによって異なります。任意のモードで使用可能なコマンドのリストを取得するには、システムプロンプトで疑問符（?）を入力します。

次の表に、最も一般的に使用される 2 つのモード（EXEC およびグローバル構成）と、サブモード（DNS）の例を示します。次の表に、モードの開始方法と終了方法、および結果として表示されるシステム プロンプトを示します。システム プロンプトは、現在のモードとそのモードで使用可能なコマンドを識別するのに役立ちます。

モード

アクセス方法

プロンプト

終了方法

EXEC

APIC プロンプトから、 execshと入力します。

apic#

終了してログイン プロンプトに戻るには、exit コマンドを使用します。

グローバル コンフィギュレーション

EXEC モードで、configure コマンドを入力します。

apic(config)#

構成サブモードから親モードに戻るには、 exit コマンドを使用します。

構成モードまたは構成サブモードから EXEC モードに戻るには、 exit コマンドを使用します。

DNS 構成

グローバル構成モードで、dns コマンドを入力します。

apic(config-dns)#

CLI コマンド階層

構成モードには複数のサブモードがあり、同様の機能を実行するコマンドは同じレベルでグループ化されています。たとえば、システム、構成、またはハードウェアに関する情報を表示するすべてのコマンドは show コマンドの下にグループ化され、スイッチを設定できるすべてのコマンドは configure コマンドの下にグループ化されています。

EXEC モードで使用できないコマンドを実行するには、階層の最上位レベルからサブモードに移動します。たとえば、DNS を設定するには、 configure コマンドを使用してグローバル構成モードを開始し、 dns コマンドを入力します。DNS 構成サブモードでは、使用可能な コマンドを照会できます。次の例のように行います。

apic1# configure
apic1(config)# dns
apic1(config-dns)# ?
address   Configure the ip address for dns servers
domain    Configure the domains for dns servers
exit      Exit from current mode
fabric    Show fabric related information
no        Negate a command or set its defaults
show      Show running system information
use-vrf   Configure the management vrf for dns servers
where     Show the current mode

apic1(config-dns)# end
apic1#

各サブモードに入ると、プロンプト階層のさらに深いレベルで操作できます。現在のモードの階層を表示するには、次の例に示すように、 configure コマンドを使用します。

apic1# configure
apic1(config)# bgp-fabric
apic1(config-bgp-fabric)# where
configure t; bgp-fabric
apic1(config-bgp-fabric)#

現在のレベルを終了して前のレベルに戻るには、 exit と入力します。EXEC レベルに直接戻るには、 end と入力します。

EXEC モード コマンド

CLI セッションを開始する場合、EXEC モードから始めます。この EXEC モードから、コンフィギュレーション モードを開始できます。show コマンドなどの EXEC コマンドのほとんどは、現在の構成 ステータスを表示します。

構成モード コマンド

既存の構成に変更を加えるには、構成モードを使用します。設定を保存すると、これらのコマンドはデバイスの再起動後も保存されます。構成モードに入ると、プロトコル固有のさまざまなモードを開始できます。構成モードは、すべての構成コマンドの開始点です。

コマンドと構文の一覧表示

どのコマンド モードでも、疑問符（?）を入力すると、使用可能なコマンドのリストを取得できます。

apic1(config-dns)# ?
address   Configure the ip address for dns servers
domain    Configure the domains for dns servers
exit      Exit from current mode
fabric    Show fabric related information
no        Negate a command or set its defaults
show      Show running system information
use-vrf   Configure the management vrf for dns servers
where     Show the current mode

apic1(config-dns)# end
apic1#

特定の文字シーケンスで始まるコマンドのリストを表示するには、それらの文字を入力し、その直後に疑問符（?）を入力します。疑問符の前にスペースを入れないでください。

apic1(config)# sh ?
aaa              Show AAA information
access-list      Show Access-list Information
accounting       Show accounting information
acllog           Show acllog information
. . .

入力開始後にコマンドの入力を完了するには、タブを入力します。

apic1# qu<TAB>
apic1# quota

キーワードまたは引数のリストを表示するには、キーワードまたは引数の代わりに疑問符を入力します。疑問符の前にスペースを 1 つ入れてください。この形式のヘルプは、すでに入力したコマンド、キーワード、および引数に基づいて、使用できるキーワードまたは引数を表示するので、コマンド構文ヘルプと呼びます。

apic1(config-dns)# use-vrf ?
inband-mgmt  Configure dns on inband
oob-mgmt     Configure dns on out-of-band

apic1(config-dns)#

省略形が明確な場合は、コマンドを省略形にすることもできます。この例では、 configure コマンドが省略されています。

apic1# conf
apic1(config)#

「no」プレフィックスを使用したデフォルト値または条件の取り消しまたは復元

多くの構成 コマンドでは、コマンドの前に no キーワードを付けると、設定を削除したり、設定をデフォルト値に戻したりできます。この例は、設定済みの DNS アドレスを構成から削除する方法を示します。

apic1(config-dns)# address 192.0.20.123 preferred
apic1(config-dns)# show dns-address
Address             Preferred
------------------- ---------
192.0.20.123        yes

apic1(config-dns)# no address 192.0.20.123
apic1(config-dns)# show dns-address
Address             Preferred
------------------- ---------

NX-OS スタイル CLI からの BASH コマンドの実行

bash シェルで単一のコマンドを実行するには、次の例に示すように、 bash -c 'path/command' と入力します。

apic1# bash -c '/controller/sbin/acidiag avread'

NX-OS スタイル CLI の任意のモードまたはサブモードから bash コマンドを実行できます。

スペースまたは特殊文字を含む設定テキストの入力

構成フィールドがユーザー定義のテキストで構成されている場合は、Bash による誤った解釈を避けるために、「$」などの特殊文字をエスケープするか（「\$」）、単語または文字列全体を一重引用符で囲む必要があります。

NX-OS との使用方法の違い

APIC の NX-OS スタイル CLI の使用方法は、次の点で従来の NX-OS CLI とは異なります。

- configure terminal ではなく configure コマンドを使用してグローバル構成モードを開始する。

- 特定のリーフ スイッチでノードレベルの構成を実行するには、まず leaf コマンドを使用してそのスイッチに移動する必要があります。

- 物理ポートを指定するコマンド構文は若干異なります。たとえば、イーサネットポートは eth x/y ではなく ethx/y と指定されます。

- 設定フィールドがパスワードなどのユーザ定義のテキストで構成されている場合、「$」や「!」などの特殊文字バックスラッシュ（「\$」）でエスケープするか、単語または文字列全体を一重引用符で囲んで、Bash による誤った解釈を避ける必要があります。

- 一部のコマンド ショートカットは、Bash の動作により異なります。

- Ctrl-D はセッションを終了します。

- Ctrl-Z はジョブを一時停止します。

- OSPF 構成は、area route-map および area connectivity コマンドを追加します。

ユーザー インターフェイスの混在に関する制限

Cisco APIC は構成のための複数のユーザー インターフェイス (UI) をサポートしているので、ある UI を使用して構成を作成し、その後別の UI を使用して構成を変更することは可能ですが、予期しない結果になることがあります。たとえば、NX-OS スタイル CLI を使用して実行された構成も、APIC GUI で表示できます。これらを表示できますが、時折 GUI で編集できない可能性があります。同様に、APIC GUI で行われた変更も、NX-OS スタイル CLI で確認はできますが、部分的にしか変更できないことがあります。

インターフェイスごとに設定する場合の NX-OS スタイルの CLI と Cisco APIC GUI の混在による制限

インターフェイスごとに設定する場合、Cisco APIC GUI で実行する設定は、NX-OS スタイルの CLI では部分的にしか機能しない場合があります。

たとえば、GUI の [テナント（Tenants）] > [tenant-name] > [アプリケーション プロファイル（Application Profiles）] > [application-profile-name] > [アプリケーション EPG（Application EPGs）] > [EPG-name] > [スタティック ポート（Static Ports）] > [PC、VPC、インターフェイス上に静的 EPG を展開（Deploy Static EPG on PC, VPC, or Interface）] でスイッチ ポートを構成したとします。次に NX-OS スタイルの CLI で show running-config コマンドを使用すると、以下のように出力されます。

leaf 102
interface ethernet 1/15
switchport trunk allowed vlan 201 tenant t1 application ap1 epg ep1
exit
exit

NX-OS スタイルの CLI でこれらのコマンドを使用してスタティック ポートを設定すると、次のエラーが発生します。

apic1(config)# leaf 102
apic1(config-leaf)# interface ethernet 1/15
apic1(config-leaf-if)# switchport trunk allowed vlan 201 tenant t1 application ap1 epg ep1
No vlan-domain associated to node 102 interface ethernet1/15 encap vlan-201

これは、CLI に APIC GUI では実行されない検証があることが原因です。show running-config コマンドによって出力されたコマンドが NX-OS CLI で機能するためには、vlan ドメインが事前に構成されている必要があります。設定の順序は GUI に適用されません。

レイヤ 3 外部接続コンフィギュレーション モードのユーザ インターフェイスの混在に関する制限

ここでは、さらに他のユーザー インターフェイスを使用していた場合、NX-OS スタイルの CLI を使用してレイヤ 3 外部接続を構成するための考慮事項を説明します。

APIC NX-OS スタイルの CLI を使用してレイヤ 3 外部接続を設定する場合、次の 2 つのモードを選択することができます。

- 暗黙モード：シンプルなモードですが、APIC GUI または REST API と互換性がありません。

- 名前付き（または明示）モード：APIC GUI および REST API と互換性があります。

いずれの場合も、設定は互換性がない UI では読み取り専用であると考えてください。

レイヤ 3 外部接続構成モードの違い

どちらのモードでも、構成設定は API の l3extOut クラスのインスタンスである内部コンテナ オブジェクト「Layer 3 Outside」（または「L3Out」）内で定義されます。2 つのモード間の主な違いは、このコンテナ オブジェクト インスタンスの命名にあります。

- 暗黙モード：コンテナの命名は暗黙的であり、CLI コマンドには表示されません。CLI は、これらのオブジェクトを内部的に作成し保持します。

- 名前付きモード： コンテナの命名を指定します。名前付きモードの CLI コマンドには、追加の l3Out フィールドがあります。名前付き L3Out を正常に構成し、障害を回避するためには、ユーザーが外部レイヤ 3 構成用の API オブジェクト モデルを理解する必要があります。

（注）

「名前付きモードを使用したレイヤ 3 外部接続の構成」セクションの手順を除き、このガイドでは、暗黙モードの手順を説明します。

レイヤ 3 外部接続構成モードの注意事項と制約事項

次の注意事項と制約事項は、レイヤ 3 外部接続構成モードに適用されます。

暗黙モードと名前付きモードの併用

同じ Cisco APIC インスタンスで、両方のモードを一緒に使用してレイヤ 3 外部接続を設定できます。ただし、テナント、VRF インスタンス、およびリーフ スイッチの特定の組み合わせに対するレイヤ 3 外部接続設定は、1 つのモードでのみ実行できます。

レイヤ 3 外部接続用に展開されたテナント VRF インスタンスに 1 つのモードを使用します。

特定のテナント VRF インスタンスの場合、外部 EPG を配置できるポリシー ドメインは、名前付きモードまたは暗黙モードのいずれかになります。推奨する構成方式は、特定のテナント VRF インスタンスがレイヤ 3 外部接続用に展開されるすべてのノード全体で、その特定のテナント VRF インスタンスの組み合わせに対する 1 つのモードだけを使用することです。モードは、異なるテナントまたは異なる VRF インスタンス全体で異なったものにすることができ、制限は適用されません。

構成は不整合に対して検証される可能性がある

場合によっては、Cisco APIC クラスタへの着信設定で不整合が検証されます。外部から確認できる設定（L3Out を通過するノースバウンド トラフィック）も検証の対象です。構成が無効な状況では、構成が無効であるとのエラー メッセージが表示されます。

外部レイヤ 3 機能でサポートされる構成モード

外部レイヤ 3 機能は、次の例外を除き、両方の構成モードでサポートされます。レイヤ 4 ～ レイヤ 7 サービス アプライアンスを使用したルート ピアリングおよびルート ヘルス インジェクション（RHI）は、指定されたモードでのみサポートされます。ルート ピアリングが関係するテナント VRF インスタンスのすべてのボーダー リーフ スイッチでは、名前付きモードを使用する必要があります。

暗黙モード CLI を使用して作成された L3Out は、GUI では読み取り専用です。

暗黙モード CLI 手順を使用して作成されたレイヤ 3 外部ネットワーク オブジェクト（L3Out とも呼ばれる）は、「_ui_」で始まる名前で識別され、GUI で読み取り専用としてマークされます。

暗黙モード CLI を使用して作成された L3Outs は、REST API を使用して変更された場合、CLI で変更できなくなる可能性がある

CLI は、インターフェイス、プロトコル、ルート マップ、EPG などの機能で、L3Out を分割します。REST API を使用して L3Out の構成を変更すると、この構造が壊れ、CLI を使用して L3Out を変更できなくなる可能性があります。

変更できない L3Out を削除するには、 Cisco APIC Troubleshooting Guideの「不要な _ui_ オブジェクトのトラブルシューティング」セクションを参照してください。

- レイヤ 3 外部接続の設定のモードについて

レイヤ 3 外部接続の設定のモードについて

APIC は設定のための複数のユーザ インターフェイス (UI) をサポートしているので、1 つの UI を使用して設定を作成し、その後、別の UI を使用して設定を変更する場合は、予期しないインタラクションが潜んでいます。ここでは、さらに他の APIC のユーザ インターフェイスを使用した可能性がある場合、APIC NX-OS スタイルの CLI を使用してレイヤ 3 外部接続を設定するための考慮事項を説明します。

APIC NX-OS スタイルの CLI を使用してレイヤ 3 外部接続を設定する場合、次の 2 つのモードを選択することができます。

- よりシンプルな暗黙 モードは、APIC GUI または REST API と互換性がありません。

- 名前付き（または明示) モードは、APIC GUI および REST API と互換性があります。

いずれの場合も、設定は互換性がない UI では読み取り専用であると考えてください。

モードの違いについて

どちらのモードでも、構成設定は API の l3extOut クラスのインスタンスである内部コンテナ オブジェクト「L3 Outside」（または「L3Out」）内で定義されます。2 つのモード間の主な違いは、このコンテナ オブジェクト インスタンスの命名にあります。

- 暗黙モード：コンテナのネーミングは潜在的であり、CLI コマンドには表示されません。CLI は、これらのオブジェクトを内部的に作成し保持します。

- 名前付きモード：名前はユーザーが決定します。名前付きモードの CLI コマンドには、追加の l3Out フィールドがあります。名前付き L3Out がを正常に設定され障害を回避するためには、ユーザーが外部レイヤ 3 用の API オブジェクト モデルを理解する必要があります。

（注）

「名前付きモード セクションを使用したレイヤ 3 外部接続の設定」セクションの手順を除き、このガイドでは、暗黙モードの手順を説明します。

注意事項および制約事項

- 同じ APIC インターフェイスでは、両方のモードを、次の制限でレイヤ 3 外部接続を設定するために一緒に使用することができます。テナント VRF、およびリーフの特定の組み合わせのレイヤ 3 外部接続設定は、1 つのモードを介してのみ実行できます。

- 特定のテナント VRF の場合、外部 L3 EPG を配置できるポリシー ドメインは、名前付きモードまたは暗黙モードのいずれかになります。推奨する設定方式は、特定のテナント VRF が、レイヤ 3 外部接続用に展開されたすべてのノード全体で、特定のテナント VRF の組み合わせに対して 1 つのモードだけを使用することです。モードは、異なるテナントまたは異なる VRF 全体で変えることができ、制限は適用されません。

- 場合によっては、Cisco APIC クラスタへの着信設定で不整合が検証されます。外部から確認できる設定（L3Out を通過するノースバウンド トラフィック）も検証の対象です。設定が無効な場合は、「Invalid Configuration」エラー メッセージが表示されます。

- 外部レイヤ 3 機能は、次の例外を除いて、両方の設定モードでサポートされます

- L4 ～ L7 サービス アプライアンスを使用したルーティング ピアリングとルート ヘルス インジェクション (RHI) は、名前付きモードでのみをサポートされます。名前付きモードは、ルーティング ピアリングが含まれるテナント VRF のすべての境界リーフ スイッチ全体で使用する必要があります。

- 暗黙モード CLI 手順を使用して作成されたレイヤ 3 外部ネットワーク オブジェクト（l3extOut）は、「__ui_」で始まる名前で識別され、GUI で読み取り専用としてマークされます。CLI は、インターフェイス、プロトコル、ルート マップ、EPG などの機能で、これらの外部 L3 ネットワークを分割します。REST API を介して実行される設定変更は、この構造を破棄することができ、CLI を介してさらなる変更を防ぐことができます。

このようなオブジェクトを削除する手順については、『APIC Troubleshooting Guide』の「Troubleshooting Unwanted _ui_ Objects」を参照してください。

Trademarks

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS REFERENCED IN THIS DOCUMENTATION ARE SUBJECT TO CHANGE WITHOUT NOTICE. EXCEPT AS MAY OTHERWISE BE AGREED BY CISCO IN WRITING, ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS DOCUMENTATION ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED.

The Cisco End User License Agreement and any supplemental license terms govern your use of any Cisco software, including this product documentation, and are located at: https://www.cisco.com/c/en/us/about/legal/cloud-and-software/software-terms.html. Cisco product warranty information is available at https://www.cisco.com/c/en/us/products/warranty-listing.html. US Federal Communications Commission Notices are found here https://www.cisco.com/c/en/us/products/us-fcc-notice.html.

IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

Any products and features described herein as in development or available at a future date remain in varying stages of development and will be offered on a when-and if-available basis. Any such product or feature roadmaps are subject to change at the sole discretion of Cisco and Cisco will have no liability for delay in the delivery or failure to deliver any products or feature roadmap items that may be set forth in this document.

Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product.

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: https://www.cisco.com/c/en/us/about/legal/trademarks.html. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1721R)

GNU 著作権宣言文

FSF および GNU に関する一般的なお問い合わせは、 gnu@gnu.orgまでお送りください。FSF に連絡する他の方法 もあります。壊れたリンクやその他の修正や提案を bug-bash@gnu.orgに送信してください。この記事の翻訳の調整と送信については、 Translations README を 参照してください。

Copyright © 2007, 2009, 2011 Free Software Foundation, Inc. この通知および著作権表示が保持されていることを条件に、いかなる媒体においても、著作権使用料なしで、この記事全体のコピーおよび配布が世界中で許可されています。更新日：2011/06/28 02:44:32