Deploy a NetScaler BLX appliance
Deploying a NetScaler BLX appliance on a Linux host consists of first downloading and installing the NetScaler BLX appliance. Then, the installed NetScaler BLX appliance can be deployed either with or without DPDK support. A NetScaler BLX appliance can be configured in either shared or dedicated network mode. A NetScaler BLX appliance with DPDK support can be configured only in dedicated mode.
Before you Begin
Before you start deploying a NetScaler BLX appliance on a Linux host, the following table lists the pre-requisites and consideration points:
|Category||NetScaler BLX appliance||NetScaler BLX appliance with DPDK support|
|Supported Linux operating system||CentOS Release 7.5 or later||CentOS Release 7.5 or later|
|’’||Oracle Linux Release 7.4 or later||Oracle Linux Release 7.4 or later|
|’’||Ubuntu release 18.04 and Ubuntu release 20.04||Ubuntu release 18.04 and Ubuntu release 20.04|
|’’||Linux on Oracle Cloud Infrastructure (OCI)||-|
|Processor type on the Unix host||Intel or AMD x86-64 (64-bit) processor||Intel x86-64 (64-bit) processor|
|Minimum RAM on the Linux Host||2 GB RAM||See the next row DPDK related requirements and information.|
|DPDK related requirement and Information||NA||The Linux host must meet the minimum system requirements for installing DPDK. For more information about the minimum requirements, see the Official DPDK Documentation.|
|’’||’’||NetScaler BLX appliance supports only the following DPDK version: DPDK 17.11.10 (LTS).|
|’’||’’||The Linux host must have a minimum of 64 hugepages of size of 2 MB each. Citrix recommends that you configure at least 1024 hugepages of size of 2 MB each for better performance.|
|’’||’’||For a list of limitations related to a NetScaler BLX appliance in DPDK mode, see NetScaler BLX limitations and usage guidelines.|
|Install Extra Packages for Enterprise Linux (EPEL) repository applicable for Redhat based Linux systems||Run the following command on the Linux shell to install the package:
||Run the following command on the Linux shell to install the package:
A NetScaler BLX appliance deployed on CentOS Linux version 8.0 host or Oracle Linux version 8.0 host might not start or function properly if the following condition is met:
SELinuxpolicy is enabled on the Linux host. SELinux prevents the
systemdprocess from running some NetScaler BLX system files.
SELinuxon the Linux host.
A NetScaler BLX appliance supports a maximum of nine NIC ports (DPDK NIC ports, or non-DPDK NIC ports, or both).
Download a NetScaler BLX installation package on the Linux host
NetScaler BLX installation packages are hosted on the official NetScaler BLX downloads page. A NetScaler BLX installation package bundles Citrix ADC feature packages including a package with DPDK support. A NetScaler BLX installation package is a TAR file and has the following name format:
To download a NetScaler BLX installation package:
Access the official NetScaler BLX downloads page.
Navigate to the desired Citrix ADC Release > NetScaler BLX image build page.
Download the NetScaler BLX installation package to the Linux host.
Install a NetScaler BLX appliance on the Linux host
To install a NetScaler BLX appliance on the Linux host:
Untar the NetScaler BLX installation package and then change the working directory to the extracted NetScaler BLX installation directory:
tar -xvf blx-<release number>-<build-number>.tgz cd <path to the extracted NetScaler BLX installation directory> <!--NeedCopy-->
The following sample output shows that a NetScaler BLX installation package
blx-13.0-41.20.tgz, which is already downloaded to the
/var/blxinstalldirectory of a Linux host, is untared. Then, the working directory is changed to the extracted directory
> cd /var/blxinstall > tar -xvf blx-13.0-41.20.tgz > cd blx-13.0-41.20 > pwd /var/blxinstall/blx-13.0-41.20 <!--NeedCopy-->
Install a NetScaler BLX appliance on a Red Hat enterprise Linux (RHEL) host or Debian based Linux host.
Run the following command on a Red Hat enterprise Linux (RHEL) host:
yum install ./blx*.rpm <!--NeedCopy-->
Run the following command on a Debian based Linux host:
apt install ./blx*.deb <!--NeedCopy-->
By default, the NetScaler BLX appliance is in Down state.
Check the status of NetScaler BLX appliance by running the following command:
systemctl status blx <!--NeedCopy-->