Citrix Application Delivery Management-Service

Integrierten ADC Agent zur Verwaltung von Instanzen konfigurieren

Ein integrierter Agent ist auf Citrix ADC MPX, VPX, Gateway-Instanzen verfügbar, auf denen die Version 12.1.48.13 ausgeführt wird, und später sowie auf Citrix ADC SDX-Instanzen mit Version 13.0 61.x und höher sowie 12.1 58.x und höher. Sie können diesen Agenten auf der ADC-Instanz initiieren, anstatt einen dedizierten Agenten in Ihrem Rechenzentrum oder in der Public Cloud zu installieren. Der integrierte Agent ermöglicht die Kommunikation zwischen der Instanz und Citrix ADM.

Hinweis

Der integrierte Agent ist nur für die folgenden Citrix ADC-Instanztypen verfügbar:

  • Citrix ADC MPX
  • Citrix ADC VPX
  • Citrix ADC SDX
  • Citrix Gateway

Der integrierte Agent ist ideal für kleinere ADC-Standalone- oder HA-Paar-Bereitstellungen. Wenn Sie über mehrere ADC-Instanzen verfügen, verwenden Sie einen dedizierten Agenten für Bereitstellungen. Dieser Agent stellt sicher, dass Sie über bessere Datenaggregationsfunktionen verfügen als der integrierte Agent. Weitere Informationen finden Sie unter Installieren eines Agents on-premises.

Citrix ADM unterstützt die Verwaltung und Überwachung von Citrix ADC-Instanzen mithilfe integrierter Agents. Die folgenden Funktionen werden jedoch vom integrierten Agenten nicht unterstützt:

  • Anwendungs-Dashboard
  • Web Insight
  • SSL-Einblick
  • HDX Insight
  • Gateway-Einblick
  • Einblicke in die Sicherheit
  • Fortschrittliche Analytik
  • Zusammengefasste Lizenzierung

Sie können von einem integrierten Agenten zu einem externen Agenten wechseln. Weitere Informationen finden Sie unter Übergang von einem integrierten Agenten zu einem externen Agenten.

Voraussetzungen

Bevor Sie einen integrierten Agenten in der Citrix ADC-Instanz konfigurieren, stellen Sie Folgendes sicher:

  • Die Citrix ADC (MPX, VPX oder Gateway) -Instanz wird auf der Version 12.1.48.13 oder höher ausgeführt. Auf der SDX-Instanz läuft Version 13.0.61.x und höher.

  • Ein DNS-Namenserver wird auf der Citrix ADC-Instanz hinzugefügt.

    Weitere Informationen finden Sie unter Hinzufügen eines Namenservers.

  • Sie haben ein Citrix Cloud-Konto. Weitere Informationen finden Sie unter Für Citrix Cloud anmelden.

Hinweis

Alle Informationen zu Ports und anderen Systemanforderungen finden Sie unter Systemanforderungen.

Integrierten Agenten konfigurieren

