ゼロタッチプロビジョニングの設定

ゼロタッチプロビジョニング（ZTP）は、ルートスイッチプロセッサ（RSP）およびルートプロセッサ（RP）のサードパーティアプリケーション（TPA）として機能します。ZTP は、2 つの異なる操作を実行するように設計されました。

初期設定をダウンロードして適用します。
シェルスクリプトをダウンロードして実行します。

ダウンロードしたファイルの内容が !! IOS XR で始まる場合はコンフィギュレーションファイルと見なされ、ZTP がコンフィギュレーションファイルで apply_config アクションを実行します。

ダウンロードしたファイルの内容が #! /bin/bash、 #! /bin/sh、または #!/usr/bin/python で始まる場合はスクリプトファイルと見なされ、ZTP でスクリプトを実行します。

ZTP は次のように動作します。

起動時に実行される XR スクリプトが DHCP 要求を呼び出します。
DHCP サーバがユーザスクリプトまたは設定ファイルのいずれかを返します。
ユーザスクリプトまたは設定ファイルをダウンロードします。
ダウンロードしたユーザスクリプトを実行するか、またはダウンロードした設定を適用します。

ZTP プロセスでエラーが発生した場合、または ZTP が終了した場合は、ZTP プロセスを開始する前に存在した初期設定に戻します。

管理ポートとデータポート間の ZTP の切り替え

Cisco IOS XR リリース 6.5.1 から、ルータの新規起動時に、自動 ZTP プロセスが管理ポートから開始され、データポートに切り替わります。次の場合に、ZTP プロセスが管理ポートとデータポートの間で切り替えられます。

ZTP が 10 秒以内にアクティブインターフェイスを検出しない場合。
ZTP が DHCP 応答を受信せず、dhclient 開始後の経過時間が 128 秒を超えている場合。
ZTP でエラーが発生した場合。

以下のフロー図に、ZTP プロセスを示します。

（注）

新規起動時または手動での呼び出し中に、ZTP が dataport モードのすべてのデータポートインターフェイスで IPv6 をイネーブルにします。
自動ブレークアウトモードはサポートされていません。

この章は次のトピックで構成されています。

手動 ZTP 呼び出し

手動ゼロタッチプロビジョニング（ZTP）は、CLI コマンドを使用して手動で呼び出すことができます。この手動による方法は、ルータを段階的にプロビジョニングするのに役立ちます。再起動なしで ZTP 設定をテストするのに最適です。インターフェイス（データポートまたは管理ポート）上で ZTP を呼び出す場合は、最初にインターフェイスを起動して設定する必要はありません。 ztp initiate コマンドを実行すると、インターフェイスがダウンしていても、ZTP スクリプトでインターフェイスを起動し、dhclient が呼び出されます。したがって、ZTP はアップ状態かダウン状態かに関係なく、すべてのインターフェイスで実行できます。

ztp initiate 、ztp breakout 、ztp terminate 、および ztp clean コマンドを使用して、ZTP をより多くのインターフェイス上で強制的に実行します。

ztp initiate ：新しい ZTP DHCP セッションを呼び出します。ログは、/disk0:/ztp/ztp.log にあります。
ztp terminate ：進行中の ZTP セッションを終了します。
ztp clean ：ディスクに保存されているすべての ZTP ファイルを削除します。

リリース 6.2.3 以降、ログファイル ztp.log が /var/log フォルダに保存され、ログファイルのコピーがソフトリンクを使用して /disk0:/ztp/ztp.log で使用できるようになりました。ただし、ztp clean を実行すると、現在の ZTP ログが保存されている /var/log フォルダではなくディスクに保存されていたファイルがクリアされます。現在の ZTP からログを実行するには、/var/log/ フォルダから ZTP ログファイルを手動でクリアする必要があります。

コマンドの詳細については、の「ZTP command」の章を参照してください。

このタスクでは、手動 ZTP 呼び出しの最も一般的な使用例、4x10 ブレークアウト検出と ZTP の呼び出しを示しています。

手順

