Installation/Uninstallation


Minimum system requirements

Installation Steps

Installation must be performed in a command line terminal. For testing purpose, LiteSpeed Web Server can be installed into your home directory as a non-privileged user. For production use, it should be installed into a system directory. Under Mac OS X, root user is disabled by default; it can be enabled by using the NetInfo Manager Application in /Applications/Utilities folder. If you don't want to enable root user, you can use "sudo" to install LSWS into a system directory as well.

  1. decompress the package into a convenient location:
    tar xvfz lsws-xxxx.tar.gz or gunzip -c lsws-xxxx.tar.gz | tar xvf -

  2. [Enterprise Edition Only] Install license key or serial number.

  3. Go to the installation directory cd lsws-xxxx and run command ./install.sh
    The "root" user can install the server into a system directory; other users should install it to somewhere under his home directory.
    Mac OS X user can install the server into a system directory with command sudo ./install.sh

  4. Read the End User License Agreement and type "Yes" to confirm your agreement.

  5. [Enterprise Edition Only] Generate license request.
    If the Installer only finds serial number but no valid license key, it will prompt to generate a license request. The installer will talk to LiteSpeed products registration server and obtain a valid license key automatically. Upon getting the license key, it will go to next step. If failed, the installer will exit and leave a license request file.
    If the automatic process failed, you can create a ticket with license department from online store client area.

    Note: Installation will continue only if there is a valid/trial license.


  6. Follow the instructions on the screen.
    The following questions will be asked:
    1. User and group that the server process run on behalf of.
    2. Destination directory where the server should be installed.
    3. If an installed copy exists, choose either Update or Reinstall.
      Update will keep your current configuration.
    4. Administrator's user name and password for the administration web interface.
    5. TCP port for normal web service.
    6. TCP port for web administration interface.
    7. [Enterprise Edition Only] "root" user has option to enable "chroot". The installer will setup the initial chroot environment automatically. Chroot is an advanced feature and your CGI may fail without configuration tuning. We strongly recommend not enabling it unless you are familiar with "chroot". You can always enable it later with an upgrade installation.
    "root" user can also choose to run LiteSpeed web server as a service which starts automatically at system startup.
    Server can be started by the installer once it is installed successfully.

Testing Installation
  1. There are a couple of ways to control the server process. For detail information please see Administration Guide. To start the server, simply run [your_install_dir]/bin/lswsctrl start.

  2. If the default port for normal web service was not changed during installation, point your browser to http://[address]:8088/, otherwise replace "8088" with actual port used. "[address]" should be the IP address or domain name of web server machine. Use "localhost" if it is accessed from the same machine. The congratulation page should be loaded into browser, if it is not, try next step.

  3. If the default port for web administration interface is not changed during installation, point your browser to http://[address]:7080/, otherwise replace "7080" with actual port used. "[Address]" should be the IP address or domain name of your web server machine. Use "localhost" if it is accessed from the same machine.
    The welcome page of administration interface should be loaded, click "Log on" link and use the administrator's user name and password specified during installation to log on. For detailed information regarding configuration, please refer to our Configuration Guide, or click "help" link on top of each page.

  4. If your server uses firewall, please make sure that localhost is trusted. For instance, Linux with IPTables should include a rule ALLOW INPUT from LO.

  5. If the web administration interface is inaccessible either, please take a look at the error log - [your_install_dir]/logs/error.log
If you still have problem with installation, please read the up to date Trouble Shooting first. Post your problem on our support Forum if you cannot find an answer.

Upgrade

There are a few scenarios that you need to update or upgrade the server

To upgrade to another edition/release, just run install.sh again and select 'upgrade', your current configuration will be kept.
Since release 2.0, the built-in update agent will check new release periodically and automatically download new package and send email notification about the new release. Server upgrade can be performed via the web admin interface by clicking the upgrade link in the version management page.

For license upgrade, you can manually copy "serial.no" and "license.key" to [your_install_dir]/conf/ directory then restart, it is recommended to backup your old license key first.

Version Management
Uninstallation Steps
  1. Simply run [your_install_dir]/admin/misc/uninstall.sh and follow the instructions on the screen.

  2. The following questions will be asked:
  3. All the directories that are not created by the Installer will not be touched, even they are under [your_install_dir]. But all the files created by the Installer will be removed.

  4. [your_install_dir] will be removed as well if it is empty.