Führen Sie die folgenden Aufgaben aus, um den integrierten ADC-Agenten zu konfigurieren:

  1. Wählen Sie die Option Integrierter Agent, wie unter Erste Schritte beschrieben.

  2. Kopieren Sie die Service-URL und den Aktivierungscode.

    Der Agent verwendet die Dienst-URL, um den Dienst zu finden, und den Aktivierungscode, um sich beim Dienst zu registrieren. Überspringen Sie Schritt 7, wenn Sie ein MPX- oder Gateway-Kunde sind.

    Dienst-URL und Aktivierungscode kopieren

  3. Initiieren Sie den integrierten Agenten mit einem SSH-Client. Gateway-Benutzer müssen diesen Schritt überspringen.

    1. Melden Sie sich bei der Citrix ADC-Instanz an. Weitere Informationen finden Sie unter Zugriff auf einen Citrix ADC.

    2. Navigieren Sie zum Verzeichnis /var/mastools/scripts, und geben Sie den folgenden Befehl ein:

      Auf der SDX-Instanz

      ./mastools_init.sh <user_name> <service-url> <activation-code> -sdx
      <!--NeedCopy-->
      
      • Geben Sie in <user_name> den Citrix ADC Benutzername ein.
      ./mastools_init.sh <device-profile-name> <service-url> <activation-code> -sdx -profile
      
      <!--NeedCopy-->
      

      Hinweis:

      Citrix ADM erkennt alle VPX-Instanzen, die auf dieser SDX ausgeführt werden, und Sie müssen die VPX-Instanzen nicht einzeln registrieren.

      Bei VPX-Instanzen, die nicht auf einer SDX-Appliance ausgeführt werden, sowie bei MPX- und Gateway-Instanzen:

      Wenn die ADC-Imageversion niedriger als 13.0 61.x oder 12.1 57.x ist, müssen Sie die mastools-Version überprüfen, indem Sie den Befehl cat /var/mastools/version.txt eingeben. Wenn die Ausgabe 0.0-0.0 ist, ist es das erste Mal.

      Geben Sie je nach Softwareversion einen der folgenden Befehle ein.

      ADC-Imageversion Ist mastools_version 0.0-0.0? Befehl zur Registrierung mit Profil Befehl zur Registrierung ohne Profil
      Unter 13,0 61.xx und 12,1 57,xx Ja ./mastools_init.sh <device_profile_name> <service_url> "MAS;<activation_code>" -profile ./mastools_init.sh <user_name> <pwd> <service_url> "MAS;<activation_code>"
      Unter 13,0 61.xx und 12,1 57,xx Nein ./mastools_init.sh <device_profile_name> <service_url> <activation_code> -profile ./mastools_init.sh <user_name> <pwd> <service_url> <activation_code>
      Höher als 13,0 61.x und 12.1 57,xx Nicht zutreffend ./mastools_init.sh <device_profile_name> <service_url> <activation_code> -profile ./mastools_init.sh <user_name> <pwd> <service_url> <activation_code>
      • Geben Sie in <user_name> den Citrix ADC Benutzername ein.

    Hinweis: Schließen Sie

    bei einem HA-Paar die Registrierung auf dem primären Knoten ab. Wenn Sie die Registrierung auf dem sekundären Knoten ausführen, wird die folgende Meldung angezeigt:

    Bitte führen Sie den Registrierungsbefehl auf dem primären Knoten aus.

  4. Kehren Sie zur Seite Citrix ADM zurück und klicken Sie auf Instanz registrieren.

  5. Zeigen Sie unter Instanzen hinzufügendie Instanz an, in der Sie den integrierten Agenten initiiert haben. Stellen Sie sicher, dass die Instanz den Status “Nach oben “ hat, und klicken Sie auf “ Weiter”.

    Instanzen hinzufügen

  6. Klicken Sie auf Fertig.

Vollständige integrierte Agentenkonfiguration

Nach erfolgreicher Konfiguration des integrierten Agents können Sie auf die Citrix ADM-Funktionen zugreifen, z. B.:

  • Virtueller Server und Analysen — Wenden Sie Lizenzen auf Ihren virtuellen Server an, um ADC-Instanzen zu verwalten. Weitere Informationen finden Sie unter Abonnements verwalten.

  • Anwendungs-Dashboard — Um alle Anwendungen auf ganzheitliche Weise anzuzeigen. Weitere Informationen finden Sie unter Anwendungsverwaltung und Dashboard.

  • Infrastrukturanalyse — Mit dieser Funktion können Sie die Faktoren visualisieren, die zu einem Problem in den Instanzen geführt haben oder dazu führen könnten. Weitere Informationen finden Sie unter Infrastructure Analytics.

Hinweis:

Sie können den integrierten Agenten auch konfigurieren, indem Sie zur Seite Infrastruktur > Instanzen > Agents > Aktivierungscode generieren navigieren. Kopieren Sie die URL und den Aktivierungscode, fügen Sie sie in eine ADC-Instanz ein und ermitteln Sie diese Instanz.

Nachdem der integrierte Agent initiiert wurde, navigieren Sie zu Infrastruktur > Instanzen > Citrix ADC. Auf dieser Seite werden die Details zur verwalteten Instanz angezeigt, die mit dem integrierten Agenten ermittelt wurde.

Problembehandlung

Sie können Protokolle überprüfen, wenn die Registrierung fehlschlägt oder wenn die Registrierung erfolgreich ist, der integrierte Agent jedoch nicht in der Citrix ADM GUI angezeigt wird.

  • Wenn die Registrierung fehlschlägt, checken Sie die Login /var/mastools/logs/mastools_reg.py.log
  • Wenn die Registrierung erfolgreich ist, der integrierte Agent jedoch nicht in der Citrix ADM GUI angezeigt wird, überprüfen Sie:
    • mastools_Upgrade meldet sich an /var/mastools/logs/mastools_upgrade.log
    • Binär meldet sich an /var/log/mastoolsd.log.
Integrierten ADC Agent zur Verwaltung von Instanzen konfigurieren