How to manage versions using update-alternatives
managing the alternative versions manually with tooling available in (almost) every linux distribution
Background
Recently I needed to run the end to end tests in the older chrome browser as the tool the chrome driver available to me was only working with the older version of chrome.
The solution instead of downgrading my chrome installation was to install multiple versions of chrome-browser. More on this in my recent article how and where to get older versions of google-chrome.
Long story short, I would like to be able to hotswap the chrome version. Any python, node or java developer most likely uses some type or form of version manager. In java world people might be using sdkman
[sdkman.org] or node js world us used nvm
www.getnvm.org.
What is update-alternatives
update-alternatives creates, removes, maintains and displays information about the symbolic links comprising the Debian alternatives system.
It is a tool provided by Debian based distributions which is designed to help to manage multiple versions or different implementations of a command or program, read more on Debian Alternatives. Update-alternatives in Debian based system like Ubuntu is used as default option by apt
, however, it offers the command-line interface to interact with the settings and to add and remove entries manually.
It can also provide functionality to update something what is called slave links to cater for associated software or manual pages which also need to change when the main target changes.
The analogy in the nodejs world would be corresponding npm
installation or in python world it would be corresponding pip
.
How to install another version with update-alternatives
if you plan to use update-alternavives to e.g. install the multiple node versions you will download the desired version and unpack it in the directory of the choice In my case I need older version of google chrome so it would be /opt/google/chromium/1027016/chrome-linux/
.
This will contain binary /opt/google/chromium/1027016/chrome-linux/chrome
if you already have chrome
installed and you did that from the Debian package by
sudo apt install google-chrome-stable.deb
your already have used update-alternatives
and running
update-alternatives --display google-chrome
will show output:
google-chrome - auto mode
link best version is /usr/bin/google-chrome-stable
link currently points to /usr/bin/google-chrome-stable
link google-chrome is /usr/bin/google-chrome
/usr/bin/google-chrome-stable - priority 200
This indicates that there is only one version of google-chrome and it shows the location and priority for auto mode (the higher version takes precedence). I don't want to go into too much detail here as it could be found in man pages or online debian alternatives.
Running the following lists the existing links stored by update-alternatives.
update-alternatives --list google-chrome
?> /usr/bin/google-chrome-stable
We can see also here that there is only one. If we follow the symbolic links and investigate further we get to:
/usr/bin/google-chrome --> /etc/alternatives/google-chrome
/etc/alternatives/google-chrome --> /usr/bin/google-chrome-stable
/usr/bin/google-chrome-stable --> /opt/google/chrome/google-chrome
The last one is hard link to executable file and paint a pretty clear picture how the update-alternatives work. /usr/bin/google-chrome-stable
is an executable and /usr/bin/google-chrome
is a symbolic link to the executable so we can just type google-chrome
and it starts the browser. Update-alternatives sticks in an extra layer of symbolic links in the middle of which it has the full control.
To add another version to it execute the following
sudo update-alternatives --install /usr/bin/google-chrome google-chrome /opt/google/chromium/1027016/chrome-linux/chrome
if you want to use this as default link in auto mode you can add the priority number at the end, higher number takes precedence. For manual intervention enter the following command:
sudo update-alternatives --config google-chrome
output (depending on given priority nubmer this might differ):
There are 2 choices for the alternative google-chrome (providing /usr/bin/google-chrome).
Selection Path Priority Status
------------------------------------------------------------
0 /opt/google/chromium/1027016/chrome-linux/chrome 300 auto mode
1 /opt/google/chromium/1027016/chrome-linux/chrome 300 manual mode
* 2 /usr/bin/google-chrome-stable 200 manual mode
Press <enter> to keep the current choice[*], or type selection number:
if you choose one option the link will no longer be in auto mode, but you can return anytime to automode by running
sudo update-alternative --auto google-chrome
slave links
As mentioned before, these are associated links which should change when master link changes. The examples are node and npm or python and pip. It also works with manual pages as some packages install also manual pages. This is also the case when installing google-chrome as deb package as above.
Version managers not based on update-alternatives usually add/edit the entry in manpath
pointing to the correct man page or edit (add) entry in $PATH
environment variable.
update-alternatives
does this via mentioned slave links.
In case of google-chrome, even though it uses update-alternatives by default, it does feature the manual entry, but it does not use slave links and the installer simply copies the man page in the man location. Which prevents update-alternatives to apply sim link here. However, even though we can't do anything with the hard link we can add another manual entry just for the specific version. I'm install chromium so I would be interested to have chromium manual entry
manual entry for google chrome can be found here:
man -w google-chrome
We could manually move man entry for google-chrome-stable elsewhere and let update-alternatives utilize slave links, but we could also add another man entry via slave link to demonstrate flexibility. Let's do it.
sudo update-alternatives --install /usr/bin/google-chrome google-chrome /opt/google/chromium/chrome-linux/chrome \
--slave /usr/share/man/man1/chromium.1.gz chromium.1.gz /opt/google/chromium/chromium.1.gz
The result of this will be following. If we use the google-chrome-stable the manual entry for chromium via man chromium
will not be available, but swapping the version for chromium will make the manual entry for chromium available along the original manual entry which is/was set as hard link (actual file).
Summary
This short articles demonstrate the basic capabilities of the tool update-alternatives. More detail can be found on manual pages or on Debian website.