Konfigurieren von SureConnect

In den folgenden Themen wird beschrieben, wie Sie SureConnect für Szenarien konfigurieren, bei denen ein alternativer Serverausfall auftritt.

Konfigurieren der Antwort für einen alternativen Serverausfall

Wenn der alternative Server ausfällt und der primäre Server den angeforderten Inhalt nicht sofort an den Client liefern kann, zeigt SureConnect keinen alternativen Inhalt vom ausgefallenen alternativen Server im Client-Webbrowser an.

Die Citrix ADC Appliance sendet automatisch eine Antwort an den Clientbrowser. Sie können die Serverantwort so anpassen, dass Informationen angezeigt werden, die Ihren Anforderungen entsprechen.

Die Standardantwort lautet:

Ihre Anfrage wird bearbeitet… Geschätzte Zeit: __ Sekunden

Anpassen der Standardantwort

Die Citrix ADC Appliance sendet die Antwort automatisch an den Client, wenn der alternative Server ausfällt oder wenn die Appliance so konfiguriert ist, dass die Standardantwort gesendet wird.

Um die Standardantwort der Appliance anzupassen, erstellen Sie eine vsr.htm Datei (ein Beispiel wird in diesem Abschnitt bereitgestellt) wie folgt:

  • Die Datei kann alle gültigen HTML-Anweisungen außer eingebetteten Objekten enthalten.
  • Die Dateigröße darf 800 Byte nicht überschreiten.
  • Die Datei muss sich auf der Citrix ADC Appliance befinden. Wenn Sie über ein Hochverfügbarkeit-Setup (HA) verfügen, muss sich die Datei auf dem primären und sekundären Knoten befinden. Alle Änderungen an der Datei auf dem primären Knoten müssen auch auf die Datei auf dem sekundären Knoten angewendet werden.
  • Legen Sie die Datei vsr.htm in das Verzeichnis /etc ein.

So passen Sie die Standardantwort an

Ändern Sie einen beliebigen Inhalt zwischen den</HEAD> Tags</HTML> und in der Datei vsr.htm. Im Folgenden finden Sie den Beispielinhalt aus vsr.htm Datei. Die Abschnitte, die Sie bearbeiten können, sind fett formatiert.

HTTP/1.1 200 OK
Server: NS_WS3.0
Content-Type: text/html
Cache-control: no-cache
Pragma: no-cache
Set-Cookie: NSC_BPIP=@@SID@@; path=/
<HTML> <HEAD> <META HTTP-EQUIV="Refresh" CONTENT="0">
</HEAD> <font color=blue size=5>Your request is being processed...
<br>Estimated Delay: @@DELAY@@ Sec </font> </HTML>

Hinweis: Fügen Sie @ @DELAY @@ ein, um die prognostizierte verzögerte Antwortzeit in Sekunden anzuzeigen.

SureConnect mit In-Memory-Antwort (NS-Aktion)

Wenn Sie die SureConnect Richtlinie mithilfe des Befehls add sc policy definieren, können Sie die Citrix ADC Appliance so konfigurieren, dass dem Client alternative Inhalte bereitgestellt werden.

Führen Sie die folgenden Aufgaben aus, um SureConnect zu aktivieren und die In-Memory-Antwort zu konfigurieren:

  • Aktivieren Sie die SureConnect Funktion auf der Appliance mithilfe des Befehls enable feature SC
  • Definieren Sie die Dienste mithilfe desadd service <servicename> <IP address> <servicetype> <port> Befehls. Dies identifiziert den ursprünglichen Server, für den der SureConnect konfiguriert ist, und die Arten von Diensten.
  • Fügen Sie mithilfe des Befehls add sc policy eine SureConnect Richtlinie hinzu. Sie können eine URL-basierte Richtlinie oder eine regelbasierte Richtlinie konfigurieren. Die eingehenden Anforderungen werden anhand der URL oder Regel überprüft, die Sie in der Richtlinie angeben.