コマンドまたはアクション目的

	コマンドまたはアクション	目的
ステップ 1	ztp breakout 例: `RP/0/RP0/CPU0:router# ztp breakout`	ブレイクアウトをサポートしている 100 GE インターフェイス上で 4x10 ブレークアウトを試行し、no-shut 後に動作がダウンします。10x10 ブレークアウト設定によって 10GE インターフェイスの動作が起動する場合は、ブレークアウト設定が維持されます。それ以外の場合は、設定が元に戻されます。
ステップ 2	ztp initiate dataport 例: `RP/0/RP0/CPU0:router# ztp initiate dataport`	起動している、または起動可能なすべてのデータポートで DHCP セッションを呼び出します。ZTP はバックグラウンドで実行されます。進行状況を確認するには、show logging を使用するか、/disk0:/ztp/ztp.log を確認してください。

ステップ 1

ztp breakout

例:


RP/0/RP0/CPU0:router# ztp breakout

ブレイクアウトをサポートしている 100 GE インターフェイス上で 4x10 ブレークアウトを試行し、no-shut 後に動作がダウンします。10x10 ブレークアウト設定によって 10GE インターフェイスの動作が起動する場合は、ブレークアウト設定が維持されます。それ以外の場合は、設定が元に戻されます。

ステップ 2

ztp initiate dataport

例:


RP/0/RP0/CPU0:router# ztp initiate dataport

起動している、または起動可能なすべてのデータポートで DHCP セッションを呼び出します。ZTP はバックグラウンドで実行されます。進行状況を確認するには、show logging を使用するか、/disk0:/ztp/ztp.log を確認してください。

データポートでの認証

新規起動時は ZTP プロセスが管理ポートから開始されますが、データポートに切り替えることができます。DHCP サーバとの接続を検証するために、DHCP オプション 43（IPv4）、およびオプション 17（IPv6）を使用してデータポートで認証が実行されます。これらの DHCP オプションはオプションスペースで定義され、dhcpd.conf および dhcpd6.conf コンフィギュレーションファイルに含まれています。オプションスペースを定義する際は、認証に次のパラメータを指定する必要があります。

認証コード：認証コードは 0 または 1 のいずれかです。0 は認証が不要であることを示し、1 は MD5 チェックサムが必要であることを示します。
クライアント ID：クライアント ID は「exr-config」にする必要があります。
MD5 チェックサム：これはシャーシのシリアル番号です。これは、echo -n $SERIALNUMBER | md5sum | awk '{print $1}' を使用して取得できます。

dhcpd.conf の設定例を次に示します。以下の例では、VendorInfo というオプションスペースが、認証用の 3 つのパラメータを使用して定義されています。

class "vendor-classes" {
   match option vendor-class-identifier;
}

option space VendorInfo;
option VendorInfo.clientId code 1 = string;
option VendorInfo.authCode code 2 = unsigned integer 8;
option VendorInfo.md5sum code 3 = string
option vendor-specific code 43 = encapsulate VendorInfo;
subnet 10.65.2.0 netmask 255.255.255.0 {
  option subnet-mask 255.255.255.0;
  option routers 10.65.2.1;
  range 10.65.2.1 10.65.2.200;
}
host xrv9k-1-mgmt {
   hardware ethernet 00:50:60:45:67:01;
   fixed-address 10.65.2.39;
   vendor-option-space VendorInfo;
   option VendorInfo.clientId "exr-config";
   option VendorInfo.authCode 1;
   option VendorInfo.md5sum "aedf5c457c36390c664f5942ac1ae3829";
   option bootfile-name "http://10.65.2.1:8800/admin-cmd.sh";
}

ZTP ブートスクリプト

ブートごとに実行するようにスクリプトをハードコードする場合は、次のように設定します。


conf t
    ztp bootscript /disk0:/myscript
commit

上記の設定では、最初のデータプレーンインターフェイスが設定されるまで待機し、その後、IP アドレスで管理インターフェイスが設定されるまでさらに 1 分待機することで、アプリケーションが使用するサードパーティの名前空間への接続が確実に行われます。遅延が望ましくない場合は、以下を使用します。


