Erstellen eines StyleBooks zum Hochladen von Dateien
Mit NetScaler Console StyleBooks können Sie NetScaler-Konfigurationen erstellen, die unter anderem das Hochladen von Dateien beliebigen Typs von Ihrem lokalen Dateisystem auf die NetScaler-Instanz über die NetScaler Console GUI oder die APIs umfassen können. Diese Dateien können beispielsweise Zertifikatsdateien oder Geolocation-Dateien sein. Sie können auch das Verzeichnis angeben, in das diese Dateien hochgeladen werden sollen.
StyleBook-Konfiguration
Das Folgende ist ein Beispiel-StyleBook, das beschreibt, wie eine Geolocation-Datei auf die NetScaler-Instanz hochgeladen wird. Die Geodateien werden typischerweise in GSLB-Konfigurationen zur Definition der statischen Proximity basierend auf dem geografischen Standort verwendet:
Erstellen Sie Ihr StyleBook – 1
name: upload-geolocations
namespace: com.citrix.adc.stylebooks.samples
version: "1.0"
display-name: GeoLocation File Upload
description: This StyleBook is used to upload a geolocation file to NetScaler
schema-version: "1.0"
import-stylebooks:
-
namespace: netscaler.nitro.config
version: "11.1"
prefix: ns
parameters:
-
name: locationfile
label: Location File
description: The system file path of the geolocation file on NetScaler Console
type: file
required: true
components:
-
name: upload-file-comp
type: ns::systemfile
properties:
filename: $parameters.locationfile.filename
filelocation: "/var/netscaler/inbuilt_db/"
filecontent: base64.encode($parameters.locationfile.contents)
Hinweis
Der in diesem Beispiel verwendete Parameter ist vom Typ Datei. Sie können dieses StyleBook in NetScaler Console importieren und zum Hochladen von Geolocation-Dateien verwenden.
Dieses StyleBook erfordert, dass die Datei bereits in NetScaler Console vorhanden ist (Sie hätten sie beispielsweise bereits mit einem Dienstprogramm wie SCP in NetScaler Console kopiert). Wenn Sie eine Datei über NetScaler Console auf NetScaler hochladen möchten, ohne sie zuerst in das NetScaler Console-Dateisystem zu kopieren, können Sie ein StyleBook erstellen, das zwei „String“-Parameter enthält: einen zum Angeben des auf dem NetScaler zu verwendenden Dateinamens und den anderen zum Angeben des Dateiinhaltes, und diese beiden Parameter in den upload-file-comp-Komponenten verwenden. Das Folgende ist ein alternatives StyleBook zum Hochladen einer Geolocation-Datei:
Erstellen Sie Ihr StyleBook – 2
name: upload-geolocations-alt
namespace: com.citrix.adc.stylebooks.samples
version: "1.0"
display-name: GeoLocation File Upload
description: This StyleBook is used to upload a geolocation file to NetScaler
schema-version: "1.0"
import-stylebooks:
-
namespace: netscaler.nitro.config
version: "11.1"
prefix: ns
parameters:
-
name: filename
label: Location Filename
description: The name of the location file on the NetScaler
type: string
required: true
-
name: filecontents
label: Location File Contents
description: The contents of the location file
type: string
required: true
components:
-
name: upload-file-comp
type: ns::systemfile
properties:
filename: $parameters.filename
filelocation: "/var/NetScaler/inbuilt_db/"
filecontent: base64.encode($parameters.filecontents)
Erstellen von Konfigurationen zum Hochladen von Dateien
Das folgende Verfahren erstellt eine Konfiguration auf einer ausgewählten NetScaler-Instanz, die eine Geolocation-Datei mit dem oben beschriebenen ersten StyleBook hochlädt.
So erstellen Sie eine Konfiguration zum Hochladen von Dateien:
-
Navigieren Sie in NetScaler Console zu Applications > Configuration, und klicken Sie auf Create New. Die Seite „Choose StyleBook“ zeigt alle StyleBooks an, die in Ihrer NetScaler Console verfügbar sind. Scrollen Sie nach unten und wählen Sie das importierte StyleBook aus.Die StyleBook-Parameter werden als Benutzeroberflächenseite angezeigt, auf der Sie die Werte für alle in diesem StyleBook definierten Parameter eingeben können.
-
Geben Sie den Namen des Load Balancers und die virtuelle IP-Adresse im Abschnitt „Basic Load Balancer Settings“ ein.
-
Geben Sie im Abschnitt Location File den Namen oder den Speicherort der Datei ein.HinweisStellen Sie sicher, dass sich die Datei in der NetScaler Console nur im Ordner des aktuellen Mandanten befindet. Verwenden Sie einen beliebigen FTP-Client, um die Datei in das NetScaler Console-Dateisystem zu kopieren.
-
Möglicherweise werden Sie aufgefordert, Ihre Benutzeranmeldeinformationen anzugeben, bevor Sie auf die Zielinstanzen zugreifen.
-
Wählen Sie die NetScaler-Zielinstanz aus, auf der die Konfiguration erstellt werden soll, und klicken Sie auf Erstellen.
Hinweis
Citrix empfiehlt, Testlauf auszuwählen, um die Konfigurationsobjekte zu überprüfen, die auf der Zielinstanz erstellt werden, bevor Sie die eigentliche Konfiguration auf der Instanz ausführen.
Wenn die Erstellung des Konfigurationspakets erfolgreich ist, wird die Datei im Dateisystem der NetScaler-Instanz unter dem Speicherort /var/netscaler/inbuilt_db/ gespeichert.
Hinweis
Sie können auch auf das Aktualisierungssymbol klicken, um kürzlich entdeckte NetScaler-Instanzen in der NetScaler Console zur verfügbaren Liste der Instanzen in diesem Fenster hinzuzufügen.
Verwenden der NetScaler Console-API zum Erstellen eines Konfigurationspakets
Sie können die NetScaler Console-API auch verwenden, um ein Konfigurationspaket zu erstellen, das Dateien auf die ausgewählte NetScaler-Instanz hochlädt. Weitere Informationen zur Verwendung von APIs finden Sie unter Verwenden der API zum Erstellen von Konfigurationen zum Hochladen beliebiger Dateitypen.