Citrix ADC

基本的なコンテンツスイッチングの設定

コンテンツスイッチングを構成する前に、コンテンツスイッチングの設定方法と、サービスと仮想サーバーの接続方法を理解する必要があります。

基本的な機能的なコンテンツスイッチングの設定を構成するには、まずコンテンツスイッチング機能を有効にします。次に、少なくとも 1 つのコンテンツグループを作成します。コンテンツグループごとに、コンテンツスイッチングを使用する Web サイトのグループへの要求を受け入れるコンテンツスイッチング仮想サーバーを作成します。また、コンテンツスイッチング仮想サーバーが要求を送信する負荷分散仮想サーバーのグループを含む負荷分散セットアップを作成します。どの要求をどの負荷分散仮想サーバーに転送するかを指定するには、リダイレクトする要求の種類ごとに 1 つずつ、少なくとも 2 つのコンテンツスイッチングポリシーを作成します。仮想サーバーとポリシーを作成したら、ポリシーをコンテンツスイッチ仮想サーバーにバインドします。ポリシーを複数のコンテンツスイッチ仮想サーバーにバインドすることもできます。ポリシーをバインドするときは、ポリシーに一致する要求が転送される負荷分散仮想サーバーを指定します。

個々のポリシーをコンテンツスイッチ仮想サーバーにバインドするだけでなく、ポリシーラベルをバインドすることもできます。追加のコンテンツグループを作成する場合、ポリシーまたはポリシーラベルを複数のコンテンツスイッチ仮想サーバーにバインドできます。

コンテンツグループを作成したら、そのコンテンツスイッチ仮想サーバーを変更して、構成をカスタマイズできます。

コンテンツスイッチングの有効化

コンテンツスイッチング機能を使用するには、コンテンツスイッチングを有効にする必要があります。コンテンツスイッチング機能が無効になっていても、コンテンツスイッチングエンティティを構成できます。ただし、エンティティは機能しません。

コマンドラインインターフェイスを使用してコンテンツの切り替えを有効にするには

コマンドプロンプトで次のコマンドを入力して、コンテンツの切り替えを有効にし、構成を確認します。

enable ns feature CS

show ns feature

例:

> enable  feature ContentSwitch
    Done
> show feature

    Feature                        Acronym              Status
    -------                        -------              ------
1)     Web Logging                    WL                   OFF
2)     Surge Protection               SP                   ON
3)     Load Balancing                 LB                   ON
4)     Content Switching              CS                   ON
.
.
.
22)    Responder                      RESPONDER            ON
23)    HTML Injection                 HTMLInjection        ON
24)    NetScaler Push                 push                 OFF
Done

構成ユーティリティを使用してコンテンツの切り替えを有効にするには

[システム] > [設定] に移動し、[モードと機能] グループで [基本機能の構成] を選択し、[コンテンツの切り替え] を選択します。

次の図は、コンテンツスイッチングの段階的な構成を示しています。

ローカライズされた画像

コンテンツスイッチング仮想サーバーの作成

コンテンツスイッチ仮想サーバーを追加、変更、および削除できます。仮想サーバーを作成すると、仮想サーバーの状態は DOWN になります。これは、負荷分散仮想サーバーがまだバインドされていないためです。

コマンドラインインターフェイスを使用して仮想サーバーを作成するには

コマンドプロンプトで、次のように入力します。

add cs vserver <name> <protocol> <IPAddress> <port>

例:

add cs vserver Vserver-CS-1 HTTP 10.102.29.161 80

GUI を使用してコンテンツスイッチ仮想サーバーを追加するには

  1. [トラフィック管理] > [コンテンツスイッチング] > [仮想サーバー] に移動し、仮想サーバーを追加します。
  2. コンテンツスイッチング仮想サーバーの名前を指定します。

    プロトコルごとに異なるコンテンツスイッチング仮想サーバーがあります。(HTTP や SSL など)。

  3. 関連するフィールドに入力し、[OK] をクリックします。

コンテンツスイッチング仮想サーバの統計

コンテンツスイッチング仮想サーバの統計情報には、vserver ヒット、要求バイト、応答バイト、受信パケット合計、送信パケット合計、スピルオーバーしきい値、スピルオーバーヒット、現在のクライアントが確立した接続、仮想サーバのダウンバックアップヒットなどの情報が表示されます。

コンテンツスイッチ仮想サーバーの統計情報には、バインドされたデフォルトの負荷分散仮想サーバーの概要の詳細も表示されます。

CLI を使用してコンテンツスイッチ仮想サーバーの統計情報を表示するには

