Documentation produit
Citrix ADC
Current Release 13.0 12.1
Voir PDF

Configuration de la commutation de contenu de base

October 4, 2021
Contributeur: 
C

Avant de configurer la commutation de contenu, vous devez comprendre comment la commutation de contenu est configurée et comment les services et les serveurs virtuels sont connectés.

Pour configurer une configuration de base et fonctionnelle de commutation de contenu, activez d’abord la fonction de commutation de contenu. Ensuite, créez au moins un groupe de contenu. Pour chaque groupe de contenu, créez un serveur virtuel de commutation de contenu pour accepter les demandes adressées à un groupe de sites Web qui utilisent la commutation de contenu. Créez également une configuration d’équilibrage de charge, qui inclut un groupe de serveurs virtuels d’équilibrage de charge vers lesquels le serveur virtuel de commutation de contenu dirige les demandes. Pour spécifier les requêtes à diriger vers quel serveur virtuel d’équilibrage de charge, créez au moins deux stratégies de commutation de contenu, une pour chaque type de requête à rediriger. Lorsque vous avez créé les serveurs virtuels et les stratégies, liez les stratégies au serveur virtuel de commutation de contenu. Vous pouvez également lier une stratégie à plusieurs serveurs virtuels de commutation de contenu. Lorsque vous liez une stratégie, vous spécifiez le serveur virtuel d’équilibrage de charge vers lequel les demandes correspondant à la stratégie doivent être dirigées.

En plus de lier des stratégies individuelles à un serveur virtuel de commutation de contenu, vous pouvez lier des étiquettes de stratégie. Si vous créez plus de groupes de contenu, vous pouvez lier une stratégie ou un libellé de stratégie à plusieurs serveurs virtuels de commutation de contenu.

Remarque

Après avoir créé un groupe de contenu, vous pouvez modifier son serveur virtuel de commutation de contenu pour personnaliser la configuration.

Activation de la commutation de contenu

Pour utiliser la fonction de commutation de contenu, vous devez activer la commutation de contenu. Vous pouvez configurer des entités de commutation de contenu même si la fonction de commutation de contenu est désactivée. Cependant, les entités ne fonctionneront pas.

Pour activer le changement de contenu à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez les commandes suivantes pour activer la commutation de contenu et vérifier la configuration :

enable ns feature CS

show ns feature
<!--NeedCopy-->

Exemple :

> 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
<!--NeedCopy-->

Pour activer la commutation de contenu à l’aide de l’interface graphique

Accédez à Système > Paramètres et, dans le groupe Modes et fonctionnalités, sélectionnez Configurer les fonctionnalités de base et sélectionnez Commutation de contenu.

La figure suivante illustre la configuration par étape de Content Switching.

Flux de changement de contenu

Création de serveurs virtuels de commutation de contenu

Vous pouvez ajouter, modifier et supprimer des serveurs virtuels de commutation de contenu. L’état d’un serveur virtuel est DOWN lorsque vous le créez, car le serveur virtuel d’équilibrage de charge n’y est pas encore lié.

Pour créer un serveur virtuel à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez :

add cs vserver <name> <protocol> <IPAddress> <port>
<!--NeedCopy-->

Exemple :

add cs vserver Vserver-CS-1 HTTP 10.102.29.161 80
<!--NeedCopy-->

Pour ajouter un serveur virtuel de commutation de contenu à l’aide de l’interface graphique

  1. Accédez à Gestion du trafic > Commutation de contenu > Serveurs virtuels, puis ajoutez un serveur virtuel.
  2. Spécifiez un nom pour le serveur virtuel de commutation de contenu.

    Remarque

    Il existe différents serveurs virtuels de commutation de contenu pour chaque protocole. (Par exemple, HTTP et SSL).

  3. Remplissez les champs pertinents et cliquez sur OK.

Statistiques du serveur virtuel de commutation de contenu

Les statistiques du serveur virtuel de commutation de contenu affichent des informations telles que la sélection du serveur virtuel, les octets de demande, les octets de réponse, le nombre total de paquets reçus, le nombre total de paquets envoyés, le seuil de débordement, la sélection de débordement, les connexions établies par le client actuel et la sélection de sauvegarde du serveur virtuel en panne.

