Commit e880a922 authored by Paul Rich's avatar Paul Rich
Browse files

updating README.md

parent f6083877
# PMIX Vagrant Test Setup #
This is a vagrant configuration and provisioner for testing out PMIx. This is
built around the bento/CentOS-7 box.
built around the bento/CentOS-7 box. This setup supports both VirtualBox and
VMWare Workstation environments with the VMWare connector for Vagrant.
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:
````
git clone https://xgitlab.cels.anl.gov/AIG/pmix-vagrant.git
```
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.
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment