StyleBooks Configuration Builder を使用した NetScaler® アプリケーション構成の移行
StyleBooks Configuration Builder は、既存の NetScaler 構成からアプリケーション構成 StyleBook を作成するために使用されます。この機能は、ある NetScaler インスタンスから別のインスタンスへのアプリケーション構成の移行も自動化します。
Configuration Builder を使用すると、カスタマイズされた StyleBook を作成するプロセスを効率化でき、StyleBook の文法と構成要素を深く理解していなくても簡単に作成できます。そうでない場合、StyleBook を作成するには、StyleBook の文法と構成要素に精通している必要があります。
Configuration Builder は、ある NetScaler インスタンスの構成を別の NetScaler インスタンスに複製できる config pack も作成します。初期構成ソースは次のいずれかです。
-
NetScaler インスタンス: 複製するアプリケーション構成が利用可能なインスタンスを指定します
Configuration Builder は、ターゲットインスタンスを指定しない場合でも、NetScaler 構成を StyleBook および config pack に変換します。後でこの config pack を使用して、NetScaler 構成を他の NetScaler インスタンスに移行できます。
-
CLI コマンドセット:
ns.confまたはApplication configから構成を貼り付けます -
構成ファイルのアップロード: ローカルマシンから構成をアップロードします
Configuration Builder は、ソース構成に埋め込まれた個別のアプリケーションのリストを識別します。関心のあるアプリケーション構成を選択すると、Configuration Builder は選択したアプリケーションの CLI コマンドセットを抽出します。これらの CLI コマンドはソース構成から抽出されます。また、入力が必要になる可能性のある展開属性と構成属性も識別します。
-
アプリケーション展開情報 - 元の構成から、仮想サーバー、サービス、サービスグループメンバーの IP アドレスとポートを表示および編集できます。仮想サーバーの状態と ARP も表示および編集できます
-
構成属性 - これらの属性は、ソース構成で指定されたパスワードまたは証明書です
必要な情報を指定した後、ターゲット NetScaler インスタンスでアプリケーション構成の移行または複製を開始します。

アプリケーションの作成と移行が完了すると、NetScaler Console に、対応する StyleBook とともに config pack が作成されます。この config pack は、ターゲット NetScaler インスタンス上のアプリケーション構成を表します。作成された config pack を表示するには、[Applications] > [StyleBooks] > [Configurations] に移動します。
移行された構成間での構成エンティティの共有
Config Migration ユーティリティを使用して構成を移行する際に、構成エンティティを再利用できます。その後の移行では、既存の構成エンティティが正常に再利用されます。以前は、一部の構成エンティティを共有する 2 つの構成を移行する際に、Resource already exists エラーで構成の移行が失敗していました。このオプションにより、複数の構成で構成エンティティが使用されるシナリオで構成エンティティの再利用が可能になり、移行ワークフローが効率化されます。
サポートされる NetScaler 機能
StyleBook Configuration Builder は、ソース構成で次の NetScaler 機能を認識し、サポートします。
- アナリティクス
- AppFlow®
- アプリケーションレベルの Quality of Experience 構成 (AppQoE)
- 認証と承認
- 監査
- ボット管理
- キャッシュリダイレクト
- コンテンツスイッチング
- DNS
- フロントエンド最適化
- HTTP 圧縮
- 統合キャッシュ
- 負荷分散
- 監視
- QUIC プロトコル
- レート制限
- レスポンダー
- 書き換え
- SSL オフロード
- スピルオーバー
- トラフィック管理
- URL 変換
- Web Application Firewall (WAF)
NetScaler アプリケーション構成を移行するための StyleBook の作成
NetScaler Console で NetScaler アプリケーションの移行を行う StyleBook を作成する手順は次のとおりです。
-
[Applications] > [Configuration] > [Config Packs] に移動します
-
[Migrate NetScaler Configuration] をクリックします
-
[Get Started] をクリックします
-
[Specify Configuration] で、次のいずれかの構成ソースを選択します。
-
NetScaler からインポート:`
- ソース NetScaler インスタンス - アプリケーション構成を移行または複製する NetScaler インスタンスを選択します。[OK] をクリックします
-
CLI コマンドを使用してインポート - 構成ファイルから構成を貼り付けます
- 構成ファイルのアップロード - [参照] をクリックして、ローカルマシンから構成ファイルを選択します
ターゲットインスタンス - アプリケーション構成を移行または複製する NetScaler インスタンスまたはオートスケールグループのいずれかを選択します。[OK] をクリックします。
[Next] をクリックします。
-
NetScaler からインポート:`
-
[Advanced Policy Configuration] で、構成に応じて、次のシナリオが発生します。
- 構成内の既存のすべてのクラシックポリシーは、エラーなしで高度なポリシーに正常に変換されます。更新された構成を確認し、確認応答を選択します。[Next] をクリックします
- 構成内の既存のすべてのクラシックポリシーは、エラーとともに高度なポリシーに正常に変換されます。エラーを確認して修正します。[Previous] をクリックします
- クラシックポリシーがない場合、構成は更新されません。続行するには [OK] をクリックします
-
[Define Application] で、
-
[Application Name] で、アプリケーションの名前を指定します
-
移行する仮想サーバーを選択します
-
[Next] をクリックします
-
-
[Application Configuration] で、アプリケーションのコマンドを確認します。これらのコマンドは、選択したアプリケーション構成に固有のものです。
[Visualizer] を有効にして、アプリケーション構成とそれに関連するエンティティを表示します。Visualizer を使用すると、さまざまなコンポーネントがどのように接続されているかを確認でき、移行プロセス中の理解と意思決定に役立ちます。

