Erstellen eines StyleBook zum Hochladen von Dateien in NetScaler ADM
Mit NetScaler Application Delivery Management (NetScaler ADM) StyleBooks können Sie NetScaler-Konfigurationen erstellen, die unter anderem das Hochladen von Dateien beliebigen Typs von Ihrem lokalen Dateisystem auf die NetScaler-Instanz umfassen können, indem Sie die NetScaler ADM-GUI oder die APIs verwenden. Bei diesen Dateien kann es sich um Beispielzertifikatsdateien oder Geolocation-Dateien handeln. Sie können auch das Verzeichnis angeben, in das diese Dateien hochgeladen werden sollen.
StyleBook-Konfiguration
Im Folgenden finden Sie ein Beispiel-StyleBook, das beschreibt, wie eine Geo-Location-Datei auf die NetScaler-Instanz hochgeladen wird. Die Geodateien werden normalerweise in GSLB-Konfigurationen verwendet, um statische Nähe basierend auf dem geografischen Standort zu definieren:
Erstellen des StyleBooks -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 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 es zum Hochladen von Geolocationsdateien verwenden.
Dieses StyleBook erfordert, dass die Datei bereits in NetScaler ADM vorhanden ist (Sie hätten sie beispielsweise bereits mit einem Hilfsprogramm wie scp nach NetScaler ADM kopiert). Wenn Sie eine Datei über NetScaler ADM auf NetScaler hochladen möchten, ohne sie zuerst in das NetScaler ADM-Dateisystem zu kopieren, können Sie ein StyleBook mit zwei “String”-Parametern erstellen. Einer dient zur Angabe des Dateinamens, der auf dem NetScaler verwendet werden soll, und der andere, um den Inhalt der Datei anzugeben. Verwenden Sie diese beiden Parameter in den Upload-File-Comp-Komponenten. Im Folgenden finden Sie ein alternatives StyleBook zum Hochladen einer Geolokalisierungsdatei:
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)
<!--NeedCopy-->
Erstellen von Konfigurationen zum Hochladen von Dateien
Im folgenden Verfahren wird eine Konfiguration für eine ausgewählte NetScaler-Instanz erstellt, die eine Geolocationsdatei mithilfe des ersten oben beschriebenen StyleBook hochladen würde.
So erstellen Sie eine Konfiguration für das Hochladen von Dateien:
-
Navigieren Sie in NetScaler ADM zu Anwendungen > Konfiguration, und klicken Sie auf Neu erstellen. Auf der Seite StyleBook auswählen werden alle StyleBooks angezeigt, die in Ihrem NetScaler ADM verfügbar sind. Scrolle nach unten und wähle das StyleBook aus, das du importiert hast
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 Grundeinstellungen des Load Balancers ein.
- Geben Sie im Abschnitt Standortdatei den Namen oder Speicherort der Datei ein.
Hinweis Stellen Sie
sicher, dass sich die Datei in NetScaler ADM nur im Ordner des aktuellen Mandanten 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 NetScaler Zielinstanz aus, für die die Konfiguration erstellt werden muss, und klicken Sie auf Erstellen.
Hinweis
Citrix empfiehlt, dass SieDry Runauswählen, um die Konfigurationsobjekte zu überprüfen, die auf der Zielinstanz erstellt werden, bevor Sie die tatsächliche Konfiguration für die Instanz ausführen.
Wenn die Erstellung des Konfigurationspakets erfolgreich ist, wird die Datei im NetScaler-Instanzdateisystem unter dem folgenden Speicherort gespeichert: /var/netscaler/inbuilt_db/
Hinweis
Sie können auch auf das Aktualisierungssymbol klicken, um kürzlich erkannte 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 So erstellen Sie mithilfe der API Konfigurationen zum Hochladen beliebiger Dateitypen .