NETCONF インターフェイスを有効にするには、次のコマンドを入力します。

configure terminal
netconf-yang
exit

デフォルト ポート 830 上のデバイスに接続することで NETCONF 機能交換を取得できます。機能交換には、デバイスがサポートしていて使用可能なすべての YANG データ モデルがリストされます。以降の項で詳しく説明する YangExplore や pYANG のようなツールを使用して、これらの YANG モジュールをデバイスからダウンロードし、さらに分析することができます。

NETCONF インターフェイスが動作可能であることを確認するには、show platform software yang-management process コマンドを実行します。NETCONF SSHD「ncsshd」プロセスが実行されていることを確認します。

次に示す XML RPC ペイロードは YangExplorer ツール内または NETCONF インターフェイスを介して XML ペイロードを送信できる Python スクリプトなどの他のツール内から生成、変更、送信できます。次に、XML ペイロードの WLC による作成、確認、および 削除の例を示します。これらを使用すると、NETCONF インターフェイスを介して WLAN の作成、確認、および削除をすばやく簡単に行えます。

<rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="6">
<edit-config xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0">
   <target>
     <running/>
   </target>
   <test-option>test-then-set</test-option>
   <error-option>rollback-on-error</error-option>
   <config>
   <wlan-cfg-data xmlns="http://cisco.com/ns/yang/Cisco-IOS-XE-wireless-wlan-cfg">
     <wlan-cfg-entries>
       <wlan-cfg-entry>
         <profile-name>open</profile-name>
         <vap-id>4</vap-id>
         <security-wifi-sec>false</security-wifi-sec>
         <rsn-ie-enabled>false</rsn-ie-enabled>
         <rsn-cipher-suite-aes>false</rsn-cipher-suite-aes>
         <auth-key-mgmt-suite8021x>false</auth-key-mgmt-suite8021x>
         <client-session-timeout>1800</client-session-timeout>
         <id-data>
           <profile-name>open</profile-name>
           <ssid>open</ssid>
           <status>true</status>
         </id-data>
         <is-remote-lan>false</is-remote-lan>
       </wlan-cfg-entry>
     </wlan-cfg-entries>
   </wlan-cfg-data>
</config></edit-config></rpc>

<rpc message-id="101" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
  <get>
    <filter>
      <wlan-cfg-data xmlns="http://cisco.com/ns/yang/Cisco-IOS-XE-wireless-wlan-cfg">
        <wlan-cfg-entries>
          <wlan-cfg-entry>
            <vap-id>4</vap-id>
          </wlan-cfg-entry>
        </wlan-cfg-entries>
      </wlan-cfg-data>
    </filter>
  </get>
</rpc>

<rpc message-id="101" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" 
xmlns:xc="urn:ietf:params:xml:ns:netconf:base:1.0">
  <edit-config>
    <target>
      <running/>
    </target>
    <config>
      <wlan-cfg-data xmlns="http://cisco.com/ns/yang/Cisco-IOS-XE-wireless-wlan-cfg">
        <wlan-cfg-entries xc:operation="delete">
          <wlan-cfg-entry>
            <vap-id>4</vap-id>
          </wlan-cfg-entry>
        </wlan-cfg-entries>
      </wlan-cfg-data>
    </config>
  </edit-config>
</rpc>

RESTCONF インターフェイスを有効にするには、次のコマンドを入力します。

configure terminal
ip http secure-server
restconf
exit

サポート対象の YANG データ モデルのリストは、URI restconf/data?fields=ietf-yang-library:modules-state/module に GET 要求を送信することで RESTCONF インターフェイスから取得できます。

次に例を示します。

curl -k -u username:password https://10.10.10.223/restconf/data?fields=ietf-yang-
library:modules-state/module

YANG データ モデルを含んだ URI に別の GET 要求を送信すると特定の YANG モジュールをダウンロードできます。たとえば、Cisco-IOS-XE-wireless-access-point-oper モデルをダウンロードするには、次に示すスクリーンショットのように restconf/tailf/modules/Cisco-IOS-XE-wireless-access-point-oper/2018-06-28 へ GET 要求を送信します。

上のステップでは、YANG データ モデル内にいくつかのデータが含まれている詳細情報に対して「pyang」が使用されています。この例では、ap-history、wireless-interface-data などが「access-point-oper-data」コンテナ内のセクションです。

RESTCONF インターフェイスが動作可能であることを確認するには、show platform software yang-management process コマンドを実行します。「nginx」プロセスが実行されていることを確認します。

gNMI インターフェイスを有効にするには、次のコマンドを入力します。

configure terminal
gnmi-yang
gnmi-yang server
gnmi-yang port 50052
exit
write memeory

gNMI インターフェイスを介して次の動作がサポートされています。

gNMI GetRequest

gNMI SetRequest

このインターフェイスの利用に関するその他の詳細は、「その他のリソース」の項でリンクされている『Programmability Configuration Guide』から入手できます。

gNMI インターフェイスが動作可能であることを確認するには、show gnmi-yang state コマンドを実行します。状態が enabled で、ステータスが up になっていることを確認します。

