Erstellen eines StyleBooks zum Hochladen von Dateien in NetScaler® ADM
NetScaler Application Delivery Management (NetScaler ADM) StyleBooks ermöglichen Ihnen die Erstellung von NetScaler-Konfigurationen, die unter anderem das Hochladen von Dateien beliebigen Typs von Ihrem lokalen Dateisystem auf die NetScaler-Instanz umfassen können, entweder über die NetScaler ADM GUI oder die APIs. 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 der NetScaler-Instanz hochgeladen wird. Die Geodateien werden typischerweise in GSLB-Konfigurationen zur Definition von statischer 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-Datei-Upload
description: Dieses StyleBook wird verwendet, um eine Geolocation-Datei auf NetScaler hochzuladen
schema-version: "1.0"
import-stylebooks:
-
namespace: netscaler.nitro.config
version: "11.1"
prefix: ns
parameters:
-
name: locationfile
label: Standortdatei
description: Der Systemdateipfad der Geolocation-Datei auf NetScaler ADM
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)
<!--NeedCopy-->
Hinweis
Der in diesem Beispiel verwendete Parameter ist vom Typ Datei. Sie können dieses StyleBook in NetScaler ADM importieren und zum Hochladen von Geolocation-Dateien verwenden.
Dieses StyleBook erfordert, dass die Datei bereits in NetScaler ADM vorhanden ist (Sie hätten sie beispielsweise bereits mit einem Dienstprogramm wie scp nach NetScaler ADM kopiert).
Wenn Sie eine Datei über NetScaler ADM auf NetScaler hochladen möchten, ohne sie zuvor in das NetScaler ADM-Dateisystem zu kopieren, können Sie ein StyleBook erstellen, das zwei “String”-Parameter enthält: einen zur Angabe des auf dem NetScaler zu verwendenden Dateinamens und den anderen zur Angabe des Dateiinhaltes. Diese beiden Parameter können Sie dann 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-Datei-Upload
description: Dieses StyleBook wird verwendet, um eine Geolocation-Datei auf NetScaler hochzuladen
schema-version: "1.0"
import-stylebooks:
-
namespace: netscaler.nitro.config
version: "11.1"
prefix: ns
parameters:
-
name: filename
label: Dateiname des Standorts
description: Der Name der Standortdatei auf dem NetScaler
type: string
required: true
-
name: filecontents
label: Inhalt der Standortdatei
description: Der Inhalt der Standortdatei
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)
<!--NeedCopy-->
Erstellen von Konfigurationen zum Hochladen von Dateien
Das folgende Verfahren erstellt eine Konfiguration auf einer ausgewählten NetScaler-Instanz, die eine Geolocation-Datei mithilfe des oben beschriebenen ersten StyleBooks hochladen würde.
So erstellen Sie eine Konfiguration zum Hochladen von Dateien:
-
Navigieren Sie in NetScaler ADM zu Applications > Configuration, und klicken Sie auf Create New. Die Seite „Choose StyleBook“ zeigt alle StyleBooks an, die in Ihrem NetScaler ADM verfügbar sind. Scrollen Sie nach unten und wählen Sie das von Ihnen importierte StyleBook aus.
Die StyleBook-Parameter werden als Benutzeroberflächenseite angezeigt, die es Ihnen ermöglicht, die Werte für alle in diesem StyleBook definierten Parameter einzugeben.
-
Geben Sie den Namen des Load Balancers und die virtuelle IP-Adresse im Abschnitt für die grundlegenden Load-Balancer-Einstellungen ein.
- Im Abschnitt Location File geben Sie den Namen oder den Speicherort der Datei ein.
Hinweis
Stellen Sie sicher, dass sich die Datei in NetScaler ADM nur im Ordner des aktuellen Tenants befindet. Verwenden Sie ein beliebiges Dateiübertragungsprotokoll, um die Datei in das NetScaler ADM-Dateisystem zu kopieren.
-
Möglicherweise werden Sie aufgefordert, Ihre Benutzeranmeldeinformationen anzugeben, bevor Sie auf die Zielinstanzen zugreifen.
- Wählen Sie die Ziel-NetScaler-Instanz aus, auf der die Konfiguration erstellt werden soll, und klicken Sie auf Create.
Hinweis
Citrix empfiehlt, dass Sie Dry Run auswä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 auf dem 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 NetScaler ADM zur verfügbaren Liste der Instanzen in diesem Fenster hinzuzufügen.
Verwenden der NetScaler ADM API zum Erstellen eines Konfigurationspakets
Sie können auch die NetScaler ADM API 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.