How To Install WordPress with OpenLiteSpeed on Ubuntu 14.04

WordPress is currently the most popular content management system (CMS) in the world. It allows you to easily set up flexible blogs and websites on top of a database backend, using PHP to execute scripts and process dynamic content. WordPress has a large online community for support and is a great way to get websites up and running quickly.

In this guide, we will focus on how to get a WordPress instance set up and running on Ubuntu 14.04 using the OpenLiteSpeed web server.

Before you begin this guide, there are some important steps that you must complete to prepare your server.

We will be running through the steps in this guide using a non-root user with sudo privileges. To learn how to set up a user of this type, follow our initial server setup guide for Ubuntu 14.04.

This guide will not cover how to install OpenLiteSpeed or MySQL. You can learn how to install and configure these components by following our guide on installing OpenLiteSpeed on Ubuntu 14.04. This will also cover the MySQL installation.

Finally, if you are using a server with less than 1 Gigabyte of RAM, you should create and enable a swap file. Learn how to do this by running through this guide.

When you are finished preparing your server using the guides linked to above, you can proceed with this article.

We will start by creating a database and database user for WordPress to use.

Start a MySQL session by using the root MySQL username:

mysql -u root -p

You will be prompted to enter the MySQL administrative password that you selected during installation. Afterwards, you will be dropped into a MySQL prompt.

First, create a database for our application. To keep things simple, we’ll call our database wordpress in this guide, but you can use whatever name you’d like:

CREATE DATABASE wordpress;

Next, we’ll create a database user and grant it access to manage the database that we just created. We will call this user wordpressuser, but again, feel free to choose a different name. Replace password in the command below with a strong password for your user:

GRANT ALL ON wordpress.* TO wordpressuser@localhost IDENTIFIED BY 'password';

Flush the changes you’ve made to make them available to the current MySQL process:

FLUSH PRIVILEGES;

Now, exit out of the MySQL prompt to get back to your regular shell:

exit

With our database configured, we can go ahead and shift our focus to configuring PHP. A customized version of PHP is included with the OpenLiteSpeed installation. However, the included version does not have the PHP extensions we need compiled in. Due to the way that the interpreter ties into the OpenLiteSpeed web server, we will need to recompile a custom version of PHP with the modules we need.

Before starting the configuration and compilation process, we need to download and install some libraries that our extensions will need from the Ubuntu repositories. Update your local package index file and download the libraries by typing:

sudo apt-get update
sudo apt-get install libgd-dev libmcrypt-dev libcurl4-openssl-dev

Once the components are installed, visit the OpenLiteSpeed admin interface by navigating to your server’s domain or IP address and port :7080 in your web browser:

https://server_domain_or_IP:7080

If prompted, log in using the username and password you configured for OpenLiteSpeed in the installation tutorial.

To get started, select “Compile PHP” from the “Actions” menu in the top menu bar:

You will be presented with a menu where you can select the version of PHP you’d like to compile:

Select the most recent version out of the “PHP 5” selection menu. This should be already be preselected, but it doesn’t hurt to check. Click on the “Next” button in that row to continue.

On the next page, you will be able to select the compilation options for PHP:

In the “Configure Parameters” section, we need to add some additional flags. Specifically, we need to add the --with-mysql and --with-curl parameters. If your server uses the x64 architecture, you will also need to add the --with-libdir=lib64 option. The complete list of options will look like this:

--with-mysqli --with-zlib --with-gd --enable-shmop --enable-sockets --enable-sysvsem --enable-sysvshm --enable-mbstring --with-iconv --with-mcrypt --with-mysql --with-curl --with-libdir=lib64

Click on the “Build PHP [version number]” button at the bottom when you are finished.

You will be taken to a screen where the PHP build will be prepared:

If the preparation completes successfully, click on the “Next” button to continue to the compilation process.

A PHP build script has been generated using the options that you have selected. However, OpenLiteSpeed will not actually run the build script automatically for security reasons:

To run the script, you must go back to your terminal and run a command. Keep your browser page open so that you can see the output of the build process. In your terminal, type:

sudo /usr/local/lsws/phpbuild/buildphp_manual_run.sh

