Bare Metal Installs
Prerequisites
To install, you need:
-
A valid LeanXcale license file
-
The LeanXcale zip distribution
-
Ubuntu 20.04 LTS or 22.04 LTS with a standard installation, including
-
openjdk-11-jdk
-
python3
-
python3-dev
-
python3-pip
-
gdb
-
java 11
-
ssh tools as included in most UNIX distributions.
-
-
Availability for ports used by leanXcale (refer to the [LeanXcale Components and Ports] section for details).
The install program itself requires a unix system with python 3.7 (or later).
Your sales representative will provide you with a valid license file. In case you have any issues with it, please send an email to sales@leanxcale.com.
The LeanXcale zip distribution can be found at:
https://artifactory.leanxcale.com/artifactory/lxpublic
There is a zip file per version. Download the latest version.
If needed, install the required software dependencies on your system:
unix$ sudo apt update unix$ sudo apt -y install python3 python3-dev python3-pip gdb openjdk-11-jdk curl
Here, and in what follows, unix$ is the sytem prompt used in
commands and examples.
Install
Working on the directory where the distribution has been downloaded, unzip the LeanXcale zipped distribution:
unix$ unzip lx.2.1.231129.zip Archive: lx.2.1.231129.zip creating: lxdist/ inflating: lxdist/lxinst.v2.1.port.tgz inflating: lxdist/lxavatica.v2.1.libs.tgz ...
Here, you type the command after the unix$ prompt, and the following
lines are an example of the expected output.
Verify that the process completed successfully and there is a directory
lxdist (with the distribution packages) and the lxinst program:
unix$ ls lx.2.1.231129.zip lxdist lxinst
To install, run the lxinst program and, as an option, supply the
name of the installation directory (/usr/local/leanxcale by
default):
unix$ ./lxinst /usr/local/leanxcale
sysinfo localhost...
install #cfgfile: argv /usr/local/leanxcale...
cfgcomps…
...
config: lxinst.conf
install done.
To run lx commands:
localhost:/usr/local/leanxcale/bin/lx
Or adjust your path:
# At localhost:~/.profile:
export PATH=/usr/local/leanxcale/bin:$PATH
To start (with lx in your path):
lx start
The command takes the zipped LeanXcale distribution from ./lxdist, and
installs it at the target folder.
The detailed configuration file built by the install process is
saved at lxinst.conf, as a reference.
The database has users (different from UNIX users). The user lxadmin is
the administrator for the whole system. During the install you are asked
to type a password for lxadmin.
To complete the install, a license must be added, as explained in the next section.
Using leanXcale Commands
The installation creates the lx command. Use it to execute commands
to operate the installed system.
At the end of the installation, the install program prints suggestions
for adjusting the PATH variable so that lx will be available as any
other command. For example, as done with:
export PATH=/usr/local/leanxcale/bin:$PATH
when the install directory is /usr/local/leanxcale.
The lx command can be found at the bin directory in the install
directory. For example, at /usr/local/leanxcale/bin/lx when
installing at /usr/local/leanxcale.
In what follows, we assume that lx is on the system PATH.
The first command used is usally the one to install a license file:
unix$ lx license -f lxlicense
It is also possible to put the license file at ~/.lxlicense, and the
install process will find it and install it on the target system(s).