conf t
    ztp bootscript preip /disk0:/myscript
commit

（注）

上記のコマンドが最初に設定されると、今すぐ呼び出すかどうかを尋ねるプロンプトが表示されます。このプロンプトはテスト時に役立ちます。

次は /disk0:/myscript のコンテンツ例です。


#!/bin/bash
exec &> /dev/console # send logs to console 
source /pkg/bin/ztp_helper.sh
 
# If we want to only run one time: 
xrcmd "show running" | grep -q myhostname
if [[ $? -eq 0 ]]; then
    echo Already configured
fi
 
# Set the hostname
cat >/tmp/config <<%%
!! XR config example
hostname myhostname
%%
xrapply /tmp/config
 
#
# Force an invoke of ZTP again. If there was a username normally it would not run. This forces it.
# Kill off ztp if it is running already and suppress errors to the console when ztp runs below and
# cleans up xrcmd that invokes it. ztp will continue to run however.
#
xrcmd "ztp terminate noprompt" 2>/dev/null
xrcmd "ztp initiate noprompt" 2>/dev/null

ZTP ユーティリティ

ZTP には、ユーザスクリプト内から送信可能な一連のシェルユーティリティが含まれています。ztp_helper.sh は、ユーザスクリプトによって送信可能なシェルスクリプトです。ztp_helper.sh は、一部の XR 機能にアクセスするための単純なユーティリティを提供します。以下は、呼び出すことができる bash 関数です。

xrcmd：単一の XR exec コマンドを実行するために使用されます。
```
xrcmd “show running”
```

xrapply：ファイルに指定された構成ブロックを適用します。


cat >/tmp/config <<%%
!! XR config example
hostname node1-mgmt-via-xrapply
%%
xrapply /tmp/config

xrapply_with_reason：XR 構成のブロックをロギング目的の理由とともに適用するために使用されます。


cat >/tmp/config <<%%
!! XR config example
hostname node1-mgmt-via-xrapply
%%
xrapply_with_reason "this is a system upgrade" /tmp/config

xrapply_string：XR 構成のブロックを 1 行で適用するために使用されます。


xrapply_string "hostname foo\ninterface GigabitEthernet0/0/0/0\nipv4 address 1.2.3.44 255.255.255.0\n"

xrapply_string_with_reason：ロギング目的の理由とともに XR 構成のブロックを 1 行で適用するために使用されます。
```
xrapply_string_with_reason ”system renamed again" "hostname venus\n interface TenGigE0/0/0/0\n ipv4 address 172.30.0.144/24\n”
```
xrreplace：XR 構成の置換をファイルを介して XR 名前空間に適用するために使用されます。
```
cat rtr.cfg <<%%
!! XR config example
hostname node1-mgmt-via-xrreplace
%%
xrreplace rtr.cfg
```

admincmd：XR 名前空間で管理 CLI コマンドを実行するために使用されます。ログは、/disk0:/ztp/ztp_admincmd.log にあります。


admincmd running [show platform]

ztp-user connected from 192.0168.0.1 using console on host
sysadmin-vm:0_RP0# show platform | nomore
Tue Jan 30 23:12:30.757 UTC
Location Card Type HW State SW State Config State 
----------------------------------------------------------------------------
0/RP0 NCS-5501 OPERATIONAL OPERATIONAL NSHUT 
0/FT0 NCS-1RU-FAN-FW OPERATIONAL N/A NSHUT 
0/FT1 NCS-1RU-FAN-FW OPERATIONAL N/A NSHUT 
0/PM0 NCS-1100W-ACFW OPERATIONAL N/A NSHUT 
0/PM1 NCS-1100W-ACFW OPERATIONAL N/A NSHUT

