Upgrade or Downgrade OpenLiteSpeed¶
There are three different methods for upgrading or downgrading your version of OpenLiteSpeed:
- LiteSpeed repository
- lsup.sh script
- Binary install
To avoid complications, always upgrade or downgrade using the same method you used to install OpenLiteSpeed originally.
Warning
If you are using OLS on DirectAdmin, please don't use any of these methods. Please see How to Upgrade OLS on DirectAdmin.
Method 1: LiteSpeed Repository¶
Note
You will only have access to the stable versions of the software via the repository. For example, v1.8.x may be available on the edge branch, but you may only be able to access versions in the 1.7.x family from the repo until 1.8.x is considered stable.
If you wish to use a version from the edge branch, you will need to upgrade via lsup.sh.
If you installed OpenLiteSpeed through the LiteSpeed repository before, you should simply run the package update command.
Upgrade¶
yum update openlitespeed
apt-get upgrade openlitespeed
Downgrade¶
You can downgrade to any specific version that the repository supports.
- Find all of the available versions from the repository
yum --showduplicates list openlitespeed
- Run the downgrade command with the version you need
yum downgrade openlitespeed-1.7.16
- Find all of the installed available versions from apt
apt-cache policy openlitespeed
- Run the downgrade command with the version you need
apt install openlitespeed=1.7.16-3+bionic
- Search available OpenLitespeed versions from repository
- Download the specific version, for example, the
openlitespeed_1.7.16-3+bionic_amd64.deb
packagewget https://rpms.litespeedtech.com/debian/pool/main/jammy/openlitespeed_1.7.16-3%2Bjammy_amd64.deb
- Install the package
dpkg -i openlitespeed_1.7.16-3+jammy_amd64.deb
Method 2: lsup.sh Script¶
The lsup.sh
script works similarly to the LiteSpeed Enterprise lsup.sh
script, and allows you to upgrade or downgrade OLS to a particular version.
You can download the latest lsup.sh
with the following command if /usr/local/lsws/admin/misc/lsup.sh
does not exist:
wget https://raw.githubusercontent.com/litespeedtech/openlitespeed/master/dist/admin/misc/lsup.sh
Note
If you previously installed OLS through yum
or apt-get
, it's fine to upgrade to other versions with the lsup
command.
Running ./lsup.sh
will update to the latest stable version, and ./lsup.sh -d
will update to the latest stable DEBUG version.
Additionally, these options are available:
Usage: lsup.sh [-t] | [-c] | [[-d] [-r] | [-v VERSION]] | [-e VERSION]
-a
Update web admin password
-d
Choose Debug version to upgrade or downgrade, will do clean like -c at the same time.
-v VERSION
If VERSION is given, this command will install the specified VERSION. Otherwise, it will get the latest version from /usr/local/lsws/autoupdate/release.
-e VERSION
Upgrade/downgrade to specified VERSION without making any other changes. The version listed in /usr/local/lsws/VERSION does not change.
-r
Restore the originally installed version which is in file VERSION.
-p
Restore the previously installed version which was renamed to .old files.
-t
To test openlitespeed running status.
-c
Do some cleanup and restart openlitespeed service.
-h | --help
Display this help and exit.
-g
Toggle DEBUG log
lsup.sh
is not only a very powerful tool to upgrade/downgrade OLS, but also an installation tool if OLS has not yet been installed on the server.
Tip
To test a particular version temporarily, use the -e VERSION
option, run your tests, and then use the -r
option to restore the original version listed in /usr/local/lsws/VERSION
.
Commonly used example:
/usr/local/lsws/admin/misc/lsup.sh -v 1.8.1
Method 3: Binary Install¶
If you installed OLS by downloading the package and running ./install.sh
, you will need to do the same to upgrade. For example, you could upgrade from 1.5.x to 1.6.7 like so:
wget https://openlitespeed.org/packages/openlitespeed-1.6.7.tgz
tar -zxvf openlitespeed-*.tgz
cd openlitespeed
./install.sh
Note
Binary install should not be mixed with repository installation. If you'd like to switch to a different type of installation, see below.
Switch Method of Installation¶
Most of the time, you should upgrade or downgrade with the same method that you originally used to install OLS. If you need to switch to a different version for some reason, follow these steps:
- Back up your entire OLS configuration.
- Uninstall OLS using
yum
orapt-get
, as appropriate for your OS, to avoid accidentally downgrading in the future. - Copy the OLS configuration backup to
/usr/local/lsws/conf/
. - Install OLS using your preferred method.