How-To

Activate a License

Prerequisites

  • LiteSpeed Web Server or LiteSpeed Web ADC has to have already been installed on your server.
  • Please make sure license.litespeedtech.com is reachable from your server.
  1. Obtain your serial number. You will receive it in an automated email once your invoice for your license is marked paid. We recommend you copy & paste it instead of typing it to avoid a possible mistake.
    • (If you do not receive the email you can also find the serial number in our store: Client Area > My Products. Please resolve an emails issues ASAP by checking your mail server or changing the email on your account, otherwise you will not receive invoice related emails.)
  2. Remove all of the old license related files before you register a new license.
  3. When purchasing a LiteSpeed Web Server license, back up any old serial.no, license.key or trial.key and then remove all of them from the lsws and lsws/conf directories.
  4. When purchasing a LiteSpeed Web ADC license back up any old serial.no, license.key or trial.key and then remove all of them from the lslb and lslb/conf directories.
  5. Run these commands:
$ sudo echo "SERIAL_NO" > /usr/local/lsws/conf/serial.no
$ sudo /usr/local/lsws/bin/lshttpd -r
$ sudo /usr/local/lsws/bin/lshttpd -V #If license key has been registered successfully, you will see a new “license.key” under conf/, you can verify your new key 
$ sudo systemctl restart lsws #Restart with command to make it effective
$ sudo echo "SERIAL_NO" > /usr/local/lslb/conf/serial.no
$ sudo /usr/local/lslb/bin/lslbd -r
$ sudo /usr/local/lslb/bin/lslbd -V #If license key has been registered successfully, you will see a new “license.key” under conf/, you can verify your new key 
$ sudo systemctl restart lslb #Restart with command to make it effective

Failure

If obtaining a license key fails because it has already been used on a different server, you can release the license. Please refer to Transfer or Release A License.

If you still cannot register a license key after following the instructions, please create a ticket with the licensing department from your Client Area.

Add Cache to an Existing License

Our LiteSpeed Cache options offer high-powered page caching features that can be built into LiteSpeed Web Server (LSWS) and LiteSpeed Web ADC (LSADC). LSCache is included by default in all of our LiteSpeed Web ADC and LiteSpeed Web Server Enterprise licenses (excluding the legacy licenses).

Purchase A Caching Module

  1. Log into your account and access the license you wish to add caching to.
    !add-lscache2
  2. Under Actions, go to Upgrade/Downgrade Options.
    !add-lscache3
  3. Under New Configuration, select the caching module you wish to add from the checkbox.
    !add-lscache4
  4. Pay the generated invoice and you will be sent to an order confirmation screen. If you go back to your license's details, you will now see the caching module you selected under Configurable Options.
    !add-lscache5

Update your License

Your license will automatically be updated on our licensing server when you order one of our caching modules, but this update will not take effect on your server until your server communicates with our licensing server. This communication happens automatically once every 24 hours. You can also force communication in a number of ways. The easiest and most reliable way is to run the following commands:

$ sudo /usr/local/lsws/bin/lshttpd -V
$ sudo systemctl restart lsws
$ sudo /usr/local/lslb/bin/lslbd -V
$ sudo systemctl restart lslb

The above commands cause your server to check your current license against our licensing server and then restart, causing the new license changes to take effect.

Cancel a License

Leased Licenses

Log in to your Client Area > Services > My Services. Select the license you want to cancel and Request Cancellation. You can choose Immediate cancel or End of Billing Period.

If you choose End of Billing Cycle when cancelling, your license will be active until the end of the month, otherwise, it will be terminated the next day.

The invoice will be generated 3 days before the due date. If you send a cancellation request after the invoice has been generated but before it's been paid, the license being cancelled will be automaticaly removed.

Important

If you have a PayPal subscription, you have to cancel your subrciption on PayPal's website. Otherwise, PayPal will continue sending in payments even after the license has been cancelled.

Owned Licenses

You cannot cancel an owned license. If you no longer want it you can sell or transfer your license to someone else. We will process your transfer for a small processing fee. Either you or the recipient of the license should purchase the Account Merge/Transfer support service.

Check out the Billing section for information on refunds.

Check Concurrent Connections

Some legacy LiteSpeed Web Server licenses have a limit on the maximum number of concurrent connections you can serve. The VPS license has a limit of 500, and the Ultra VPS license has a limit of 800.

If you've already installed LSWS, you can check the number of concurrent connections in the Real-Time Statistics report in the WebAdmin console.

Even without LSWS you can use the command netstat -an | grep 80 | grep ESTA | wc -l to check your current number of concurrent connections. You may be surprised how few concurrent connections you have. (For example, a forum with 3,000 users online might use 300 concurrent connections or less, as those 3,000 users are not executing actions at the exact same time.)

Purchase a Year of Owned License Updates

For an owned license, after the initial year of free updates has expired, you will need to purchase a yearly add-on if you want to keep LSWS or LSADC up to date. If you don't want to purchase the update, you can simply keep using your current version.

To order the add-on, log in to your Client Area from the online store and select Order > Add On. Select the license for which you want to purchase a yearly add-on.

Your license will be renewed on the LiteSpeed license server automatically once your invoice is paid.

Perform a graceful restart to retrieve a new license key.

$ sudo /usr/local/lsws/bin/lshttpd -V
$ sudo systemctl restart lsws
$ sudo /usr/local/lslb/bin/lslbd -V
$ sudo systemctl restart lslb

