Deploy a Citrix ADC BLX appliance

Deploying a Citrix ADC BLX appliance on a Linux host consists of first downloading and installing the Citrix ADC BLX appliance. Then, the installed Citrix ADC BLX appliance can be deployed either with or without DPDK support. A Citrix ADC BLX appliance can be configured in either shared or dedicated network mode. A Citrix ADC BLX appliance with DPDK support can be configured only in dedicated mode.

Before you Begin

Before you start deploying a Citrix ADC BLX appliance on a Linux host, the following table lists the pre-requisites and consideration points:

Category Citrix ADC BLX appliance Citrix ADC 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.
’’ ’’ Citrix ADC 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 Citrix ADC BLX appliance in DPDK mode, see Citrix ADC 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: rpm -ivh epel-release-latest-7.noarch.rpm. For more information about installing the EPEL repository, see EPEL. Run the following command on the Linux shell to install the package: rpm -ivh epel-release-latest-7.noarch.rpm. For more information about installing the EPEL repository, see EPEL.

Note:

  • A Citrix ADC 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:

    • SELinux policy is enabled on the Linux host. SELinux prevents the systemd process from running some Citrix ADC BLX system files.

    Workaround: Disable SELinux on the Linux host.

  • A Citrix ADC BLX appliance supports a maximum of nine NIC ports (DPDK NIC ports, or non-DPDK NIC ports, or both).

Download a Citrix ADC BLX installation package on the Linux host

Citrix ADC BLX installation packages are hosted on the official Citrix ADC BLX downloads page. A Citrix ADC BLX installation package bundles Citrix ADC feature packages including a package with DPDK support. A Citrix ADC BLX installation package is a TAR file and has the following name format:

blx-<release number>-<build-number>.tgz

Example:

blx-13.0-41.20.tgz

To download a Citrix ADC BLX installation package:

  1. Access the official Citrix ADC BLX downloads page.

  2. Navigate to the desired Citrix ADC Release > Citrix ADC BLX image build page.

  3. Download the Citrix ADC BLX installation package to the Linux host.

Install a Citrix ADC BLX appliance on the Linux host

To install a Citrix ADC BLX appliance on the Linux host:

  1. Untar the Citrix ADC BLX installation package and then change the working directory to the extracted Citrix ADC BLX installation directory:

    tar -xvf blx-<release number>-<build-number>.tgz
    
    cd <path to the extracted Citrix ADC BLX installation directory>
    <!--NeedCopy-->
    

    Sample output:

    The following sample output shows that a Citrix ADC BLX installation package blx-13.0-41.20.tgz, which is already downloaded to the /var/blxinstall directory of a Linux host, is untared. Then, the working directory is changed to the extracted directory blx-13.0-41.20.

    > 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-->
    
  2. Install a Citrix ADC 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-->
      

    Note:

    By default, the Citrix ADC BLX appliance is in Down state.

  3. Check the status of Citrix ADC BLX appliance by running the following command:

    systemctl status blx
    <!--NeedCopy-->
    
Deploy a Citrix ADC BLX appliance