コマンドプロンプトで、次のように入力します。

stat cs vserver <name>

例:

stat cs vserver CS_stats

ローカライズされた画像

GUI を使用してコンテンツスイッチ仮想サーバーの統計情報を表示するには

1. [トラフィック管理] > [コンテンツスイッチング] > [仮想サーバー] に移動します。

2. 仮想サーバを選択し、[統計]をクリックします。

ローカライズされた画像

コンテンツスイッチング用の負荷分散設定の構成

コンテンツスイッチング仮想サーバーは、すべての要求を負荷分散仮想サーバーにリダイレクトします。切り替えるコンテンツのバージョンごとに、負荷分散仮想サーバーを 1 つ作成する必要があります。これは、コンテンツのバージョンごとにサーバーが 1 つしか設定されていない場合にも当てはまります。そのため、これらのサーバーで負荷分散を行っていません。また、コンテンツの各バージョンをミラーリングする複数の負荷分散サーバーを使用して、実際の負荷分散を構成することもできます。どちらのシナリオでも、コンテンツスイッチング仮想サーバーには、切り替え対象のコンテンツの各バージョンに割り当てられた特定の負荷分散仮想サーバーが必要です。

次に、負荷分散仮想サーバは要求をサービスに転送します。バインドされているサービスが 1 つしかない場合は、そのサービスを選択します。複数のサービスがバインドされている場合は、設定された負荷分散方式を使用して要求のサービスを選択し、その要求を選択したサービスに転送します。

基本的な負荷分散設定を構成するには、次のタスクを実行する必要があります。

  • 負荷分散仮想サーバーの作成
  • サービスの作成
  • 負荷分散仮想サーバへのサービスのバインド

負荷分散の詳細については、負荷分散の仕組みを参照してください。基本的な負荷分散設定の詳細な手順については、基本的な負荷分散の設定を参照してください。

コンテンツスイッチングアクションの設定

コンテンツを切り替える仮想サーバーにポリシーをバインドするときに、コンテンツスイッチングポリシーのターゲット負荷分散仮想サーバーを指定します。したがって、トラフィックの転送先となる負荷分散仮想サーバごとに 1 つのポリシーを設定する必要があります。

ただし、コンテンツスイッチングポリシーでデフォルトの構文規則が使用されている場合は、ポリシーのアクションを設定できます。アクションでは、ターゲットの負荷分散仮想サーバーの名前を指定するか、実行時に要求の送信先となる負荷分散仮想サーバーの名前を計算する要求ベースの式を構成できます。アクション式は、デフォルトの構文で指定する必要があります。

expression オプションを使用すると、コンテンツスイッチング仮想サーバーごとに 1 つのポリシーしか必要ないため、コンテンツスイッチング構成のサイズを大幅に削減できます。アクションを使用するコンテンツスイッチングポリシーは、複数のコンテンツスイッチ仮想サーバーにバインドすることもできます。これは、ターゲットの負荷分散仮想サーバーがコンテンツスイッチングポリシーで指定されなくなったためです。単一のポリシーを複数のコンテンツスイッチング仮想サーバーにバインドする機能によって、コンテンツスイッチング構成のサイズをさらに縮小できます。

アクションを作成したら、コンテンツスイッチポリシーを作成し、ポリシーでアクションを指定します。これにより、ポリシーがリクエストに一致したときにアクションが実行されます。

また、既定の構文規則を使用するコンテンツスイッチングポリシーの場合、別のアクションを使用する代わりに、ポリシーをコンテンツスイッチ仮想サーバーにバインドするときに、ターゲットの負荷分散仮想サーバーを指定することもできます。従来の式を使用するドメインベースのポリシー、URL ベースのポリシー、および規則ベースのポリシーの場合、アクションは使用できません。したがって、これらのタイプのポリシーでは、ポリシーをコンテンツスイッチ仮想サーバーにバインドするときに、ターゲットの負荷分散仮想サーバーの名前を指定します。

ターゲットの負荷分散仮想サーバーの名前を指定するアクションの構成

コンテンツスイッチング操作でターゲット負荷分散仮想サーバーの名前を指定する場合は、ターゲット負荷分散仮想サーバーと同じ数のコンテンツスイッチングポリシーが必要です。この場合、コンテンツスイッチングの決定は、コンテンツスイッチングポリシーのルールに基づいており、アクションはターゲット負荷分散仮想サーバーを指定するだけです。要求がポリシーに一致すると、要求は指定された負荷分散仮想サーバーに転送されます。

