-
-
Citrix ADM on Kubernetes cluster
-
Migrate Citrix ADM single-server deployment to a high availability deployment
-
-
-
-
Importing and synchronizing StyleBooks from GitHub repository
-
Simplified migration of Citrix ADC application configuration using StyleBooks
-
-
Use ADM log messages for managing and monitoring your infrastructure
-
-
Citrix ADC automation using Citrix ADM in Cisco ACI hybrid mode
-
Citrix ADC device package in Cisco ACI's cloud orchestrator mode
-
This content has been machine translated dynamically.
Dieser Inhalt ist eine maschinelle Übersetzung, die dynamisch erstellt wurde. (Haftungsausschluss)
Cet article a été traduit automatiquement de manière dynamique. (Clause de non responsabilité)
Este artículo lo ha traducido una máquina de forma dinámica. (Aviso legal)
此内容已经过机器动态翻译。 放弃
このコンテンツは動的に機械翻訳されています。免責事項
이 콘텐츠는 동적으로 기계 번역되었습니다. 책임 부인
Este texto foi traduzido automaticamente. (Aviso legal)
Questo contenuto è stato tradotto dinamicamente con traduzione automatica.(Esclusione di responsabilità))
This article has been machine translated.
Dieser Artikel wurde maschinell übersetzt. (Haftungsausschluss)
Ce article a été traduit automatiquement. (Clause de non responsabilité)
Este artículo ha sido traducido automáticamente. (Aviso legal)
この記事は機械翻訳されています.免責事項
이 기사는 기계 번역되었습니다.책임 부인
Este artigo foi traduzido automaticamente.(Aviso legal)
这篇文章已经过机器翻译.放弃
Questo articolo è stato tradotto automaticamente.(Esclusione di responsabilità))
Translation failed!
Citrix ADM on Kubernetes cluster
Before you install Citrix ADM virtual appliances on a Kubernetes cluster, read the prerequisites section.
Prerequisites
Ensure the following prerequisites are met before you install ADM.
Kubernetes cluster
-
The Kubernetes cluster must be of the following version or above:
- Server version v1.13
- Client version v1.13
Type the command
kubectl version
to check the version. - The Helm application installed on the cluster must be of the following version or above.
- Server version v2.12.1
- Client version v2.12.0
Use the command
helm version
to check the version. -
Kubernetes cluster CNI (Container Network Interface) must be Calico version v3.1.3 or above.
- All the subordinate nodes in the cluster must have an NFS client installed on them. This is because the ADM application persists the data and configuration on volumes mounted on a Network File Server. To install an NFS client on an Ubuntu-based subordinate, type the following commands:
apt-get update
apt install nfs-common
- The ADM application needs 32 GB memory and 8 vCPUs across the cluster and 120 GB space on NFS.
NFS share
The ADM application needs persistent volumes to store data such as configuration, certificates, images, and others. For this purpose, ADM requires NFS mounts. The application requires two folders from the shared network mounts:
- One for storing files such as certificates, images, and others
- The other one for database
Note
It’s recommended to have an NFS with an SSD.
These two folders can be different or the same. Both the folders must have 777 permissions. The first folder must have minimum 10 GB pace. The second folder’s size depends upon the amount of data that needs to be persistent in the database. Minimum size is 100 GB. For the production environment, we recommend having a production grade NFS solution.
Citrix ADC appliance
The Citrix ADC appliance is required as the ingress device. ADC makes the required application services available outside the Kubernetes cluster. The Citrix ADC appliance must be outside the Kubernetes cluster, and the worker nodes must be reachable from the ADC. Perform the following steps:
-
Configure a SNIP on the ADC. ADC uses this SNIP to reach the worker nodes of the Kubernetes cluster.
-
Identify a free IP address to be used as virtual server IP address to make the required application services available outside the Kubernetes cluster.
Install ADM on Kubernetes cluster
Follow these steps to install an ADM appliance on a Kubernetes cluster:
-
Go to the Citrix Download site and download the file for the Citrix ADM Helm Chart for Kubernetes.
-
Extract the downloaded Helm Chart tarball into the /var directory of the main node of the Kubernetes cluster.
-
Open the
values.yaml
file under the/var/citrixadm
directory. -
Enter a password for the database in the
dbpasswd
field in the file. -
Change the following values. The ADM application uses these values to configure the Citrix ADC appliance so that the services are exposed to the external world:
-
ingressIP
: a Virtual IP configured in the Citrix ADC for accessing the application. -
applicationID
: a unique ID to distinguish the ingress configuration from the rest of the configuration on the Citrix ADC appliance. -
ingressADCIP
: Citrix ADC IP address (NSIP), which is used as an ingress for the ADM application. -
ingressADCUsername
: a user name to access the Citrix ADC appliance. This user must have write privileges. -
ingressADCPassword
: Password for the user name.
-
- Change the following values in the storage section. These values specify the persistence required to store files required by the ADM application.
-
nfsServer
: Host name or IP address of the NFS server -
path
: mount the path for the folder to store application files. -
size
: at least 10 GB.
Note
The unit for this value is Gi. For example, 10Gi, 20Gi.
-
- Go to storage section under
pg-datastore
and change the following values. These values specify the persistence used for creating a database.-
nsfServer
: Host name or IP address of the NFS server. -
size
: mount a path for the folder used for the datastore. -
path
: at least 100 GB.
Note
The unit for this value is Gi. For example, 100Gi, 200Gi.
-
-
Go to the /var/citrix directory in the main node and run the following command to install an ADM application:
helm install -n citrixadm --namespace <name> ./citrixadm
Note
This helm command is not supported in helm version 3.x.
This command also installs the required pods in your cluster. Namespace argument is optional. If namespace is not provided, Helm installs ADM in the default namespace. For ease of management, install ADM under a separate namespace.
- Open your browser and type
http://< virtual server IP address >
and log in to the ADM usingnsroot/nsroot
as credentials. For secure access typehttps://< virtual server IP address >
.
Note
During deployment, the ADM application creates tables in the datastore, which can take a while. Depending upon the resources allocated by Kubernetes to various pods of the ADM application, it can take 5- 15 mins for the service to come up.
Share
Share
In this article
This Preview product documentation is Cloud Software Group Confidential.
You agree to hold this documentation confidential pursuant to the terms of your Cloud Software Group Beta/Tech Preview Agreement.
The development, release and timing of any features or functionality described in the Preview documentation remains at our sole discretion and are subject to change without notice or consultation.
The documentation is for informational purposes only and is not a commitment, promise or legal obligation to deliver any material, code or functionality and should not be relied upon in making Cloud Software Group product purchase decisions.
If you do not agree, select I DO NOT AGREE to exit.