Citrix Application Delivery Management-Service

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 Master-Konfigurationsvorlage bereitstellen, indem Sie beim Erstellen eines Auftrags die Konfigurationsvorlage “DeployMasterConfiguration” verwenden, können Sie sie für jede bestimmte Citrix ADC-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 Citrix ADC-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 Citrix ADC CPX-Instanzen, in einem Cluster konfigurierten Citrix ADC-Instanzen oder auf 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 Vorlage DeployMasterConfiguration 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 den variablen Eingabedateien auch Zertifikat- und Schlüsseldateien hochladen.

    Master-Konfiguration

  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.

    • Während Sie einen Konfigurationsauftrag bearbeiten, navigieren Sie zu Netzwerk > 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.

    Beispiel-Konfigurationsvorschau

  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.

    Angegebene Variablen

  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>
    
    

    Eine CSV-Datei ist hier für Ihre Verwendung zur Verfügung gestellt.

    #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,,,,
    

    Die gleiche Datei wird in Microsoft Excel angezeigt:

    Beispiel CSV auf Excel

  10. Klicken Sie auf Weiter.

    Dateien auswählen

    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.

    Befehle überprüfen

  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 Citrix ADM 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.

    Erlaube autorisierten Benutzern

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

    Befehle anzeigen, die für den Auftrag ausgeführt werden

Verwenden der Masterkonfigurationsvorlage