The compilation process can take quite a long time (anywhere from 5 to 20 minutes). When it completes, it will automatically link to the correct location so that it will be enabled on the next restart. Before we restart though, we will configure some aspects of our virtual host to prepare for WordPress.

We will be modifying the default virtual host that is already present in the OpenLiteSpeed configuration so that we can use it for our WordPress installation.

To begin, in the admin interface, select “Virtual Hosts” from the “Configuration” item in the menu bar:

On the “Example” virtual host, click the “View/Edit” link:

This will allow you to edit the configuration of your virtual host.

RewriteRule ^/index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]

The last thing that we need to do before installing and configuring WordPress is clean up our virtual host and document root directories. As we said in the last section, the default site has some extraneous pieces that we won’t be using for our WordPress site.

Start by moving into the virtual host root directory:

cd /usr/local/lsws/DEFAULT

If you deleted all of the entries in the “Contexts” tab in the last section, you can get rid of the cgi-bin and fsci-bin directories entirely:

sudo rm -rf cgi-bin fcgi-bin

If you have left these contexts enabled, you should at least remove any scripts currently present in these directories by typing:

sudo rm cgi-bin/* fcgi-bin/*

You may see a warning about not being able to remove fastcgi-bin/*. This will happen if there was nothing present in that directory and is completely normal.

Next, we should remove the password and group files that previously protected our “/protected/” context. Do this by typing:

sudo rm conf/ht*

Finally, we should clear out the present contents of our document root directory. You can do that by typing:

sudo rm -rf html/*

We now have a clean place to transfer our WordPress files.

We are now ready to download and install WordPress. Move to your home directory and download the latest version of WordPress by typing:

cd ~
wget https://wordpress.org/latest.tar.gz

Extract the archive and enter the directory by typing:

tar xzvf latest.tar.gz
cd wordpress

We can copy the sample WordPress configuration file to wp-config.php, the file that WordPress actually reads and processes. This is where we will put our database connection details:

cp wp-config-sample.php wp-config.php

Open the configuration file so that we can add our database credentials:

nano wp-config.php

We need to find the settings for DB_NAME, DB_USER, and DB_PASSWORD so that WordPress can authenticate and utilized the database that we set up for it.

Fill in the values of these parameters with the information for the database you created. It should look something like this:

// ** MySQL settings - You can get this info from your web host ** //
/** The name of the database for WordPress */
define('DB_NAME', 'wordpress');

/** MySQL database username */
define('DB_USER', 'wordpressuser');

/** MySQL database password */
define('DB_PASSWORD', 'password');

Save and close the file when you are finished.

Now, we are ready to copy the files into our document root. To do this, type:

sudo cp -r ~/wordpress/* /usr/local/lsws/DEFAULT/html/

Give permission of the entire directory structure to the user that the web server runs under so that changes can be made through the WordPress interface:

sudo chown -R nobody:nogroup /usr/local/lsws/DEFAULT/html

With the files installed, we can access our WordPress installation by going to our server’s domain name or IP address. If you changed the port for the default site to port 80 during the OpenLiteSpeed installation in the prerequisite guide, you can access the site directly:

http://server_domain_or_IP

If you have not switched to port 80, you will have to add :8088 to the end of your address. Consider switching to port 80 when launching your site using the instructions in the last guide:

http://server_domain_or_IP:8088

You should see the first screen of the WordPress installation interface, asking you to select a language:

Make your selection and click “Continue”.

On the next page, you will need to fill in some information about the site you are creating. This will include the site title, an administrative username and password, the admin email account to set, as well as a decision as to whether to prohibit web crawlers:

After the installation, you will have to login using the account you just created. Once authenticated, you will be taken to the WordPress admin dashboard, allowing you to configure your site:

Your WordPress installation should now be complete.

In this guide, we’ve installed and configured a WordPress instance on Ubuntu 14.04 using the OpenLiteSpeed web server. This configuration is ideal for many users because both WordPress and the web server itself can mainly be administered through a web browser. This can make administration and modifications easier for those who do not always have access to an SSH session or who may not feel comfortable managing a web server completely from the command line.