コマンドラインインターフェイスを使用して、ターゲットの負荷分散仮想サーバーの名前を指定するコンテンツスイッチングアクションを作成および検証するには

コマンドプロンプトで、次のように入力します。

add cs action <name> -targetLBVserver <string> [-comment <string>]

show cs action <name>

例:

> add cs action mycsaction -targetLBVserver mylbvserver -comment "Forwards requests to mylbvserver."
 Done
> show cs action mycsaction
    Name: mycsaction
    Target LB Vserver: mylbvserver
    Hits: 0
    Undef Hits: 0
    Action Reference Count: 0
    Comment: "Forwards requests to mylbvserver."

 Done
>

構成ユーティリティを使用して、ターゲットの負荷分散仮想サーバーの名前を指定するコンテンツスイッチングアクションを構成するには

  1. [トラフィック管理] > [コンテンツの切り替え] > [アクション]に移動します。
  2. コンテンツスイッチングアクションを構成し、ターゲットの負荷分散仮想サーバーの名前を指定します。

実行時にターゲットを選択するための式を指定するアクションの構成

ターゲットの負荷分散仮想サーバーの名前を動的に計算できる要求ベースの式を構成する場合は、適切な仮想サーバーを選択するために 1 つのコンテンツスイッチングポリシーを構成するだけで済みます。ポリシーの規則は、単純な TRUE(ポリシーはすべてのリクエストに一致する)にすることができます。この場合、コンテンツスイッチングの決定はアクションの式に基づいているためです。アクションで式を設定することで、コンテンツスイッチングの設定のサイズを大幅に減らすことができます。

実行時にターゲットの負荷分散仮想サーバーの名前を計算するための要求ベースの式を構成する場合は、構成内の負荷分散仮想サーバーに名前を付ける方法を慎重に検討する必要があります。アクションで要求ベースのポリシー式を使用して、名前を取得できる必要があります。

たとえば、URL サフィックス (要求されたリソースのファイル拡張子) に基づいて要求を切り替える場合は、負荷分散仮想サーバーに名前を付けるときに、URL サフィックスをあらかじめ決められた文字列 (mylb_など) に付加する規則に従うことができます。たとえば、HTML ページと PDF ファイルの負荷分散仮想サーバーには 、それぞれmylb_htmlmylb_pdfという名前を付けることができます。その場合、適切な負荷分散仮想サーバーを選択するために、コンテンツスイッチングアクションで使用できるルールは"mylb_"+HTTP.REQ.URL.SUFFIXです。コンテンツスイッチング仮想サーバーが HTML ページの要求を受信した場合、式はmylb_htmlを返し、要求は仮想サーバーmylb_htmlに切り替えられます。

コマンドラインインターフェイスを使用して、式を指定するコンテンツスイッチングアクションを作成するには

コマンドラインで次のコマンドを入力して、式を指定し、構成を確認するコンテンツスイッチングアクションを作成します。

add cs action <name> -targetVserverExpr <expression>) [-comment <string>]

show cs action <name>

例:

> add cs action mycsaction1 -targetvserverExpr '"mylb_" + HTTP.REQ.URL.SUFFIX'
 Done
> show cs action mycsaction1
    Name: mycsaction1
    Target Vserver Expression: "mylb_" + HTTP.REQ.URL.SUFFIX
    Target LB Vserver: No_Target
               …
 Done
>

構成ユーティリティを使用して式を指定するコンテンツスイッチングアクションを構成するには

  1. [トラフィック管理] > [コンテンツの切り替え] > [アクション]に移動します。
  2. コンテンツスイッチングアクションを構成し、ターゲットの負荷分散仮想サーバーの名前を動的に計算する式を指定します。

コンテンツスイッチングポリシーの構成

コンテンツスイッチングポリシーは、負荷分散仮想サーバーに送信される要求のタイプを定義します。これらのポリシーは、割り当てられた優先順位の順序、または(Citrix ADC クラシックポリシーを使用し、バインド時に優先順位を割り当てない場合)、ポリシーが作成された順序で適用されます。

