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

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

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

StyleBook Configuration Builderは、ソース構成で次のNetScaler機能を認識し、サポートしています。
  • コンテンツスイッチング
  • ロードバランシング
  • モニタリング
  • SSLオフロード
  • レート制限
  • リライト
  • レスポンダー
  • Webアプリケーションファイアウォール (WAF)

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

NetScaler ADMでNetScalerアプリケーションの移行を行うStyleBookを作成する手順は次のとおりです。
  1. Applications > StyleBooks > Configurations の順に移動します。
  2. Migrate ADC Configuration をクリックします。
  3. Get Started をクリックします。
  4. 構成の指定で、構成ソースを選択します:
    • ADCからインポート: このオプションは、選択したADCインスタンス上のアクティブなアプリケーションを検出します。
    • CLIコマンドを使用してインポート: このオプションは、CLIコマンドを分析し、CLIコマンドからアプリケーションを抽出します。
  5. アプリケーション構成を移行または複製するソースADCインスタンスを指定します。
  6. アプリケーション構成を移行または複製するターゲットADCインスタンスを指定します。
  7. アプリケーションの定義で、,
    1. アプリケーション名で、アプリケーションの名前を指定します。
    2. 移行する仮想サーバーを選択します。
    3. 次へをクリックします。
  8. 同等のCLIコマンドで、コマンドを確認し、次へをクリックします。
    これらのコマンドは、選択したアプリケーション構成に固有です。
  9. 展開属性で、仮想サーバー、サービス、およびサービスグループメンバーのIPアドレスとポートを表示および編集できます。
    IPアドレスとポートを編集するには、フロー図の仮想サーバー、サービス、またはサービスグループメンバーの編集アイコンをクリックします。
    展開属性を編集する
    このタブは、次の場合にのみ表示されます:
    • ソースインスタンスとターゲットインスタンスが異なります。
    • CLIコマンドを使用して構成をインポートします。
  10. Configuration Attributesで、必要な詳細を指定し、Nextをクリックします。
    このタブには、パスワードや証明書を復号化するためのキーなどのシークレットが一覧表示されます。
    注
    移行を開始する前に、見つからない構成またはサポートされていない構成が、次のいずれかのタブに表示されます。
    サポートされていない構成
    サポートされていないグローバル構成
    これらの構成を正常に移行するには、見つからない構成またはサポートされていない構成をターゲットインスタンスに個別に適用する必要があります。そして、Nextをクリックします。
  11. Migrateで、必要なStyleBookの詳細を指定します。Migrateをクリックします。

制限事項

  • ソースインスタンスで言及されている名前付き式と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 ビルド以降で修正されています。