Find below instructions to install/update VSoil software for Linux Debian/Ubuntu operating systems family.

1 - Connect to the VSoil repository

1.1 - Stable version

To connect to the VSoil repository, stable version, you need to follow the instructions below. Notice: this step is needed only once.

With command line interface

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.

1.2 - Testing version

If you want to test latest unstable VSoil packages, you can activate the vsoil-testing branch repository. To enable it, follow the instructions below.

With command line interface

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.

With command line interface

Type in a shell terminal (or by simple copy/paste by mouse):

sudo apt-get remove --yes vsoil-testing-apt-source

2 - Installing the VSoil software

2.1 - VSoil software on local computer

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).

With command line interface

Type in a shell terminal (or by simple copy/paste by mouse):

sudo apt-get install --install-recommends vsoil

2.2 - To run VSoil models on a distant server

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.

With command line interface

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.

With command line interface

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.

With command line interface

Type in a shell terminal (or by simple copy/paste by mouse):

sudo adduser MY_LOGIN_NAME

3 - Use a VSoil software

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:

4 - Upgrade VSoil software

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.

With command line interface

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.