ポリシーには、次のものがあります。

  • ドメインベースのポリシー。Citrix ADCアプライアンスは、受信URLのドメインとポリシーで指定されたドメインを比較します。その後、アプライアンスは最適なコンテンツを返します。ドメインベースのポリシーは、従来のポリシーである必要があります。このタイプのコンテンツスイッチングポリシーでは、デフォルトの構文ポリシーはサポートされていません。

  • URL ベースのポリシー。アプライアンスは、着信 URL とポリシーで指定された URL を比較します。次に、アプライアンスは、最も適切な URL ベースのコンテンツを返します。これは、通常、最も長く一致する構成された URL です。URL ベースのポリシーは、クラシックポリシーである必要があります。このタイプのコンテンツスイッチングポリシーでは、デフォルトの構文ポリシーはサポートされていません。

  • ルールベースのポリシー。アプライアンスは、受信データをポリシーで指定された式と比較します。ルールベースのポリシーは、クラシック式またはデフォルトの構文式を使用して作成します。ルールベースのコンテンツスイッチングポリシーでは、従来の構文ポリシーとデフォルトの構文ポリシーの両方がサポートされています。

    規則ベースのポリシーは、オプションのアクションで設定できます。アクションを持つポリシーは、複数の仮想サーバまたはポリシーラベルにバインドできます。

    ポリシーをコンテンツスイッチ仮想サーバーにバインドするときに優先度を設定すると、ポリシーが優先度順に評価されます。ポリシーをバインドするときに特定の優先順位を設定しない場合、ポリシーは作成された順序で評価されます。

Citrix ADC の従来のポリシーと式の詳細については、「クラシックポリシーおよび式の設定」を参照してください。デフォルト構文ポリシーの詳細については、「デフォルトの構文式の構成」を参照してください。

コマンドラインインターフェイスを使用してコンテンツスイッチポリシーを作成するには

コマンドプロンプトで、次のコマンドのいずれかを入力します。

add cs policy <policyName> -domain <domain>

add cs policy <policyName> -url <URLValue>

add cs policy <policyName> -rule <RULEValue>

add cs policy <policyName> -rule <RULEValue> -action <actionName>

:

add cs policy Policy-CS-1 -url "http://example.com"

add cs policy Policy-CS-1 -domain "example.com"

add cs policy Policy-CS-1 -rule "CLIENT.IP.SRC.SUBNET(24).EQ(10.217.84.0)"

add cs policy Policy-CS-2 -rule "SYS.TIME.BETWEEN(GMT 2009 Nov,GMT 2009 Dec)"

add cs policy Policy-CS-3 -rule "http.req.method.eq(GET)" -action act1

コマンドラインインターフェイスを使用してコンテンツスイッチポリシーの名前を変更するには

コマンドプロンプトで、次のように入力します。

rename cs policy <policyName> <newName>

:

rename cs policy myCSPolicy myCSPolicy1

構成ユーティリティを使用してコンテンツスイッチポリシーの名前を変更するには

[トラフィック管理] > [コンテンツの切り替え] > [ポリシー] に移動し、ポリシーを選択し、[アクション] リストで [名前の変更] を選択します。

構成ユーティリティを使用してコンテンツスイッチングポリシーを作成するには

  1. [トラフィック管理] > [コンテンツの切り替え] > [ポリシー] に移動し、[追加] をクリックします。
  2. 関連フィールドに入力し、[Create] をクリックします。

コンテンツスイッチングポリシーラベルの設定

ポリシーラベルは、ポリシーがバインドされるユーザー定義のバインドポイントです。ポリシーラベルが呼び出されると、そのラベルにバインドされているすべてのポリシーが、割り当てた優先順位に従って評価されます。ポリシー・ラベルには、1つ以上のポリシーを含めることができ、それぞれに独自の結果を割り当てることができます。ポリシー・ラベル内の1つのポリシーが一致すると、次のポリシーに進み、別のポリシー・ラベルまたは適切なリソースを呼び出したり、ポリシー評価の即時終了を行ったり、ポリシー・ラベルを呼び出したポリシーに制御が戻ったりすることがあります。ポリシーラベルは、デフォルトの構文ポリシーに対してのみ作成できます。

コンテンツスイッチポリシーラベルは、名前、ラベルタイプ、およびポリシーラベルにバインドされたポリシーのリストで構成されます。ポリシーラベルタイプは、ラベルにバインドされたポリシーに割り当てられたプロトコルを指定します。ポリシーラベルを呼び出すポリシーがバインドされているコンテンツスイッチ仮想サーバーのサービスタイプと一致する必要があります。たとえば、TCP ペイロードポリシーを TCP タイプのポリシーラベルだけにバインドできます。TCP ペイロードポリシーを HTTP タイプのポリシーラベルにバインドすることはできません。

コンテンツスイッチポリシーラベル内の各ポリシーは、ターゲット(書き換えポリシーやレスポンダーポリシーなど、他のタイプのポリシーに関連付けられているアクションと同等です)、または gotoPriorityExpression オプションおよび/または呼び出しオプションのいずれかに関連付けられます。つまり、コンテンツスイッチングポリシーラベル内の特定のポリシーに対して、ターゲットを指定するか、gotoPriorityExpression オプションまたは invoke オプションを設定できます。さらに、複数のポリシーが true と評価された場合、true と評価される最後のポリシーのターゲットだけが考慮されます。

