StyleBooks Configuration Builderを使用したNetScaler®アプリケーション構成の移行

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

移行された構成間での構成エンティティの共有

Config Migrationユーティリティを使用して構成を移行する際に、構成エンティティを再利用できます。その後の移行では、既存の構成エンティティが正常に再利用されます。以前は、一部の構成エンティティを共有する2つの構成を移行する際に、Resource already existsというエラーで構成の移行が失敗していました。このオプションにより、複数の構成で構成エンティティが使用されるシナリオで構成エンティティの再利用が可能になり、移行ワークフローが効率化されます。

サポートされているNetScaler機能

StyleBook Configuration Builderは、ソース構成で以下のNetScaler機能を認識し、サポートしています。
  • アナリティクス
  • AppFlow®
  • アプリケーションレベルのQuality of Experience構成 (AppQoE)
  • 認証と承認
  • 監査
  • ボット管理
  • キャッシュリダイレクト
  • コンテンツスイッチング
  • DNS
  • フロントエンド最適化
  • HTTP圧縮
  • 統合キャッシュ
  • ロードバランシング
  • 監視
  • QUICプロトコル
  • レート制限
  • レスポンダー
  • リライト
  • SSLオフロード
  • スピルオーバー
  • トラフィック管理
  • URL変換
  • Webアプリケーションファイアウォール (WAF)

NetScalerアプリケーション構成を移行するためのStyleBookを作成する

