Differences

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

--- litespeed_wiki:directadmin:custombuild-installation [2016/03/16 16:11]
Jackson Zhang [1. Edit Options]
+++ litespeed_wiki:directadmin:custombuild-installation [2018/04/02 19:19]
Eric Leu [Troubleshooting]
@@ Line 1: / Line 1: @@
 ====== Installing LiteSpeed Web Server with CustomBuild 2.0 ======
-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.
+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.
@@ Line 22: / Line 22: @@
 **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 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 install:
+  * 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}}
@@ Line 33: / Line 33: @@
 ==== 1. Edit Options ====
-In the Edit Options tab, change the php1_mode setting to "lsphp".
+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".
+Then change the ''webserver'' setting to ''litespeed''.
 {{litespeed_wiki:directadmin:custombuild_edit_webserver.png?700}}
-Save the settings.
+Save your settings by clicking the ''Save'' button at the bottom of the page.
 ==== 2. Build Software ====
-Then go to the Build Software tab. First, build LSWS.
+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:
+**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}}
@@ Line 64: / Line 65: @@
 **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.
+  * 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 ======
+. **./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.
+. **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>
+. **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