xrapply_with_extra_auth：認証を必要とする XR 構成を、ファイルを介して XR 名前空間に適用するために使用されます。xrapply_with_extra_auth API が、エイリアス、フレックスグループなどの追加の認証を必要とする構成が適用されるときに使用されます。
```
cat >/tmp/config <<%%
!! XR config example
alias exec alarms show alarms brief system active
alias exec version run cat /etc/show_version.txt
%%
xrapply_with_extra_auth >/tmp/config 
```
xrreplace_with_extra_auth：XR 構成の置換をファイルを介して XR 名前空間に適用するために使用されます。xrreplace_with_extra_auth API が、エイリアス、フレックスグループなどの追加の認証を必要とする構成が適用されるときに使用されます。
```
cat >/tmp/config <<%%
!! XR config example
alias exec alarms show alarms brief system active
alias exec version run cat /etc/show_version.txt
%%
xrreplace_with_extra_auth >/tmp/config 
```

例

ZFS はフラッシュファイルシステムでの操作をディレクトリ /disk0:/ztp/ に記録します。ZTP は、DHCP サーバとのすべてのトランザクションおよびすべての状態遷移を記録します。ZTP の先行実行も /disk0:/ztp/old_logs/ に記録されます。

次の例に、コマンド ztp initiate interface Ten 0/0/0/0 verbose を使用してデータインターフェイスからダウンロードした単純な構成スクリプトの実行を示します。このスクリプトは、システムのすべてのインターフェイスを開き、すべてのインターフェイスに 30 秒のロード間隔を設定します。


#!/bin/bash
#############################################################################
# *** Be careful this is powerful and can potentially destroy your system ***
#                *** !!! Use at your own risk !!! ***
#
# Script file should be saved on the backend HTTP server
#############################################################################

source ztp_helper.sh
config_file="/tmp/config.txt"
interfaces=$(xrcmd "show interfaces brief")

function activate_all_if(){
  arInt=($(echo $interfaces | grep -oE '(Te|Fo|Hu)[0-9]*/[0-9]*/[0-9]*/[0-9]*'))
  for int in ${arInt[*]}; do
    echo -ne "interface $int\n no shutdown\n load-interval 30\n" >> $config_file
  done
  xrapply_with_reason "Initial ZTP configuration" $config_file
}

### Script entry point
if [ -f $config_file ]; then
  /bin/rm -f $config_file
else
  /bin/touch $config_file
fi
activate_all_if;
exit 0

次に、ZTP ロギング出力の例を示します。


Oct 11 11:05:38 172.30.0.54 ztp-script: Hello from ncs-560-c !!!
Oct 11 11:05:40 172.30.0.54 ztp-script: current=6.1.1, desired=6.1.1
Oct 11 11:05:40 172.30.0.54 ztp-script: Version match, proceeding to configuration
Oct 11 11:05:41 172.30.0.54 ztp-script: Starting autoprovision process...
Oct 11 11:05:42 172.30.0.54 ztp-script: ### XR K9SEC INSTALL ###
Oct 11 11:05:44 172.30.0.54 ztp-script: ### Downloading complete ###
Oct 11 11:05:55 172.30.0.54 ztp-script: Waiting for k9sec package to be activated
Oct 11 11:06:01 172.30.0.54 ztp-script: ### XR K9SEC INSTALL COMPLETE ###
Oct 11 11:06:03 172.30.0.54 ztp-script: ### Installing midnight commander ###
Oct 11 11:06:04 172.30.0.54 ztp-script: ### Downloading system configuration ###
Oct 11 11:06:05 172.30.0.54 ztp-script: ### Downloading system configuration complete ###
Oct 11 11:06:06 172.30.0.54 ztp-script: ### Applying initial system configuration ###
Oct 11 11:06:11 172.30.0.54 ztp-script: !!! Checking for errors !!!
Oct 11 11:06:14 172.30.0.54 ztp-script: ### Applying system configuration complete ###
Oct 11 11:06:15 172.30.0.54 ztp-script: Autoprovision complete...

Cisco NCS 560 シリーズルータ（IOS XR リリース 6.6.x）システム管理コンフィギュレーションガイド

偏向のない言語

翻訳について

Book Title

Cisco NCS 560 シリーズルータ（IOS XR リリース 6.6.x）システム管理コンフィギュレーションガイド

Chapter Title