Verwenden der Master-Konfigurationsvorlage

Die Verwendung einer Hauptkonfigurationsvorlage ist eine flexible Option zum Erstellen und Bereitstellen einer Master-Konfiguration auf mehreren NetScaler-Instanzen.

Als Administrator möchten Sie möglicherweise Konfigurationsänderungen vornehmen und Lizenzen, Zertifikate und andere Dateien auf der NetScaler-Instanz speichern. Sie können die neue Konfiguration als Master-Konfigurationsvorlage (.conf-Datei) speichern.

Um Ihre Master-Konfigurationsvorlage von einer NetScaler-Instanz zu speichern, können Sie eine der folgenden Aktionen ausführen:

• Geben Sie an der Eingabeaufforderung save ns config ein. Die Konfiguration wird im FLASH-Speicher der Instanz in der Datei /nsconfig/ns.conf gespeichert.

• Navigieren Sie in der GUI der Instanz zu Diagnostics > View Configuration. Wählen Sie die Art der Konfiguration aus, die Sie speichern möchten. Wenn Sie beispielsweise die gespeicherte Konfiguration Ihrer Instanz speichern möchten, wählen Sie Saved configuration. Klicken Sie auf den Link Save text to a file, um die Datei ‘ns.conf’ auf Ihrem lokalen Computer zu speichern.

Wenn Sie die Master-Konfigurationsvorlage mithilfe der Konfigurationsvorlage ‘DeployMasterConfiguration’ bei der Erstellung eines Jobs bereitstellen, können Sie diese für jede spezifische NetScaler-Instanz weiter anpassen, indem Sie weitere Befehle hinzufügen, bestehende Befehle ändern und unterschiedliche Variablenwerte in der Eingabedatei bereitstellen.

Als Administrator möchten Sie beispielsweise zusätzlich zur ns.conf-Datei Zertifikatsschlüssel auf Ihre NetScaler-Instanzen hochladen und die Master-Konfiguration auch auf diesen bereitstellen.

Wichtig

Sie können einen Konfigurationsjob mit der DeployMasterConfiguration-Vorlage nicht auf NetScaler CPX-Instanzen, in einem Cluster konfigurierten Instanzen oder auf partitionierten NetScaler-Instanzen ausführen.

So erstellen Sie einen Konfigurationsjob mithilfe der Master Config-Konfigurationsvorlage in NetScaler Console:

1. Navigieren Sie in NetScaler Console zu Infrastructure > Configuration Jobs, und klicken Sie dann auf Create Job.

2. Geben Sie auf der Seite Create Job auf der Registerkarte Select Configuration den Job Name an und wählen Sie den Instance Type aus der Dropdown-Liste aus.

3. Wählen Sie Master Configuration aus der Dropdown-Liste Configuration Source aus. Ziehen Sie die Befehle der DeployMasterConfiguration-Vorlage in den rechten Bereich. Sie können auch Befehle im rechten Bereich hinzufügen, ändern oder löschen. Klicken Sie auf Next.

   Hinweis

   Sie können put-Befehle hinzufügen, um Eingabedateien zu Ihrer Vorlage hinzuzufügen. In unserem Beispiel müssen wir zusätzlich zur Konfigurationsvorlagendatei und den Variableneingabedateien Zertifikats- und Schlüsseldateien hochladen.

   

4. Sie können alle Variablen, die Sie beim Erstellen oder Bearbeiten eines Konfigurationsjobs definiert haben, in einer einzigen konsolidierten Ansicht überprüfen.

5. Führen Sie eine der folgenden Aktionen aus, um alle Variablen in einer einzigen konsolidierten Ansicht anzuzeigen:

   • Navigieren Sie beim Erstellen eines Konfigurationsjobs zu Infrastructure > Configuration Jobs, wählen Sie Create Job. Auf der Seite Create Job können Sie alle Variablen überprüfen, die Sie beim Erstellen des Konfigurationsjobs hinzugefügt haben.

   • Navigieren Sie beim Bearbeiten eines Konfigurationsjobs zu Network > Configuration Jobs, wählen Sie den Jobnamen aus und klicken Sie auf Edit. Auf der Seite Configure Job können Sie alle Variablen überprüfen, die beim Erstellen des Konfigurationsjobs hinzugefügt wurden.

6. Sie können dann auf die Registerkarte Preview Variables klicken, um die Variablen, die Sie beim Erstellen oder Bearbeiten eines Konfigurationsjobs definiert haben, in einer einzigen konsolidierten Ansicht anzuzeigen.

   

7. Ein neues Pop-up-Fenster wird angezeigt und zeigt alle Parameter von Variablen wie Name, Display Name, Type und Standardwert in einem Tabellenformat an. Sie können diese Parameter auch bearbeiten und ändern. Klicken Sie auf die Schaltfläche Done, nachdem Sie Parameter bearbeitet oder geändert haben.

   

8. Wählen Sie die Instanzen aus, auf denen Sie den Konfigurationsjob ausführen möchten, und klicken Sie dann auf Next.

