Verwenden der Masterkonfigurationsvorlage

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

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

Um die Masterkonfigurationsvorlage aus einer Citrix ADC 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 Citrix ADC Instanz zu Diagnose > Konfiguration anzeigen. Wählen Sie die Art der Konfiguration aus, die Sie speichern möchten. Wenn Sie beispielsweise die gespeicherte Konfiguration Ihrer Citrix ADC 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 Masterkonfigurationsvorlage mithilfe der Konfigurationsvorlage DeployMasterConfiguration bereitstellen, während Sie einen neuen Auftrag erstellen, können Sie sie für jede bestimmte Citrix ADC Instanz weiter anpassen, indem Sie zusätzliche Befehle hinzufügen, vorhandene Befehle ändern und unterschiedliche Variablenwerte im Eingabedatei.

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

Wichtig

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

So erstellen Sie einen Konfigurationsauftrag mit der Konfigurationsvorlage Master Config unter Citrix ADM:

  1. Navigieren Sie in Citrix Application Delivery Management (ADM) zu Netzwerke > 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 Bereich. 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 variablen Eingabedateien Zertifikate und Schlüsseldateien hochladen.

    lokalisiertes Bild

  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 Netzwerke > Konfigurationsaufträge und wählen Sie Auftrag erstellen. 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 Netzwerk > Konfigurationsaufträge, wählen Sie den Auftragsnamen 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 Variablenvorschau klicken, um die Variablen in einer einzigen konsolidierten Ansicht anzuzeigen, die Sie beim Erstellen oder Bearbeiten eines Konfigurationsauftrags definiert haben.

    lokalisiertes Bild

  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.

    lokalisiertes Bild

  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 Citrix ADC Instanz extrahiert haben.
    • Laden Sie die Eingabedatei hoch (.xml/csv) - Laden Sie die Eingabedatei mit Werten für die Variablen hoch, die Sie in Ihren Befehlen definiert haben.

    Eine XML-Beispieldatei wird hier für Ihre Verwendung bereitgestellt. Stellen Sie sicher, dass die XML-Dateien die Details enthalten, die den 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>
    
    
  10. Klicken Sie auf Weiter.

    lokalisiertes Bild

    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 ausgeführten Konfigurationsaufträge beim Erstellen eines Konfigurationsauftrags anzuzeigen, navigieren Sie zu Netzwerk > Konfigurationsaufträge, und 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 während der Bearbeitung eines Konfigurationsauftrags anzuzeigen, navigieren Sie zu Netzwerk > Konfigurationsaufträge, wählen Sie den Auftragsnamen 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.

    lokalisiertes Bild

  12. Auf der Registerkarte Ausführen können Sie Ihren Job jetzt ausführen oder planen, dass er zu einem späteren Zeitpunkt ausgeführt wird. Sie können auch auswählen, welche Aktion Citrix ADM ausführen soll, wenn der Befehl fehlschlägt.

    Sie können auch zulassen, dass autorisierte Benutzer Aufträge auf Ihren verwalteten Instances ausführen können, und Sie können auswählen, ob eine E-Mail-Benachrichtigung über den Erfolg oder Misserfolg des Auftrags sowie weitere Details gesendet werden soll.

    lokalisiertes Bild

    Nachdem Sie Ihren Job ausgeführt haben, können Sie die Auftragsdetails anzeigen, indem Sie zu Netzwerke > Konfigurationsaufträge navigieren und den Job auswählen, den Sie gerade konfiguriert haben. Klicken Sie auf Details und dann auf Ausführungsübersicht, um die Details Ihres Jobs zu sehen. Klicken Sie auf die Instanz, um die Befehlsprotokolle anzuzeigen, um die Befehle anzuzeigen, die für den Auftrag ausgeführt werden.

    lokalisiertes Bild

Verwenden der Masterkonfigurationsvorlage