Differences

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

Link to this comparison view

Both sides previous revision Previous revision
litespeed_wiki:directadmin:custombuild-installation [2020/04/28 13:02]
Jackson Zhang 		litespeed_wiki:directadmin:custombuild-installation [2025/06/03 18:01] (current)
Lisa Clarke Redirect to new Documentation Site
Line 1: Line 1:
-====== Installing LiteSpeed Web Server with CustomBuild 2.0 ====== +~~REDIRECT>​https://docs.litespeedtech.com/lsws/​installation/​~~
- +
-Starting with CustomBuild 2.0 RC7, [[http://forum.directadmin.com/showthread.php?​t=44743|DirectAdmin'​s CustomBuild 2.0]] supports integration with LiteSpeed Web Server. This wiki will guide you through the steps for installing LSWS on a server using DirectAdmin with CustomBuild 2.0. +
- +
-This wiki assumes that you already have a working server using DirectAdmin (version 1.45.2 and up), CustomBuild 2.0, and Apache. +
- +
-===== Using the Command Line ===== +
- +
-Using the command line, LSWS can be installed with the following commands: +
- +
-  cd /usr/​local/​directadmin/​custombuild +
-  ./build update +
-  ./build set webserver litespeed +
-  ./build set php1_mode lsphp +
-  ./build set php2_mode lsphp +
-  ./build set php3_mode lsphp +
-  ./build set php4_mode lsphp +
-  ./build litespeed +
-  ./build php n +
- +
-The commands above install LSWS with a trial license and build PHP for LSWS. +
- +
-Now that LSWS is installed, follow the steps in the [[litespeed_wiki:​licenses:​activating-a-license|wiki on activating licenses]] to switch from the trial license to a purchased license. +
- +
-**Notes:​** +
-  * CustomBuild 2.0 will always install the latest version of LSWS. +
-  * If you have an existing ​installation ​of LSWS, you will still need to run the above commands in order to see LSWS in CustomBuild and DirectAdmin'​s Service Manager. +
-  * If you do not have an existing installation of LSWS, CustomBuild will assign you a username and password for the LSWS WebAdmin console. The username is ''​admin'',​ the password will be randomly generated. The password appears at the end of the installation:​ +
- +
-{{litespeed_wiki:​directadmin:​custombuild_admin_password.png?​700}} +
- +
-===== Through the CustomBuild Plugin ===== +
- +
-The [[http://​forum.directadmin.com/​showthread.php?​t=48989|CustomBuild Plugin]] is a GUI addition to CustomBuild. Use the following steps to install LSWS through the CustomBuild Plugin: +
- +
-==== 1. Edit Options ==== +
- +
-In the ''​Edit Options''​ tab, change the ''​php1_mode''​ setting to ''​lsphp''​. +
- +
-{{litespeed_wiki:​directadmin:​custombuild_edit_php.png?​700}} +
- +
-Then change the ''​webserver''​ setting to ''​litespeed''​. +
- +
-{{litespeed_wiki:​directadmin:​custombuild_edit_webserver.png?​700}} +
-  +
-Save your settings by clicking the ''​Save''​ button at the bottom of the page. +
- +
-==== 2. Build Software ==== +
- +
-Go to the ''​Build Software''​ tab. First, build LSWS. +
- +
-{{litespeed_wiki:​directadmin:​custombuild_build_litespeed.png?​700}} +
- +
-**Note:** If you do not have an existing installation of LSWS, CustomBuild will assign you a username and password for the LSWS WebAdmin console. The username is ''​admin'',​ the password will be randomly generated. The password appears at the end of the installation:​ +
- +
-{{litespeed_wiki:​directadmin:​custombuild_admin_password.png?​700}} +
- +
-Then build PHP. +
- +
-{{litespeed_wiki:​directadmin:​custombuild_build_php.png?​700}} +
- +
-==== 3. Check that LSWS is running ==== +
- +
-You can then go into DirectAdmin'​s Service Manager to check that LSWS is running. +
- +
-{{litespeed_wiki:​directadmin:​custombuild_check_lsws.png?​700}} +
- +
-**Notes:​** +
-  * CustomBuild 2.0 will always install the latest version of LSWS. +
-  * If you have an existing installation of LSWS, you will still need to follow the steps above in order to see LSWS in CustomBuild and DirectAdmin'​s Service Manager. +
- +
-===== Using the LiteSpeed DirectAdmin Plugin with CustomBuild Integration ===== +
- +
-Now that CustomBuild 2.0 has LSWS integration,​ [[litespeed_wiki:​directadmin:​custombuild-with-litespeed-plugin|some of the LiteSpeed DirectAdmin Plugin'​s functions are now redundant]]. We will be updating the Plugin to include only functionality not covered by CustomBuild 2.0. +
- +
-====== Switching between Apache and LiteSpeed ====== +
- +
-CustomBuild does not provide a hot switch between web servers. Each time you switch servers, you will need to recompile PHP again. You can run a series of commands through CustomBuild 2.0 to make this happen or you can run the following script to switch web servers and recompile PHP. +
- +
-  /​usr/​local/​lsws/​admin/​misc/​cp_switch_ws.sh lsws(or apache) +
- +
-DirectAdmin will be adding a hot switch feature in the near future. +
- +
-====== Setup Multi PHP version ====== +
-For Custombuild2 PHP1_release=5.6,​ PHP2_release=7.1 as example. \\ +
-Login as user level -> click domain settings and you will see: \\ +
-{{:​litespeed_wiki:​directadmin:​da-4.png?​600|}} \\ +
-Note:  +
-  - Before setup multi PHP version, please make sure PHP handler setup already. +
-  - May need to restart web server to make settings effect +
- +
- +
-====== Setup CloudLinux Selector PHP version ====== +
-  - From CageFS User Manager add user as Enabled user +
-  - LVE Manager set Default php version to **Native** +
-  - Login as user level -> Choose **Select PHP version** to the version you want.  +
-====Verify method====  +
-''​su - USER_ACCOUNT -s /​bin/​bash''​ \\ +
-''​php -v''​ \\ +
-Then you should see the version you choose from **Select PHP version**  +
- +
-====== Troubleshooting ====== +
-1. **./build: line 968: 14423 Killed ​ ${INITDDIR}/​${SERVICE_NAME} ${SERVICE_ACTION}. ​ ** +
-**Installation of LiteSpeed 5.0.16 is now complete.** +
- +
-Your server IP has used a trial license before and it has expired. You should purchase a license or log a ticket with us to ask for a trial extension. Please copy your serial number file to ''/​usr/​local/​lsws/​conf/''​ or download a new trial key. +
- +
-2. **MIME type [application/​x-httpd-php55] for suffix '​.php'​ does not allow serving as static file, access denied!** +
- +
-  A ''​.php55''​ suffix should be created to be associated with php external apps, for example, lsphp5. +
-  This can be done through the WebAdmin console or ''​vi /​usr/​local/​lsws/​conf/​httpd_config.xml''​ by adding  +
-  the following to inside of the ''<​scriptHandlerList> ​  </​scriptHandlerList>''​ block: +
-    +
-    <​scriptHandler>​ +
-      <​suffix>​php55</​suffix>​ +
-      <​type>​lsapi</​type>​ +
-      <​handler>​lsphp5</​handler>​ +
-      <​note></​note>​ +
-    </​scriptHandler>​ +
-3. **PHP1/2 select not working** ​    +
-  - Check php1 by ''​grep php1 /​usr/​local/​directadmin/​custombuild/​options.conf''​ +
-  - Check config file, e.g. ''/​usr/​local/​directadmin/​data/​users/​USER_ACCOUNT/​httpd.conf''​ +
-  - Check PHP selector setup correctly through LiteSpeed web admin +
-  - If you change some php settings, sometimes may need to rebuild to make it works+
  • Admin
  • Last modified: 2025/06/03 18:01
  • by Lisa Clarke