9. Laden Sie auf der Registerkarte Specify Variable Values Folgendes hoch:

   • Konfigurationsvorlagendatei (.conf) – Laden Sie die .conf-Datei hoch, die Sie von einer NetScaler-Instanz extrahiert haben.

   • Eingabedatei hochladen (.xml/csv) – Laden Sie die Eingabedatei mit Werten für die Variablen hoch, die Sie in Ihren Befehlen definiert haben.

   Eine Beispiel-XML-Datei wird hier zur Verwendung bereitgestellt. Stellen Sie sicher, dass die XML-Dateien die Details enthalten, die den von Ihnen verwendeten NetScaler-Instanzen entsprechen.

   
   <?xml version="1.0" encoding="UTF-8" ?>
   
   <properties>
   
   <!--
   Geben Sie Eingaben für alle in der Master-Konfigurationsdatei definierten Parameter an.
   
   -  global. Dieses Tag enthält alle gemeinsamen Parameter und Werte.
   
   -  devicegroup. Dieses Tag enthält alle instanzgruppenspezifischen Parameter und Werte.
   
   Wenn dieselben Parameter in globalen und Instanz-Tags definiert sind, hat der instanzspezifische Parameterwert Vorrang vor der Instanzgruppe. Der instanzgruppenspezifische Parameterwert hat bei der Ausführung Vorrang vor globalen Parametern.
   
   -  name. Dieses Attribut repräsentiert den Namen der Instanzgruppe.
   
   -  device. Dieses Tag enthält alle instanzspezifischen Parameter und Werte.
   
   Wenn dieselben Parameter in globalen und Instanz-Tags definiert sind, hat der instanzspezifische Parameterwert bei der Ausführung Vorrang.
   
   -  name. Dieses Attribut repräsentiert die IP-Adresse der Instanz. Hostname wird für das Attribut nicht unterstützt.
   
   HA-Paare sollten als <primaryip>-<secondaryip> dargestellt werden. Beispiel 10.102.2.1-10.102.2.2
   
   In der Vorlagendatei muss der Parametername innerhalb des Dollarzeichens angegeben werden, Beispiel: $NSIP$, $CC_Trap_Dest$ und Parameternamen sind Groß- und Kleinschreibung-sensitiv.
   -->
   
   <global>
   
   </global>
   <devicegroup name="BLR_DEVS">
   </devicegroup>
   <device name="10.106.101.209">
   <param name="IP" value="10.106.101.209"/>
   </device>
   
   <!-- HA-PAAR-->
   <!--<device name="10.102.43.154-10.102.43.155">
   <param name="NSIP" value="10.102.43.154"/>
   <param name="HostName" value="NS43HA"/>
   <param name="LBSERVER" value="haserver43http"/>
   <param name="SNMPTrapDest" value="10.102.43.130"/>
   </device>-->
   </properties>
   
   <!--NeedCopy-->
   

10. Klicken Sie auf Next.

Die Eingabedateien, die die Variablenwerte enthalten, werden (mit demselben Dateinamen) in den Konfigurationsjobs gespeichert. Sie können diese Eingabedateien, die Sie zuvor beim Erstellen oder Bearbeiten der Konfigurationsjobs verwendet und hochgeladen haben, anzeigen und bearbeiten.

Um die ausgeführten Konfigurationsjobs beim Erstellen eines Konfigurationsjobs anzuzeigen, navigieren Sie zu Network > Configuration Jobs und klicken Sie auf Create Job. Auf der Seite Create Job. Wählen Sie auf der Registerkarte Specify Variable Values die Option Common Variable Values for all Instances aus, um die hochgeladenen Dateien anzuzeigen. Um die Eingabedateien zu bearbeiten, laden Sie die Eingabedatei herunter und bearbeiten und laden Sie die Dateien dann hoch (wobei der Dateiname beibehalten wird).

Um die bereits ausgeführten Konfigurationsjobs beim Bearbeiten eines Konfigurationsjobs anzuzeigen, navigieren Sie zu Network > Configuration Jobs, wählen Sie den Jobnamen aus und klicken Sie auf Edit. Auf der Seite Configure Job wählen Sie auf der Registerkarte Specify Variable Values die Option Common Variable Values for all Instances aus, um die hochgeladenen Dateien anzuzeigen. Um die Eingabedateien zu bearbeiten, laden Sie die Eingabedatei herunter und bearbeiten und laden Sie die Dateien dann hoch (wobei der Dateiname beibehalten wird).

1. Auf der Registerkarte Job Preview können Sie die Befehle, die auf jeder Instanz oder Instanzgruppe ausgeführt werden sollen, auswerten und überprüfen und dann auf Next klicken.

   

2. Auf der Registerkarte Execute können Sie wählen, ob Sie Ihren Job sofort ausführen oder für eine spätere Ausführung planen möchten. Sie können auch festlegen, welche Aktion NetScaler Console ausführen soll, wenn der Befehl fehlschlägt.

   Sie können auch autorisierten Benutzern erlauben, Jobs auf Ihren verwalteten Instanzen auszuführen, und Sie können wählen, ob eine E-Mail-Benachrichtigung über den Erfolg oder Misserfolg des Jobs zusammen mit weiteren Details gesendet werden soll.

   

Nach dem Ausführen Ihres Jobs können Sie die Jobdetails anzeigen, indem Sie zu Infrastructure > Configuration Jobs navigieren und den von Ihnen konfigurierten Job auswählen. Klicken Sie auf Details und dann auf Execution Summary, um die Details Ihres Jobs anzuzeigen. Klicken Sie auf die Instanz, um die Command Logs anzuzeigen und die für den Job ausgeführten Befehle zu sehen.