Tool zur Überprüfung der Vorkonfiguration

August 15, 2023

Beitrag von:

Hinweis:

Sie können das NSPEPI- und das Preconfig-Check-Tool vom öffentlichen GitHub herunterladen. Weitere Informationen finden Sie auf GitHub NEPEPI Seite und GitHub Preconfig Seite für detaillierte Anweisungen zum Herunterladen der Tools. Wir empfehlen Kunden, die in GitHub verfügbaren Tools für die vollständigste und aktuellste Version zu verwenden.

In den Versionen NetScaler 12.1, 13.0 und 13.1 ist ein Vorvalidierungstool verfügbar, mit dem überprüft werden kann, ob in einer Feature-Konfiguration noch ungültige oder entfernte Funktionen verwendet werden. Die Tools validieren die Datei nsconfig, wenn sie Befehle oder Parameter in einem Befehl enthält, der in der NetScaler 13.1 Version entfernt wurde. Wenn das Validierungsergebnis die Verwendung entfernter oder ungültiger Befehle anzeigt, müssen Sie vor dem Upgrade Ihrer Appliance zuerst die Konfiguration auf die von Citrix empfohlene Alternative ändern.

Das Tool validiert auch die Verwendung von klassischen Richtlinienausdrücken, die in der Featurekonfiguration verwendet werden, die Classic-Richtlinien nicht unterstützen. Sie können entweder manuell ändern oder das Tool nspepi verwenden.

Das Tool validiert die folgende Verwendung:

Klassische Richtlinienausdrücke in den Funktionen Content Switching, Cache-Umleitung, AppFW, SSL und CMP.
Filterfunktion (auch Content-Filter genannt) - Aktionen, Richtlinien und Bindung
SPDY im HTTP-Profil, sichere Verbindung (SC), Priority Queuing (PQ), HTTP Denial of Service (DoS) und HTML Injection Funktionen.
Klassische Ausdrücke in Persistenzregeln für den Lastausgleich.
Parameter “Pattern” und “bypassSafetyCheck” in Rewrite-Aktionen.
“patclass” -Konfigurationseinheit.
“HTTP.REQ.BODY” ohne Argument in erweiterten Ausdrücken.
Q- und S-Präfixe in erweiterten Ausdrücken.
Parameter “PolicyType” für die cmp-Parametereinstellung.

Führen Sie das Tool vor der erneuten Überprüfung in UNIX Shell aus

Geben Sie an der Eingabeaufforderung Folgendes ein:


check_invalid_config <config_file>

Beispiel:

root@ns# check_invalid_config/nsconfig/ns.conf

Wo ist die Konfigurationsdatei die NetScaler-Konfigurationsdatei. Die Datei muss aus einer gespeicherten Konfiguration wie ns.conf sein.

Beispielausgabe mit Validierungsfehlern

Es folgt eine Beispielausgabe der Konfigurationsdatei mit Fehlern in NetScaler Version 13.1:

add cmp policy cmp_pol -rule ns_true -resAction GZIP
add cs policy cs_pol_2 -rule ns_true
add cs policy cs_pol_3 -domain www.abc.com
add cs policy cs_pol_4 -url "/abc"
add rewrite action act_1 replace_all "http.req.body(1000)" http.req.url -pattern abcd
add rewrite action act_123 replace_all http.req.url ""aaaa"" -pattern abcd
add responder action ract respondwith "Q.URL + Q.HEADER("abcd")"
add appfw policy aff_pol_1 "http.req.body.length.gt(10)" APPFW_BYPASS
add appfw policy aff_pol ns_true APPFW_BYPASS

 

Wenn Sie diese Fehler erhalten haben, können Sie das Upgradetool nspepi verwenden, um Ihre Konfiguration zu konvertieren oder Ihre Konfiguration manuell zu konvertieren. Weitere Informationen finden Sie im Thema nspepi tool .

Hinweis:

Sie können das Tool nspepi nur auf NetScaler Version 12.1, 13.0 und höher ausführen.

Beispielausgabe ohne Validierungsfehler

Es folgt eine Beispielausgabe der Konfigurationsdatei ohne entfernte oder ungültige Konfiguration:

root@ns# check_invalid_config /var/tmp/new_ns.conf  
No issue detected with the configuration.
root@ns#
 

Die offizielle Version dieses Inhalts ist auf Englisch. Für den einfachen Einstieg wird Teil des Inhalts der Cloud Software Group Dokumentation maschinell übersetzt. Cloud Software Group hat keine Kontrolle über maschinell übersetzte Inhalte, die Fehler, Ungenauigkeiten oder eine ungeeignete Sprache enthalten können. Es wird keine Garantie, weder ausdrücklich noch stillschweigend, für die Genauigkeit, Zuverlässigkeit, Eignung oder Richtigkeit von Übersetzungen aus dem englischen Original in eine andere Sprache oder für die Konformität Ihres Cloud Software Group Produkts oder Ihres Diensts mit maschinell übersetzten Inhalten gegeben, und jegliche Garantie, die im Rahmen der anwendbaren Endbenutzer-Lizenzvereinbarung oder der Vertragsbedingungen oder einer anderen Vereinbarung mit Cloud Software Group gegeben wird, dass das Produkt oder den Dienst mit der Dokumentation übereinstimmt, gilt nicht in dem Umfang, in dem diese Dokumentation maschinell übersetzt wurde. Cloud Software Group kann nicht für Schäden oder Probleme verantwortlich gemacht werden, die durch die Verwendung maschinell übersetzter Inhalte entstehen können.

NetScaler Secure Deployment Guide

Tool zur Überprüfung der Vorkonfiguration

August 15, 2023

Beitrag von:

In diesem Artikel

NetScaler Secure Deployment Guide