How to Set Up ZConf Between LiteSpeed Web ADC and cPanel

Benefits of Setting up ZConf

We noticed it's a little complicated to setup ADC + Web Server, needing to modify Cluster and Domain every time when adding a new site or modifying any domain. ZConf enables automatic configuration updates to simplify the process of setting up the ADC and Web Server:

Simplifies configuration for those with many sites and/or servers that wish to have a single front end node

ZConf password Setup

Run the following command to generate the .htpasswd file from console:

echo 'zero:zero' > /PATH_YOU_WANT/.htpasswd

The first zero is the account and the second is the password. You can change them to whatever you want.

cPanel ZConf Setup

Navigate to WHM > LSADC ZConf Manager from the Plugins section

Click Configurations

Setup Server Conf Name ,e.g. cpanel-153

Setup ADC Basic Auth ,e.g. /PATH_YOU_WANT/.htpasswd

Setup ADC List ,e.g. 10.10.40.150:55688

Setup Exclude Users(optional), e.g. testaccount

After configuring the settings, we can navigate back to upper level by clicking back to LSADC ZConf Manager button * The Server Conf Name is the conf name used by the ADC to identify this backend server. This should be unique to this server. If another backend server uses the same conf name, the old conf will be overridden.

Manually Send Server Confs

The first time we set up ZConf, we may want to try it manually to see if it works as we expect.

Click Generate ZConf to generate ZConf Message Files

Click Send Server Confs to send Server with config files

Firewall Configuration

If you set up ZConf to listen on port 55688, then you need to confirm the firewall allows TCP 55688 on both ADC and WebServer(cPanel).
For example, CentOS 7 firewall setup port 55688:

Warning Message

Required configurations are not set.

Configuration file not complete

Server conf files not generated yet.

ZConf file not generated yet

Failed to send command ZCUP to ADC_IP:PORT. This could be because the ADC is not configured to listen on that port. This could also be an issue related to iptables configurations on the server. To test, please make sure that a basic curl command from the server to the ADC works. If the curl test returns that it couldn't connect to host, there is an issue.

ADC ZConf listener set up incorrectly

Firewall issue

Failed to send command ZCUP to ADC_IP:PORT, auth parameters did not work.