Activate a License¶
- 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.
- 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.)
- Remove all of the old license related files before you register a new license.
- When purchasing a LiteSpeed Web Server license, back up any old
trial.keyand then remove all of them from the lsws and lsws/conf directories.
- When purchasing a LiteSpeed Web ADC license back up any old
trial.keyand then remove all of them from the
- 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
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). The basic LSCache module is included by default in all of our LiteSpeed Web ADC and LiteSpeed Web Server Enterprise licenses (excluding the legacy licenses). LiteMage Cache users may wish to upgrade or downgrade their configuration as follows:
Upgrade/Downgrade Caching Module¶
- Log into your account through our Client Area and navigate to Services > My Services. Select the license you wish to add caching to. This will bring you to the Manage Product screen.
- From the Actions menu, select Upgrade/Downgrade Options.
- Under New Configuration, select the LSCache configuration you'd like to apply to the license. Press the Click to Continue>> button, and pay the generated invoice.
- If you view the license details again in the Manage Product screen, you will see the new caching configuration you selected displayed under the Configurable Options tab.
Update your License¶
Your license will automatically be updated on our licensing server when you reconfigure your caching module, but this update will not take effect locally until your LSWS or LSADC instance 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
This will instruct your server to check your current license against our licensing server and then restart, putting any new license changes into effect.
Cancel a License¶
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.
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.
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
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¶
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.
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.
- Log in to you Client Area.
- Go to Services > My Services. Select the license you want to release, then click Release License.
- Use the serial number to register a new license key. You can follow instructions at Activate A License.
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.
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:
- Back up your current
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.
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.
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.
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.
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.
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.
You cannot upgrade/downgrade Free Starter licenses.
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
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.
Enable Two-Factor Authentication for LiteSpeed Account¶
Two-Factor Authentication adds an extra layer of protection to logins to your LiteSpeed Client Area. Once enabled & configured, each time you sign in you will be asked to enter both your username & password, as well as a second factor such as a security code.
To enable two-factor authentication please log in to your Client Area, then go to ‘Hello,Name!’ in the top right corner, and click it so that the drop down menu appears. On that menu, click ‘Security Settings’.
On the following page, press ‘Click here to Enable’.
On the next screen, click ‘Get Started’ if you’d like to continue, or click ‘Close’ to cancel the setup process.
Please follow the instructions on the following page, ‘Time-based One-Time Password’, to configure your authenticator app.
If you don’t already have an authentication application, or would like to try a new one, we suggest the Google Authenticator app.
Once your app provides you with a 6 digit code, click ‘Confirm’ on the webpage.
The next screen is the Verification Step. Input the 6 digit code you received from the app into the box, and click ‘Confirm’.
The 6 digit code on the Google Authenticator app changes frequently, so please be sure to check it right before you input it.
On the top of this last screen should be a banner saying ‘Key Verified Successfully!’. If there is, that means you have successfully enabled two-factor authentication. Please make sure to write down and save the backup code offered on this screen in case you lose or are unable to use your 2nd authenticating device.
Once you’ve recorded the backup code, you can return to the Client Area.