Hinweis: Sie können die SureConnect Funktion auf einem virtuellen Lastausgleichsserver konfigurieren. Führen Sie in diesem Fall die folgenden zusätzlichen Aktionen aus:

  • Aktivieren Sie den Lastenausgleich mithilfe des Befehls enable feature LB.
  • Aktivieren Sie die SureConnect Funktion auf dem virtuellen Server mithilfe desset lb vserver <vservername> -sc ON Befehls.
  • Binden Sie Dienste mit dembind lb vserver <name> <serviceName> Befehl an den virtuellen Server.
  • Binden Sie Richtlinien mit dembind lb vserver <name> -policyname <name> Befehl an den virtuellen Server.

Das folgende Beispiel veranschaulicht, wie Sie SureConnect für die Lastausgleichsfunktion so konfigurieren, dass SureConnect alternative Inhalte von der Citrix ADC Appliance anzeigt.

In diesem Beispiel werden zwei physische Server mit IP-Adressen 10.101.3.187 und 10.101.3.188 von der Citrix ADC Appliance Lastausgleich. Die Appliance verfügt über einen konfigurierten virtuellen Server, VS-NSact, dessen IP-Adresse 10.101.3.201 ist. Die Datei, die den alternativen Inhalt enthält, ist vsr.htm. Es wird aus dem Dateisystem in den Systemspeicher kopiert. Dienste werden geladen, bis die SureConnect Richtlinie ausgelöst wird und die Appliance den alternativen Inhalt bereitstellt.

