Masterkonfigurationsvorlage verwenden

Die Verwendung einer Masterkonfigurationsvorlage ist eine flexible Option zum Erstellen und Bereitstellen einer Masterkonfiguration auf mehreren NetScaler-Instanzen.

Als Administrator können Sie Konfigurationsänderungen vornehmen und Lizenzen, Zertifikate und andere Dateien auf einer NetScaler-Instanz speichern. Sie können die neue Konfiguration als Masterkonfigurationsvorlage (.conf-Datei) speichern.

Um die Masterkonfigurationsvorlage aus einer NetScaler-Instanz zu speichern, können Sie einen der folgenden Schritte ausführen:

• Geben Sie an der Eingabeaufforderung save ns configein. Die Konfiguration wird im FLASH-Speicher der Instanz in der Datei /nsconfig/ns.conf gespeichert.
• Navigieren Sie auf der Benutzeroberfläche der NetScaler-Instanz zu Diagnose > Konfiguration anzeigen. Wählen Sie die Art der Konfiguration, die Sie speichern möchten. Wenn Sie beispielsweise die gespeicherte Konfiguration Ihrer NetScaler-Instanz speichern möchten, wählen Sie Gespeicherte Konfigurationaus. Klicken Sie auf den Link Text in einer Datei speichern, um die Datei ‘ns.conf’ auf Ihrem lokalen Computer zu speichern.

Wenn Sie die Master-Konfigurationsvorlage bereitstellen, indem Sie beim Erstellen eines Auftrags die Konfigurationsvorlage “DeployMasterConfiguration” verwenden, können Sie sie für jede bestimmte NetScaler-Instanz weiter anpassen, indem Sie weitere Befehle hinzufügen, vorhandene Befehle ändern und unterschiedliche Variablenwerte in der Eingabedatei angeben .

Als Administrator können Sie beispielsweise Zertifikatschlüssel in Ihre NetScaler-Instanzen zusätzlich ns.conf-Datei hochladen und die Master-Konfiguration auch auf ihnen bereitstellen.

Wichtig!

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

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

1. Navigieren Sie in der NetScaler Console zu Infrastruktur > Konfiguration > Konfigurationsaufträge , und klicken Sie dann auf Job erstellen .**

2. Geben Sie auf der Seite Job erstellen auf der Registerkarte Konfiguration auswählen den Auftragsnamen an, und wählen Sie in der Dropdownliste den Instanztyp aus.

3. Wählen Sie in der Dropdownliste Konfigurationsquelle die Option Hauptkonfiguration aus. Ziehen Sie die Befehle der DeployMasterConfiguration-Vorlage in den rechten Fensterbereich. Sie können Befehle auch im rechten Fensterbereich hinzufügen, ändern oder löschen. Klicken Sie auf Weiter.

   Hinweis

   Sie können Put-Befehle hinzufügen, um Ihrer Vorlage Eingabedateien hinzuzufügen. In unserem Beispiel müssen wir neben der Konfigurationsvorlagendatei und den variablen Eingabedateien auch Zertifikat- und Schlüsseldateien hochladen.

   

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

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

   • Navigieren Sie beim Erstellen eines Konfigurationsauftrags zu Infrastruktur > Konfigurationsaufträge undwählen Sie Auftrag erstellenaus. Auf der Seite Job erstellen können Sie alle Variablen überprüfen, die Sie beim Erstellen des Konfigurationsauftrags hinzugefügt haben.

   • Navigieren Sie beim Bearbeiten eines Konfigurationsauftrags zu Infrastruktur > Konfiguration > Konfigurationsjobs, wählen Sie den Job-Namen aus und klicken Sie auf Bearbeiten. Auf der Seite Job konfigurieren können Sie alle Variablen überprüfen, die beim Erstellen des Konfigurationsauftrags hinzugefügt wurden.

6. Sie können dann auf die Registerkarte Vorschauvariablen klicken, um eine Vorschau der Variablen in einer einzelnen konsolidierten Ansicht anzuzeigen, die Sie beim Erstellen oder Bearbeiten eines Konfigurationsauftrags definiert haben.

   

7. Ein neues Popup-Fenster wird angezeigt, in dem alle Parameter von Variablen wie Name, Anzeigename, Typ und Standardwert in einem tabellarischen Format angezeigt werden. Sie können diese Parameter auch bearbeiten und ändern. Klicken Sie auf die Schaltfläche Fertig, nachdem Sie einen der Parameter bearbeitet oder geändert haben.

   

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

