Deploy a BLX appliance

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

Before you Begin

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

Note:

• A 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 BLX system files.

  Workaround: Disable SELinux on the Linux host.

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

Download a BLX installation package on the Linux host

BLX installation packages are hosted on the official BLX downloads page. A BLX installation package bundles Citrix ADC feature packages including a package with DPDK support. A 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 BLX installation package:

1. Access the official BLX downloads page.

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

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

Install a BLX appliance on the Linux host

To install a BLX appliance on the Linux host:

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

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

   Sample output:

   The following sample output shows that a 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 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 BLX appliance is in Down state.

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

   systemctl status blx
   <!--NeedCopy-->