Verwenden der Masterkonfigurationsvorlage

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

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

Um Ihre Master-Konfigurationsvorlage von einer 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 in der Benutzeroberfläche der 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 Instanz speichern möchten, wählen Sie Gespeicherte Konfiguration aus.Klicken Sie auf den Link Text in eine Datei speichern, um die Datei ‘ns.conf’ auf Ihrem lokalen Rechner 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 spezifische 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 ADC-Instanzen zusätzlich ns.conf-Datei hochladen und die Master-Konfiguration auf ihnen bereitstellen.

Wichtig

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

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

  1. Navigieren Sie in Citrix ADM zu Infrastruktur > Konfigurationsaufträge, und klicken Sie dann auf Auftrag 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 den variablen Eingabedateien auch Zertifikat- und Schlüsseldateien hochladen.

    Hinzufügen von Eingabedateien

  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.

    • 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.

    Vorschau von Variablen

  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.

    Parameter editieren

  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 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>
    
    <!--NeedCopy-->
    
  10. Klicken Sie auf Weiter.

Datei hochladen

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 Ausführungskonfigurationsaufträ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 beim Bearbeiten 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).

  1. 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.

    Job-Vorschau

  2. 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.

    Führen Sie den Job aus

Nachdem Sie Ihren Job ausgeführt haben, können Sie die Jobdetails anzeigen, indem Sie zuInfrastruktur > Konfigurationsaufträgenavigieren und den Job auswählen, den Sie konfiguriert haben. Klicken Sie aufDetailsund dann aufAusfü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.

Anzeigen von Befehlslogs

Verwenden der Masterkonfigurationsvorlage

In diesem Artikel