enable feature SC LB
add service psvc1 10.101.3.187 http 80
add service psvc2 10.101.3.188 http 80
add lb vserver vs-NSact HTTP 10.101.3.201 80
bind lb vserver vs-NSact psvc1
bind lb vserver vs-NSact psvc2
add sc policy policyNS -url /cgi-bin/*.cgi -delay 400000
-action NS
set sc parameter -vsr /nsconfig/ssl/vsr.htm
bind lb vserver vs-NSact -policyName policyNS
set lb vserver vs-NSact -sc ON
save config

Tabelle 1. In diesem Beispiel verwendete Parameterwerte

   
Service  
Name psvc1, psvc2
Server 10.101.3.187, 10.101.3.188
Protokoll HTTP
Port 80
Virtueller Server mit Lastenausgleich  
Name VS-NSact
IP-Adresse 10.101.3.201
Protokoll HTTP
Port 80
SureConnect Richtlinie  
Name policyNS
URL /cgi-bin/*.cgi
Verzögerung (Mikrosekunden) 400000
SC-Parameter  
VSR-Dateiname vsr.htm

So konfigurieren Sie dieses Beispiel mithilfe der GUI

  1. Navigieren Sie im Navigationsbereich zu System > Einstellungen. Führen Sie im Bereich Modi und Features die folgenden Aktionen aus:
    1. Klicken Sie auf Grundfunktionen konfigurieren, wählen Sie Lastenausgleich aus, und klicken Sie auf Los.
    2. Klicken Sie auf Erweiterte Funktionen konfigurieren, wählen Sie SureConnect aus, und klicken Sie auf Los.
  2. Navigieren Sie im Navigationsbereich zu Sicherheit > Schutzfunktionen > SureConnect. Klicken Sie im Detailbereich auf Parameter. Suchen Sie im Fenster SureConnect Parameter konfigurieren den VSR-Dateinamen und wählen Sie ihn aus.
  3. Navigieren Sie zu Traffic Management > Load Balancing > Services. Klicken Sie im Detailbereich auf “Hinzufügen”. Geben Sie im Fenster Dienste erstellen die Parameterwerte ein, wie in Tabelle 5-1 dargestellt, und klicken Sie auf OK.
  4. Navigieren Sie zu Traffic Management > Load Balancing > Virtuelle Server. Klicken Sie im Detailbereich auf “Hinzufügen”. Geben Sie im Dialogfeld Virtuellen Server erstellen (Load Balancing) die Werte in Tabelle 5.1 für die Parameter für den Lastenausgleich des virtuellen Servers ein, und klicken Sie auf OK.
  5. Navigieren Sie im Navigationsbereich zu Traffic Management > Load Balancing > Virtuelle Server. Wählen Sie den virtuellen Server VS-NSact aus, und klicken Sie im Detailbereich auf Öffnen. Im Dialogfeld Virtuelles System konfigurieren (Load Balancing) wird die Liste der konfigurierten Dienste angezeigt. Wählen Sie Dienste psvc1 und psvc2 aus und klicken Sie auf OK.
  6. Erweitern Sie im Navigationsbereich Sicherheit > Schutzfunktionen > SureConnect. Klicken Sie im Detailbereich auf “Hinzufügen”. Erstellen Sie die Richtlinie mit den Werten, wie in der Parametertabelle angegeben.
  7. Navigieren Sie im Navigationsbereich zu Traffic Management > Load Balancing > Virtuelle Server. Wählen Sie den virtuellen Server VS-NSact aus, und klicken Sie im Detailbereich auf Öffnen. Klicken Sie im Dialogfeld Virtuelles System konfigurieren (Lastenausgleich) auf die Registerkarte Richtlinien. Klicken Sie auf », um die Features zu erweitern. Wählen Sie SureConnect aus. Wenn die Liste der SureConnect Polices angezeigt wird, wählen Sie PolicyNs aus, und klicken Sie auf OK.
  8. Navigieren Sie im Navigationsbereich zu Traffic Management > Load Balancing > Virtuelle Server. Wählen Sie den virtuellen Server VS-NSact aus, und klicken Sie im Detailbereich auf Öffnen. Wählen Sie im Dialogfeld Virtuelles System konfigurieren (Load Balancing) auf der Registerkarte Erweitert die Option SC aus, und klicken Sie auf OK.

Konfigurieren der SureConnect Richtlinien

Sie können die folgenden SureConnect Richtlinien konfigurieren. Die Citrix ADC Appliance entspricht eingehenden Anforderungen in der Reihenfolge, in der die Richtlinien konfiguriert sind:

  • Exakte URL-basierte Richtlinien
  • Platzhalterregelbasierte Richtlinien

Konfigurieren exakter URL-basierter Richtlinien

Wenn Sie eine genaue URL-basierte Richtlinie konfigurieren, gleicht die Citrix ADC Appliance die eingehende Anforderung mit der in der Richtlinie konfigurierten URL ab. URL-basierte Richtlinien haben Vorrang vor regelbasierten Richtlinien.

Konfigurieren einer exakten URL-basierten Richtlinie mithilfe der CLI

Geben Sie an der Eingabeaufforderung Folgendes ein:

add sc policy <name> [-url <URL> | -rule <expression>] [ -delay <usecs>] [ -maxConn <positive_integer>] [ -action (ACS <altContentSvcName> <altContentPath>) | NS | NOACTION)]

Konfigurieren einer exakten URL-basierten Richtlinie mithilfe der GUI

  1. Navigieren Sie zu Sicherheit > Schutzfunktionen > SureConnect.
  2. Klicken Sie im Detailbereich auf “Hinzufügen”.
  3. Legen Sie im Dialogfeld SureConnect Richtlinie erstellen die folgenden Parameter fest:
    • Name*
    • URL (Stellen Sie sicher, dass das Kontrollkästchen URL aktiviert ist)
    • Wert*
    • Verzögerung (Mikrosekunden) *
    • Maximale Clientverbindungen
    • Aktion (Wählen Sie aus der Liste Aktion auswählen.)
    • Alternativer Dienstname (wenn Sie ACS als Aktion auswählen)
    • Alternativer Inhaltspfad (wenn Sie ACS als Aktion auswählen) *Ein erforderlicher Parameter
  4. Klicken Sie auf Erstellen, und klicken Sie auf Schließen. Die URL-basierte Richtlinie wird im rechten Fensterbereich angezeigt, und in der Statusleiste wird eine Meldung angezeigt, dass die Richtlinie erfolgreich konfiguriert wurde.

Konfigurieren von Regeln für Platzhalterregeln

SureConnect ordnet die eingehenden Anforderungen mit einer definierten Regel ab, wenn Sie eine regelbasierte Richtlinie konfigurieren.

Konfigurieren einer SureConnect Richtlinie basierend auf einer Platzhalterregel mithilfe der CLI

  1. Erstellen Sie die Ausdrücke.

    Verwenden Sie den Befehl add expression, um jeden Ausdruck zu erstellen.

  2. Erstellen Sie die Regel (n).

    Verwenden Sie den Befehl add sc policy mit dem Argument -rule expression_logic, um die Regel (en) anzugeben. Verweisen Sie im Argument -rule expression_logic auf die Ausdrücke, die Sie in Schritt 1 erstellt haben.

    Wiederholen Sie diesen Befehl, um jede Regel zu erstellen und zu benennen.

Im folgenden Beispiel wird eine Regel “rule = /*.cgi” erstellt:

add vserver vs-lb http 1.1.1.1 80
add expression expr1 url == /cgi-bin/*.cgi
add expression expr2 url == /index.html
add sc policy surecpolicy1 -rule (expr1||expr2) -delay 1000000 -action NS
bind lb vserver vs-lb -policyName surecpolicy1

Um die SureConnect Konfiguration abzuschließen, müssen Sie zusätzliche Befehle eingeben, die über die im Beispiel angezeigten Befehle hinausgehen.

Konfigurieren einer Platzhalterregelbasierten Richtlinie mithilfe der GUI

  1. Navigieren Sie zu Sicherheit > Schutzfunktionen > SureConnect.
  2. Klicken Sie im Detailbereich auf “Hinzufügen”.
  3. Geben Sie im Dialogfeld SureConnect t-Richtlinie erstellen im Textfeld Name den Namen der Richtlinie ein.
  4. Klicken Sie unter Zu überwachende Überwachung auf Ausdruck, und klicken Sie dann auf Konfigurieren.
  5. Klicken Sie im Dialogfeld Ausdruck erstellen auf Hinzufügen.
  6. Geben Sie im Dialogfeld Ausdruck hinzufügen einen Ausdruck ein. Sie können z. B. einen Ausdruckstyp von Allgemein, einen Flow Type von REQ, ein Protokoll von HTTP, einen Qualifier von URLQUERY, einen Operator von CONTAINS auswählen und im Textfeld Wert AA eingeben. Weitere Hinweise zu Ausdrücken finden Sie unterRichtlinien und Ausdrücke.
  7. Klicken Sie auf OK, und klicken Sie auf Schließen.
  8. Klicken Sie im Dialogfeld Ausdruck erstellen auf Erstellen.

Beispiele für Platzhalterregeln:

“/sports/*” entspricht allen URLs unter /sports

“/sports*” entspricht allen URLs, deren Präfix mit “/sports” übereinstimmt, beginnend am Anfang der URL.

”/*.jsp” entspricht allen URLs, deren Dateierweiterung “jsp” ist

Wenn Sie regelbasierte Richtlinien konfigurieren, fügen Sie zuerst die spezifischeren regelbasierten Richtlinien hinzu, bevor Sie weitere generische Regeln hinzufügen (z. B. /cgi-bin/sports *.cgi hinzufügen, bevor Sie /cgi-bin/ *.cgi hinzufügen).

Anzeigen der konfigurierten SureConnect Richtlinie

Geben Sie an der Citrix ADC Eingabeaufforderung den Befehl show sc policy ein, um die von Ihnen konfigurierte SureConnect t-Richtlinie anzuzeigen.

Anpassen der alternativen Inhaltsdatei

Wenn SureConnect aktiviert wird, kann es alternative Inhalte aus einer der folgenden Dateien anzeigen, die Sie konfiguriert haben:

  • progressbar.htm. Zeigt die Fortschrittsinformationen an.
  • alternatepage.htm. Zeigt eine alternative Seite an.
  • barandpage.htm. Zeigt sowohl die Fortschrittsinformationen als auch eine alternative Seite an.

Die alternativen Inhaltsdateien sind JavaScript-Dateien. Während der Installation von SureConnect werden diese Dateien auf den Server kopiert, der den alternativen Inhalt enthält. Diese Dateien können alternativen Inhalt (einschließlich einer alternativen Seite) oder Verweise auf andere Dateien enthalten, die den alternativen Inhalt enthalten.

In diesem Abschnitt werden die Änderungen beschrieben, die Sie an der von der Appliance bereitgestellten alternativen Inhaltsdatei vornehmen können.

//**** DEFINE YOUR VALUES HERE ****
var alt_url = "/netscaler system /sample.gif";
var alt_url = "http://www.DomainName.com";
var netscaler system _logo = "netscaler_logo.gif";
var our_logo = "netscaler_logo.gif";
var height = 450;
var width = 550;
var top = 200;
var left = 200;
var popunder = "no"; //specify yes for pop-under & no for pop-up
var shift_focus = "yes" //if you want to send pop-up to background on getting primary content else specify no
//**** YOUR DEFINITIONS ENDS HERE ****

Sie können diese Änderungen vornehmen:

  • var alt_url. Geben Sie die URL für den alternativen Inhalt an, wenn eine Datei den alternativen Inhalt bereitstellt. Zum Beispiel:

     var alt_url = "/netscaler system/sports.htm"
    

    Hinweis: Die alternative Inhaltsdatei muss im Systemverzeichnis /netscaler unter dem Dokumentenstamm des Webservers vorhanden sein.

  • var our_logo. Geben Sie die Bilddatei Ihres Unternehmenslogos an.

  • var height. Geben Sie die Höhe des SureConnect-Fensters an.

  • var width. Geben Sie die Breite des SureConnect-Fensters an.

  • var top and var left. Geben Sie die Position des SureConnect-Fensters an.

  • var popunder. Gibt die Position des alternativen Inhaltsfensters an. Geben Sie den Wert als NO an, um das alternative Inhaltsfenster über dem ursprünglichen Fenster zu platzieren. Geben Sie den Wert als JA an, um das alternative Inhaltsfenster unterhalb des ursprünglichen Fensters zu platzieren.

  • var shift_focus. Geben Sie den Fokus des alternativen Inhaltsfensters an. JA platziert das Popup-Fenster beim Abrufen des primären Inhalts im Hintergrund. NEIN hält das Popup-Fenster immer im Fokus, auch wenn der primäre Inhalt abzurufen ist.

Hinweis: Weitere Informationen finden Sie in der Datei Readme.txt, die von der Appliance mit anderen alternativen Inhaltsdateien bereitgestellt wird.

Konfigurieren von SureConnect für Citrix ADC Funktionen

In diesem Abschnitt wird beschrieben, wie SureConnect in Kombination mit Lastenausgleich, Content-Switching, Cache-Umleitung und Hochverfügbarkeitsfunktionen der Citrix ADC Appliance funktioniert.

Konfigurieren von SureConnect für den Lastausgleich

Sie können SureConnect in Umgebungen verwenden, in denen die primären Server die Lastausgleichsfunktion verwenden, mit oder ohne alternative Server. Wenn der für SureConnect konfigurierte virtuelle Lastausgleichsserver fehlschlägt, verarbeitet der virtuelle Sicherungsserver (falls vorhanden) den Datenverkehr. Sichern virtueller Server unterstützen keine SureConnect Richtlinien.

Hinweis: Hinweise zum Lastenausgleich finden Sie unter Lastausgleich.

Konfigurieren von SureConnect für die Cache-Umleitung

Sie können SureConnect in Umgebungen verwenden, in denen die Cache-Umleitung konfiguriert ist. Der primäre Server ist ein virtueller Lastausgleichsserver, der an den virtuellen Cache-Umleitungsserver gebunden ist. Unabhängig von den für die Cache-Umleitungsfunktion konfigurierten Regeln:

  • Sie können eine beliebige URL für SureConnect konfigurieren.
  • Sobald SureConnect für einen Client aktiviert ist, werden Anfragen vom Client immer an den Ursprungsserver gesendet.

Konfigurieren von SureConnect für hohe Verfügbarkeit

SureConnect ist mit Citrix ADC Appliances kompatibel, die im Hochverfügbarkeitsmodus arbeiten.

Hinweis: Wenn die optionale Datei vsr.htm verwendet wird, muss sie in beiden Knoten (primär und sekundär) vorhanden sein und denselben Namen und dasselbe Verzeichnis verwenden.