9. Laden Sie auf der Registerkarte “ Variablenwerte angeben “ Folgendes hoch:

   • Konfigurationsvorlagendatei (.conf) - Laden Sie die CONF-Datei hoch, die Sie aus 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 für Ihre 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>
   
   <!-- 
   
   Provide inputs for all the parameters defined in the master config file.
   
   -  global. This tag contains all the common parameters and value.
   
   -  devicegroup. This tag contains all the instance group specific parameters and values.
   
   If the same parameters are defined in global and instance tags, the instance specific parameters value will take precedence over the instance group. The instance group specific parameters value will take precedence over global parameters in the execution.    
   
   -  name. This attribute represents the name of the instance group.
   
   -  device. This tag contains all the instance specific parameters and value. 
   
   If the same parameters are defined in global and instance tags, the instance specific parameters value will take precedence in the execution.
   
   -  name. This attribute represents the IP Address of the instance. Host name is not supported for the attibute.
   
   HA pair should be represented as <primaryip>-<secondaryip>. Example 10.102.2.1-10.102.2.2
   
   In the template file, the parameter name must be specified within the dollar sign,Example: $NSIP$, $CC_Trap_Dest$ and parameters names are case sensitive.
   -->
   
   <global>
   
   </global>
   <devicegroup name="BLR_DEVS">
   </devicegroup>
   <device name="10.106.101.209">
   <param name="IP" value="10.106.101.209"/>
   </device>
   
   <!-- HA PAIR-->
   <!--<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-->
   

   Eine Beispiel-CSV-Datei wird hier für Ihre Verwendung bereitgestellt.

   #job-s_variable_input_key_file ,,,,
   ,,,,
   #Global,NSIP,HostName,LBSERVER,SNMPTrapDest
   Global Values,,,,
   #InstanceGroup,NSIP,HostName,LBSERVER,SNMPTrapDest
   example_doc,,,,
   #Instance(s),NSIP,HostName,LBSERVER,SNMPTrapDest
   10.xx.xx.xx,,,,
   <!--NeedCopy-->
   

   Dieselbe Datei wird in Microsoft Excel angezeigt:

   

10. Klicken Sie auf Weiter.

    

    Die Eingabedateien, die die Variablenwerte enthalten, werden in den Konfigurationsaufträgen beibehalten (mit demselben Dateinamen). Sie können diese Eingabedateien anzeigen und bearbeiten, die Sie früher beim Erstellen oder Bearbeiten der Konfigurationsaufträge verwendet und hochgeladen haben.

    Um die Run Configuration Jobs beim Erstellen eines Konfigurationsauftrags anzuzeigen, navigieren Sie zu Netzwerk > Konfigurationsjobsund klicken Sie auf Job erstellen. Auf der Seite Job erstellen. Wählen Sie auf der Registerkarte Variablenwerte angeben die Option Gemeinsame Variablenwerte für alle Instanzen aus, um die hochgeladenen Dateien anzuzeigen. Um die Eingabedateien zu bearbeiten, laden Sie die Eingabedatei herunter und bearbeiten und laden Sie die Dateien hoch (unter gleichem Dateinamen).

    Um die bereits ausgeführten Konfigurationsaufträge anzuzeigen, während Sie einen Konfigurationsauftrag bearbeiten, navigieren Sie zu Netzwerk > Konfigurationsjobs, wählen Sie den Job-Namen aus und klicken Sie auf Bearbeiten. Wählen Sie auf der Seite Job konfigurieren auf der Registerkarte Variablenwerte angeben die Option Gemeinsame Variablenwerte für alle Instanzen aus, um die hochgeladenen Dateien anzuzeigen. Um die Eingabedateien zu bearbeiten, laden Sie die Eingabedatei herunter und bearbeiten und laden Sie die Dateien hoch (unter gleichem Dateinamen).

11. Auf der Registerkarte Auftragsvorschau können Sie die Befehle auswerten und überprüfen, die für jede Instanz oder Instanzgruppe ausgeführt werden sollen, und klicken Sie dann auf Weiter.

    

12. Auf der RegisterkarteAusführenkönnen Sie wählen, ob Sie Ihren Job jetzt ausführen oder planen, dass er später ausgeführt wird. Sie können auch auswählen, welche Aktion NetScaler Console ausführen muss, wenn der Befehl fehlschlägt.

    Sie können auch autorisierten Benutzern erlauben, Aufträge auf Ihren verwalteten Instanzen auszuführen, und Sie können wählen, ob Sie eine E-Mail-Benachrichtigung über den Erfolg oder Misserfolg des Auftrags zusammen mit anderen Details senden möchten.

    

    Nachdem Sie Ihren Job ausgeführt haben, können Sie die Auftragsdetails anzeigen, indem Sie zu Infrastruktur > Konfiguration > Konfigurationsjobs navigieren und den Job auswählen, den Sie gerade konfiguriert haben. Klicken Sie auf Details und dann auf Ausführungszusammenfassung, um die Details Ihres Auftrags anzuzeigen. Klicken Sie auf die Instanz, um die Befehlsprotokolle anzuzeigen, damit die Befehle für den Auftrag ausgeführt werden.