This is an old revision of the document!


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

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 the settings from the bottom of the page.

2. Build Software

Then 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 install:

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 to see LSWS in CustomBuild and DirectAdmin's Service Manager.

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.

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

1. ./build: line 968: 14423 Killed ${INITDDIR}/${SERVICE_NAME} ${SERVICE_ACTION}. Installation of LiteSpeed 5.0.16 is now complete.

Your server IP may trial license before and it has been expired. You should purchase a license or login ticket to ask trial extension. Please a serial no 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!

.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>
  • Admin
  • Last modified: 2016/05/02 18:52
  • by Jackson Zhang