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 sowie andere Dateien auf der ADC-Instanz speichern. Sie können die neue Konfiguration als Master-Konfigurationsvorlage (.conf-Datei) speichern.

Um Ihre Master-Konfigurationsvorlage von einer ADC-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 aus. 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 ADC-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 ADC-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 ADC-Instanzen ausführen.

So erstellen Sie einen Konfigurationsjob mithilfe der Master-Konfigurationsvorlage in NetScaler® ADM:

1. Navigieren Sie in NetScaler ADM 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 Zertifikats- und Schlüsseldateien zusätzlich zur Konfigurationsvorlagendatei und den variablen Eingabedateien 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 aus. 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. Anschließend können Sie 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 ADC-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 ADC-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-->
   

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 einen späteren Zeitpunkt planen möchten. Sie können auch festlegen, welche Aktion NetScaler ADM 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.

   

Nachdem Sie Ihren Job ausgeführt haben, 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 auf dem Job ausgeführten Befehle zu sehen.