Open MPI logo

Frequently Asked Questions

  |   Home   |   Support   |   FAQ   |   all just the FAQ
This FAQ is for Open MPI v4.x and earlier.
If you are looking for documentation for Open MPI v5.x and later, please visit docs.open-mpi.org.

Table of contents:

  1. How do I build netloc?
  2. What version of hwloc does netloc require?
  3. What is Jansson? Why does netloc require it?


1. How do I build netloc?

The following only applies to netloc v0.5 since next releases will be included in hwloc releases.

In general, all you need to do is expand the tarball, run the provided configure script, and then run "make all install". For example:

1
2
3
4
5
shell$ gunzip -c netloc-.tar.gz | tar xf -
shell$ cd netloc-
shell$ ./configure --prefix=/usr/local
<...lots of output...>
shell$ make all install

Note that the configure script supports a lot of different command line options. For example, the --prefix option in the above example tells netloc to install under the directory /usr/local/.

Consult the README file in the netloc tarball and the output of "configure --help" for specific instructions regarding netloc's configure command line options.


2. What version of hwloc does netloc require?

The following only applies to netloc v0.5 since next releases will be included in hwloc releases.

netloc requires a hwloc version of 1.4.2 or later. There are some addtional features in hwloc 1.8 and later that netloc can take advantage of as well (e.g., topology compression).


3. What is Jansson? Why does netloc require it?

Jansson is C library for managing JSON encoded data. Internally, netloc uses Jansson to store metadata and the network topology.

netloc requires Jansson version 2.3 or later. The --with-jansson(=DIR) configure option allows you to specifiy the location of the Jansson library. The (=DIR) part means that specifying the directory is optional.