Differences

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

--- litespeed_wiki:directadmin:custombuild-installation [2016/05/02 18:48]
Jackson Zhang [Troubleshooting]
+++ 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 to 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 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 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 install:
-{{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 the settings from the bottom of the page.
-==== 2. Build Software ====
-Then 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 install:
-{{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 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.
-====== Switch between Apache and LiteSpeed ======
-Custombuild does not provide hot switch between web servers. Each time during the switch, you will change the web server and recompile the PHP again. You can run a series of commands through custom build 2.0 to make it happen. Alternatively, you can run the following script to switch web server and recompile PHP.
-  /usr/local/lsws/admin/misc/cp_switch_ws.sh lsws(or apache)
-Direct Admin will make a hot switch feature in the nearly future.
-====== Troubleshooting ======
-. ./build: line 968: 14423 Killed  ${INITDDIR}/${SERVICE_NAME} ${SERVICE_ACTION}
-Installation of LiteSpeed 5.0.16 is now complete.
-Your server IP may have used trial license before and it has been expired. You should purchase a license or login ticket to ask trial extension.
-. MIME type [application/x-httpd-php55] for suffix '.php' does not allow serving as static file, access denied!
-  .php55 suffix should be created to be associated with php external apps, for example, lsphp5.
-  It can be done through web admin console or vi /usr/local/lsws/conf/httpd_config.xml by adding
-  the following to inside of <scriptHandlerList>   </scriptHandlerList>
-    <scriptHandler>
-      <suffix>php55</suffix>
-      <type>lsapi</type>
-      <handler>lsphp5</handler>
-      <note></note>
-    </scriptHandler>