NetScaler Console-Dienst

Konfigurieren des integrierten Agenten zur Instanzverwaltung

Ein integrierter Agent ist auf NetScaler MPX-, VPX- und Gateway-Instanzen ab Version 12.1.48.13 sowie auf NetScaler SDX-Instanzen ab Version 13.0 61.x und 12.1 58.x verfügbar. Sie können diesen Agenten auf der NetScaler-Instanz initiieren, anstatt einen dedizierten Agenten in Ihrem Rechenzentrum oder Ihrer Public Cloud zu installieren. Der integrierte Agent ermöglicht die Kommunikation zwischen der Instanz und der NetScaler Console.

Hinweis:

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

  • NetScaler MPX
  • NetScaler VPX
  • NetScaler SDX
  • NetScaler Gateway

Der integrierte Agent ist ideal für kleinere NetScaler-Bereitstellungen als Standalone- oder HA-Paar. Wenn Sie mehrere NetScaler-Instanzen haben, verwenden Sie einen dedizierten Agenten für die Bereitstellungen. Dieser Agent gewährleistet bessere Datenaggregationsfunktionen als der integrierte Agent. Weitere Informationen finden Sie unter Installieren eines Agenten vor Ort.

NetScaler Console unterstützt die Verwaltung und Überwachung von NetScaler-Instanzen mithilfe integrierter Agenten. Die folgenden Funktionen werden jedoch im integrierten Agenten nicht unterstützt:

  • Anwendungs-Dashboard
  • Web Insight
  • SSL Insight
  • HDX Insight
  • Gateway Insight
  • Security Insight
  • Erweiterte Analysen
  • Gepoolte/flexible Lizenzierung

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

Voraussetzungen

Bevor Sie einen integrierten Agenten auf der NetScaler-Instanz konfigurieren, stellen Sie Folgendes sicher:

  • Die NetScaler-Instanz (MPX, VPX oder Gateway) muss Version 12.1.48.13 oder höher ausführen. Die SDX-Instanz muss Version 13.0.61.x oder höher ausführen.

  • Ein DNS-Nameserver ist auf der NetScaler-Instanz hinzugefügt.

    Weitere Informationen finden Sie unter Hinzufügen eines Nameservers.

  • Sie haben ein Citrix Cloud-Konto. Weitere Informationen finden Sie unter Registrieren für Citrix Cloud.

Hinweis:

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

Konfigurieren des integrierten Agenten

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

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

  2. Kopieren Sie die Dienst-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.

  3. Initiieren Sie den integrierten Agenten mithilfe eines SSH-Clients. Gateway-Benutzer müssen diesen Schritt überspringen.

    1. Melden Sie sich bei Ihrer NetScaler-Instanz an. Weitere Informationen finden Sie unter Zugriff auf einen NetScaler.

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

      Auf der SDX-Instanz

      Registrierung mit NetScaler-Profil Registrierung ohne NetScaler-Profil
        Voraussetzung Erstellen Sie vor der Registrierung ein NetScaler-Profil. Weitere Informationen finden Sie unter Erstellen eines NetScaler-Profils.
        Führen Sie diesen Befehl aus ./mastools_init.sh <device-profile-name> <service-url> <activation-code> -sdx -profile ./mastools_init.sh <user_name> <service-url> <activation-code> -sdx
        Benutzeranmeldeinformationen Geben Sie nsroot in <device_profile_name> ein. Alternativ können Sie einen Benutzernamen mit denselben Zugriffsrechten wie nsroot verwenden. Geben Sie nsroot in <user_name> ein. Alternativ können Sie einen Benutzernamen mit denselben Zugriffsrechten wie nsroot verwenden.

      Hinweis:

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

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

      Wenn die NetScaler-Image-Version 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 lautet, ist es das erste Mal.

      Geben Sie je nach Softwareversion einen der folgenden Befehle ein.

      Hinweis:

      Bevor Sie sich mit einem NetScaler-Profil registrieren, müssen Sie das Profil erstellen. Weitere Informationen finden Sie unter Erstellen eines NetScaler-Profils.

      NetScaler-Image-Version Ist mastools_version 0.0-0.0? Befehl zur Registrierung mit Profil Befehl zur Registrierung ohne Profil
      Niedriger als 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>"
      Niedriger als 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>

    Hinweis:

    • Geben Sie in <device_profile_name> oder <user_name> nsroot ein. Alternativ können Sie einen Benutzernamen mit denselben Zugriffsrechten wie nsroot verwenden.
    • Führen Sie in einem HA-Paar die Registrierung auf dem primären Knoten durch. Wenn Sie die Registrierungsbefehle 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 NetScaler Console-Seite zurück und klicken Sie auf Instanz registrieren.

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

  6. Klicken Sie auf Fertig.

Nach erfolgreicher Konfiguration des integrierten Agenten können Sie auf die Funktionen der NetScaler Console zugreifen, wie zum Beispiel:

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

  • Anwendungs-Dashboard – Um alle Anwendungen ganzheitlich anzuzeigen. Weitere Informationen finden Sie unter Anwendungsverwaltung und Dashboard.

  • Infrastrukturanalysen – Diese Funktion hilft Ihnen, die Faktoren zu visualisieren, die zu einem Problem auf den Instanzen geführt haben oder führen könnten. Weitere Informationen finden Sie unter Infrastrukturanalysen.

Lizenzserver über den integrierten NetScaler-Agenten konfigurieren

Hinweis:

Dem integrierten NetScaler-Agenten kann die LSA-Rolle nicht zugewiesen werden.

Wenn Sie einen Lizenzserver-Agenten (LSA) an einem Standort konfiguriert haben und denselben LSA von anderen Standorten aus verwenden möchten, können Sie einen integrierten NetScaler-Agenten verwenden. Bei der Verwendung des integrierten Agenten müssen Sie den Lizenzserver mit dem folgenden Befehl auf der NetScaler-Instanz konfigurieren.

add licenseserver 127.0.0.1 -port 27000

In dieser Konfiguration kann NetScaler den Lizenzserver-Agenten (LSA) über den Konsolendienst erreichen.

Hinweis:

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

Nachdem der integrierte Agent initiiert wurde, navigieren Sie zu Infrastruktur > Instanzen > NetScaler. Diese Seite zeigt die Details zur verwalteten Instanz an, die mithilfe des integrierten Agenten erkannt wurde.

Fehlerbehebung

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

  • Wenn die Registrierung fehlschlägt, überprüfen Sie die Protokolle unter /var/mastools/logs/mastools_reg.py.log
  • Wenn die Registrierung erfolgreich ist, der integrierte Agent jedoch nicht in der NetScaler Console-GUI angezeigt wird, überprüfen Sie:
    • Mastools_upgrade-Protokolle unter /var/mastools/logs/mastools_upgrade.log
    • Binäre Protokolle unter /var/log/mastoolsd.log.
Konfigurieren des integrierten Agenten zur Instanzverwaltung