Hinzufügen von NetScaler CPX-Instanzen zu NetScaler ADM

Sie müssen die auf einem Docker-Host installierten NetScaler CPX-Instanzen zur NetScaler Application Delivery Management (ADM)-Software hinzufügen, wenn Sie diese Instanzen verwalten und überwachen möchten.

Sie können Instanzen entweder bei der erstmaligen Einrichtung von ADM oder später hinzufügen.

Um Instanzen hinzuzufügen, müssen Sie ein Instanzprofil erstellen und entweder den Hostnamen oder die IP-Adresse jeder Instanz oder einen Bereich von IP-Adressen angeben. Dieses Instanzprofil enthält den Benutzernamen und das Kennwort der Instanzen, die Sie zu NetScaler ADM hinzufügen möchten. Für jeden Instanztyp ist ein Standardprofil verfügbar. Zum Beispiel ist ns-root-profile das Standardprofil für NetScaler-Instanzen. Dieses Profil wird durch die Standard-Administratoranmeldeinformationen des ADC definiert. Wenn Sie die Standard-Administratoranmeldeinformationen Ihrer Instanzen geändert haben, können Sie benutzerdefinierte Instanzprofile für diese Instanzen definieren. Wenn Sie die Anmeldeinformationen einer Instanz ändern, nachdem die Instanz erkannt wurde, müssen Sie das Instanzprofil bearbeiten oder ein Profil erstellen und die Instanz dann erneut erkennen.

Voraussetzungen

Stellen Sie sicher, dass Sie Folgendes haben:

• Die NetScaler ADM-Software auf Citrix XenServer installiert haben. Weitere Informationen finden Sie unter NetScaler ADM-Dokumentation.
• Die NetScaler CPX-Instanzen auf einem Docker-Host installiert haben.

So fügen Sie NetScaler CPX-Instanzen zu ADM hinzu:

