Using APEX with HPX5

Build APEX

NB: the following instructions assume the bash shell.

First, you need to build APEX. A "vanilla" configuration that would work with HPX and provide support for APEX policies would use the following steps:

Step 1. Download, configure and build APEX (using the latest code in Github).

Obviously, change the installation prefix if desired, and you can use your own builds of Active Harmony and Binutils. See the full documentation for details.

git clone https://github.com/khuck/xpress-apex
cd xpress-apex
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=../install -DCMAKE_BUILD_TYPE=RelWithDebInfo -DUSE_OMPT=FALSE -DBUILD_EXAMPLES=TRUE -DBUILD_TESTS=TRUE -DBUILD_BFD=TRUE -DBUILD_ACTIVEHARMONY=TRUE -DUSE_OTF2=FALSE ..
make -j8
make doc
make install

Step 2. Download, configure and build HPX-5 (using the latest release, or their Gitlab code if desired).

Again, change the installation prefix if desired, and you can specify your own versions of HPX dependencies - see the HPX documentation for details.

wget http://hpx.crest.iu.edu/release/hpx-4.0.0.tar.gz
tar -xzf hpx-4.0.0.tar.gz
cd hpx-4.0.0
cd scripts
./setup-autotools.sh ../autotools-install
cd ..
export PATH=`pwd`/autotools-install/bin:$PATH
export LD_LIBRARY_PATH=/path/to/xpress-apex/install/lib:$LD_LIBRARY_PATH
export PKG_CONFIG_PATH=/path/to/xpress-apex/install/lib/pkgconfig:$MPI/lib/pkgconfig:$PKG_CONFIG_PATH
./bootstrap
./configure --enable-testsuite --prefix=`pwd`/hpx-install --with-apex=yes --enable-instrumentation --enable-shared --enable-mpi --with-libffi=contrib --with-jemalloc=contrib
make -j8
make install
export PKG_CONFIG_PATH=`pwd`/hpx-install/lib/pkgconfig:$PKG_CONFIG_PATH

Step 3. Download, configure and build HPX application example: LibPXGL

git clone https://gitlab.crest.iu.edu/hpx-apps/LibPXGL.git
cd LibPXGL
./bootstrap
./configure --with-hpx="hpx,apex,hwloc"
make

Step 4. Run the HPX LibPXGL example

(coming soon)