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

最終公開日 : Oct 02, 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ワークフロー
アプリケーションの作成と移行が完了すると、対応するStyleBookとともに構成パックがNetScaler Consoleに作成されます。この構成パックは、ターゲットのNetScalerインスタンス上のアプリケーション構成を表します。作成された構成パックを表示するには、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アプリケーションファイアウォール (WAF)

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

NetScaler ConsoleでNetScalerアプリケーション構成を移行するStyleBookを作成する手順は次のとおりです。
  1. アプリケーション > 構成 > Config Packs の順に移動します。
  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を変更することはできません。
    ソースインスタンスとターゲットインスタンスが同じ場合、Application Deployment Infoタブは表示されません。
  9. Authentication/Networking Deployment Infoでは、利用可能な場合、認証サーバーとネットプロファイルの属性を表示および編集できます。
    1. Authentication Deployment Infoで、必要な認証サーバーを選択し、サーバーのIPアドレス、サーバーIP、サーバー名、およびポート番号を編集します。
    2. NetProfile Infoで、必要なネットプロファイルを選択し、NetProfileとIPSETの詳細を編集します。
      注:
      このステップで行われたNSIPアドレスの変更は最終的な移行に考慮され、以前のステップでの構成は変更を反映するように更新されます。
  10. 「リソースファイル/シークレット」で、パスワードと証明書を復号化するための証明書とキーをアップロードします。「次へ」をクリックします。
  11. Global Configurationで、ソースとターゲット間のグローバル構成設定の違いを表示します。ターゲットに適用される構成を確認し、確認応答を選択します。Nextをクリックします。
  12. Migrateで、StyleBookの詳細を表示します。Migrateをクリックします。
    注:
    デフォルトでは、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 ビルド以降で修正されています。