StyleBook-Konfiguration

Erstellen Sie ein StyleBook um Dateien hochzuladen

Mit NetScaler Console StyleBooks können Sie NetScaler-Konfigurationen erstellen, die unter anderem beim Hochladen von Dateien beliebigen Typs aus Ihrem lokalen Dateisystem auf die NetScaler-Instanz mithilfe der NetScaler-Console-GUI oder der APIs enthalten können. 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 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)
<!--NeedCopy-->

Hinweis

Der in diesem Beispiel verwendete Parameter ist vom Typ Datei. Sie können dieses StyleBook in NetScaler Console importieren und es zum Hochladen von Geolocation-Dateien verwenden.

Für dieses StyleBook muss die Datei bereits in NetScaler Console vorhanden sein (Sie hätten sie beispielsweise bereits mit einem Hilfsprogramm wie SCP auf die NetScaler Console kopiert). Wenn Sie eine Datei über NetScaler Console auf NetScalers hochladen möchten, ohne sie zuerst in das NetScaler Console-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, und diese beiden Parameter in den Upload-File-Comp-Komponenten verwenden. 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:

  1. Navigieren Sie in der NetScaler Console zu Anwendungen > Konfiguration und klicken Sie auf Neu erstellen . Auf der Seite Choose StyleBook werden alle StyleBooks angezeigt, die in Ihrer NetScaler Console 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.

  2. Geben Sie den Namen des Load Balancers und die virtuelle IP-Adresse im Abschnitt Grundeinstellungen des Load Balancers ein.

  3. Geben Sie im Abschnitt Standortdatei den Namen oder Speicherort der Datei ein.
    Hinweis

    Stellen Sie sicher, dass sich die Datei in NetScaler Console nur im Ordner des aktuellen Mandanten befindet. Verwenden Sie ein beliebiges FTP, um die Datei in das NetScaler Console-Dateisystem zu kopieren.

  4. Möglicherweise werden Sie aufgefordert, Ihre Benutzeranmeldeinformationen anzugeben, bevor Sie auf die Zielinstanzen zugreifen.

  5. Wählen Sie die NetScaler Zielinstanz aus, für die die Konfiguration erstellt werden muss, und klicken Sie auf Erstellen.

Hinweis

Citrix empfiehlt, dass Sie Dry Run auswählen, um die auf der Zielinstanz erstellten Konfigurationsobjekte zu überprüfen, bevor Sie die eigentliche Konfiguration auf der Instanz ausführen.

Wenn die Erstellung des Konfigurationspakets erfolgreich ist, wird die Datei im NetScaler-Instanzdateisystem unter dem Speicherort gespeichert: /var/netscaler/inbuilt_db/

Hinweis

Sie können auch auf das Aktualisierungssymbol klicken, um kürzlich erkannte NetScaler-Instanzen in der NetScaler Console zur Liste der verfügbaren Instanzen in diesem Fenster hinzuzufügen.

Verwenden der NetScaler Console-API zum Erstellen eines Konfigurationspakets

Sie können auch die NetScaler Console 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 Verwendung der API zum Erstellen von Konfigurationen zum Hochladen beliebiger Dateitypen.

Erstellen Sie ein StyleBook um Dateien hochzuladen