README.md 1.49 KB
Newer Older
Paul Rich's avatar
Paul Rich committed
1
2
3
# PMIX Vagrant Test Setup #

This is a vagrant configuration and provisioner for testing out PMIx.  This is
Paul Rich's avatar
Paul Rich committed
4
5
built around the bento/CentOS-7 box.  This setup supports both VirtualBox and
VMWare Workstation environments with the VMWare connector for Vagrant.
Paul Rich's avatar
Paul Rich committed
6

Paul Rich's avatar
Paul Rich committed
7
8
9
10
11
12
13
14
15
This setup contains builds of PMIx, PRRTE, and an OpenMPI master built against
the locally built PMIx and PRRTE.

## Setup ##

1. If you haven't done so install VirtualBox.  Instructions are available here:
 https://www.virtualbox.org/manual/ch01.html#intro-installing
2. Install a Vagrant pacakage from here: https://www.vagrantup.com/intro/getting-started/install.html
3. Clone the pmix-vagrant git repository:
Paul Rich's avatar
Paul Rich committed
16
```
17
git clone https://xgitlab.cels.anl.gov/aig-public/pmix-vagrant.git
Paul Rich's avatar
Paul Rich committed
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
```
4. Bring up the Vagrant box with _vagrant up_. Significant output about the VM
   and image bring up will follow.

## Usage ##

1. Once the bring up has completed, you can see which environments are running
   with _vagrant global-status_.
2. You may connect to the VM with _vagrant ssh_
3. Once connected, you should be able to build using the built MPI compilers and
   run using _orterun_ from ~vagrant/openmpi-install.

## Notes ##
* The builds of PMIx, PRRTE, and OpenMPI were based on the following sites and
   each repositories HACKING files:
* https://pmix.org/code/getting-the-reference-implementation/
* https://pmix.org/code/getting-the-pmix-reference-server/
* https://pmix.org/code/building-the-pmix-reference-server/
* These were built with debugging enabled.