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
start a compute node.  You can create a compute node and start it with
the helper scripts:

41
Create node c1 (choose whatever name makes sense, c1 matches the config):
42
```
43
compute_create c1
44
45
```

46
When prompted start node c1:
47
```
48
compute_start c1
49
50
51
52
```

If you want to stop the node:
```
53
compute_stop c1
54
55
56
57
```

If you want to get rid of the compute node VM:
```
58
compute_destroy c1
59
60
61
62
63
64
```

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.