Citrix ADC CLIまたは構成ユーティリティーを使用して、コンテンツスイッチングポリシーラベルを構成できます。Citrix ADC CLIでは、最初に add cs policylabel コマンドを使用してポリシーラベルを作成します。次に、bind cs policylabel コマンドを使用して、ポリシーをポリシーラベルに一度に 1 つのポリシーをバインドします。Citrix ADC GUIでは、単一のダイアログボックスで両方のタスクを実行します。

コマンドラインインターフェイスを使用してコンテンツスイッチポリシーラベルを作成するには

コマンドプロンプトで、次のように入力します。

add cs policylabel <labelName> <cspolicylabelTypetype>`

例:

add cs policylabel testpollab http

コマンドラインインターフェイスを使用してコンテンツスイッチポリシーラベルの名前を変更するには

コマンドプロンプトで、次のように入力します。

rename cs policylabel <labelName> <newName>`

例:

rename cs policylabel oldPolicyLabelName newPolicyLabelName

構成ユーティリティを使用してコンテンツスイッチングポリシーラベルの名前を変更するには

[トラフィック管理] > [コンテンツスイッチング] > [ポリシーラベル] に移動し、ポリシーラベルを選択し、[アクション] リストで [名前の変更] を選択します。

コマンドラインインターフェイスを使用してポリシーをコンテンツスイッチポリシーラベルにバインドするには

コマンドプロンプトで次のコマンドを入力して、ポリシーをポリシーラベルにバインドし、構成を確認します。

bind cs policylabel <labelName> <policyName> <priority>[-targetVserver <string>] | [-gotoPriorityExpression <expression>] | [-invoke <labeltype> <labelName>] ]

show cs policylabel <labelName>

例:

bind cs policylabel testpollab test_Pol 100 -targetVserver LBVIP
show cs policylabel testpollab
        Label Name: testpollab
        Label Type: HTTP
        Number of bound policies: 1
        Number of times invoked: 0
        Policy Name: test_Pol
        Priority: 100
        Target Virtual Server: LBVIP

ポリシーにアクションが設定されている場合、ターゲット仮想サーバ(targetVserver)、優先度式(gotoPriorityExpression)に移動し、呼び出し(呼び出し)パラメータは必要ありません。ポリシーにアクションが設定されていない場合は、targetVserver、gotoPriorityExpression、および呼び出しのパラメータの少なくとも 1 つを設定する必要があります。

コマンドラインインターフェイスを使用してポリシーラベルからポリシーをバインド解除するには

コマンドプロンプトで次のコマンドを入力して、ポリシーラベルからポリシーをバインド解除し、構成を確認します。

unbind cs policylabel <labelName> <policyName>

show cs policylabel <labelName>

例:

unbind cs policylabel testpollab test_Pol
show cs policylabel testpollab
        Label Name: testpollab
        Label Type: HTTP
        Number of bound policies: 0
        Number of times invoked: 0

コマンドラインインターフェイスを使用してポリシーラベルを削除するには

コマンドプロンプトで、次のように入力します。

rm cs policylabel <labelName>

構成ユーティリティを使用してコンテンツスイッチングポリシーラベルを管理するには

[トラフィック管理] > [コンテンツスイッチング] > [ポリシーラベル]に移動し、ポリシーラベルを設定し、ラベルにポリシーをバインドし、オプションで優先順位、gotoPriority 式、呼び出しオプションを指定します。

コンテンツスイッチング仮想サーバーへのポリシーのバインド

コンテンツスイッチ仮想サーバーとコンテンツスイッチポリシーの作成後、各ポリシーをコンテンツスイッチ仮想サーバーにバインドします。ポリシーをコンテンツスイッチ仮想サーバーにバインドするときには、ターゲットとなる負荷分散仮想サーバーを指定します。

コンテンツスイッチングポリシーでデフォルトの構文規則が使用されている場合は、そのポリシーのコンテンツスイッチングアクションを設定できます。アクションを構成する場合、ポリシーをコンテンツスイッチ仮想サーバーにバインドするときではなく、アクションを構成するときにターゲットの負荷分散仮想サーバーを指定する必要があります。コンテンツスイッチングアクションの設定の詳細については、 「コンテンツスイッチングアクションの設定」セクションを参照してください。

