Installation on Linux¶
Here are described the main steps for installing and licensing LocalSolver on your computer. LocalSolver is implemented in C++ language. The software can be used either as a standalone executable or as a callable library (C++, Java, Python, .NET). Please check that your computer meets the minimum system requirements before installing the software.
System requirements¶
Architecture: x64.
Operating systems: Linux with libc 2.17 (or superior) and libstdc++ 6.0.19 (or superior).
For the C++ library: GCC 6.1 (or superior) and C++11 (or superior).
For the Java library: Java 8 (or superior).
For the .NET library: .NET Core 2.0 (or superior), Mono 2.6 (or superior).
For the Python library: Python 2.7, or Python >= 3.4.
Installation¶
You must have administrator rights on your computer to install LocalSolver. If you haven’t done so yet, download LocalSolver for Linux from the LocalSolver website.
Open a terminal as root where the archive LocalSolver_11_5_20230316_Linux64.run is located.
Execute the following command line:
$ bash LocalSolver_11_5_20230316_Linux64.run
Choose the install location of LocalSolver and press enter to start
the installation. Note that you can install different versions of LocalSolver
on your system but only the last installed version will be easily accessible
from the command line. To use the previous ones, you have to use their exact
path (e.g. /opt/localsolver_11_5/bin/localsolver
). Furthermore, you will
experience troubles if you try to use the native C library without modifying
environment variables such as LD_LIBRARY_PATH
.
If you install LocalSolver for the first time or if no license file is already present on your system, a specific page with your hardware signature will appear at the end of the installation. You will have to give us this hexadecimal number if you want to apply for a free trial license or a free academic license on our website.
Licensing for: Free Trial, Free Academic, Desktop or Server licenses¶
Note
If you don’t have your license yet, please go to our website to register and request a free academic license or a free trial license. As licenses are manually delivered by a member of the LocalSolver team, the whole procedure can take a few days to complete (usually 1 day).
You simply have to put the correct license file in the installation folder of LocalSolver. For that:
Go on LocalSolver website, login on your account and download your license file.
Copy the file
license.dat
downloaded from your account in /opt/localsolver_11_5/.
Licensing for: Floating or Site licenses¶
This procedure applies only if you bought a floating or an academic network license. You have to setup a token server and then license each client machine as follows.
For the token server¶
Go to your account and download the license file of the token server.
Copy the file
license.dat
downloaded from your account in /opt/localsolver_11_5/.Open a terminal and launch the executable “lstokenserver”. Note that this program is launched in background and will keep running until the machine is shut down. You can safely close your terminal.
If you want to start automatically the token server when the machine is rebooted you have to create an init script. You can also add the following line in /etc/rc.local:
/opt/localsolver_11_5/bin/lstokenserver
For each client machine¶
Create a new file and write the following line with the IP of the token server:
TOKEN_SERVER = <HOST NAME OR IP ADDRESS OF THE TOKEN SERVER>
Save it in /opt/localsolver_11_5/license.dat.
Note
The token server listens on TCP port 7462. Please ensure that your firewall is correctly configured to allow the trafic between the lstokenserver service and your applications.
Alternative license locations¶
If you want to use several licenses on the same machine, or if you have no write access to the default license location, you can specify a different license path. LocalSolver will look at the following locations for a valid license file, in that order:
The file the
LS_LICENSE_PATH
environment variable points to.In the current directory, if a file named
license.dat
is present.In the default location, /opt/localsolver_11_5/license.dat.
The LocalSolver API provides methods to set the license path. To use it, please consult the documentation for your programming language.
License content can also be provided through a LS_LICENSE_CONTENT
environment
variable. This variable content will have priority over the license file.
Testing¶
Open a terminal in folder /opt/localsolver_11_5/ and enter the following line:
$ localsolver examples/toy/toy.lsp lsTimeLimit=1
If no error occurs, you are ready to use LocalSolver and solve your first model.
Uninstall LocalSolver¶
You must have root privileges on your computer to uninstall LocalSolver. Then, uninstall LocalSolver in 2 steps:
Open a terminal as root and navigate to /opt/localsolver_11_5/
Execute the following command line:
bash uninstall.sh