Les statistiques du serveur virtuel de commutation de contenu affichent également les détails récapitulatifs du serveur virtuel d’équilibrage de charge par défaut lié.

Pour afficher les statistiques du serveur virtuel de commutation de contenu à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez :

stat cs vserver <name>
<!--NeedCopy-->

Exemple :

stat cs vserver CS_stats
<!--NeedCopy-->

Statistiques de commutation de contenu

Pour afficher les statistiques du serveur virtuel de commutation de contenu à l’aide de l’interface graphique

1. Accédez à Gestion du trafic > Changement de contenu > Serveurs virtuels.

2. Sélectionnez le serveur virtuel et cliquez sur Statistiques.

Statistiques de changement de contenu

Configuration d’une configuration d’équilibrage de charge pour la commutation de contenu

Le serveur virtuel de commutation de contenu redirige toutes les demandes vers un serveur virtuel d’équilibrage de charge. Vous devez créer un serveur virtuel d’équilibrage de charge pour chaque version du contenu en cours de commutation. Cela est vrai même lorsque votre installation n’a qu’un seul serveur pour chaque version du contenu, et que vous n’effectuez donc aucun équilibrage de charge avec ces serveurs. Vous pouvez également configurer l’équilibrage de charge réel avec plusieurs serveurs équilibrés de charge qui reflètent chaque version du contenu. Dans les deux scénarios, le serveur virtuel de commutation de contenu doit disposer d’un serveur virtuel d’équilibrage de charge spécifique affecté à chaque version du contenu en cours de commutation.

Le serveur virtuel d’équilibrage de charge transmet ensuite la demande à un service. S’il n’y a qu’un seul service qui lui est lié, il sélectionne ce service. S’il a plusieurs services liés à lui, il utilise sa méthode d’équilibrage de charge configurée pour sélectionner un service pour la demande et transfère cette demande au service qu’il a sélectionné.

Pour configurer une configuration d’équilibrage de charge de base, vous devez effectuer les tâches suivantes :

  • Créer des serveurs virtuels d’équilibrage de charge
  • Créer des services
  • Liez les services au serveur virtuel d’équilibrage de charge

Pour plus d’informations sur l’équilibrage de charge, voir Fonctionnement de l’équilibrage de charge. Pour obtenir des instructions détaillées sur la configuration d’une configuration d’équilibrage de charge de base, voir Configurer l’équilibrage de charge de base.

Configuration d’une action de commutation de contenu

Vous spécifiez le serveur virtuel d’équilibrage de charge cible pour une stratégie de commutation de contenu lors de la liaison de la stratégie au serveur virtuel de commutation de contenu. Par conséquent, vous devez configurer une stratégie pour chaque serveur virtuel d’équilibrage de charge vers lequel diriger le trafic.

Toutefois, si votre stratégie de changement de contenu utilise une règle de syntaxe par défaut, vous pouvez configurer une action pour la stratégie. Dans l’action, vous pouvez spécifier le nom du serveur virtuel d’équilibrage de charge cible ou vous pouvez configurer une expression basée sur la demande qui, au moment de l’exécution, calcule le nom du serveur virtuel d’équilibrage de charge auquel envoyer la demande. L’expression d’action doit être spécifiée dans la syntaxe par défaut.

L’option d’expression peut réduire considérablement la taille de votre configuration de commutation de contenu, car vous n’avez besoin que d’une seule stratégie par serveur virtuel de commutation de contenu. Les stratégies de commutation de contenu qui utilisent une action peuvent également être liées à plusieurs serveurs virtuels de commutation de contenu, car le serveur virtuel d’équilibrage de charge cible n’est plus spécifié dans la stratégie de commutation de contenu. La possibilité de lier une stratégie unique à plusieurs serveurs virtuels de commutation de contenu permet de réduire davantage la taille de votre configuration de commutation de contenu.

Après avoir créé une action, vous créez une stratégie de commutation de contenu et spécifiez l’action dans la stratégie, de sorte que l’action soit exécutée lorsque cette stratégie correspond à une demande.

Remarque