ワイヤレス用のネイティブ モデルは設定と運用の 2 つの主要カテゴリに分類できます。設定モジュールには関連機能の設定情報が含まれ、運用モデルは機能に関する実行時間と運用データを提供します。

シスコのネイティブ設定と動作モデルの他に、デバイス上でサポートされている他の YANG モデルがいくつかあります。NETCONF および RESTCONF の YANG ライブラリを介した機能交換では、これらのモデルのすべてがリストされます。SNMP MIB、IETF、および OpenConfig 用のモデルがあります。これらのモデルはネイティブ モデルと同じ方法で使用できますが、デバイスで利用可能な機能のうちの限定された機能またはそれらのサブセットが提供されます。そのため、可能な限りシスコ ネイティブ モデルを利用することをお勧めします。

https://github.com/CiscoDevNet/yang-explorer にある GitHub サイトでの指示に従ってインストールを完了します。Mac と Linux 用の詳細手順が入手できます。

YangExplorer がインストールされ、実行された後は、Catalyst 9800 とやり取りする前にいくつかのタスクを完了する必要があります。[Create device profile] を選択し、ユーザ名とパスワードに「admin」を使用して [Django administration] ページに移動します。[Add Device Profile] ページがロードされます。このページでは、デバイスに関する情報を追加する必要があります。プロファイル名を入力し、デバイス タイプを選択して、NETCONF IP、RESTCONF IP、ユーザ名およびパスワードを入力します。

デバイスが追加された後、メインの YangExplorer ウィンドウを更新すると [Profile] ドロップダウンを選択したときに使用可能なデバイスが表示されます。

セットアップが正常であることを確認するには、[Capabilities] ボタンを選択します。選択したデバイスに YangExplorer が接続され、そのデバイスでサポートされている YANG モジュールのリストが返されます。

YangExplorer 内で、デバイスから YANG モジュールをダウンロードできます。同期してモデルにサブスクライブする手順に従います。

1. [Manage Models] タブを選択します。

2. [Device] タブを選択します。

3. 下矢印を選択してデバイス プロファイルを選択します。

   

4. ワイヤレス モジュールのみを表示するには、検索ボックスに「wireless」と入力します。

5. [Select All] チェックボックスをオンにしてすべてのワイヤレス モジュールを選択します。

6. [Sync] を選択してデバイスからモジュールをダウンロードします。

   について

7. ダウンロードの完了後に [Subscribe] を選択すると、YangExplorer の [Explorer] タブでモデルが使用可能になります。

   

ホスト ファイルには接続の詳細と、クレデンシャルなどのデバイス固有の情報が含まれています。この例では、SSH ログインを許可するように Catalyst 9800 がすでに設定されていて、イネーブル パスワードも設定されていることが想定されます。ホスト ファイルと YAML ファイルを一緒に使用してタスクが実行されます。この例では、SSH を介して CLI に接続してイネーブル モードに移行し、必要な IOS コマンドを実行して netconf-yang を有効にし、AAA 要求をセットアップします。

この hosts.txt ファイルの例には、デバイスへの接続を正常に確立するために必要な変数が含まれています。

 [all:vars]
ansible_connection=network_cli
ansible_network_os=ios
ansible_user=admin
ansible_password=Cisco123
ansible_become=yes
ansible_become_method=enable
ansible_become_pass=Cisco123
[cat9800]
cat9800-1 ansible_host=10.10.10.224

この enable_netconf_yang.yaml YAML ファイルの例は、デバイス上で NETCONF インターフェイスを有効にし、ユーザの追加などの認証の前提条件を設定するために使用できます。

---
- hosts: cat9800
  gather_facts: no

  tasks:
   - ios_config:
      commands:
       - aaa new-model
       - aaa authorization exec default local
       - aaa authentication login default local
       - aaa session-id common
       - username netconf privilege 15 password 0 netconf
       - netconf-yang
       - ip http secure-server
       - restconf
      save_when: modified

この cat9800_verify.yaml YAML ファイルの例では、2 つの ios show コマンドを実行して netconf-yang と restconf が有効であることを確認し、実行されると出力が登録されて画面に表示されます。

- hosts: cat9800
  gather_facts: no

  tasks:
   - ios_command:
      commands:
      - show run | i netconf-yang
      - show run | i restconf
     register: show
   - debug: var=show.stdout_lines

「ansible-playbook」コマンドを使用すると、前述で定義したタスクを実行し、デバイス上で NETCONF-YANG インターフェイスを有効にすることができます。この例では、変数を定義して Host Key Checking を false に設定し、SSH ホスト キーが検証されないようにします。実稼働環境ではアクセスされる側のデバイスの信頼性を確認することが重要ですが、このラボの例では使用しやすいようにチェックが false に設定されていされます。

コマンド ラインから次のコマンドを実行して enable_netconf_yang.yaml 設定を実行します。

$ ANSIBLE_HOST_KEY_CHECKING=False ansible-playbook -i ./hosts.txt ./enable_netconf_yang.yaml

コマンド ラインから次のコマンドを実行して cat9800_verify.yaml 設定を実行します。

$ ANSIBLE_HOST_KEY_CHECKING=False ansible-playbook -i ./hosts.txt ./cat9800_verify.yaml

