README.md 1.84 KB
Newer Older
John-Paul Robinson's avatar
John-Paul Robinson committed
1
2
3
4
5
6
7
8
9
10
11
12
13
14
Project to provision an OpenHPC cluster via Vagrant using the
CRI_XCBC (XSEDE basic cluster) Ansible provisioning framework.

The Vagrantfile takes inspiration from the [vagrantcluster](https://github.com/cluening/vagrantcluster)
project but is oriented toward deploying only a master node 
and using standard OHPC tools to provision the cluster, and 
therfore favors the CRI_XCBC approach to ansible scripts just 
for the master.

The Vagrantfile is stripped to the core (rather that carry all
the cruft of a vagrant init).  It leverages work from a 
[pilot project](https://gitlab.rc.uab.edu/ravi89/ohpc_vagrant)
(primaryly the development of an updated centos 7.5 image)
but prefers a clean repo slate.  
15

John-Paul Robinson's avatar
John-Paul Robinson committed
16
## Project Setup
17
18
19
20
21
22
23
24
25
26

After cloning this project you need to initialize the submodule
from with in the git repo
```
git submodule init
git submodule update
```

Alternatively you can provide the `--recurse-submodules` command 
during the initial clone.
27
28
29
30
31
32
33
34
35
36
37

## Cluster Setup

After setting up the project above create your single node OpenHPC
cluster with vagrant:
```
vagrant up
```

The ansible config will bring the master node to the point where its
ready to ingest compute nodes via wwnodescan and prompt to you
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
start a compute node.  You can create a compute node and start it with
the helper scripts:

Create node c0 (choose whatever name makes sense, c0 matches the config):
```
compute_create c0
```

When prompted start node c0:
```
compute_start c0
```

If you want to stop the node:
```
compute_stop c0
```

If you want to get rid of the compute node VM:
```
compute_destroy c0
```

Note, the compute scripts work directly with the VirtualBox hypervisor.  The
machine created is a basic, lightweight diskless compute node the boots
via iPXE from the OpenHPC master.   You may need to adjust the path to the
ipxe.iso in compute_create to match your local environment.