コンテンツスイッチ仮想サーバーにポリシーをバインドし、コマンドラインインターフェイスを使用してターゲットの負荷分散仮想サーバーを選択するには

コマンドプロンプトで、次のように入力します。

bind cs vserver <name>[-lbvserver<string> -targetLBVServer<string> -policyname <string> -priority <positive_integer>] [-gotoPriorityExpression <expression>] [-type ( REQUEST | RESPONSE )] [-invoke (<labelType> <labelName>)]

例:

bind cs vserver csw-vip2 -policyname csw-ape-policy2 -priority 14 -gotoPriorityExpression NEXT

bind cs vserver csw-vip3 -policyname rewrite-policy1 -priority 17 -gotoPriorityExpression
'q.header("a").count' -flowtype REQUEST -invoke policylabel label1

bind cs vserver Vserver-CS-1 Vserver-LB-1 -policyname Policy-CS-1 -priority 20

ポリシーにアクションがある場合、パラメータ、ターゲット負荷分散仮想サーバ(targetVserver)、優先度式(gotoPriorityExpression)、および呼び出しメソッド(invoke)は使用できません。

構成ユーティリティを使用してポリシーをコンテンツスイッチ仮想サーバーにバインドし、ターゲットの負荷分散仮想サーバーを選択するには

[トラフィック管理] > [コンテンツスイッチング] > [仮想サーバー] に移動し、仮想サーバーを開き、 [コンテンツスイッチングポリシーのバインディング] セクションでポリシーを仮想サーバーにバインドし、ターゲットの負荷分散仮想サーバーを指定します。

コンテンツスイッチングのためのポリシーベースのロギングの構成

コンテンツスイッチングポリシーのポリシーベースのログを設定できます。ポリシーベースのロギングでは、ログメッセージの形式を指定できます。ログメッセージの内容は、コンテンツスイッチングポリシーでデフォルトの構文式を使用して定義されます。ポリシーで指定されているコンテンツスイッチングアクションが実行されると、Citrix ADCアプライアンスは式からログメッセージを作成し、ログファイルにメッセージを書き込みます。ポリシーベースのロギングは、コンテンツスイッチングアクションが実行時にターゲット負荷分散仮想サーバーを識別する構成をテストおよびトラブルシューティングする場合に特に便利です。

特定の仮想サーバーにバインドされた複数のポリシーがTRUEと評価され、監査メッセージアクションで構成されている場合、Citrix ADCアプライアンスはすべての監査メッセージアクションを実行しません。コンテンツスイッチングアクションが実行されるポリシーに対して構成されている監査メッセージアクションだけを実行します。

コンテンツスイッチングポリシーのポリシーベースのログを設定するには、まず監査メッセージアクションを構成する必要があります。監査メッセージアクションの設定の詳細については、「監査ログ用のCitrix ADCアプライアンスの構成」を参照してください。監査メッセージアクションを構成したら、コンテンツスイッチングポリシーでアクションを指定します。

コマンドラインインターフェイスを使用してコンテンツスイッチングポリシーのポリシーベースのログを構成するには

コマンドラインで次のコマンドを入力して、コンテンツスイッチングポリシーのポリシーベースのロギングを設定し、設定を確認します。

set cs policy <policyName> -logAction <string>

show cs policy <policyName>

例:

> set cs policy cspol1 -logAction csLogAction
 Done
> show cs policy cspol1

    Policy: cspol1  Rule: TRUE  Action: csact1
    LogAction: csLogAction
    Hits: 0

1)  CS Vserver: csvs1
    Priority: 10
 Done
>

構成ユーティリティを使用してコンテンツスイッチングポリシーのポリシーベースのログを構成するには

[トラフィック管理] > [コンテンツスイッチング] > [ポリシー] に移動し、ポリシーを開き、[ログアクション] リストでポリシーのログアクションを選択します。

設定の確認

コンテンツスイッチングの設定が正しいことを確認するには、コンテンツスイッチングエンティティを表示する必要があります。コンテンツスイッチ構成の展開後に正しく動作していることを確認するために、サーバーへのアクセス時に生成される統計情報を表示できます。

コンテンツスイッチング仮想サーバーのプロパティの表示

Citrix ADCアプライアンスで構成したコンテンツスイッチ仮想サーバーのプロパティを表示できます。この情報を使用して、仮想サーバーが正しく構成されているかどうかを確認し、必要に応じてトラブルシューティングを行うことができます。名前、IP アドレス、ポートなどの詳細に加えて、仮想サーバーにバインドされたさまざまなポリシーとそのトラフィック管理設定を表示できます。

