Find below instructions to install/update VSoil software for Linux Debian/Ubuntu operating systems family.
To connect to the VSoil repository, stable version, you need to follow the instructions below. Notice: this step is needed only once.
Type in a shell terminal (or by simple copy/paste by mouse):
sudo apt-get install --yes wget && wget -O ./bootstrap.sh "https://vsoil.inrae.fr/repo/linux/bootstrap.sh" && sudo /bin/bash ./bootstrap.sh && /bin/rm -f ./bootstrap.sh
If you get an error during the post-installation step, this should be caused by an access problem on a repository, potentially different from vsoil. In this case, there should be an output message like W: Some index files failed to download. They have been ignored, or old ones used instead. If so, you should identify the Website causing the problem and comment/remove it from your "sources.list" files, in "/etc/apt" directory. Contact your system administrator if unsure.
If you want to test latest unstable VSoil packages, you can activate the vsoil-testing branch repository. To enable it, follow the instructions below.
Type in a shell terminal (or by simple copy/paste by mouse):
sudo apt-get install --yes vsoil-testing-apt-source
To disable this branch repository, just remove the package. Follow the instructions below.
Type in a shell terminal (or by simple copy/paste by mouse):
sudo apt-get remove --yes vsoil-testing-apt-source
Prerequisites: be connected to the VSoil repository, as described in section 1.
To use VSoil software and run VSoil models on your local computer, follow the instructions below. Notice: this will install all recommended extra software. In particular: C++ and Fortran compilers, R and some of its packages, some libraries (Blas, Lapack, Gimli).
Type in a shell terminal (or by simple copy/paste by mouse):
sudo apt-get install --install-recommends vsoil
To use VSoil software on your local computer but run VSoil models on a distant server, there are 4 steps. The first is to install VSoil on your local computer. If on Linux, see previous section (2.1). If on Windows, see the dedicated Web page.
The second step is on the server side. It involves installing the needed software to run VSoil models. Prerequisites: on the server side, be connected to the VSoil repository, as described in section 1. Then follow the instructions below.
Type in a shell terminal (or by simple copy/paste by mouse):
sudo apt-get install --install-recommends vsoil-run singularity-ce
Then, you need the server to accept SSH connections. So next step consists in installing the SSH server, on the server side. Do the following command.
Type in a shell terminal (or by simple copy/paste by mouse):
sudo apt-get install openssh-server
Finally, you need a user on the server to run the models, via the SSH connection. The easiest way is to create, on the server side, a dedicated user with the same login name as your local computer login name. You can type the following command, replacing the string MY_LOGIN_NAME. Notice: be concise and avoid spaces or special characters.
Type in a shell terminal (or by simple copy/paste by mouse):
sudo adduser MY_LOGIN_NAME
To use a VSoil software, you can invoke it by selecting its icon, as usual, on your operating system. Typically, this is done by entering a menu containing all applications, it depends on your graphical environment. As an alternative, you can type its name in a shell. See below for details:
Type in a shell terminal (or by simple copy/paste by mouse):
vsoil_processes
vsoil_modules
vsoil_models
vsoil_player
It is useful to regularly update the VSoil software. First, because there are regular major updates scheduled by the project team, approximatively, each year.
They concern new features and more (or updated) processes, skeletons, modules and model. The second reason is because there should be some bugs corrections and security patches in the software. It can appears at any moment during two major updates.
Just ask your operating system to do so as usual if you know how to do. Otherwise execute the following instructions, depending on your environment.
To update the package database and upgrade all packages, type in a shell:
sudo apt-get update && sudo apt-get upgrade --with-new-pkgs
The system will upgrade automatically all installed software to their latest version. If ensure, ask your system administrator.