NetScaler VPX構成をクラウドでNetScalerアプライアンスの最初の起動時に適用する
NetScaler VPX構成は、クラウド環境でのNetScalerアプライアンスの最初の起動時に適用できます。このステージは、このドキュメントでプレブートステージとして取り上げられています。したがって、ADC プールライセンスなどの特定のケースでは、特定の VPX インスタンスがはるかに短時間で起動されます。この機能は、Microsoft Azure、Google Cloud Platform、および AWS クラウドで使用できます。
ユーザーデータとは何ですか
クラウド環境で VPX インスタンスをプロビジョニングする場合、ユーザーデータをインスタンスに渡すオプションがあります。ユーザーデータを使用すると、一般的な自動設定タスクの実行、インスタンスの起動動作のカスタマイズ、インスタンスの起動後にスクリプトを実行できます。最初の起動時に、NetScaler VPXインスタンスは次のタスクを実行します。
- ユーザーデータを読み取ります。
- ユーザーデータで提供される構成を解釈します。
- 新しく追加された構成をブート時に適用します。
クラウドインスタンスでプレブートユーザーデータを提供する方法
プレブートユーザーデータを XML 形式でクラウドインスタンスに提供できます。クラウドによって、ユーザーデータを提供するためのインターフェースが異なります。
AWS コンソールを使用してプレブートユーザーデータを提供する
AWSコンソールを使用してNetScaler VPXインスタンスをプロビジョニングする場合は、[インスタンスの詳細の構成] > [詳細の詳細] に移動し、[ユーザーデータ]フィールドにプレブートユーザーデータ構成を指定します。
各手順の詳細については、「AWSウェブコンソールを使用して AWS にNetScaler VPXインスタンスをデプロイする」を参照してください。 詳細については、インスタンスの起動に関するAWS ドキュメントを参照してください。
注：
プリブートユーザーデータ機能のAWS IMDSv2専用モードは、NetScaler VPXリリース13.1.48.x以降のリリースでサポートされています。
AWS CLI を使用してプレブートユーザーデータを提供する
AWS CLI で次のコマンドを入力します。
aws ec2 run-instances \ --image-id ami-0abcdef1234567890 \ --instance-type t2.micro \ --count 1 \ --subnet-id subnet-08fc749671b2d077c \ --key-name MyKeyPair \ --security-group-ids sg-0b0384b66d7d692f9 \ --user-data file://my_script.txt 詳細については、インスタンスの実行に関するAWS ドキュメントを参照してください。
詳細については、インスタンスユーザーデータの使用に関するAWS ドキュメントを参照してください。
Azure コンソールを使用してプリブートユーザーデータを提供する
Azureコンソールを使用してNetScaler VPXインスタンスをプロビジョニングする場合は、［仮想マシンの作成］>［詳細設定］タブに移動します。[カスタムデータ] フィールドに、プリブートユーザーデータの構成を指定します。
Azure CLI を使用してプリブートユーザーデータを提供する
Azure CLI で次のコマンドを入力します。
az vm create \ --resource-group myResourceGroup \ --name MyVm \ --image debian \ --custom-data MyCloudInitScript.txt \ 例:
az vm create --resource-group MyResourceGroup -name MyVm --image debian --custom-data MyCloudInitScript.txt カスタムデータまたはプリブート設定をファイルとして「—custom-data」パラメータに渡すことができます。この例では、ファイル名はMyCloudInitScript.txtです。
詳細については、Azure CLI のドキュメントを参照してください。
GCP コンソールを使用してプレブートユーザーデータを提供する
GCP コンソールを使用してNetScaler VPXインスタンスをプロビジョニングする場合は、インスタンスのプロパティを入力します。管理、セキュリティ、ディスク、ネットワーキング、単独テナンシを展開します。[管理] タブに移動します。[自動化] セクションで、[スタートアップスクリプト] フィールドにプリブートユーザーデータ設定を指定します。
GCPを使用したVPXインスタンスの作成の詳細については、「Google Cloud Platform でのNetScaler VPXインスタンスの展開」を参照してください。
gcloud CLI を使用してプレブートユーザーデータを提供する
GCP CLI で次のコマンドを入力します。
gcloud compute instances create INSTANCE_NAMES --metadata-from-file=startup-script=LOCAL_FILE_PATH metadata-from-file-に格納されているファイルから値またはユーザーデータを読み取ります。
詳細については、gcloud CLI ドキュメントを参照してください。
プレブートユーザーデータ形式
プレブートユーザーデータは XML 形式でクラウドインスタンスに提供する必要があります。起動時にクラウドインフラストラクチャを介して提供されるNetScaler プレブートユーザーデータは、次の4つのセクションで構成されます。
- NetScaler構成は
前の 4 つのセクションは、ADC のプレブート構成内で任意の順序で提供できます。 プリブートユーザーデータを提供しながら、次のセクションに示す書式に厳密に従うようにしてください。
注：
次の例に示すように、プレブートユーザーデータ構成全体を
タグで囲む必要があります。
例1：
例2：
注：
セクションには、有効な ADC CLI コマンドが必要です。CLI は、構文エラーまたは形式について検証されません。
NetScaler 構成
注：
セクションには、有効な ADC CLI コマンドが必要です。CLI は、構文エラーまたは形式について検証されません。
例:
次の例では、
前のスクリーンショットに示した設定をここからコピーできます。
add vlan 5 add ns ip 5.0.0.1 255.255.255.0 bind vlan 5 -IPAddress 5.0.0.1 255.255.255.0 enable ns feature WL SP LB RESPONDER add server 5.0.0.201 5.0.0.201 add service preboot_s5_201 5.0.0.201 HTTP 80 -gslb NONE -maxClient 0 -maxReq 0 -cip DISABLED -usip NO -useproxyport YES -sp OFF -cltTimeout 180 -svrTimeout 360 -CKA NO -TCPB NO -CMP NO add lb vserver preboot_v4_101 HTTP 4.0.0.101 80 -persistenceType NONE -cltTimeout 180 NetScaler VPXインスタンスは、次の図に示すように、
ユーザースクリプト
次のスナップショットでは、「script-1.sh」スクリプトが「/var/」ディレクトリに保存されていることを確認できます。「Script-1.sh」スクリプトが実行され、出力ファイルが適切に作成されます。
例2：
次の例では、
- 最初のスクリプトは「script-1.sh」として「/var」ディレクトリに保存されます。スクリプトは指定された内容で読み込まれ、パケットエンジンの起動後にコマンド「sh /var/script-1.sh」で実行されます。
- 2 番目のスクリプトは「file-2.txt」として「/var」ディレクトリに保存されます。このファイルには、指定されたコンテンツが入力されます。しかし、ブートアップ実行コマンド
前のスクリーンショットに示した設定をここからコピーできます。
< NS-PRE-BOOT-CONFIG > < NS-SCRIPTS > < SCRIPT > <脚本-CONTENT> #Shell script echo "Running script 1" > /var/script-1.output date >> /var/script-1.output script-1.sh /var/ sh /var/script-1.sh 次のスナップショットでは、script-1.sh と file-2.txt が「/var/」ディレクトリに作成されていることを確認できます。Script-1.sh が実行され、出力ファイルが適切に作成されます。
ライセンス
VPXインスタンスの起動中にNetScalerプールライセンスを適用するには、
標準のプールライセンスコマンドを使用して、
- ライセンスのチェックアウトが成功すると、構成された帯域幅がVPXに適用されます。
- ライセンスのチェックアウトに失敗した場合、約 10 ～ 12 分以内にライセンスはライセンスサーバから取得されません。その結果、システムがリブートし、ライセンスなしの状態になります。
例:
次の例では、
前のスクリーンショットに示した設定をここからコピーできます。
add ns licenseserver 10.102.38.214 -port 2800 set ns capacity -unit gbps -bandwidth 3 edition platinum 次の図に示すように、「ライセンスサーバーの表示」コマンドを実行し、ライセンスサーバー（10.102.38.214）がVPXに追加されていることを確認します。
ブートストラッピング
デフォルトのブートストラップ構成
NetScalerアプライアンスのデフォルトのブートストラップ構成は、次のインターフェイスの割り当てに従います。
- Eth0-特定の NSIP アドレスを持つ管理インターフェイス。
- Eth1-特定の VIP アドレスを持つクライアント向けインターフェイス。
- Eth2-特定の SNIP アドレスを持つサーバー側インターフェイス。
ブートストラップ構成をカスタマイズする
デフォルトのブートストラップシーケンスをスキップして、NetScaler VPXインスタンスに新しいブートストラップシーケンスを指定することができます。
次の表に、
SKIP-DEFAULT-BOOTSTRAP |
NEW-BOOTSTRAP-SEQUENCE |
ブートストラップ動作 |
|---|---|---|
| はい | はい | デフォルトのブートストラップ動作はスキップされ、 |
| はい | いいえ | デフォルトのブートストラップ動作はスキップされます。「 |
ブートストラップ構成は、次の 3 つの方法でカスタマイズできます。
- インターフェイスの詳細のみを入力します。
- IP アドレスとサブネットマスクとともにインターフェイスの詳細を指定します。
方法 1: インターフェイスの詳細のみを指定してカスタムブートストラップ
管理インターフェイス、クライアント向けインターフェイス、およびサーバ側インターフェイスは指定しますが、その IP アドレスとサブネットマスクは指定しません。IP アドレスとサブネットマスクは、クラウドインフラストラクチャのクエリによって設定されます。
AWS のカスタムブートストラップの例
次の例に示すように、カスタムブートストラップシーケンスを指定します。詳細については、「クラウドインスタンスでプレブートユーザーデータを提供する方法」を参照してください。Eth1 インターフェイスは管理インターフェイス（NSIP）、クライアントインターフェイス（VIP）として Eth0 インターフェイス、サーバインターフェイス（SNIP）として Eth2 インターフェイスが割り当てられます。
VM インスタンスの作成後、AWS ポータルで、ネットワークインターフェイスのプロパティを次のように確認できます。
- [AWS Portal] > [EC2 インスタンス] に移動し、カスタムブートストラップ情報を指定して作成したインスタンスを選択します。
- [説明] タブでは、次の図に示すように、各ネットワークインタフェースのプロパティを確認できます。
ADC CLIでshow nsipコマンドを実行し、ADCアプライアンスの初回起動時にNetScalerVPXインスタンスに適用されるネットワークインターフェイスを確認できます。
Azure のカスタムブートストラップの例
次の例に示すように、カスタムブートストラップシーケンスを指定します。詳細については、「クラウドインスタンスでプレブートユーザーデータを提供する方法」を参照してください。Eth2 インターフェイスは、管理インターフェイス（NSIP）として、Eth1 インターフェイスをクライアントインターフェイス（VIP）として、Eth0 インターフェイスをサーバインターフェイス（SNIP）として割り当てます。
NetScaler VPXインスタンスが3つのネットワークインターフェイスで作成されていることがわかります。Azure Portal > VM インスタンス > ネットワークに移動し、次の図に示すように 3 つの NIC のネットワークプロパティを確認します。
ADC CLI で「show nsip」コマンドを実行し、
GCP のカスタムブートストラップの例
次の例に示すように、カスタムブートストラップシーケンスを指定します。詳細については、「クラウドインスタンスでプレブートユーザーデータを提供する方法」を参照してください。Eth1 インターフェイスは管理インターフェイス（NSIP）、クライアントインターフェイス（VIP）として Eth0 インターフェイス、サーバインターフェイス（SNIP）として Eth2 インターフェイスが割り当てられます。
GCP ポータルで VM インスタンスを作成した後、ネットワークインターフェイスのプロパティを次のように確認できます。
- カスタムブートストラップ情報を指定して、作成したインスタンスを選択します。
- ネットワークインターフェイスのプロパティに移動し、NIC の詳細を次のように確認します。
ADC CLIでshow nsipコマンドを実行し、ADCアプライアンスの初回起動時にNetScalerVPXインスタンスに適用されるネットワークインターフェイスを確認できます。
方法 2: インターフェイス、IP アドレス、およびサブネットマスクを指定してカスタムブートストラップ
管理インターフェイス、クライアント向けインターフェイス、およびサーバ向けインターフェイスと IP アドレスとサブネットマスクを指定します。
AWS のカスタムブートストラップの例
次の例では、デフォルトのブートストラップをスキップして、NetScalerアプライアンスの新しいブートストラップシーケンスを実行します。新しいブートストラップシーケンスでは、次の詳細を指定します。
- 管理インターフェイス：インターフェイス-Eth1、NSIP-172.31.52.88、およびサブネットマスク-255.255.240.0
- クライアント側インターフェイス：インターフェイス-Eth0、VIP-172.31.5.155、およびサブネットマスク-255.255.240.0。
- サーバー側インターフェイス：インターフェイス-Eth2、SNIP-172.31.76.177、サブネットマスク-255.255.240.0。
ADC CLIでshow nsipコマンドを実行し、
Azure のカスタムブートストラップの例
次の例では、ADC の新しいブートストラップシーケンスが記述され、デフォルトのブートストラップがスキップされます。インターフェイスの詳細と IP アドレスとサブネットマスクを次のように指定します。
- 管理インターフェイス（eth2）、NSIP（172.27.2.53）、およびサブネットマスク（255.255.255.0）
- クライアント側インターフェイス（eth1）、VIP（172.27.1.53）、およびサブネットマスク（255.255.255.0）
- サーバー側インターフェイス (eth0)、SNIP (172.27.0.53)、およびサブネットマスク (255.255.255.0)
NetScaler VPXインスタンスが3つのネットワークインターフェイスで作成されていることがわかります。Azure Portal > VM インスタンス > ネットワークに移動し、次の図に示すように 3 つの NIC のネットワークプロパティを確認します。
ADC CLIでshow nsipコマンドを実行し、
GCP のカスタムブートストラップの例
次の例では、ADC の新しいブートストラップシーケンスが記述され、デフォルトのブートストラップがスキップされます。インターフェイスの詳細と IP アドレスとサブネットマスクを次のように指定します。
- 管理インターフェイス（eth2）、NSIP（10.128.4.31）、およびサブネットマスク（255.255.255.0）
- クライアント側インターフェイス（eth1）、VIP（10.128.0.43）、およびサブネットマスク（255.255.255.0）
- サーバ側インターフェイス（eth0）、SNIP（10.160.0.75）、およびサブネットマスク（255.255.255.0）
カスタムブートストラップを使用して GCP ポータルで VM インスタンスを作成した後、ネットワークインターフェイスのプロパティを次のように確認できます。
- カスタムブートストラップ情報を指定して、作成したインスタンスを選択します。
- ネットワークインターフェイスのプロパティに移動し、NIC の詳細を次のように確認します。
ADC CLIでshow nsipコマンドを実行し、
方法 3:
ブートストラップ関連のコマンドについては、
カスタムブートストラップを提供する前に、クラウドインフラストラクチャが特定のインターフェイス構成をサポートしていることを確認してください。
AWS のカスタムブートストラップの例
この例では、ブートストラップ関連のコマンドを
前のスクリーンショットに示した設定をここからコピーできます。
set ns config -IPAddress 172.31.52.88 -netmask 255.255.240.0 add route 0.0.0.0 0.0.0.0 172.31.48.1 set ns config -nsvlan 10 -ifnum 1/2 -tagged NO add route 172.31.0.2 255.255.255.255 172.31.48.1 enable ns feature WL SP LB RESPONDER add server 5.0.0.201 5.0.0.201 add service preboot_s5_201 5.0.0.201 HTTP 80 -gslb NONE -maxClient 0 -maxReq 0 -cip DISABLED -usip NO - useproxyport YES -sp OFF -cltTimeout 180 -svrTimeout 360 -CKA NO -TCPB NO -CMP NO add lb vserver preboot_v4_101 HTTP 4.0.0.101 80 -persistenceType NONE -cltTimeout 180 YES NO VM インスタンスの作成後、AWS ポータルで、ネットワークインターフェイスのプロパティを次のように確認できます。
- [AWS Portal] > [EC2 インスタンス] に移動し、カスタムブートストラップ情報を指定して作成したインスタンスを選択します。
- [説明] タブでは、次の図に示すように、各ネットワークインタフェースのプロパティを確認できます。
ADC CLIでshow nsipコマンドを実行し、ADCアプライアンスの初回起動時にNetScalerVPXインスタンスに適用されるネットワークインターフェイスを確認できます。
Azure のカスタムブートストラップの例
この例では、ブートストラップ関連のコマンドを
注：
Azure クラウドの場合、インスタンスメタデータサーバー (IMDS) と DNS サーバーはプライマリインターフェイス (Eth0) を介してのみアクセスできます。したがって、Eth0 インターフェイスが管理インターフェイス（NSIP）として使用されない場合、Eth0 インターフェイスは、少なくとも IMDS または DNS アクセスを動作させるには、SNIP として設定する必要があります。Eth0 のゲートウェイを経由する IMDS エンドポイント（169.254.169.254）および DNS エンドポイント（168.63.129.16）へのルートも追加する必要があります。
set ns config -IPAddress 172.27.2.61 -netmask 255.255.255.0 add route 0.0.0.0 0.0.0.0 172.27.2.1 set ns config -nsvlan 10 -ifnum 1/2 -tagged NO add ns ip 172.27.0.61 255.255.255.0 -type SNIP add route 169.254.169.254 255.255.255.255 172.27.0.1 add route 168.63.129.16 255.255.255.255 172.27.0.1 add vlan 5 bind vlan 5 -IPAddress 5.0.0.1 255.255.255.0 enable ns feature WL SP LB RESPONDER add server 5.0.0.201 5.0.0.201 add service preboot_s5_201 5.0.0.201 HTTP 80 -gslb NONE -maxClient 0 -maxReq 0 -cip DISABLED -usip NO -useproxyport YES -sp OFF -cltTimeout 180 -svrTimeout 360 -CKA NO -TCPB NO -CMP NO add lb vserver preboot_v4_101 HTTP 4.0.0.101 80 -persistenceType NONE -cltTimeout 180 YES NO NetScaler VPXインスタンスが3つのネットワークインターフェイスで作成されていることがわかります。Azure Portal > VM インスタンス > ネットワークに移動し、次の図に示すように 3 つの NIC のネットワークプロパティを確認します。
ADC CLIでshow nsipコマンドを実行し、
GCP のカスタムブートストラップの例
この例では、ブートストラップ関連のコマンドを
前のスクリーンショットに示した設定をここからコピーできます。
set ns config -IPAddress 10.128.0.2 -netmask 255.255.255.0 add route 0.0.0.0 0.0.0.0 10.128.0.1 set ns config -nsvlan 10 -ifnum 1/1 -tagged NO enable ns feature WL SP LB RESPONDER add server 5.0.0.201 5.0.0.201 add service preboot_s5_201 5.0.0.201 HTTP 80 -gslb NONE -maxClient 0 -maxReq 0 -cip DISABLED -usip NO -useproxyport YES -sp OFF -cltTimeout 180 -svrTimeout 360 -CKA NO -TCPB NO -CMP NO add lb vserver preboot_v4_101 HTTP 4.0.0.101 80 -persistenceType NONE -cltTimeout 180 YES NO カスタムブートストラップを使用して GCP ポータルで VM インスタンスを作成した後、ネットワークインターフェイスのプロパティを次のように確認できます。
- カスタムブートストラップ情報を指定して、作成したインスタンスを選択します。
- [Network Interface] プロパティに移動し、図に示すように NIC の詳細を確認します。
ADC CLIでshow nsipコマンドを実行し、ADCアプライアンスの最初の起動時に前の
AWS および Azure での NIC のアタッチとデタッチによる影響
AWS と Azure には、ネットワークインターフェイスをインスタンスにアタッチし、ネットワークインターフェイスをインスタンスからデタッチするオプションが用意されています。インターフェイスをアタッチまたはデタッチすると、インターフェイスの位置が変わることがあります。そのため、CitrixではNetScaler VPXインスタンスからインターフェイスをデタッチしないことをお勧めします。カスタムブートストラップが構成されているときにインターフェイスをデタッチまたは接続すると、NetScaler VPXインスタンスは、管理インターフェイスの位置で新しく使用可能なインターフェイスのプライマリIPをNSIPとして再割り当てします。デタッチしたインターフェイスの後に使用可能なインターフェイスがない場合は、最初のインターフェイスがNetScaler VPXインスタンスの管理インターフェイスになります。
たとえば、NetScaler VPXインスタンスは、Eth0（SNIP）、Eth1（NSIP）、およびEth2（VIP）の3つのインターフェイスで起動されます。管理インターフェイスであるインスタンスから Eth1 インターフェイスをデタッチすると、ADC は次の使用可能なインターフェイス（Eth2）を管理インターフェイスとして設定します。そのため、NetScaler VPXインスタンスには引き続きEth2インターフェイスのプライマリIPを介してアクセスされます。Eth2 も使用できない場合は、残りのインターフェイス（Eth0）が管理インターフェイスになります。そのため、NetScaler VPXインスタンスには引き続きアクセスできます。
Eth0 (SNIP)、Eth1 (VIP)、Eth2 (NSIP) の異なるインターフェイスの割り当てを考えてみましょう。Eth2（NSIP）をデタッチすると、Eth2 の後に新しいインターフェイスが使用できないため、最初のインターフェイス（Eth0）が管理インターフェイスになります。
この記事の概要
- ユーザーデータとは何ですか
- クラウドインスタンスでプレブートユーザーデータを提供する方法
- AWS コンソールを使用してプレブートユーザーデータを提供する
- Azure コンソールを使用してプリブートユーザーデータを提供する
- GCP コンソールを使用してプレブートユーザーデータを提供する
- プレブートユーザーデータ形式
- NetScaler 構成
- ユーザースクリプト
- ライセンス
- ブートストラッピング
- 方法 1: インターフェイスの詳細のみを指定してカスタムブートストラップ
- 方法 2: インターフェイス、IP アドレス、およびサブネットマスクを指定してカスタムブートストラップ
- 方法 3:
セクションにブートストラップ関連のコマンドを指定して、カスタムブートストラップ - AWS および Azure での NIC のアタッチとデタッチによる影響