Resource Oriented Computing Platform

The CoR-HPX library requires C++17 features. If you use GCC you would need GCC >= 7 (GCC 7.4.0 are used for development and testing). CMake 3.12 (or later) is required for the build and testing process of the Runtime. Libssh 0.8 (or later) is also required to spawning processes dynamicly.

The CoR-HPX library is built on HPX. In order to build HPX as the necessary requirement, please refer to either:
HPX Wiki: https://github.com/STEllAR-GROUP/hpx/wiki/HPX-Resource-Guide
HPX Documentation: https://hpx-docs.stellar-group.org/latest/html/index.html

summary:

• GCC (>= 7.0.0)
• HPX (>= 1.5.0)
• Libssh (>= 0.8)
• Cmake (>= 3.12)

git clone https://github.com/tiagofgon/CoR-HPX

• $HPX_LOCATION -> hpx library location
• $Libssh_LOCATION -> Libssh library location
• $INSTALATION_DIR -> CoR-HPX target installation

cd cor-hpx
mkdir build
cd build
cmake -DCMAKE_PREFIX_PATH=$HPX_LOCATION -DLibSSH_ROOT=$Libssh_LOCATION -DCMAKE_INSTALL_PREFIX=$INSTALATION_DIR ..

make -jN
make install

To use all features without defining paths (recommended):

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$INSTALATION_DIR/lib
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$INSTALATION_DIR/examples
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$INSTALATION_DIR/cap6
export PATH=$PATH:$INSTALATION_DIR/bin

Print active resource idp (thread/agent identifier)

$ corhpx app ctx 1 0 libmodule.so

Exchange data between two agents

$ corhpx app ctx 1 0 libbasicOperations.so

Launching a program with multiple domains(processes): using two consoles or using mpi

$ corhpx app ctx 2 0 /cor-hpx_installation_dir/examples/libparallel.so --hpx:hpx=localhost:1337
$ corhpx app ctx 2 0 /cor-hpx_installation_dir/examples/libparallel.so --hpx:agas=localhost:1337 --hpx:run-hpx-main --hpx:worker

using mpi: (N == number of domains(processes))

$ mpirun -np N corhpx apps ctx N 0 /cor-hpx_installation_dir/examples/libparallel.so

Dynamically spawn a new process

$ corhpx app ctx 1 0 libspawn.so