Installing LiteSpeed Web Server with CustomBuild 2.0

Starting with CustomBuild 2.0 RC7, 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 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 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:

Through the CustomBuild Plugin

The 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.

Then change the webserver setting to litespeed.

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.

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:

Then build PHP.

3. Check that LSWS is running

You can then go into DirectAdmin's Service Manager to check that LSWS is running.

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, 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.

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>
 
litespeed_wiki/directadmin/custombuild-installation.txt · Last modified: 2016/10/13 22:16 by Rob Holda