Vous pouvez également, pour une stratégie de commutation de contenu qui utilise une règle de syntaxe par défaut, spécifier le serveur virtuel d’équilibrage de charge cible lors de la liaison de la stratégie à un serveur virtuel de commutation de contenu, au lieu d’utiliser une action distincte. Pour les stratégies basées sur un domaine, les stratégies basées sur des URL et les stratégies basées sur des règles qui utilisent des expressions classiques, aucune action n’est disponible. Par conséquent, pour ces types de stratégies, vous spécifiez le nom du serveur virtuel d’équilibrage de charge cible lors de la liaison de la stratégie à un serveur virtuel de commutation de contenu.

Configuration d’une action qui spécifie le nom du serveur virtuel d’équilibrage de charge cible

Si vous choisissez de spécifier le nom du serveur virtuel d’équilibrage de charge cible dans une action de commutation de contenu, vous avez besoin d’autant de stratégies de commutation de contenu que de serveurs virtuels d’équilibrage de charge cible. Dans ce cas, les décisions de commutation de contenu sont basées sur la règle de la stratégie de commutation de contenu, et l’action spécifie simplement le serveur virtuel d’équilibrage de charge cible. Lorsqu’une demande correspond à la stratégie, la demande est transmise au serveur virtuel d’équilibrage de charge spécifié.

Pour créer et vérifier une action de commutation de contenu qui spécifie le nom du serveur virtuel d’équilibrage de charge cible, à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez :

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

show cs action <name>
<!--NeedCopy-->

Exemple :

> 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
>
<!--NeedCopy-->

Pour configurer une action de commutation de contenu qui spécifie le nom du serveur virtuel d’équilibrage de charge cible, à l’aide de l’interface graphique

  1. Accédez à Gestion du trafic > Commutation de contenu > Actions.
  2. Configurez une action de commutation de contenu et spécifiez le nom du serveur virtuel d’équilibrage de charge cible.

Configuration d’une action qui spécifie une expression pour sélectionner la cible au moment de l’exécution

Si vous choisissez de configurer une expression basée sur la demande qui peut calculer dynamiquement le nom du serveur virtuel d’équilibrage de charge cible, vous devez configurer une seule stratégie de commutation de contenu pour sélectionner le serveur virtuel approprié. La règle de la stratégie peut être TRUE simple (la stratégie correspond à toutes les demandes) car, dans ce cas, les décisions de changement de contenu sont basées sur l’expression dans l’action. En configurant une expression dans une action, vous pouvez réduire considérablement la taille de votre configuration de changement de contenu.

Si vous choisissez de configurer une expression basée sur la demande pour calculer le nom du serveur virtuel d’équilibrage de charge cible au moment de l’exécution, vous devez examiner attentivement comment nommer les serveurs virtuels d’équilibrage de charge dans la configuration. Vous devez pouvoir dériver leurs noms à l’aide de l’expression de stratégie basée sur la demande dans l’action.

Par exemple, si vous changez de demandes basées sur le suffixe d’URL (extension de la ressource demandée), lorsque vous nommez les serveurs virtuels d’équilibrage de charge, vous pouvez suivre la convention d’ajout du suffixe URL à une chaîne prédéterminée, telle que mylb_. Par exemple, les serveurs virtuels d’équilibrage de charge pour les pages HTML et les fichiers PDF peuvent être nommés mylb_html et mylb_pdf respectivement. Dans ce cas, la règle que vous pouvez utiliser dans l’action de commutation de contenu, pour sélectionner le serveur virtuel d’équilibrage de charge approprié, est "mylb_"+HTTP.REQ.URL.SUFFIX. Si le serveur virtuel de commutation de contenu reçoit une demande pour une page HTML, l’expression renvoie mylb_htmlet la demande est basculée sur le serveur virtuel mylb_html.

Pour créer une action de commutation de contenu qui spécifie une expression, à l’aide de l’interface de ligne de commande

Sur la ligne de commande, tapez les commandes suivantes pour créer une action de commutation de contenu qui spécifie une expression et vérifier la configuration :

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

show cs action <name>
<!--NeedCopy-->

Exemple :

> 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
>
<!--NeedCopy-->

Pour configurer une action de commutation de contenu qui spécifie une expression à l’aide de l’interface graphique

  1. Accédez à Gestion du trafic > Commutation de contenu > Actions.
  2. Configurez une action de commutation de contenu et spécifiez une expression qui calculera dynamiquement le nom du serveur virtuel d’équilibrage de charge cible.