Note

If you don't perform a graceful restart, your local license.key will be refreshed in one day.

If you don't see your update's expiration date extended, please create a ticket with our license department from the Client Area.

You will receive a new invoice after a year. You can pay the invoice to get the add-on for another year. If you no longer need to use the license you can request a cancellation of the add-on.

Transfer or Release a License

Tip

Make sure license.litespeedtech.com is reachable from your server.

The migration command is for clients to migrate licenses from one server to another when they change servers. It's for same site content.

Currently, we do not allow manual migration from the command line if the license has already been migrated 3 times in the past 30 days. After 3 times, you are required to go to your account's Client Area to release it.

The Difference Between Transfer and Release

You can freely TRANSFER a LiteSpeed license from one server to another server under you account. The transfer will give you 3 days of overlapping time to give you a smooth migration from the old server to the new one.

In case you don't have access to the old server, such as in cases of hardware failure, you will need to enable the license on the new server. You can use the RELEASE license option.

Release

Warning

Do NOT Release your license if it is still being actively used; it will immediately terminate the license and LiteSpeed Web Server or LiteSpeed Web ADC will stop running.

  1. Log in to you Client Area.
  2. Go to Services > My Services. Select the license you want to release, then click Release License. release_transfer
  3. Use the serial number to register a new license key. You can follow instructions at Activate A License.

Transfer

The license is tied to the server hardware signature and will NOT be affected by your IP or domain name change. * If you switch your server, you have to migrate your license. * If you upgrade your hardware, you may or may not have to migrate your license.

Warning

The LSWS or LSADC process on your old server will automatically SHUT DOWN after 3 days, so make sure you are ready to register the new license when you are ready to migrate.

To migrate your current license:

  1. Back up your current serial.no and license.key under lsws/conf or lslb/conf.
  2. Run these commands on your old server:

    sudo /usr/local/lsws/bin/lshttpd -V #Verify your current license on the old server. You can use it to check whether you need to migrate your license after your hardware upgrade.
    sudo /usr/local/lsws/bin/lshttpd -m #Migrate the license from your old server
    sudo /usr/local/lsws/bin/lshttpd -V #Verify your migrated license on your old server.
    
    sudo /usr/local/lslb/bin/lslbd -V #Verify your current license on the old server. You can use it to check whether you need to migrate your license after your hardware upgrade.
    sudo /usr/local/lslb/bin/lslbd -m #Migrate the license from your old server.
    sudo /usr/local/lslb/bin/lslbd -V #Verify your migrated license on your old server.
    
  3. In your new server, or the same server after a hardware upgrade, register a new license by following Activate a License. Assume you already copied over the same directory.

Now your old and new copy will run parallel for 3 days. Make sure your DNS will be refreshed by then.

Note

In emergency situations, if you cannot get your production server online, you can temporarily apply a trial license and create a ticket with the licensing department from your Client Area. You can use the Release license option as well.

If you have already performed the migration on the old server but haven't registered on the new server, you can continue to use the old server by registering a new key on it.

Tip

If you need more than 3 days of parallel running time you can apply a trial key first and test everything on your new server. Then, when you're ready, perform the migration step, which gives you 3 extra days.

Can I transfer my license to someone else?

You can sell and transfer annually leased and owned licenses to another person if you no longer need it. The recipient of the license must purchase the Account Merge/Transfer premium support service. Both parties must open a ticket with us to verify you both agree to the transfer.

Upgrade/Downgrade Licenses

You can upgrade/downgrade your license in your Client Area by going to: My Products > Product Detail. There you will be able to see our available options to upgrade or downgrade to.

Note

If you have an existing pending invoice, you will have to pay the invoice before you can perform the upgrade/downgrade.

For leased Site Owner and Web Host licenses, you can upgrade/downgrade between them at any time with the same serial.no. If you choose to upgrade, the system will calculate the price difference and issue a new invoice. The upgrade will be effective upon receipt of payment. A downgrade will be effective right away. Check the Refunds section in Billing for more information.

To upgrade from a leased license to an owned license, just cancel the leased license at the end of the billing period and order a new owned license.

Owned licenses can only be upgraded. If you have an owned license and want to upgrade to a higher owned package you only need to pay the price difference between these two licenses.

Your license will be updated from our license server automatically once your invoice is paid. Your local license key will be auto-updated within one day. If you want it to become effective immediately, and LSWS is installed to /usr/local/lsws or LSADC is installed to /usr/local/lslb, please run the following commands to retrieve a new license key:

$ sudo /usr/local/lsws/bin/lshttpd -r
$ sudo systemctl restart lsws
$ sudo /usr/local/lslb/bin/lslbd -r
$ sudo systemctl restart lslb

Tip

You can check the number of lshttpd or lslbd processes running to verify the correct license is active. You can run ps -ef | grep litespeed. * For Site Owner and Web Host Essential, there will be two lshttpd processes running. You will see one parent process running as root, and one child processes running as nobody. For a 1-worker process license, you will see one child process, for a 2-worker process license (Web Host Professional) you will see 2 child processes, for Web Host Enterprise, 4 child processes,and Web Host Elite, the number of child process is configurable, but the default is 8.

If you have any issues, please create a ticket with our licensing department from your Client Area.

Check my Current License

Run the command:

$ sudo /usr/local/lsws/bin/lshttpd -V
$ sudo /usr/local/lslb/bin/lslbd -V

It will list your current license information.


Last update: July 7, 2020