Read More

Installation/Uninstallation

Minimum system requirements

  • Operating System:
    • Linux: kernel 2.4 and up, glibc-2.2 and up
    • CentOS: 5 and up
    • Ubuntu: 8.04 and up
    • Debian: 4 and up
    • AlmaLinux: 8 and up
    • Solaris: Sun0S 5.8 and up
    • FreeBSD: 4.5 and up
    • MacOSX: 10.3 and up
  • CPU:
    • Intel: 80486 and up
    • PowerPC: PowerPC G4
  • Memory: 32MB and up
  • Disk:
    • Installation: 200MB
    • Runtime: 300MB and up, swapping space depends on usage.

Installation

Installation must be performed in a command line terminal. For testing purposes, LiteSpeed Web Server can be installed into a home directory by a non-privileged user. For production use, it should be installed into a system directory.

In Mac OS X, root user is disabled by default. It can be enabled using a series of actions detailed on the Apple website. You can also use the sudo command to install LSWS into a system directory without enabling the root user, but system folders will still only be manipulable by the root user. This means that every time you want to control LSWS from the command line terminal (like when you want to start or stop LSWS), you will have to use the sudo command.

Installation Steps:

  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 trial license key or serial number:
    • Trial License:

      A trial license is for evaluation purposes and is only good for 15 days after download. A trial license can be requested from download page.

      A trial license key will be sent to you as an attachment in a confirmation email. Please save the attachment as trial.key and copy it to the installation directory.

      When you switch from a trial license to a production license, you can simply run the install script again after following the steps below to update your license.

    • Production license:
      1. Licenses can be leased or purchased at the LiteSpeed store.
      2. A serial number will be sent to you in the confirmation email after you order has been successfully processed. Each serial number allows for one server installation.
      3. Save the serial number as "serial.no"; in the installation directory (where install.sh is located). The LiteSpeed products registration server will use this file to retrieve your license key during the installation process.
  3. Go to the installation directory cd lsws-xxxx and run command ./install.sh This will start LiteSpeed's Installer.

    Note that only by running this command as the "root" user can you install the server into a system directory. Other users should install it to somewhere under their home directory.

    Mac OS X users 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. Specify the directory where you would like to install LiteSpeed Web Server. For the root user, the default is /usr/local/lsws. For non-privileged users, the default is their home directory. Remember, non-privileged users will not be able to install the server into a system directory.
  6. [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 or valid Enterprise license.

  7. Follow the instructions on the screen. The Installer will ask you to set the following:
    1. If a previously installed copy exists, the Installer will ask you to choose either upgrade, reinstall, or change directory. Upgrading will keep your current configurations.
    2. Administrator's username and password for the WebAdmin interface.
    3. What control panel, if any, you will use with LSWS.
    4. User and group that the server process will run on behalf of.
    5. TCP port for normal web service.
    6. TCP port for WebAdmin interface.
    7. Whether to set up LiteSpeed PHP.
    8. [Enterprise Edition Only] Root user has the 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 chroot unless you are familiar with it. You can always enable it later by performing an upgrade installation.

    Finally, the Installer will ask you if you want to install the AWStats add-on module to keep track of your web statistics. Root user can also choose to run LiteSpeed Web Server automatically at system startup as a service. Then you're done! The installer can start up the server.

Testing Installation

  1. For detailed information on controlling the server processes, please see the Administration Guide. To start the server, simply run [your_install_dir]/bin/lswsctrl start.
  2. To access your site, point your browser to http://[address]:8088/, [address] being the IP address or domain name of your web server machine. Use "localhost" if the server is on the machine you are using. "8088" is the default port. If you changed the port during installation, write the port you designated. A congratulations page should load into the browser. If not, try the WebAdmin interface.
  3. The default port for the WebAdmin interface is 7080. Plug http://[address]:7080/, into your browser to go to the WebAdmin interface. (If you changed the port for WebAdmin during installation, use that port instead.) Remember that for [address] you can use "localhost" if you're using the machine the server is on. The administration interface welcome page should load. Click the "Log on" link and use the administrator's username and password specified during installation to log on. For detailed information regarding configuration, please refer to our Configuration Guide, or click the "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 your web site and the WebAdmin interface are inaccessible, please take a look at the error log - [your_install_dir]/logs/error.log
    • If there is a TCP port conflict with other server applications, the web server should be reinstalled with an available port.
      The following command can be used to find an available port:
      netstat -an | grep XXXX
      XXXX is a port number. If the port is available, the command will produce no output.
    • If the swapping directory is not writable, you can either grant writing permission for the swapping directory to the user whom the web server is running as, or change the swapping directory manually. The swapping directory is configured in the server's XML configuration file located at [your_install_dir]/conf/httpd_config.xml, default value is /tmp/lshttpd/swap. Search for <swappingDir>.

If you still have problems with installation, please check out our wiki or post your problem on our support forum.

Upgrading

There are a few scenarios where you would need to update or upgrade the server:

  • A new release is available
  • Upgrade from a trial license to production license
  • Upgrade/downgrade to a different production license.

There are a number of ways to upgrade. One way is to just run install.sh again and select "Upgrade" when prompted. Your current configurations will be kept.

Starting with release 2.0, version management can also be done from the WebAdmin Console interface, under Actions - Version Management. All your installed versions and the available new releases are listed here. You can install a new release or switch between different versions by clicking the appropriate link. Since release 2.0, LSWS also features a built-in update agent that will check for new releases periodically and send email notifications.

Starting with release 4.1, you can upgrade to the latest release, force reinstall, or downgrade to an old version using the command line tool lsup.sh. See detailed usage information in [your_install_dir]/admin/misc/lsup.sh --help

Since release 1.5.6, multiple versions of LiteSpeed Web Server can be installed. You can easily switch from one to another by using the version management utility: [your_install_dir]/admin/misc/mgr_ver.sh.

  • To switch to a version already installed, for example 1.5.6, just run [your_install_dir_current_version]/admin/misc/mgr_ver.sh 1.5.6
  • To remove previously installed files for a certain version, for example 1.5.6, just run [your_install_dir_current_version]/admin/misc/mgr_ver.sh -d 1.5.6

When upgrading your license (from trial to production license, for example), you can manually copy "serial.no" to the [your_install_dir]/conf/ directory, then restart. Please backup your old serial number and license key before restart.

License transfer procedure:

Please be aware that each license key is associated with a serial number and the server's hardware signature. A new key is required if a change in hardware signature is detected. So if you upgrade or change your hardware, you need to transfer your current production license in order to continue using the product.

  1. To migrate your current license, you can simply run the server binary ./lshttpd -m. It will talk to LiteSpeed' products registration server, unlock your serial number, and generate a temporary license key. This temporary key is good for 3 days. This allows you a smooth transition to the new server.
  2. If you wish, you can take this chance to download the latest version of LiteSpeed Web Server to your new hardware. Then copy the serial number file "serial.no" to the installation directory and start up the Installer. You unlocked your serial number in the previous step, so running the Installer will get you a new license key.
  3. If you wish to copy your old installation directory over to the new hardware, then you just need to activate your license. Run command ./lshttpd -r to retrieve a new license key.
  4. If the process fails, you can create a ticket with the license department in the client area of the online store.

Uninstallation Steps

  1. Simply run [your_install_dir]/admin/misc/uninstall.sh and follow the instructions on the screen.
  2. The Uninstaller will ask the following questions:
    • whether to keep the log directory
    • whether to keep the configuration directory

  3. Directories that were not created by the Installer will not be touched, even if they are in [your_install_dir]. All the files created by the installer will be removed.
  4. [your_install_dir] will be removed as well, if it is empty.

Privacy Policy

Privacy Policy

LiteSpeed Technologies, Inc. (aka “LiteSpeed”) is committed to protecting your privacy. This policy ("Privacy Policy" or "Policy") explains our practices for our site, www.litespeedtech.com ("Site"). You can visit most pages of the Site without giving us any information about yourself, but sometimes we do need information to provide services that you request. By using this Site or any products or services provided through the Site, you expressly consent to the use and disclosure of information as described in this Privacy Policy.

LiteSpeed reserves the right to revise, modify, add, or remove provisions to this Privacy Policy at any time. If we make changes to this Privacy Policy, we will update the Effective Date to note the date of such changes. LiteSpeed encourages you to review this Privacy Policy periodically for any changes. IF YOU DO NOT AGREE WITH ANY OF THE TERMS BELOW, YOU SHOULD NOT USE THIS SITE OR THE PRODUCTS OR SERVICES OFFERED BY LITESPEED TECHNOLOGIES AT THIS SITE.

Collection of Information

Personal Information.

LiteSpeed will ask you for certain “Personal Information” when you complete registration or product information request forms on the Site, including but not limited to your name, address, telephone number, email address, and credit card information. You can always choose not to provide us with the requested information, however, you may not be able to complete the transaction or use our products or services if you do not provide the information requested.

Non-Personal Information.

LiteSpeed may collect non-personally identifiable information from you such as the type of browser you use, your operating system, the screen resolution of your browser, your ISP, your IP address, which pages you view on the Site and the time and duration of your visits to the Site (collectively, “Non-Personal Information”). LiteSpeed may associate Non-Personal Information with Personal Information if you register with the Site.

User Communications.

If you communicate with us, we may collect information relating to that communication whether it takes the form of email, fax, letter, forum posting, blog comments, testimonials or any other form of communication between you and LiteSpeed or Submitted by you to the Site (collectively, “User Communications”).

Server Information.

If you use one of our software products such as LiteSpeed Web Server or LiteSpeed Web ADC, we may collect certain information concerning such software and concerning the server upon which the software operates. This information includes: (a) the licensed or unlicensed status of the software; (b) the source from which the license for the software was obtained (i.e., LiteSpeed or a LiteSpeed affiliate); or (c) information about the server upon which the software is installed including (i) the public IP address, (ii) the operating system and (iii) the use of any virtualization technologies on such server ((a) through (c) collectively, “Server Information”). Additionally, “Server Information” may also include information collected from you by LiteSpeed in the event that you request technical support services including without limitation, IP addresses, usernames, and passwords necessary to login to SSH, the root directory of the server upon which you installed the LiteSpeed software and any affected accounts including email accounts, control panel accounts, MySQL accounts, CMS accounts and other accounts.

Use and Storage of Collected Information

LiteSpeed may use Personal Information to create and authenticate your account, to respond to your requests, to provide you with customer and technical support, or to provide you with information regarding our products, services, partners, and company. You may update your Personal Information with us at any time, but we may maintain records of any Personal Information you disclose to us indefinitely, unless otherwise requested as outlined below.

We may use User Communications in the same ways we use Personal Information. If you communicate with us for a particular purpose, we may use your User Communications for that purpose. For example, if you contact us for technical support, we may use your communications to provide technical support to you. We may maintain records of User Communications you transmit to us indefinitely, unless otherwise requested as outlined below.

LiteSpeed may use Non-Personal Information to maintain, evaluate, improve and provide our Site, the Services and any other LiteSpeed products and services. We may retain Non-Personal Information indefinitely.

We may use Server Information to provide you with technical support services and to maintain, evaluate, improve and provide LiteSpeed products and services. We may also use such information to investigate unlicensed (and therefore unauthorized) uses of our software. LiteSpeed may maintain Server Information indefinitely, with the exception of usernames, passwords, and other login information given in connection with support service requests. Such login information will be purged when the ticket is closed.

Disclosure of Collected Information

LiteSpeed will only disclose Personal Information to third parties if acting under a good faith belief that such action is necessary, including but not limited to: (a) to resolve disputes, investigate problems, or comply with laws or regulations; (b) to enforce our Terms of Service; (c) to protect and defend the rights, property, or safety of our company or our users; or (d) in the event of a merger, acquisition or sale of all or substantially all LiteSpeed assets. Other than this limited activity, we do not share, sell, or rent any personal information to third parties.

You will receive notice in the form of modifications to this Policy when information about you might go to third parties other than as described in this Policy, and you always have the opportunity to contact us as set forth below if you do not wish your information to go to third parties.

LiteSpeed cannot be responsible for protecting your information if you share such information in publicly available sections of the Site such as the user forums, blog comments, or testimonials section. You should use your own judgment in disclosing this information on the Site.

Use of Cookies

“Cookies” are small pieces of information that your browser stores on your computer on behalf of a website that you have visited. Cookies may be used in order to complete transactions on our site. You can always choose not to accept cookies with the settings of your web browser, however, you may not be able to complete these transactions if you do not accept cookies.

Security of Personal Information

We use reasonable security methods to protect your personal information from unauthorized access, use or disclosure. No data transmission over the Internet or any wireless network can be guaranteed to be perfectly secure. While we try to protect your personal information, we cannot guarantee the security of any information you transmit to us, and you do so at your own risk.

LiteSpeed uses industry-standard SSL-encryption to protect sensitive data.

In the event that LiteSpeed becomes aware of a security breach, unauthorized disclosure or inadvertent disclosure concerning your information, you agree that LiteSpeed may notify you of such an event using the Personal Information previously provided.

You are responsible for maintaining your account’s security.

GDPR Statement

LiteSpeed Technologies values your users’ privacy. Although our software does not directly collect any personally identifiable information from visitors to your site, LiteSpeed may still be considered a data processor, as user information may be temporarily cached and/or logged, as outlined in this document.

Servers

LiteSpeed Web Server, OpenLiteSpeed, LiteSpeed Web ADC, and related software may record IP addresses as a part of normal logging. An access log and an error log may record visitor IP addresses and URL visited. The logs are stored locally on the system where LiteSpeed server software is installed and are not transferred to or accessed by LiteSpeed employees in any way, except as necessary in providing routine technical support if you request it. This logging may be turned off through configuration. It is up to individual server administrators to come up with their own schedule for removing such logs from the file system.

Cache Solutions

Our cache plugins potentially store a duplicate copy of every web page on display on your site. The pages are stored locally on the system where LiteSpeed server software is installed and are not transferred to or accessed by LiteSpeed employees in any way, except as necessary in providing routine technical support if you request it. All cache files are temporary, and may easily be purged before their natural expiration, if necessary, via a Purge All command. It is up to individual site administrators to come up with their own cache expiration rules.

LSCache for WordPress

In addition to caching, our WordPress plugin has an Image Optimization feature. When optimization is requested, images are transmitted to a remote LiteSpeed server, processed, and then transmitted back for use on your site. LiteSpeed keeps copies of optimized images for 7 days (in case of network stability issues) and then permanently deletes them.

Similarly, the WordPress plugin has a Reporting feature whereby a site owner can transmit an environment report to our server so that we may better provide technical support.

Neither of these features collects any visitor data. Only server and site data is involved.

Support Services

Sometimes, when you request technical support, LiteSpeed may ask for login credentials to various areas of your site. You may refuse to share such credentials, however refusal may impact LiteSpeed’s ability to provide the requested support services.

Upon completion of a support ticket, LiteSpeed immediately deletes all login credentials you may have shared.

Any user data encountered by LiteSpeed is kept strictly confidential. We never provide your support ticket information to any third party without your explicit consent.

Contact Us

If you would like to update information that you have voluntarily provided to us, stop receiving information from us, or exercise any of the rights granted to you under Privacy Laws, including the EU’s General Data Protection Regulation, please e-mail info@litespeedtech.com.