@@ -19,12 +19,12 @@ machines* in addition to your primary vagrant virtual machine.
19
19
python3 --version
20
20
```
21
21
22
- 3 . Generate configuration for the worker machine(s).
22
+ 3 . To generate configuration for a worker machine, run:
23
23
```
24
24
vagrant workers generate
25
25
```
26
26
27
- For multiple workers, append the ` -n ` flag. ( ex. ` -n 3 ` for 3 machines).
27
+ If instead you need multiple workers, append the ` -n ` flag, ex. for 3 machines:
28
28
```
29
29
vagrant workers generate -n 3
30
30
```
@@ -41,10 +41,12 @@ machines* in addition to your primary vagrant virtual machine.
41
41
We suggest this to minimize possibility of errors while creating the
42
42
worker machines and will revert this in a later step._
43
43
44
- __ NOTE__ : Never interact with the socket while a worker machine is running.
45
- This can make the machine inaccessible.
44
+ _ NOTE: Running a socket command while a worker machine is running can detach the
45
+ process, making the VM inaccessible to vagrant. If this happens and you are unable
46
+ to ` vagrant workers halt ` , then you may run ` pkill -15 -f qemu-system- ` to halt
47
+ the worker machine._
46
48
47
- 5 . Now you can create the worker machine(s) with:
49
+ 6 . Now you can create the worker machine(s) with:
48
50
```
49
51
vagrant workers up
50
52
```
@@ -53,17 +55,27 @@ machines* in addition to your primary vagrant virtual machine.
53
55
54
56
When this is finished, you should see the Submitty duck ASCII art for each new worker machine.
55
57
56
- 6 . You can verify that all the worker machines are running with:
58
+ 7 . You can verify that all the worker machines are running with:
57
59
```
58
60
vagrant workers status
59
61
```
60
62
61
- 7 . ` vagrant ssh ` into the main virtual machine and run:
63
+ 8 . ` vagrant ssh ` into the main virtual machine and run:
62
64
```
63
65
refresh_vagrant_workers # (runs python3 /usr/local/submitty/GIT_CHECKOUT/Submitty/.setup/bin/refresh_vagrant_workers.py)
64
66
submitty_install
65
67
```
66
68
69
+ 9 . To stop the worker machines, you can run:
70
+ ```
71
+ vagrant workers halt
72
+ vagrant workers socket stop
73
+ ```
74
+
75
+ _ For MacOS QEMU users: Once the virtual machine(s) are halted, if you would like to restart under
76
+ private networking, you may do so by omitting the ` --public ` flag from the ` vagrant workers socket start ` command._
77
+
78
+
67
79
---
68
80
69
81
## Connecting to the Worker Machine
0 commit comments