Extracting the tar ball

tar xvfz MobilityDB-1.0.tar.gz
cd MobilityDB-1.0

To compile assuming you have all the dependencies in your search path

mkdir build
cd build
cmake  ..
make
sudo make install

Once MobilityDB is installed, it needs to be enabled in each individual database you want to use it in. In this example, PostGIS 2.5.5 is been used:

createdb mobility
psql mobility -c "CREATE EXTENSION PostGIS WITH VERSION '2.5.5'"
psql mobility -c 'CREATE EXTENSION MobilityDB'

The MobilityDB latest release can be found in https://github.com/MobilityDB/MobilityDB/releases/latest

wget

To download this release:

wget -O mobilitydb-1.0.tar.gz https://github.com/MobilityDB/MobilityDB/archive/v1.0.tar.gz

Go to Section 1.5.1 to the extract and compile instructions.

git

To download the repository

git clone https://github.com/MobilityDB/MobilityDB.git
cd MobilityDB
git checkout v1.0

Go to Section 1.5.1 to the compile instructions (there is no tar ball).

MobilityDB is an extension that depends on PostGIS. Enabling PostGIS before enabling MobilityDB in the database can be done as follows

CREATE EXTENSION postgis;
CREATE EXTENSION mobilitydb;

Alternatively, this can be done in a single command by using CASCADE, which installs the required PostGIS extension before installing the MobilityDB extension

CREATE EXTENSION mobilitydb CASCADE;

Compilation Dependencies

To be able to compile MobilityDB, make sure that the following dependencies are met:

Please notice that PostGIS has its own dependencies such as Proj4, GEOS, LibXML2, or JSON-C, and these libraries are also used in MobilityDB. For a full PostgreSQL/PostGIS support matrix and PostGIS/GEOS support matrix refer to http://trac.osgeo.org/postgis/wiki/UsersWikiPostgreSQLPostGIS.

Optional Dependencies

For the user's documentation

For the developers's documentation

Example: Installing dependencies on Linux

Database dependencies

sudo apt-get install postgresql-13 postgresql-server-dev-13 postgresql-13-postgis

Build dependencies

sudo apt-get install cmake gcc libgsl-dev

MobilityDB uses the cmake system to do the configuration. The build directory must be different from the source directory.

To create the build directory

mkdir build

To see the variables that can be configured

cd build
cmake -L ..

Please notice that the current version of MobilityDB has only been tested on Linux systems. It may work on other UNIX-like systems, but remain untested. Support for Windows is planned. We are looking for volunteers to help us to test MobilityDB on multiple platforms.

The following instructions start from path/to/MobilityDB on a Linux system

mkdir build
cd build
cmake ..
make
sudo make install

When the configuration changes

rm -rf build

and start the build process as mentioned above.

MobilityDB uses ctest, the CMake test driver program, for testing. This program will run the tests and report results.

To run all the tests

ctest

To run a given test file

ctest -R '21_tbox'

To run a set of given test files you can use wildcards

ctest -R '22_*'

MobilityDB user's documentation can be generated in HTML, PDF, and EPUB format. Furthermore, the documentation is available in English and in other languages (currently, only in Spanish). The user's documentation can be generated in all formats and in all languages, or specific formats and/or languages can be specified. MobilityDB developer's documentation can only be generated in HTML format and in English.

The variables used for generating user's and the developer's documentation are as follows:

Generate the user's and the developer's documentation in all formats and in all languages.

cmake -D DOC_ALL=ON -D LANG_ALL=ON -D DOC_DEV=ON ..
make doc
make doc_dev

Generate the user's documentation in HTML format and in all languages.

cmake -D DOC_HTML=ON -D LANG_ALL=ON ..
make doc

Generate the English user's documentation in all formats.

cmake -D DOC_ALL=ON ..
make doc

Generate the user's documentation in PDF format in English and in Spanish.

cmake -D DOC_PDF=ON -D ES=ON ..
make doc