====== 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 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