1. Geben Sie in einem Webbrowser die IP-Adresse von NetScaler Application Delivery Management ein (zum Beispiel http://192.168.100.1)).

2. Geben Sie in den Feldern Benutzername und Kennwort die Administratoranmeldeinformationen ein. Die Standard-Administratoranmeldeinformationen sind nsroot und nsroot.

3. Navigieren Sie zu Netzwerke > Instanzen > NetScaler und klicken Sie auf die Registerkarte CPX.

4. Klicken Sie auf Hinzufügen, um neue CPX-Instanzen in NetScaler ADM hinzuzufügen.

5. Die Seite NetScaler CPX hinzufügen wird geöffnet. Geben Sie die Werte für die folgenden Parameter ein:

   1. Sie können CPX-Instanzen hinzufügen, indem Sie entweder die erreichbare IP-Adresse der CPX-Instanz oder die IP-Adresse des Docker-Containers angeben, auf dem die CPX-Instanz gehostet wird.
   2. Wählen Sie das Profil der CPX-Instanz aus.
   3. Wählen Sie den Standort aus, an dem die Instanzen bereitgestellt werden sollen.
   4. Wählen Sie den Agenten aus.

   5. Optional können Sie das Schlüssel-Wert-Paar für die Instanz eingeben. Das Hinzufügen eines Schlüssel-Wert-Paares erleichtert Ihnen die spätere Suche nach der Instanz.

      

6. Klicken Sie auf OK.

Hinweis

Wenn Sie eine Instanz erneut ermitteln möchten, wählen Sie Netzwerke > Instanzen > NetScaler > CPX, wählen Sie die Instanz aus, die Sie erneut ermitteln möchten, und klicken Sie dann in der Dropdown-Liste Aktion auswählen auf Erneut ermitteln.

Hinzufügen von NetScaler CPX-Instanzen zu NetScaler ADM mithilfe von Umgebungsvariablen

Sie können die NetScaler CPX-Instanzen auch mithilfe von Umgebungsvariablen zu NetScaler ADM hinzufügen. Um Instanzen hinzuzufügen, müssen Sie die folgenden Umgebungsvariablen für die NetScaler CPX-Instanz konfigurieren.

• NS_MGMT_SERVER - ADM IP-Adresse/FQDN
• HOST - Knoten-IP-Adresse
• NS_HTTP_PORT - Zugeordneter HTTP-Port auf dem Knoten
• NS_HTTPS_PORT - Zugeordneter HTTPS-Port auf dem Knoten
• NS_SSH_PORT - Zugeordneter SSH-Port auf dem Knoten
• NS_SNMP_PORT - Zugeordneter SNMP-Port auf dem Knoten
• NS_ROUTABLE - (Die IP-Adresse des NetScaler CPX-Pods ist von außen nicht routingfähig.)
• NS_MGMT_USER – ADM-Benutzername
• NS_MGMT_PASS – ADM-Passwort

Im Folgenden finden Sie ein Beispiel für den docker run-Befehl zum Hinzufügen einer NetScaler CPX-Instanz zu NetScaler ADM.

 docker run -dt --privileged=true -p 9080:9080 -p 9443:9443 -p 9022:22 -p 9161:161 -e EULA=yes -e NS_MGMT_SERVER=abc-mgmt-server.com -e HOST=10.1.1.1 -e NS_HTTP_PORT=9080 -e NS_HTTPS_PORT=9443 -e NS_SSH_PORT=9022 -e NS_SNMP_PORT=9161 -e NS_ROUTABLE=0 --ulimit core=-1 –name test cpx:latest

<!--NeedCopy-->

Hinzufügen von NetScaler CPX-Instanzen zu NetScaler ADM mithilfe von Kubernetes ConfigMaps

NetScaler CPX unterstützt die Registrierung bei NetScaler ADM mithilfe von über Kubernetes ConfigMaps bereitgestellten Dateien. Um diese Art der Registrierung zu ermöglichen, benötigt NetScaler CPX einige Umgebungsvariablen, die zusammen mit einigen über ConfigMaps und Secrets bereitgestellten Dateien angegeben werden müssen.

Im Folgenden sind die erforderlichen Umgebungsvariablen und deren Beschreibung aufgeführt:

• NS_HTTP_PORT - Gibt den zugeordneten HTTP-Port auf dem Knoten an.
• NS_HTTPS_PORT - Gibt den zugeordneten HTTPS-Port auf dem Knoten an.
• NS_SSH_PORT - Gibt den zugeordneten SSH-Port auf dem Knoten an.
• NS_SNMP_PORT- Gibt den zugeordneten SNMP-Port auf dem Knoten an.

Neben den aufgelisteten Umgebungsvariablen benötigt NetScaler CPX Informationen über den ADM-Agenten, bei dem es sich registrieren muss. Diese Informationen umfassen die IP-Adresse oder FQDN-Details und Anmeldeinformationen des ADM-Agenten. NetScaler CPX erhält diese Informationen aus den bereitgestellten Dateien. Eine ConfigMap, die die IP-Adresse oder den FQDN enthält, wird als Datei im Dateisystem der NetScaler CPX-Instanz bereitgestellt. Ein Kubernetes-Secret, das Anmeldeinformationen für den ADM-Agenten enthält, wird ebenfalls als Datei im Dateisystem der NetScaler CPX-Instanz bereitgestellt. Mit allen für die Registrierung erforderlichen Informationen versucht NetScaler CPX, sich beim ADM-Agenten zu registrieren.

Im Folgenden finden Sie ein Beispiel für einen NetScaler CPX YAML-Dateiausschnitt mit der als Dateien bereitgestellten ConfigMap und dem Secret:

      …
      env:
      - name: "EULA"
        value: "yes"
      - name: "NS_HTTP_PORT"
        value: "9080"
      - name: "NS_HTTPS_PORT"
        value: "9443"
      - name: "NS_SSH_PORT"
        value: "22"
      - name: "NS_SNMP_PORT"
        value: "161"
      - name: "KUBERNETES_TASK_ID"
        value: ""
      …
      volumeMounts:
        …
        - mountPath: /var/adminfo/server/
          name: adm-agent-config
        - mountPath: /var/adminfo/credentials/
          name: adm-agent-user
        …
  volumes:
  …
  - name: adm-agent-config
    configMap:
      name: adm-agent-config
  - name: adm-agent-user
    secret:
      secretName: adm-secret

Im vorhergehenden Beispiel werden eine ConfigMap namens adm-agent-config und ein Secret adm-agent-user verwendet. Im Folgenden finden Sie ein Beispiel für die Erstellung der erforderlichen ConfigMap und des Secrets.

ConfigMap: Die ConfigMap wird aus einer Datei namens adm_reg_envs erstellt. Die Datei erfordert die IP-Adresse oder den FQDN des ADM-Agenten im folgenden Format:

NS_MGMT_SERVER=adm-agent

Im obigen Format ist adm-agent der FQDN des ADM-Agenten, bei dem die NetScaler CPX-Instanz registriert werden muss.

Verwenden Sie den folgenden Befehl, um eine ConfigMap zu erstellen:

kubectl create configmap adm-agent-config --from-file=adm_reg_envs

Hinweis: Der Dateiname muss die Variable adm_reg_envs enthalten und muss unter dem Pfad /var/adminfo/server/ gemountet werden.

Secret: Verwenden Sie den folgenden Befehl, um ein Kubernetes-Secret zu erstellen. Im folgenden Befehl ist user123 der Benutzername des ADM-Agenten und pass123 das Passwort.

kubectl create secret generic adm-secret --from-literal=NS_MGMT_USER=user123 --from-literal=NS_MGMT_PASS=pass123

Eine NetScaler CPX-Instanz kann in einem Kubernetes-Cluster mit den erforderlichen Umgebungsvariablen und gemounteten Volumes bereitgestellt werden, noch bevor der ADM-Agent im Cluster bereitgestellt wird. Wenn Sie eine NetScaler CPX-Instanz vor der Bereitstellung des ADM-Agenten bereitstellen, versucht NetScaler CPX weiterhin, sich zu registrieren, bis der ADM-Agent bereitgestellt ist. Sobald der ADM-Agent bereitgestellt ist, verwendet die NetScaler CPX-Instanz die über die Umgebungsvariablen und gemounteten Volumes bereitgestellten Konfigurationsdaten, um sich beim ADM-Agenten zu registrieren. Dies hilft Ihnen, die erneute Bereitstellung von NetScaler CPX mit den Konfigurationsinformationen zu vermeiden.

Eine NetScaler CPX-Instanz, die bereits bei einem ADM-Agenten registriert ist, kann die Registrierung nach einer Konfigurationsänderung dynamisch auf einen anderen ADM-Agenten ändern. Dazu können Sie die Konfigurationsinformationen in der ConfigMap und dem Secret für die bereits bereitgestellte NetScaler CPX aktualisieren. Sie müssen die Datei, aus der die ConfigMap erstellt wird, mit der IP-Adresse oder dem FQDN des neuen ADM-Agenten aktualisieren und die alte ConfigMap löschen, um dann eine neue ConfigMap zu erstellen. Ebenso muss das vorhandene Secret gelöscht und ein neues Secret mit den Anmeldeinformationen für den neuen ADM-Agenten erstellt werden.