Configuration des stratégies de commutation de contenu

Une stratégie de commutation de contenu définit un type de requête qui doit être dirigé vers un serveur virtuel d’équilibrage de charge. Ces stratégies sont appliquées dans l’ordre des priorités qui leur sont assignées ou (si vous utilisez des stratégies classiques Citrix ADC et que vous n’affectez pas de priorités lors de leur liaison) dans l’ordre dans lequel les stratégies ont été créées.

Les stratégies peuvent être les suivantes :

  • Stratégies basées sur le domaine. L’appliance Citrix ADC compare le domaine d’une URL entrante avec les domaines spécifiés dans les stratégies. L’appliance renvoie ensuite le contenu le plus approprié. Les stratégies basées sur le domaine doivent être des stratégies classiques. Les stratégies de syntaxe par défaut ne sont pas prises en charge pour ce type de stratégie de changement de contenu.

  • Stratégies basées sur l’URL. L’appliance compare une URL entrante avec les URL spécifiées dans les stratégies. L’appliance renvoie ensuite le contenu basé sur l’URL le plus approprié, qui est généralement l’URL configurée la plus longue correspondant. Les stratégies basées sur l’URL doivent être des stratégies classiques. Les stratégies de syntaxe par défaut ne sont pas prises en charge pour ce type de stratégie de changement de contenu.

  • Stratégies basées sur des règles. L’appliance compare les données entrantes aux expressions spécifiées dans les stratégies. Vous créez des stratégies basées sur des règles à l’aide d’une expression classique ou d’une expression de syntaxe par défaut. Les stratégies de syntaxe classique et par défaut sont prises en charge pour les stratégies de commutation de contenu basées sur des règles.

    Remarque

    Une stratégie basée sur des règles peut être configurée avec une action facultative. Une stratégie comportant une action peut être liée à plusieurs serveurs virtuels ou étiquettes de stratégie.

    Si vous définissez une priorité lors de la liaison de vos stratégies au serveur virtuel de commutation de contenu, les stratégies sont évaluées par ordre de priorité. Si vous ne définissez pas de priorités spécifiques lors de la liaison de vos stratégies, les stratégies sont évaluées dans l’ordre dans lequel elles ont été créées.

Pour plus d’informations sur les stratégies et expressions classiques Citrix ADC, reportez-vous à la section Configuration des stratégies et expressions classiques. Pour plus d’informations sur les stratégies de syntaxe par défaut, reportez-vous à la section Configuration des expressions de syntaxe par défaut.

Pour créer une stratégie de commutation de contenu à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez l’une des commandes suivantes :

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>
<!--NeedCopy-->

Exemple :

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
<!--NeedCopy-->

Pour renommer une stratégie de commutation de contenu à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez :

rename cs policy <policyName> <newName>
<!--NeedCopy-->

Exemple :

rename cs policy myCSPolicy myCSPolicy1
<!--NeedCopy-->

Pour renommer une stratégie de commutation de contenu à l’aide de l’interface graphique

Accédez à Gestion du trafic > Commutation de contenu > Stratégies, sélectionnez une stratégie et, dans la liste Action, sélectionnez Renommer.

Pour créer une stratégie de commutation de contenu à l’aide de l’interface graphique

  1. Accédez à Gestion du trafic > Commutation de contenu > Stratégies, puis cliquez sur Ajouter.
  2. Remplissez les champs pertinents et cliquez sur Créer.

Configuration des étiquettes de stratégie de commutation de contenu

Une étiquette de stratégie est un point de liaison défini par l’utilisateur auquel les stratégies sont liées. Lorsqu’une étiquette de stratégie est appelée, toutes les stratégies qui lui sont liées sont évaluées dans l’ordre de priorité que vous leur avez attribué. Une étiquette de stratégie peut inclure une ou plusieurs stratégies, dont chacune peut se voir attribuer son propre résultat. Une correspondance sur une stratégie de l’étiquette de stratégie peut entraîner la poursuite de la stratégie suivante, l’appel d’une étiquette de stratégie différente ou d’une ressource appropriée, ou la fin immédiate de l’évaluation de stratégie et le retour du contrôle à la stratégie qui a appelé l’étiquette de stratégie. Vous pouvez uniquement créer des étiquettes de stratégie pour les stratégies de syntaxe par défaut.

