====== Installing LiteSpeed ======

These instructions will step you through installing LiteSpeed Web Server, as a front-end webserver on your Accelerator.

Unlike most of the software for which guides have been written in this Knowledge Base, LiteSpeed Web Server is a commercial product. You can choose between installing a free, standard edition. Or, you can purchase a full, enterprise edition. To help you decide, there is a [[http://www.litespeedtech.com/litespeed-web-server-editions.html|editions comparison chart]] available.

===== Preflight =====

   - Disable Apache, or any other webserver that may be running on Port 80. For example, if you are using CoolStack Apache: <code>
svcadm disable csk-http/CSKapache2
</code>
   - Disable (or [[accelerators:kb:webmin#removing|remove]]) Webmin. LiteSpeed provides its own comprehensive Web Console, web administration tool. You can re-enable Webmin postflight, after a successful installation. If you do, you will have to disable the Apache module and recheck your configuration. \\ You should decide if its worth the overhead of another process to keep Webmin around to manage other aspects of server setup (such as mail). To disable Webmin: <code>
svcadm disable webmin
</code>

===== Installation =====

  - Login as root.
  - Create a new user for the LiteSpeed web server: <code>
/usr/sbin/useradd -g webservd -s /bin/false litesped
</code>

<note tip>
**Note** Create a user with the name''litesped'' not ''litespeed'', to satisfy the eight letter username restriction.
</note>

  - Download the package you wish to install:
    * Standard Edition: <code>wget http://www.litespeedtech.com/packages/3.0/lsws-3.3.4-std-i386-solaris.tar.gz</code>
    * Enterprise Edition: <code>wget http://www.litespeedtech.com/packages/3.0/lsws-3.3.4-ent-x86_64-solaris.tar.gz</code>
  - Expand the package: <code>
gtar xvfz lsws-3.3.4-std-i386-solaris.tar.gz 
cd lsws-3.3.4</code>
  - Run the install <code>
./install.sh
</code>

  - Read the License Agreement, and if you agree to it type "Yes"
  - Press "Enter" to select the recommended destination "/opt/lsws"
  - Specify user name, password for admin web interface.
  - Specify an email address for the administrator.
 
  - HTTP port: 80
  - Admin HTTP port: 7080 (or you may want to change to something different)
  - Select defaults for PHP, AWStats
 
<code>
Would you like to have LiteSpeed Web Server started automatically \nwhen the server restarts [Y/n]? Y

[OK] The startup script has been successfully installed!
Would you like to start it right now [Y/n]? Y
</code>


===== Polish your installation =====

  - You may want to secure your admin access with a self-signed SSL certificate ([[http://litespeedtech.com/support/wiki/doku.php?id=litespeed_wiki:admin:ssl|see the tutorial on litespeed website]])
  - Have a look [[http://www.litespeedtech.com/support/forum/showthread.php?p=8817|over there]] for possible SMF manifests (untested).
  - [[http://www.usefuljaja.com/litespeed|Usefuljaja]] has plenty of tutorials about how to configure LiteSpeed with PHP, Rails and more

===== Migrate over your default page =====

The default sites HTML files are located in ''/opt/lsws/DEFAULT/html'' (if you selected default installer paths).

If you're moving from apache you can copy you files from there
<code>
rm index.html
cp /opt/coolstack/apache2/htdocs/index.html .
</code>

===== Configuration =====

Visit your http://YOURDOMAIN:7080/ to open the Web Console.

FIXME add in LiteSpeed + SMF

===== Reference =====

   * [[http://www.litespeedtech.com/|LiteSpeed Technologies, Inc.]]
   * [[http://www.litespeedtech.com/docs/webserver/install/Litespeed|LiteSpeed Installation  Instructions]]