コンテンツスイッチングポリシーは、優先順位の順に表示されます。複数のポリシーに同じプライオリティが設定されている場合は、仮想サーバにバインドされた順序で表示されます。

負荷分散仮想サーバーにトラフィックを転送するようにコンテンツスイッチ仮想サーバーを構成している場合は、負荷分散仮想サーバーのプロパティを表示して、コンテンツスイッチングポリシーを表示することもできます。

コマンドラインインターフェイスを使用してコンテンツスイッチ仮想サーバーのプロパティを表示するには

構成内のすべてのコンテンツスイッチ仮想サーバーの基本プロパティ、または特定のコンテンツスイッチ仮想サーバーの詳細なプロパティを一覧表示するには、コマンドプロンプトで次のコマンドのいずれかを入力します。

show cs vserver

show cs vserver <name>

1.
show cs vserver Vserver-CS-1
Vserver-CS-1 (10.102.29.161:80) - HTTP Type: CONTENT
State: UP
Last state change was at Thu Jun 30 10:48:59 2011
Time since last state change: 6 days, 20:03:00.760
Client Idle Timeout: 180 sec
Down state flush: ENABLED
Disable Primary Vserver On Down : DISABLED
Appflow logging: DISABLED
Port Rewrite : DISABLED
State Update: DISABLED
Default: Content Precedence: RULE
Vserver IP and Port insertion: OFF
Case Sensitivity: ON
Push: DISABLED Push VServer:
Push Label Rule: none

...
1) Policy : __ESNS_PREBODY_POLICY Priority:0
2) Policy : __ESNS_POSTBODY_POLICY Priority:0

1) Compression Policy Name: __ESNS_CMP_POLICY Priority: 2147483647
GotoPriority Expression: END
Flowtype: REQUEST

2) Rewrite Policy Name: __ESNS_REWRITE_POLICY Priority: 2147483647
GotoPriority Expression: END
Flowtype: REQUEST

3) Cache Policy Name: dfbx Priority: 10
GotoPriority Expression: END
Flowtype: REQUEST

4) Responder Policy Name: __ESNS_RESPONDER_POLICY Priority: 2147483647
GotoPriority Expression: END

1) Policy: wiki Target: LBVIP2 Priority: 25 Hits: 0
2) Policy: plain Target: LBVIP1 Priority: 90 Hits: 0
3) Policy: DispOrderTest2 Target: KerbAuthLBVS Priority: 91 Hits: 0
4) Policy: test_Pol Target: LBVIP1 Priority: 92 Hits: 0
5) Policy: PolicyNameTesting Target: LBVIP1 Priority: 100 Hits: 0
 Done
>

show cs vserver
1) Vserver-CS-1 (10.102.29.161:80) - HTTP Type: CONTENT
State: UP
…
Appflow logging: DISABLED
Port Rewrite : DISABLED
State Update: DISABLED

2) apubendpt (10.111.111.1:80) - HTTP Type: CONTENT
State: UP
…
Client Idle Timeout: 180 sec
Down state flush: DISABLED
…

3) apubendpt1 (10.111.111.2:80) - HTTP Type: CONTENT
State: UP
…
Disable Primary Vserver On Down : DISABLED
Appflow logging: DISABLED
Port Rewrite : DISABLED
State Update: DISABLED
…

コンテンツスイッチングポリシーの表示

名前、ドメイン、URL、式など、定義したコンテンツスイッチポリシーのプロパティを表示し、この情報を使用して構成の間違いを検出したり、正常に動作しない場合のトラブルシューティングを行うことができます。

コマンドラインインターフェイスを使用してコンテンツスイッチングポリシーのプロパティを表示するには

構成内のすべてのコンテンツスイッチングポリシーの基本プロパティ、または特定のコンテンツスイッチングポリシーの詳細なプロパティを一覧表示するには、コマンドプロンプトで次のコマンドのいずれかを入力します。

show cs policy

show cs policy <PolicyName>

例:

show cs policy

show cs policy Policy-CS-1

構成ユーティリティを使用してコンテンツスイッチングポリシーのプロパティを表示するには

[トラフィック管理] > [コンテンツの切り替え] > [ポリシー] に移動し、ポリシーを選択し、[アクション] リストで [バインディングの表示] を選択します。

ビジュアライザーを使用したコンテンツスイッチング仮想サーバー構成の表示