NetScaler ConsoleでNetScalerアプリケーション移行を移行するStyleBookを作成する手順は次のとおりです。
  1. アプリケーション > 構成 > 構成パックに移動します。
  2. NetScaler構成の移行をクリックします。
  3. 「開始」をクリックします。
  4. 「構成の指定」で、次のいずれかの構成ソースを選択します。
    • 「NetScalerからインポート」:
      • 「ソースNetScalerインスタンス」 - アプリケーション構成を移行または複製するNetScalerインスタンスを選択します。「OK」をクリックします。
    • 「CLIコマンドを使用してインポート」 - 構成ファイルから構成を貼り付けます。
    • 「構成ファイルのアップロード」 - 「参照」をクリックして、ローカルマシンから構成ファイルを選択します。
    「ターゲットインスタンス」 - アプリケーション構成を移行または複製するNetScalerインスタンスまたはオートスケールグループを選択します。「OK」をクリックします。
    「次へ」をクリックします。
  5. 「高度なポリシー構成」で、構成に応じて、次のシナリオが発生します。
    • 構成内の既存のすべてのクラシックポリシーは、エラーなしで高度なポリシーに正常に変換されます。更新された構成を確認し、確認を選択します。「次へ」をクリックします。
    • 構成内の既存のすべてのクラシックポリシーは、エラーを伴って高度なポリシーに正常に変換されます。エラーを確認して修正します。「戻る」をクリックします。
    • クラシックポリシーがない場合、構成は更新されません。続行するには「OK」をクリックします。
  6. 「アプリケーションの定義」で、,
    1. 「アプリケーション名」で、アプリケーションの名前を指定します。
    2. 移行する仮想サーバーを選択します。
    3. 「次へ」をクリックします。
  7. 「アプリケーション構成」で、アプリケーションのコマンドを確認します。これらのコマンドは、選択したアプリケーション構成に固有のものです。
    「ビジュアライザー」を有効にして、アプリケーション構成とそれに関連付けられているエンティティを表示します。ビジュアライザーを使用すると、さまざまなコンポーネントがどのように接続されているかを確認でき、移行プロセス中の理解と意思決定に役立ちます。
    仮想サーバー設定を編集します(/en-us/netscaler-application-delivery-management-software/media/application-configuration-visualizer.png)
    ビジュアライザーを使用すると、次のことができます。
    • サーバーに関連付けられているアクションとポリシーの階層を表示する
    • サーバーにカーソルを合わせると、サーバーにバインドされているポリシーやアクションを含む、サーバーの詳細な説明が表示されます
    • ズームスライダーを使用して表示を拡大および縮小する
    • エンティティのマイナス記号(-)またはプラス記号(+)をクリックして階層を折りたたむか展開する
    「次へ」をクリックします。
  8. 「アプリケーション展開情報」で、仮想サーバー、サービス、およびサービスグループメンバーのIPアドレス、ポート、状態、ARPを表示および編集できます。
    仮想サーバー設定を編集します(/en-us/netscaler-application-delivery-management-software/media/edit-state-and-arp-attributes.png)
    「詳細」ページで、NSIPエンティティのIPアドレス、ポート、状態、およびARPステータスを編集できます。
    状態とARPステータスを編集します(/en-us/netscaler-application-delivery-management-software/media/edit-state-arp-lbv.png)
    「注:」:
    • 仮想サーバーIPのNSIPエンティティの状態が、ARPの初期状態を決定します。
    • 仮想サーバーIPのNSIPエンティティがターゲットのNetScalerにすでに構成されている場合、仮想サーバーのARPステータスを変更することはできません。
    • 仮想サーバーのARP状態を変更すると、同じIPアドレスを持つすべての仮想サーバーのARP状態が変更されます。仮想サーバーの状態を変更しても、関連付けられた仮想サーバーのみに影響します。
    • ARPは、IPパターンベースの仮想サーバーには適用されません。
    • ソース構成で仮想サーバーIPのNSIP状態が無効になっている場合、ARPも自動的に無効になり、ARPを変更することはできません。
    ソースとターゲットのインスタンスが同じ場合、アプリケーション展開情報タブは表示されません。
  9. 認証/ネットワーク展開情報で、利用可能な場合は、認証サーバーとネットプロファイルの属性を表示および編集できます。
    1. 認証展開情報で、必要な認証サーバーを選択し、サーバーのIPアドレス、サーバーIP、サーバー名、およびポート番号を編集します。
    2. NetProfile情報で、必要なネットプロファイルを選択し、NetProfileとIPSETの詳細を編集します。
      注:
      このステップで行われたNSIPアドレスの変更は、最終的な移行に考慮され、以前のステップの構成は変更を反映するように更新されます。
  10. リソースファイル/シークレットで、パスワードと証明書を復号化するための証明書とキーをアップロードします。次へをクリックします。
  11. グローバル構成で、ソースとターゲット間のグローバル構成設定の違いを表示します。ターゲットに適用される構成を確認し、確認応答を選択します。次へをクリックします。
  12. 移行で、StyleBookの詳細を表示します。移行をクリックします。
    注:
    デフォルトでは、NetScaler Consoleは、アプリケーションまたは仮想サーバーをNetScalerに移行する際に作成される設定パックを管理します。結果として得られる設定に設定パックを関連付けたくない場合は、「NetScaler Consoleを介して設定を管理する」チェックボックスをオフにします。
  13. 「サポートされていない構成」で、見落とされた構成またはサポートされていない構成を表示します。これらの構成を正常に移行するには、見落とされた構成またはサポートされていない構成をターゲットインスタンスに個別に適用する必要があります。「次へ」をクリックします。

制限事項

  • ソースインスタンスで言及されている名前付き式とresponderhtmlpagesは識別されません。移行する前に、ターゲットインスタンスで名前付き式とresponderhtmlpagesを設定してください。
  • ソースにservicegroupとモニターバインディングの設定が次のようにある場合：
    bind serviceGroup <Name> <Port> -monitorName <Monitor_Name>
    次のエラーが表示されます：
    CLI Command conversion failed: 100 - No such command [{ "errorcode": 1090, "message": "No such argument [XXX]", "severity": "ERROR" }]
    このエラーは、NetScalerがサービスグループとモニター間のバインディングを無効な形式で保存するため発生します。この問題は、NetScaler 12.1.52.15ビルド以降で修正されています。