Table of Contents

Activate License key purchased

This instruction applies to both LSWS and LSLB. For LSLB, just replace with “lslb” where “lsws” is used, and the binary is “lslbd” instead of “lshttpd”.

Notes:


Activate License in an Existing LSWS Installation

If your current installation is the latest version, you just need to activate the new license key
cd /usr/local/lsws
echo "SERIAL_NO" > conf/serial.no
bin/lshttpd -r

If license key has been registered successfully, you will see a new “license.key” under conf/, you can verify your new key with command

bin/lshttpd -V

Then restart LSWS with command to make it effective

bin/lswsctrl restart
If your current installation is NOT the latest version, you need to download the latest version and do an upgrade
echo "SERIAL_NO" > serial.no
./install.sh

Activate License in a New Installation

  1. Purchase the license from the on-line store. (Note: For first time registered user with credit card payment, there is additional ID verification process. If you use a verified paypal account with matched name, then no more verification required.) Once the transaction completes successfully, you'll receive an email with serial number.
  2. The installation package can be downloaded from here, then expand the package in a directory like your home directory.
  3. Remove all the old license related files in order to register a new one.
    • If you have an old production key and need to switch to a new one, you need to remove the old “serial.no” and “license.key” under /path/to/lsws/conf/ directory.
    • If you have a trial key installed, you should remove trial.key from /path/to/lsws/conf/trial.key.
    • Also, double check if old “serial.no”, “license.key”, “trial.key” are in the expanded installation folder, remove all of them.
  4. Save the serial number as a file named “serial.no” in the installation folder (same folder as install.sh).
    echo "serial number from your email" > serial.no
  5. Run ./install.sh.
    • If you already installed a trial version or different licensed version, just select “Upgrade”, this will keep all your configuration and data untouched.
  6. Then the installer will check whether “serial.no” exists in the same directory. If there is, it will connect to LiteSpeed products registration server and get a license key file automatically. If the license key retrieved successfully, the installation will continue. Please make sure license.litespeedtech.com is reachable from your server.
  7. If it fails to get a license key due to it's been used on a different server, you can release the license (refer to Transferring Or Releasing A License). If you cannot resolve this, please create a ticket with license department from online store - client area.