コンテンツスイッチングビジュアライザは、コンテンツスイッチング設定をグラフィカル形式で表示するために使用できるツールです。ビジュアライザーを使用すると、次の構成項目を表示できます。

  • コンテンツスイッチ仮想サーバーがバインドされている負荷分散仮想サーバーの概要。
  • 負荷分散仮想サーバーにバインドされているすべてのサービスとサービスグループ、およびサービスにバインドされているすべてのモニター。
  • 表示された要素の設定の詳細。
  • コンテンツスイッチ仮想サーバーにバインドされたポリシー。これらのポリシーは、コンテンツスイッチングポリシーである必要はありません。書き換えポリシーなど、多くの種類のポリシーは、コンテンツスイッチング仮想サーバーにバインドできます。

コンテンツスイッチングおよび負荷分散のセットアップでさまざまな要素を構成したら、構成全体をアプリケーションテンプレートファイルにエクスポートできます。

ビジュアライザーにはグラフィカルインターフェイスが必要なため、構成ユーティリティからのみ使用できます。

構成ユーティリティーのビジュアライザーを使用してコンテンツスイッチング構成を表示するには

  1. [トラフィック管理] > [コンテンツスイッチング] > [仮想サーバー] に移動します。
  2. 詳細ウィンドウで、表示する仮想サーバーを選択し、[ビジュアライザー] をクリックします。
  3. [コンテンツスイッチングビジュアライザー] ウィンドウでは、次のように表示可能領域を調整できます。
    • [拡大] および [縮小] アイコンをクリックして、表示領域を拡大または縮小します。
    • [イメージを保存] アイコンをクリックして、グラフをイメージファイルとして保存します。
    • 「検索場所」テキストフィールドに、検索する項目の名前を入力します。項目を識別するのに十分な文字を入力すると、その位置が強調表示されます。検索を制限するには、ドロップダウンメニューをクリックし、検索する要素のタイプを選択します。
  4. この仮想サーバーにバインドされているエンティティの構成の詳細を表示するには、次の操作を行います。
    • 仮想サーバにバインドされているポリシーを表示するには、ダイアログ・ボックスの上部にあるツールバーで、1つ以上の機能固有のポリシー・アイコンを選択します。ポリシーラベルが設定されている場合は、メインビュー領域に表示されます。
    • バインドされたサービスまたはサービスグループの構成の詳細を表示するには、サービスのアイコンをクリックし、[関連タスク] タブをクリックして、[メンバーサービスの表示] をクリックします。
    • モニタの構成の詳細を表示するには、モニタのアイコンをクリックし、[関連タスク] タブをクリックし、[モニタの表示] をクリックします。
  5. コンテンツスイッチ構成内の仮想サーバーの詳細な統計情報を表示するには、統計情報を表示する仮想サーバーをクリックし、[関連タスク] タブをクリックし、[統計] をクリックします。
  6. 負荷分散仮想サーバーのサービスコンテナー間で値が異なる、または定義されていないパラメータの比較リストを表示するには、コンテナーのアイコンをクリックし、[関連タスク] タブをクリックして、[サービス属性の相違] をクリックします。
  7. コンテナ内のサービスの監視バインドの詳細を表示するには、[サービス属性の相違] ダイアログボックスで、コンテナの [グループ] 列で [詳細] をクリックします。この比較リストは、どのサービスコンテナにすべてのサービスコンテナに適用する設定があるかを判断するのに役立ちます。
  8. 設定内の仮想サーバによって特定の時点で受信された 1 秒あたりの要求数、および書き換え、レスポンダ、およびキャッシュポリシーに対する特定の時点における 1 秒あたりのヒット数を表示するには、[Show Stats] をクリックします。統計情報は、ビジュアライザーの各ノードに表示されます。この情報はリアルタイムで更新されません。手動で更新する必要があります。情報を更新するには、[統計情報の更新] をクリックします。

    このオプションは、Citrix ADC nCoreビルドでのみ使用できます。

  9. 要素の構成の詳細をドキュメントまたはスプレッドシートにコピーするには、その要素のアイコンをクリックし、[関連タスク]、[プロパティのコピー] の順にクリックし、情報をドキュメントに貼り付けます。
  10. ビジュアライザーに表示される構成全体をアプリケーションテンプレートファイルにエクスポートするには、コンテンツスイッチ仮想サーバーのアイコンをクリックし、[関連タスク]、[テンプレートの作成] の順にクリックします。アプリケーションテンプレートを作成するときに、いくつかのポリシー式とアクションで変数を設定できます。アプリケーションテンプレートファイルの作成とテンプレートの変数の設定の詳細については、「AppExpert」を参照してください。

基本的なコンテンツスイッチングの設定

この記事の概要