Local Installation
Contents
2.3. Local Installation#
If you run on one of the supported distributions
Enterprise Linux 7 or CentOS 7 (
el7
)Enterprise Linux 8 or CentOS 8 (
el8
)Enterprise Linux 9 or AlmaLinux 9 (
el9
)Ubuntu 20.04 (
ubuntu2004
)Ubuntu 22.04 (
ubuntu2204
)
the installation uses precompiled binaries and is rather quick. Otherwise the code has to be compiled from source which takes a lot of time.
Hint
To find which distribution you are running on you can use
lsb_release -a
.
After you install the Belle II Software Tools you only need to download the software and corresponding externals version.
2.3.1. Downloading the Software Release#
We can obtain a list of available releases by just calling
$ b2install-release
This will give you a list of all release versions available for download. If
you don’t know which version to use just take the one with the highest number
starting with release-
. You can then download this release by calling
$ b2install-release <version> [<system>]
where <version>
should be the version you want. The operating system is
automatically determined, but you can override this by giving the system
argument which should be the short distribution name for the desired system
from the list of supported distributions in the table above. For example, to download
release-06-01-12
on an Ubuntu 20.04 machine you need to run
$ b2install-release release-06-01-12 ubuntu2004
Warning
If you work on a system for which we do not provide precompiled binaries the b2install-release command will compile the release from source. This requires that the externals are already installed, see next section.
2.3.2. Downloading the Externals Software#
After downloading the software itself you will also need to download the corresponding externals package which contains all external software required by the software. The easiest way to find out which externals version you need is by trying to setup the software version you just downloaded. For example
$ b2setup release-06-01-12
should print an error like
The externals version v01-12-01 does not exist. You can use ‘b2install-externals’ to install them.
which tells us that we need externals version v01-12-01
by calling
$ b2install-externals v01-12-01 [<system>]
system
is again optional and can be the short distribution name for the desired system from the
list of supported distributions. For example, to download
externals v01-12-01
on an Ubuntu 20.04 machine you need to run
$ b2install-externals v01-12-01 ubuntu2004
Now everything should be installed and you can setup the software using
$ b2setup release-06-01-12
(or any other version you installed).
Warning
If you work on a system for which we do not provide precompiled binaries the b2install-externals command will compile the externals from source. This can take an hour or more. In case of problems try to find a solution at the troubleshooting guide or at questions.
2.3.3. Validation of the Installation#
A quick test to check whether everything was installed correctly is to execute
$ basf2 --info
and to list the available modules with
$ basf2 -m