Une étiquette de stratégie de changement de contenu se compose d’un nom, d’un type d’étiquette et d’une liste de stratégies liées à l’étiquette de stratégie. Le type d’étiquette de stratégie spécifie le protocole qui a été affecté aux stratégies liées à l’étiquette. Il doit correspondre au type de service du serveur virtuel de commutation de contenu auquel la stratégie qui appelle l’étiquette de stratégie est liée. Par exemple, vous pouvez lier des stratégies TCP Payload à une étiquette de stratégie de type TCP uniquement. La liaison des stratégies de charge utile TCP à une étiquette de stratégie de type HTTP n’est pas prise en charge.

Chaque stratégie d’une étiquette de stratégie de changement de contenu est associée soit à une cible (qui est équivalente à l’action associée à d’autres types de stratégies, telles que les stratégies de réécriture et de répondeur), soit à une option GotoPriorityExpression et à une option d’appel. En d’autres termes, pour une stratégie donnée dans une étiquette de stratégie de commutation de contenu, vous pouvez spécifier une cible ou définir l’option GotoPriorityExpression et l’option invoke. En outre, si plusieurs stratégies sont évaluées à true, seule la cible de la dernière stratégie évaluée à true est prise en compte.

Vous pouvez utiliser l’interface de ligne de commande Citrix ADC ou l’interface graphique graphique pour configurer les étiquettes de stratégie de commutation de contenu. Dans l’interface de ligne de commande Citrix ADC, vous créez d’abord une étiquette de stratégie à l’aide de la commande add cs policy label. Ensuite, vous liez des stratégies à l’étiquette de stratégie, une stratégie à la fois, à l’aide de la commande bind cs policy label. Dans l’interface graphique Citrix ADC, vous effectuez les deux tâches dans une seule boîte de dialogue.

Pour créer une étiquette de stratégie de commutation de contenu à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez :

add cs policylabel <labelName> <cspolicylabelTypetype>`
<!--NeedCopy-->

Exemple :

add cs policylabel testpollab http
<!--NeedCopy-->

Pour renommer une étiquette de stratégie de commutation de contenu à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez :

rename cs policylabel <labelName> <newName>`
<!--NeedCopy-->

Exemple :

rename cs policylabel oldPolicyLabelName newPolicyLabelName
<!--NeedCopy-->

Pour renommer une étiquette de stratégie de commutation de contenu à l’aide de l’interface graphique

Accédez à Gestion du trafic > Commutation de contenu > Étiquettesde stratégie, sélectionnez une étiquette de stratégie et, dans la liste Action, sélectionnez Renommer.

Pour lier une stratégie à une étiquette de stratégie de changement de contenu à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez les commandes suivantes pour lier une stratégie à une étiquette de stratégie et vérifier la configuration :

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

show cs policylabel <labelName>
<!--NeedCopy-->

Exemple :

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
<!--NeedCopy-->

Remarque

Si une stratégie est configurée avec une action, le serveur virtuel cible (TargetvServer), accédez à l’expression de priorité (GotoPriorityExpression) et invoke (invoke) paramètres ne sont pas requis. Si une stratégie n’est pas configurée avec une action, vous devez configurer au moins l’un des paramètres suivants : targetVserver, gotoPriorityExpression et invoke.

Pour dissocier une stratégie à partir d’une étiquette de stratégie à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez les commandes suivantes pour dissocier une stratégie d’une étiquette de stratégie et vérifier la configuration :

unbind cs policylabel <labelName> <policyName>

show cs policylabel <labelName>
<!--NeedCopy-->

Exemple :

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
<!--NeedCopy-->

Pour supprimer une étiquette de stratégie à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez :

rm cs policylabel <labelName>
<!--NeedCopy-->

Pour gérer une étiquette de stratégie de changement de contenu à l’aide de l’interface graphique

Accédez à Gestion du trafic > Commutation de contenu > Étiquettesde stratégie, configurez une étiquette de stratégie, liez des stratégies à l’étiquette et, éventuellement, spécifiez une priorité, une expression GotoPriority et une option d’appel.