Visualizer を使用すると、次のことができます。
- サーバーに関連付けられたアクションとポリシーの階層を表示する
- サーバーにカーソルを合わせると、ポリシーやサーバーにバインドされたアクションを含むサーバーの詳細な説明が表示されます
- ズームスライダーを使用してビューを拡大および縮小する
- エンティティのマイナス (-) またはプラス (+) 記号をクリックして階層を折りたたむまたは展開する
[Next] をクリックします。
-
[Application Deployment Info] で、仮想サーバー、サービス、サービスグループメンバーの IP アドレス、ポート、状態、および ARP を表示および編集できます。

[Details] ページで、NSIP エンティティの IP アドレス、ポート、状態、および ARP ステータスを編集できます。

注:
- 仮想サーバー IP の NSIP エンティティの状態によって、ARP の初期状態が決まります
- 仮想サーバー IP の NSIP エンティティがターゲット NetScaler にすでに構成されている場合、仮想サーバーの ARP ステータスを変更することはできません
- 仮想サーバーの ARP 状態を変更すると、同じ IP アドレスを持つすべての仮想サーバーの ARP 状態が変更されます。仮想サーバーの状態を変更しても、関連する仮想サーバーのみに影響します
- ARP は、IP パターンベースの仮想サーバーには適用されません
- ソース構成で仮想サーバー IP の NSIP 状態が無効になっている場合、ARP も自動的に無効になり、ARP を変更することはできません
ソースインスタンスとターゲットインスタンスが同じ場合、[Application Deployment Info] タブは表示されません。
-
[Authentication/Networking Deployment Info] で、認証サーバーとネットプロファイルの属性 (利用可能な場合) を表示および編集できます。
- [Authentication Deployment Info] で、必要な認証サーバーを選択し、サーバーの IP アドレス、サーバー IP、サーバー名、およびポート番号を編集します
-
[NetProfile Info] で、必要なネットプロファイルを選択し、[NetProfile] と [IPSET] の詳細を編集します
注:
この手順で行われた NSIP アドレスの変更は、最終的な移行で考慮され、以前の手順の構成は、変更を反映するように更新されます
-
[Resource Files/Secrets] で、パスワードと証明書を復号化するための証明書とキーをアップロードします。[Next] をクリックします
-
[Global Configuration] で、ソースとターゲット間のグローバル構成設定の違いを表示します。ターゲットに適用される構成を確認し、確認応答を選択します。[Next] をクリックします
-
[Migrate] で、StyleBook の詳細を表示します。[Migrate] をクリックします
注:
デフォルトでは、NetScaler Console は、アプリケーションまたは仮想サーバーを NetScaler に移行するときに作成された config pack を管理します。結果の構成に config pack を関連付けたくない場合は、[Manage the configuration through NetScaler Console] チェックボックスをオフにします
-
[Unsupported Configuration] で、見落とされた構成またはサポートされていない構成を表示します。これらの構成を正常に移行するには、見落とされた構成またはサポートされていない構成をターゲットインスタンスに個別に適用する必要があります。[Next] をクリックします
制限事項
-
ソースインスタンスで言及されている名前付き式と
responderhtmlpagesは識別されません。移行前に、ターゲットインスタンスで名前付き式とresponderhtmlpagesを構成してください -
ソースに
servicegroupとモニターバインディングの構成が次のようにある場合:`bind serviceGroup <Name> <Port> -monitorName <Monitor_Name>` <!--NeedCopy-->次のエラーが表示されます。
CLI Command conversion failed: 100 - No such command [{ "errorcode": 1090, "message": "No such argument [XXX]", "severity": "ERROR" }] <!--NeedCopy-->このエラーは、NetScaler がサービスグループとモニター間のバインディングを無効な形式で保存するため発生します。この問題は、NetScaler 12.1.52.15 ビルド以降で修正されています。