mpiJava installation and usage guide
mpiJava is an open source implementation of the Message Passing Interface (MPI) for the Java programming language.
This guide presents some tips how to get the tool installed and running.
Installation and configuration
The main steps towards getting mpiJava installed are following:
Getting the source code
mpiJava is managed on the ?SourceForge under the Mercurial version control system (see more about Mercurial at http://mercurial.selenic.com/).
When using the command line, mpiJava can be checked out by using the command:
Configuring the mpiJava build
mpiJava's build system is supported by CMake - a powerful configuration system for complex software projects.
In order to configure mpiJava, run the command:
- cmake-gui
Hint to the Windows users: to avoid problem with binding the compiler, start cmake-gui from the Visual Studio command prompt
and specify the needed configuration options, as shown in the Screenshot below.
To start the configuration, click on the Configure button in the CMake-GUI interface. After the configuration has been successfully done, click on the Generate button to generate a build-ready version. You may now close the CMake GUI.
Building
To build the configured code from the command line, switch to the directory where CMake has built the binaries and execute a build command (depends on your OS as well as available build system). Below are some typical patterns:
- Linux: make; make install
- Windows (Visual Studion compiler): nmake; nmake install
- Windows (MinGW compiler): migw32-make
Testing
To test the mpiJava installation, switch to the directory where it has been installed to, and execute a simple ?PingPong test, like below:
bin/prunjava 2 -cp share/mpijava/examples/PingPong/PingPong.jar ?PingPong