Liaison de stratégies à un serveur virtuel de commutation de contenu

Après avoir créé votre serveur virtuel de commutation de contenu et les stratégies, vous liez chaque stratégie au serveur virtuel de commutation de contenu. Lorsque vous liez la stratégie au serveur virtuel de commutation de contenu, vous spécifiez le serveur virtuel d’équilibrage de charge cible.

Remarque

Si votre stratégie de commutation de contenu utilise une règle de syntaxe par défaut, vous pouvez configurer une action de commutation de contenu pour la stratégie. Si vous configurez une action, vous devez spécifier le serveur virtuel d’équilibrage de charge cible lorsque vous configurez l’action, et non lorsque vous liez la stratégie au serveur virtuel de commutation de contenu. Pour plus d’informations sur la configuration d’une action de commutation de contenu, consultez la section Configuration d’une action de commutation de contenu.

Pour lier une stratégie à un serveur virtuel de commutation de contenu et sélectionner un serveur virtuel d’équilibrage de charge cible à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez :

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

Exemple :

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
<!--NeedCopy-->

Remarque

Les paramètres, le serveur virtuel d’équilibrage de charge cible (TargeTvServer), aller à l’expression de priorité (GotoPriorityExpression) et la méthode invoke (invoke) ne peuvent pas être utilisés si une stratégie comporte une action.

Pour lier une stratégie à un serveur virtuel de commutation de contenu et sélectionner un serveur virtuel d’équilibrage de charge cible à l’aide de l’interface graphique

Accédez à Gestion du trafic > Commutation de contenu > Serveurs virtuels, ouvrez un serveur virtuel et, dans la section Liaison de stratégie de commutation de contenu, liez une stratégie au serveur virtuel et spécifiez un serveur virtuel d’équilibrage de charge cible.

Configuration de la journalisation basée sur des stratégies pour la commutation de contenu

Vous pouvez configurer la journalisation basée sur une stratégie pour une stratégie de changement de contenu. La journalisation basée sur des stratégies vous permet de spécifier un format pour les messages de journal. Le contenu du message de journal est défini à l’aide d’une expression de syntaxe par défaut dans la stratégie de commutation de contenu. Lorsque l’action de commutation de contenu spécifiée dans la stratégie est exécutée, l’appliance Citrix ADC construit le message journal à partir de l’expression et écrit le message dans le fichier journal. La journalisation basée sur des stratégies est particulièrement utile si vous souhaitez tester et dépanner une configuration dans laquelle les actions de commutation de contenu identifient le serveur virtuel d’équilibrage de charge cible lors de l’exécution.

Remarque

Si plusieurs stratégies liées à un serveur virtuel donné évaluent la valeur TRUE et sont configurées avec une action de message d’audit, l’appliance Citrix ADC n’exécute pas toutes les actions de message d’audit. Il effectue uniquement l’action de message d’audit configurée pour la stratégie dont l’action de commutation de contenu est effectuée.

Pour configurer la journalisation basée sur une stratégie pour une stratégie de changement de contenu, vous devez d’abord configurer une action de message d’audit. Pour plus d’informations sur la configuration d’une action de message d’audit, consultez Configuration de l’appliance Citrix ADC pour la journalisation des audits. Après avoir configuré l’action du message d’audit, vous spécifiez l’action dans une stratégie de changement de contenu.

Pour configurer la journalisation basée sur des stratégies pour une stratégie de changement de contenu à l’aide de l’interface de ligne de commande

Sur la ligne de commande, tapez les commandes suivantes pour configurer la journalisation basée sur une stratégie pour une stratégie de changement de contenu et vérifier la configuration :

set cs policy <policyName> -logAction <string>

show cs policy <policyName>
<!--NeedCopy-->

Exemple :

> 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
>
<!--NeedCopy-->

Pour configurer la journalisation basée sur des stratégies pour une stratégie de commutation de contenu à l’aide de l’interface graphique

Accédez à Gestion du trafic > Commutation de contenu > Stratégies, ouvrez une stratégie et, dans la liste Action de journal, sélectionnez une action de journal pour la stratégie.

Vérification de la configuration

