Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Last revision Both sides next revision
litespeed_wiki:installation:command_line [2016/03/21 15:25]
Rob Holda
litespeed_wiki:installation:command_line [2019/08/07 20:52]
Jackson Zhang
Line 1: Line 1:
 ==== Installation/​Uninstallation ==== ==== Installation/​Uninstallation ====
- 
-=== Minimum system requirements === 
- 
-  * **Operating System:** 
-    * Linux(i386):​ kernel 2.4 and up, glibc-2.2 and up 
-    * CentOS: 5 and up 
-    * Ubuntu: 8.04 and up 
-    * Debian: 4 and up 
-    * Solaris(x86):​ Sun0S 5.8 and up 
-    * FreeBSD(i386):​ 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 ===
Line 27: Line 5:
 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. 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 [[http://​support.apple.com/​kb/PH11331|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.+In Mac OS X, root user is disabled by default. It can be enabled using a series of actions detailed on the [[https://​support.apple.com/​en-us/HT204012|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: == == Installation Steps: ==
  
-  - Decompress the package into a convenient location: +  - Decompress the package into a convenient location:\\ ''​tar xvfz lsws-xxxx.tar.gz''​ or ''​gunzip -c lsws-xxxx.tar.gz | tar xvf -''​
-    - ''​tar xvfz lsws-xxxx.tar.gz''​ or ''​gunzip -c lsws-xxxx.tar.gz | tar xvf -''​+
   - **[Enterprise Edition Only]** Install trial license key or serial number:   - **[Enterprise Edition Only]** Install trial license key or serial number:
-    * Trial License:  +    * 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 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. +      ​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.+      ​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:     * Production license:
-      - Licenses can be leased or purchased at the LiteSpeed [[http://​store.litespeedtech.com|store]].+      - Licenses can be leased or purchased at the LiteSpeed [[https://​store.litespeedtech.com|store]].
       - 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.       - 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.
       - 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.       - 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.
-  - Go to the installation directory ''​cd lsws-xxxx''​ and run command ''​./​install.sh''​ This will start LiteSpeed'​s Installer. +  - 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''​
-    * 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''​+
   - Read the End User License Agreement and type "​Yes"​ to confirm your agreement.   - Read the End User License Agreement and type "​Yes"​ to confirm your agreement.
   - 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. ​   - 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. ​
-  - **[Enterprise Edition Only] Generate license request.** +  - **[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.
-    * 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.+
   - Follow the instructions on the screen. The Installer will ask you to set the following: ​   - Follow the instructions on the screen. The Installer will ask you to set the following: ​
     - If previously installed copy exists, the Installer will ask you to choose either upgrade, reinstall, or change directory. Upgrading will keep your current configurations.     - If previously installed copy exists, the Installer will ask you to choose either upgrade, reinstall, or change directory. Upgrading will keep your current configurations.
Line 63: Line 35:
  
 == Testing Installation == == Testing Installation ==
-  - For detailed information on controlling the server processes, please see the [[http://​www.litespeedtech.com/​docs/​webserver/​admin|Administration Guide]]. To start the server, simply run ''​[your_install_dir]/​bin/​lswsctrl start''​.+  - For detailed information on controlling the server processes, please see the [[https://​www.litespeedtech.com/​docs/​webserver/​admin|Administration Guide]]. To start the server, simply run ''​[your_install_dir]/​bin/​lswsctrl start''​.
   - To access your site, point your browser to **<​nowiki>​http://​[address]:​8088/</​nowiki>​**,​ [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.   - To access your site, point your browser to **<​nowiki>​http://​[address]:​8088/</​nowiki>​**,​ [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.
-  - The default port for the WebAdmin interface is 7080. Plug **<​nowiki>​http://​[address]:​7080/</​nowiki>​**,​ 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 [[http://​www.litespeedtech.com/​docs/​webserver/​config|Configuration Guide]], or click the "​help"​ link on top of each page.+  - The default port for the WebAdmin interface is 7080. Plug **<​nowiki>​http://​[address]:​7080/</​nowiki>​**([address] being the IP address or domain name of your web server machine), 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 [[https://​www.litespeedtech.com/​docs/​webserver/​config|Configuration Guide]], or click the "​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 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 your web site and the WebAdmin interface are inaccessible,​ please take a look at the error log - ''​[your_install_dir]/​logs/​error.log''​   - If your web site and the WebAdmin interface are inaccessible,​ please take a look at the error log - ''​[your_install_dir]/​logs/​error.log''​
Line 72: Line 44:
  
 If you still have problems with installation,​ please check out our  If you still have problems with installation,​ please check out our 
-[[http://​www.litespeedtech.com/​support/​wiki|wiki]] or post your problem  +[[https://​www.litespeedtech.com/​support/​wiki|wiki]] or post your problem  
-on our support [[http://​www.litespeedtech.com/​support/​forum/​|forum]].+on our support [[https://​www.litespeedtech.com/​support/​forum/​|forum]].
  
 === Upgrading === === Upgrading ===
Line 95: Line 67:
 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''​ 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''​. ​+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 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''​   * 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''​
  • Admin
  • Last modified: 2022/02/17 18:35
  • by Lisa Clarke