Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Last revision Both sides next revision
litespeed_wiki:lslb:zconfsetup [2019/05/22 19:06]
Kacey Schroeder [cPanel ZConf Setup]
litespeed_wiki:lslb:zconfsetup [2019/08/21 14:27]
Kevin Fwu
Line 17: Line 17:
     * One Mode     * One Mode
     * One Strategy ​     * One Strategy ​
-  - No need to setup all the end points in Worker Group +  - No need to set up all the end points in Worker Group 
-  - No need to setup Virtual Hosts and Cluster mapping+  - No need to set up Virtual Hosts and Cluster mapping
  
 If you want to design a multi cluster with a different strategy, then you may want to setup manually instead of using ZeroConf settings. If you want to design a multi cluster with a different strategy, then you may want to setup manually instead of using ZeroConf settings.
  
-====ZeroConf ​plugin ​==== +====ZeroConf ​Plugin ​==== 
-The initial run time may be up to mins. (e.g. create an account(Domain) on cPanel, then you will see it sync to the ADC within ​mins.) +NOTE: Automatic sync takes minutes to complete. (e.g. create an account(Domain) on cPanel, then you will see it sync to the ADC in minutes.) It takes 5 minutes because the process pauses, giving the Apache configurations time to completely update before the changes are pushed. (We have found that the PkgAcct::​Restore account action took the longest time to update.)
 ===== ADC ZeroConf Setup ===== ===== ADC ZeroConf Setup =====
 ==== Listeners ==== ==== Listeners ====
   * Navigate to **ADC WebAdmin Console > Configuration > Listeners**   * Navigate to **ADC WebAdmin Console > Configuration > Listeners**
-  * Setup both HTTP/HTTPS with **Enable Zero Config** to ''​Yes''​+  * Set up both HTTP/HTTPS with **Enable Zero Config** to ''​Yes''​
   * Please do set SSL certificates for HTTPS listener, such as ''​443'',​ either certificates from CA or Self-signed ​   * Please do set SSL certificates for HTTPS listener, such as ''​443'',​ either certificates from CA or Self-signed ​
 ==== ADC Password Setup ==== ==== ADC Password Setup ====
Line 71: Line 70:
 ===== cPanel ZeroConf Setup ===== ===== cPanel ZeroConf Setup =====
 ==== cPanel ZeroConf Plugin Install ==== ==== cPanel ZeroConf Plugin Install ====
-  * Download plugin file from http://​www.litespeedtech.com/​packages/cpanel/whm_webadc_zconf.zip+  * Download plugin file from https://​www.litespeedtech.com/​products/litespeed-web-adc/download
   * Run the following command to install plugin: <​code>​   * Run the following command to install plugin: <​code>​
 unzip whm_lsadc_zconf.zip ​ unzip whm_lsadc_zconf.zip ​
Line 77: Line 76:
 ./​install.sh ./​install.sh
 </​code>​ </​code>​
-  * Login to WHM and search zconf \\ {{:​litespeed_wiki:​lslb:​zconf-1.png?|}} \\+  * Login to WHM and search zconf \\ {{:​litespeed_wiki:​lslb:​screenshot_173.png?|}} \\
  
 ==== ZeroConf Password Setup ==== ==== ZeroConf Password Setup ====
Line 86: Line 85:
 The first ''​zero''​ is the account and the second is the password. These should match the credentials used to generate the .htpasswd for the ADC. The first ''​zero''​ is the account and the second is the password. These should match the credentials used to generate the .htpasswd for the ADC.
  
-==== cPanel ​ZConf Setup ====+==== cPanel ​ZeroConf ​Setup ====
   * Navigate to **WHM > LSADC ZConf Manager** from the Plugins section   * Navigate to **WHM > LSADC ZConf Manager** from the Plugins section
