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:

  • SERIAL_NO will be sent to you in the automated email upon your invoice paid. We recommend Copy & Paste instead of typing to avoid mistake. Save the serial number, minus quotes, as a file named “serial.no”. If you do not have the email as your mail server may block it, You can also find it on store - client area - my products. (Please resolve this ASAP by fixing it or changing to a different email. Otherwise you will not receive invoice email.)
  • Remove all the old license related files before you register a new one. If you have old “serial.no”, “license.key” or “trial.key” under lsws/ or lsws/conf directories, please back up first and remove all of them from those directories.
  • Please make sure license.litespeedtech.com is reachable from your server.
  • 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 still cannot register a license key by following all the instructions, please create a ticket with license department from online store - client area.

Activate License in an Existing LSWS Installation

  • The installed LSWS can either be on a trial key or an expired old license.
  • Assuming LSWS has been installed to directory /usr/local/lsws, you just do the follow steps to activate the new license key purchased.
If your current installation is the latest version, you just need to activate the new license key
cd /usr/local/lsws
  • If you have old “serial.no”, “license.key” or “trial.key” under lsws/ or lsws/conf, please back up first and remove from those directories.
  • Save the serial number as a file named “serial.no” under lsws/conf directory.
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
  • The installation package can be downloaded from here, then expand the package in a directory like your home directory.
  • Save the serial number as a file named “serial.no” in the installation folder (same folder as install.sh).
echo "SERIAL_NO" > serial.no
  • 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.
  • Run ./install.sh.
./install.sh
  • Select “Upgrade”, which is default option, by hit “ENTER” key. You can hit “ENTER” all the way to the end. Your existing configuration and data will not be touched. There is no service interruption as it will do a graceful restart when finish.

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.
  • Admin
  • Last modified: 2017/04/21 13:27
  • by Michael Alegre