Installation/Uninstallation
Minimum system requirements
- Operating System:
Linux(i386): kernel 2.2 and above, glibc-2.2 and above
Solaris(Sparc): SunOS 5.8 and above
Solaris(x86): Sun0S 5.8 and above
FreeBSD(i386): 4.5 and above
- CPU:
Intel: 80486 and above
Sun: UltraSPARC and above
- Memory:
32MB and above
- Disk:
Installation: 10MB
Runtime: 20MB and above swapping space depends on usage
Installation Steps
- decompress the package into a convenient location:
tar xvfz lsws-xxxx.tar.gz
or gunzip -c lsws-xxxx.tar.gz | tar xvf -
- [Professional Edition Only] Install license key or serial number.
- Install trial license. Trial license is for evaluation purpose and is only good for around 30 days. It will be sent to you in the confirmation email if you request to evaluate our product. Please copy it trial.key to the installation directory.
If you are switching from a trial license to a formal license, please
follow the steps below to get your permanent license key and run Installer again
to update your license.
- Our production licensing procedure is:
- Each production license is assigned with one serial number.
- The serial number(s) will be sent to you as attachment in the
confirmation email after you order has been successfully processed.
- A license key request should be generated by the Installer based on
the serial number and your server's hardware signatures.
- After we receive the request, a permanent production license
key will be assigned and sent to you.
Please be aware that the license key is associated with the serial number
and the server's hardware signature. A new key is required if changes of
hardware signature is detected. We will update your license key free of
charge.
For users without the production license key, the serial number
(named as serial.no) should be copied to the installation directory before
starting the Installer.
If the production license key is available, please also copy it (should be
named as license.key) to the installation directory.
- Go to the installation directory cd lsws-xxxx
and run command ./install.sh
The "root" user can install the server into a system
directory; other users should install it to somewhere under his home directory.
- Read the End User License Agreement and type "Yes" to confirm your agreement.
- [Professional 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 exit after generating the request.
The generated request lic_req.bin should be e-mailed to register@litespeedtech.com.
A new license key will be sent back to you in email shortly after we receive you request, please save it to the installation directory and run the Installer again.
Note: Installation will continue only if there is a valid/trial license.
- Follow the instructions on the screen.
The following questions will be asked:
- User and group that the server process runs on behalf of.
- Destination directory where the server should be installed.
- If an installed copy exists, choose either Update or Reinstall.
Update will keep your current configuration.
- Administrator's user name and password for the administration web interface.
- TCP port for normal web service.
- TCP port for web administration interface.
- [Professional Edition Only] "root" user has 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 to enable it unless you are familiar with "chroot". You can always enable it later with an upgrade installation.
"root" user can also choose to run LiteSpeed web server as a service which starts automatically at system startup.
Server can be started by the installer once it is installed successfully.
Testing Installation
- There are a couple of ways to control the server process. For detail information
please see Administration Guide. To start the
server, simply run [your_install_dir]/bin/lswsctrl start.
- If the default port for normal web service was not changed during installation,
point your browser to http://[address]:8088/, otherwise
replace "8088" with actual port used. "[address]" should be the IP address
or domain name of web server machine. Use "localhost" if it is
accessed from the same machine. The congratulation page should be loaded
into browser, if it is not, try next step.
- If the default port for web administration interface is not changed during
installation, point your browser to http://[address]:7080/,
otherwise replace "7080" with actual port used. "[Address]" should be the
IP address or domain name of your web server machine. Use "localhost" if it
is accessed from the same machine.
The welcome page of administration interface should be loaded, click "Log
on" link and use the administrator's user name and password specified during
installation to log on. For detailed information regarding configuration,
please refer to our Configuration Guide, or click
"help" link on top of each page.
- 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.
- If the web administration interface is inaccessible either, please take
a look at the error log - [your_install_dir]/logs/error.log
-
If it is because of TCP port confliction 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 the port number. If the port is available, no output should be produced.
-
If it is because swapping directory is not writable, you can either grant write permission of swapping directory to the user whom the web server 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]/coif/httpd_config.xml,
default value is /tmp/lshttpd/swap. Search for
<swappingDir>.
If you still have problem with installation, please read the up to date
Trouble Shooting
first. Post your problem
on our support Forum if you cannot find an answer.
Uninstallation Steps
- Simply run [your_install_dir]/admin/misc/uninstall.sh and follow the instructions on the screen.
- The following questions will be asked:
- whether to keep the log directory
- whether to keep the configuration directory
- All the directories that are not created by the Installer will not be touched, even they are under [your_install_dir].
But all the files created by the Installer will be removed.
- [your_install_dir] will be removed as well if it is empty.