-  * Click **Configurations** \\ {{:​litespeed_wiki:​lslb:​zconf-11.png?​|}} ​+  * Click **Configurations** \\ {{:​litespeed_wiki:​lslb:​screenshot_178.png?​|}} ​
   * Setup **Server Conf Name** ,e.g. ''​cpanel-153''​   * Setup **Server Conf Name** ,e.g. ''​cpanel-153''​
   * Setup **ADC Basic Auth** ,e.g. ''/​PATH_YOU_WANT/​.zconfpasswd''​   * Setup **ADC Basic Auth** ,e.g. ''/​PATH_YOU_WANT/​.zconfpasswd''​
   * Setup **ADC List** ,e.g. ''​10.10.40.150:​55688''​   * Setup **ADC List** ,e.g. ''​10.10.40.150:​55688''​
-  * Setup **Exclude Users(optional)**,​ e.g. ''​testaccount''​ \\ {{:​litespeed_wiki:​lslb:​zconfconfig.png?700|}}\\+  * Setup **Exclude Users(optional)**,​ e.g. ''​testaccount''​ \\ {{:​litespeed_wiki:​lslb:​screenshot_175.png?800|}}\\
   * 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.//​   * 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 ==== ==== 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. +The first time we set up ZeroConf, we may want to try it manually to see if it works as we expect. 
-  * Click **Generate ZConf** to generate ​ZConf Message Files \\ {{:​litespeed_wiki:​lslb:​zconf-3.png?|}} +  * Click **Generate ZConf** to generate ​ZeroConf ​Message Files \\ {{:​litespeed_wiki:​lslb:​screenshot_176.png?|}} 
-  * Click **Send Server Confs ** to send Server with config files \\ {{:​litespeed_wiki:​lslb:​zconf-4.png?|}}+  * Click **Send Server Confs ** to send Server with config files \\ {{:​litespeed_wiki:​lslb:​screenshot_177.png?|}}
  
  
 ==== Firewall Configuration ==== ==== 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). \\+If you set up ZeroConf ​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**: ​ \\  For example, CentOS 7 firewall setup port **55688**: ​ \\ 
 <​code>​ <​code>​
Line 108: Line 107:
 firewall-cmd --reload firewall-cmd --reload
 </​code>​ </​code>​
-====== How to verify ​ZConf is working ======+====== How to verify ​ZeroConf ​is working ======
 ==== Experiment environment==== ==== Experiment environment====
   * ADC IP: ''​10.10.40.150''​   * ADC IP: ''​10.10.40.150''​
Line 118: Line 117:
   * Open ''<​nowiki>​http://​c7-20.ls.com/​wordpress/</​nowiki>''​   * Open ''<​nowiki>​http://​c7-20.ls.com/​wordpress/</​nowiki>''​
   * Check response headers IP is ''​10.10.40.150''​ by Developer Tools   * Check response headers IP is ''​10.10.40.150''​ by Developer Tools
-We can see IP is ADC's instead of web server(cPanel)'​s,​ it means ZConf is working normally.+We can see IP is ADC's instead of web server(cPanel)'​s,​ it means ZeroConf ​is working normally.
  
 =====What if I Have Multi Servers? ===== =====What if I Have Multi Servers? =====
 ====Multi-ADC ==== ====Multi-ADC ====
-If I have two Web-ADCs, simply add multi ADC IPs ''​10.10.40.150:​55688,​ 10.10.40.151:​55688''​ into ADC List of ZConf Manager plugin ​+If I have two Web ADCs, simply add multi ADC IPs ''​10.10.40.150:​55688,​ 10.10.40.151:​55688''​ into ADC List of ZeroConf ​Manager plugin ​
 ====Multi-cPanel==== ====Multi-cPanel====
 If I have two cPanels, simply follow ''​cPanel ZConf setup''​ with a different Server Conf Name If I have two cPanels, simply follow ''​cPanel ZConf setup''​ with a different Server Conf Name
Line 134: Line 133:
     * Configuration file not complete     * Configuration file not complete
   * ''​Server conf files not generated yet.''​   * ''​Server conf files not generated yet.''​
-    * ZConf file not generated yet+    * ZeroConf ​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.''​   * ''​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+    * ADC ZeroConf ​listener set up incorrectly
     * Firewall issue     * Firewall issue
  
  • Admin
  • Last modified: 2020/11/18 15:36
  • by Lisa Clarke