====== Xenforo Installation ======

This guide will explain how to get up and running with Xenforo on LiteSpeed Web Server.

===== Install PHP modules =====
The easiest way to install PHP for LiteSpeed is through our CentOS repository. If the LiteSpeed Repository was not installed and enabled during the web server installation, follow [[http://www.litespeedtech.com/support/wiki/doku.php?id=litespeed_wiki:php:rpm | this guide]] to install and enable the LiteSpeed Repository.
===Step 1.Install PHP===
You can install some of the most commonly-used PHP 7.1 packages and modules for LiteSpeed. Use the following command:

<code>sudo yum install lsphp71 lsphp71-mysqlnd lsphp71-common lsphp71-gd lsphp71-pdo lsphp71-process lsphp71-mbstring lsphp71-mcrypt lsphp71-opcache lsphp71-bcmath lsphp71-xml lsphp71-soap lsphp71-json -y </code>
===Step 2.Setup PHP===
Visit ''<nowiki>http://your_server_IP:7080</nowiki>''. Navigate to **Server Configuration > External app**, then click the second icon **Edit** on the right hand side in order to edit this application.\\
Modify:
  * **Name**: lsphp -> ''lsphp71''
  * **Command**: $SERVER_ROOT/fcgi-bin/lsphp5 -> ''$SERVER_ROOT/lsphp71/bin/lsphp''
===Step 3.Restart LSWS===
When you are finished, click the **Save** icon to save your changes, then click the **Graceful Restart** button.
===Step 4. PHP Verification===
Visit ''<nowiki>http://your_server_IP/phpinfo.php</nowiki>'' and make sure **PHP Version** shows ''7.1.x''.


=====Mariadb Installation:=====
Install MariaDB:
<code>sudo yum install mariadb-server
sudo systemctl start mariadb</code>
Set new password: 
 <code>/usr/bin/mysql_secure_installation</code>
Enter ''$yourpassword''
=====Create XenForo DB Account =====
Create the XenForo database and your XenForo user/password:
<code> mysql -u root -p$yourmysqlpassword
 create database xenforo; grant all privileges on xenforo.* to xenforo@localhost identified by 'xenforo'; exit;</code> 
Note: For security purposes, you should use a XenForo username and password that are different than our example.

=====XenForo Download:=====
To illustrate setting up XenForo on a vhost we'll use the default virtual host, "Example".
Download ''XenForo.zip'' from the XenForo [[https://xenforo.com/customers/ | Customer Area]] to your server in ''usr/local/lsws/Example/http/''. 
You will see an ''upload'' file
<code> unzip xenforo_xxx_.zip
 sudo mv upload xenforo
 sudo chmod 777 -R xenforo</code> 

=====XenForo Installation:=====
Setup index.php:
Go to the **WebAdmin Console > Virtual Hosts > Example > General** tab. Click the **edit** button on the **Index Files** section and add the following:
<code>/index.php</code>

Open browser with URL ''server_IP:8088/xenforo/''
  * Click **Begin Installation** button 
    * MySQL User Name: ''xenforo''
    * MySQL Password: ''xenforo''
    * MySQL Database Name: ''xenforo''
  *Click **Test & Generate Configuration** button
  *Click **Continue with Installation** button
  *Click **Begin Installation** button 
  *Setup Administrator
    * Name: ''XXX''
    * Password: ''XXX''
    * Email: ''XXX@XXX''
  *Click **Create Administrator** button
  *Click **Setup Options** button
  *Click **Enter your control panel** button 
  *Login with your Name/Password

=====XenForo Verification:=====
{{:litespeed_wiki:installation:xenforo-ols.png?400|}}