Pour vérifier que votre configuration de commutation de contenu est correcte, vous devez afficher les entités de commutation de contenu. Pour vérifier le bon fonctionnement après le déploiement de votre configuration de commutation de contenu, vous pouvez afficher les statistiques générées lors de l’accès aux serveurs.

Affichage des propriétés des serveurs virtuels de commutation de contenu

Vous pouvez afficher les propriétés des serveurs virtuels de commutation de contenu que vous avez configurés sur l’appliance Citrix ADC. Vous pouvez utiliser ces informations pour vérifier si le serveur virtuel est correctement configuré et, si nécessaire, pour résoudre les problèmes. Outre les détails tels que le nom, l’adresse IP et le port, vous pouvez afficher les différentes stratégies liées à un serveur virtuel et ses paramètres de gestion du trafic.

Les stratégies de changement de contenu sont affichées dans l’ordre de leur priorité. Si plusieurs stratégies ont la même priorité, elles sont affichées dans l’ordre dans lequel elles sont liées au serveur virtuel.

Remarque

Si vous avez configuré le serveur virtuel de commutation de contenu pour transférer le trafic vers un serveur virtuel d’équilibrage de charge, vous pouvez également afficher les stratégies de commutation de contenu en affichant les propriétés du serveur virtuel d’équilibrage de charge.

Pour afficher les propriétés des serveurs virtuels de commutation de contenu à l’aide de l’interface de ligne de commande

Pour répertorier les propriétés de base de tous les serveurs virtuels de commutation de contenu de votre configuration, ou les propriétés détaillées d’un serveur virtuel de commutation de contenu spécifique, à l’invite de commandes, tapez l’une des commandes suivantes :

show cs vserver

show cs vserver <name>
<!--NeedCopy-->

Exemple 

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
…
<!--NeedCopy-->

Affichage des stratégies de changement de contenu

Vous pouvez afficher les propriétés des stratégies de commutation de contenu que vous avez définies, telles que le nom, le domaine et l’URL ou l’expression, et utiliser les informations pour trouver des erreurs dans la configuration, ou pour résoudre les problèmes si quelque chose ne fonctionne pas comme il se doit.

Pour afficher les propriétés des stratégies de commutation de contenu à l’aide de l’interface de ligne de commande

Pour répertorier les propriétés de base de toutes les stratégies de commutation de contenu dans votre configuration ou les propriétés détaillées d’une stratégie de commutation de contenu spécifique, tapez l’une des commandes suivantes à l’invite de commandes :

show cs policy

show cs policy <PolicyName>
<!--NeedCopy-->

Exemple :

show cs policy

show cs policy Policy-CS-1
<!--NeedCopy-->

Pour afficher les propriétés des stratégies de changement de contenu à l’aide de l’interface graphique

Accédez à Gestion du trafic > Commutation de contenu > Stratégies, sélectionnez une stratégie et, dans la liste Action, sélectionnez Afficher les liaisons .

Affichage d’une configuration de serveur virtuel de commutation de contenu à l’aide du visualiseur

Le Visualizer de commutation de contenu est un outil que vous pouvez utiliser pour afficher une configuration de commutation de contenu au format graphique. Vous pouvez utiliser le visualiseur pour afficher les éléments de configuration suivants :

  • Récapitulatif des serveurs virtuels d’équilibrage de charge auxquels le serveur virtuel de commutation de contenu est lié.
  • Tous les services et groupes de services liés au serveur virtuel d’équilibrage de charge et tous les moniteurs liés aux services.
  • Les détails de configuration de tout élément affiché.
  • Toute stratégie liée au serveur virtuel de commutation de contenu. Ces stratégies ne doivent pas nécessairement être des stratégies de changement de contenu. De nombreux types de stratégies, telles que les stratégies de réécriture, peuvent être liés à un serveur virtuel de commutation de contenu.

Après avoir configuré les différents éléments d’une configuration de commutation de contenu et d’équilibrage de charge, vous pouvez exporter l’intégralité de la configuration vers un fichier de modèle d’application.

Remarque

Le Visualizer nécessite une interface graphique, il n’est donc disponible que via l’interface graphique.