NETCONF インターフェイスと gNMI インターフェイスの両方が、ダイヤルイン設定またはダイヤルアウト設定のいずれかでテレメトリ サブスクリプションをサポートします。IOS XE は NETCONF ダイヤルインをサポートし、gRPC はダイヤルアウト形式の設定をサポートします。ダイヤルインまたは「ダイナミック」サブスクリプションでは、サブスクライバがまずデバイスへのセッション接続を確立してから、データ モデルにサブスクライブする必要があります。テレメトリ データのストリーミングを維持するには、NETCONF セッションを確立したままにする必要があります。セッションが切断された場合は、テレメトリ サブスクリプションを手動で再確立する必要があります。ダイヤルアウトまたは「設定済み」サブスクリプションでは、ユーザによって設定がセットアップされるとデバイスがサブスクリプション設定を維持してサブスクライバにテレメトリを送信します。コレクタへのアクティブなセッションは必要ありません。

ダイヤルイン テレメトリ サブスクリプションは https://github.com/CiscoDevNet/ncc から入手できるオープン ソースの NCC ツールを使用して簡単に作成できます。レポジトリは git clone コマンドを使用して GitHub から簡単に複製できます。その他の要件は、ncc-establish-subscription.py ツールで機能する、パッチが適用された ncclient ツールを使用することです。これは、[ncc GitHub] ページの指示に従うか、または次の 2 つのコマンドを実行することでインストールできます。

$ git clone https://github.com/CiscoDevNet/ncc
$ sudo pip install --upgrade git+https://github.com/CiscoDevNet/ncclient.git

ダウンロードされたら、サブスクリプションは次のコマンドを実行することで確立できます。

$ python ncc-establish-subscription.py --host 10.10.10.223 --port 830 -x “/wireless-access-point-oper:access-point-oper-data/wireless-interface-data" --period 5000 -u netconf -p netconf

上の例では、「/wireless-access-point-oper:access-point-oper-data/wireless-interface-data」の xpath を持つ Cisco-IOS-XE-wireless-access-point-oper YANG モデルを使用してテレメトリ サブスクリプションが作成されています。次のスクリーンショットに示すように、YangExplorer を使用してこの YANG モデル用の適切な XPath フィルタを決定します。

サブスクライバまたはコレクタでデバイスへのテレメトリ サブスクリプションを確立するのではなく、ダイヤルアウト サブスクリプションでデバイスを設定できます。このモードでのコレクタのロールは、データを収集して処理することだけです。テレメトリ データを受信するためにデバイスへのセッションを確立することはロールに含まれません。ダイヤルアウト サブスクリプションのみが gRPC-TCP 接続を介したキー値 Google プロトコル バッファ（kv-gp）でエンコーディングをサポートします。

次の設定を使用してダイヤルアウト gRPC テレメトリ サブスクリプションを確立できます。この設定は、101 という ID で新しいサブスクリプションを作成します。エンコーディングは kv-gpb に設定され、xpath フィルタが KPI を定義して、この場合はワイヤレスインターフェイス データをサブスクライブします。xpath フィルタは YANG モデル内で定義されます。YangExplorer を使用してこのモデルの正確な xpath を決定します。デバイスから使用する送信元アドレスと VRF が設定され、受信者 IP、ポートおよびプロトコルも含まれます。yang-push ストリームは 1000 センチ秒に設定されるため、データは 10 秒ごとに公開されます。

telemetry ietf subscription 101
 encoding encode-kvgpb
 filter xpath /wireless-access-point-oper:access-point-oper-data/wireless-interface-data
 source-address 10.10.10.223
 source-vrf Mgmt-vrf
 stream yang-push
 update-policy periodic 1000
 receiver ip address 10.10.10.49 57500 protocol grpc-tcp

gRPC インターフェイスを介して送信されるキー値暗号化 Google プロトコル バッファ（kv-gpb）テレメトリ データは、ビジネス ニーズと使用例に応じて多くのツールおよびさまざまな設定で受信できます。パイプラインはデータの受信に使用できるツールの一連のオープン ソースであり、https://github.com/cisco/bigmuddy-network-telemetry-pipeline の GitHub で入手できます。パイプラインは gRPC レシーバとして機能するように動作し、Google プロトコル バッファを処理してデータを時系列データベース InfluxDB に送信します。そこから、Grafana を使用してデータを可視化できます。パイプラインは高度に設定可能です。さまざまなテレメトリ ソースを受信できるだけでなく、Kafka、InfluxDB、Prometheus などのさまざまなデータ ソースにデータを出力できます。[GitHub] ページのドキュメントに従ってパイプラインをセットアップし、必要に応じてテレメトリを受信します。からその他のドキュメントを入手できます。 https://xrdocs.io/telemetry/tutorials/2018-06-04-ios-xr-telemetry-collection-stack-intro/

テレメトリ サブスクリプション設定のステータスを確認するために使用できるいくつかの show コマンドがあります。

show telemetry ietf subscription all
show telemetry ietf subscription <ID> receiver
show telemetry ietf subscription all <ID> detail

次にそれぞれの例を示します。