Pour afficher une configuration de commutation de contenu à l’aide du Visualizer dans l’interface graphique

  1. Accédez à Gestion du trafic > Commutation de contenu > Serveurs virtuels.
  2. Dans le volet d’informations, sélectionnez le serveur virtuel que vous souhaitez afficher, puis cliquez sur Visualiseur.
  3. Dans la fenêtre Visualiseur de commutation de contenu, vous pouvez ajuster la zone d’affichage comme suit :
    • Cliquez sur les icônes Zoomavant et Zoom arrière pour augmenter ou diminuer la zone d’affichage.
    • Cliquez sur l’icône Enregistrer l’image pour enregistrer le graphique en tant que fichier image.
    • Dans le champ Rechercher dans le texte, commencez à taper le nom de l’élément que vous recherchez. Lorsque vous avez saisi suffisamment de caractères pour identifier l’élément, son emplacement est mis en surbrillance. Pour restreindre la recherche, cliquez sur le menu déroulant et sélectionnez le type d’élément à rechercher.
  4. Pour afficher les détails de configuration des entités liées à ce serveur virtuel, vous pouvez effectuer les opérations suivantes :
    • Pour afficher les stratégies liées au serveur virtuel, dans la barre d’outils située en haut de la boîte de dialogue, sélectionnez une ou plusieurs icônes de stratégie spécifiques aux fonctionnalités. Si les étiquettes de stratégie sont configurées, elles apparaissent dans la zone d’affichage principal.
    • Pour afficher les détails de configuration d’un service ou d’un groupe de services lié, cliquez sur l’icône du service, cliquez sur l’onglet Tâches associées, puis cliquez sur Afficher les services membres.
    • Pour afficher les détails de configuration d’un moniteur, cliquez sur l’icône correspondant au moniteur, cliquez sur l’onglet Tâches associées, puis cliquez sur Afficher le moniteur .
  5. Pour afficher des statistiques détaillées pour n’importe quel serveur virtuel dans la configuration de commutation de contenu, cliquez sur le serveur virtuel pour lequel vous souhaitez afficher les statistiques, puis cliquez sur l’onglet Tâches associées, puis sur Statistiques.
  6. Pour afficher une liste comparative des paramètres dont les valeurs diffèrent ou ne sont pas définies entre les conteneurs de service pour un serveur virtuel d’équilibrage de charge, cliquez sur l’icône d’un conteneur, cliquez sur l’onglet Tâches associées, puis cliquez sur Diff des attributs de service.
  7. Pour afficher les détails de liaison du moniteur pour les services d’un conteneur, dans la boîte de dialogue Diff des attributs de service, dans la colonne Groupe du conteneur, cliquez sur Détails. Cette liste comparative vous aide à déterminer quel conteneur de service a la configuration que vous souhaitez appliquer à tous les conteneurs de service.
  8. Pour afficher le nombre de demandes reçues par seconde à un moment donné par les serveurs virtuels dans la configuration et le nombre de sélection par seconde à un moment donné dans le temps pour les stratégies de réécriture, de répondeur et de cache, cliquez sur Afficher les statistiques. Les informations statistiques sont affichées sur les nœuds respectifs dans le Visualizer. Ces informations ne sont pas mises à jour en temps réel. Il est actualisé manuellement. Pour actualiser les informations, cliquez sur Actualiser les statistiques.

    Remarque

    Cette option est disponible uniquement sur les versions Citrix ADC nCore.

  9. Pour copier les détails de configuration d’un élément dans un document ou une feuille de calcul, cliquez sur l’icône correspondant à cet élément, cliquez sur Tâches associées, cliquez sur Copier les propriétés, puis collez les informations dans un document.
  10. Pour exporter l’intégralité de la configuration affichée dans le Visualizer vers un fichier de modèle d’application, cliquez sur l’icône du serveur virtuel de commutation de contenu, cliquez sur Tâches associées, puis sur Créer un modèle. Lors de la création du modèle d’application, vous pouvez configurer des variables dans certaines expressions de stratégie et actions. Pour plus d’informations sur la création du fichier de modèle d’application et la configuration des variables pour un modèle, consultez AppExpert.
Configuration de la commutation de contenu de base
October 4, 2021
Contributeur: 
C
October 4, 2021
Contributeur: 
C

Dans cet article

Commentaires sur le site | Confidentialité et conditions légales | Préférences de cookies | Paramètres de consentement
© 1999- Cloud Software Group, Inc. All rights reserved.