You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: _docs/developer/getting_started/worker_vm.md
+16-7Lines changed: 16 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -27,20 +27,28 @@ machines* in addition to your primary vagrant virtual machine.
27
27
```
28
28
For multiple workers, use the `-n` flag. (ex. `-n 3` for 3 machines).
29
29
30
+
This command will generate workers for `virtualbox`, or `qemu` if you are on M-series macOS.
30
31
If using a provider other than the default for your system, use the `--provider` flag.
31
-
(ex. `--provider parallels`)
32
+
(ex. `--provider my-custom-provider`)
32
33
33
-
4. If you are on MacOS running QEMU, make sure to restart the network socket.
34
+
5. If you are on MacOS running QEMU, make sure to restart the network socket.
34
35
```
35
36
vagrant workers socket restart
36
37
```
37
38
If the VM runs into errors when attempting to reach the internet, try starting the socket
38
-
in public mode. (`--public`)
39
+
in public mode. (`vagrant workers socket restart --public`)
39
40
40
-
5. Now you can provision the virtual machines with:
41
+
6. Now you can create the worker machine(s) with:
41
42
```
42
43
vagrant workers up
43
44
```
45
+
Do not use the --provider flag with this command, since it will conflict with the
46
+
provider generated in step 3.
47
+
48
+
7. Once all the workers are fully set up and running, `vagrant ssh` into the main VM and run:
49
+
```
50
+
refresh_vagrant_workers
51
+
```
44
52
45
53
---
46
54
@@ -50,14 +58,15 @@ If you would like to ensure the worker is functioning properly, or enter the wor
50
58
51
59
To connect to a worker machine through SSH, run:
52
60
```
53
-
vagrant ssh <worker-name>
61
+
vagrant workers ssh <worker-name>
54
62
```
55
63
56
64
If you want to test the connection between the primary VM and a worker, you can first `vagrant ssh` into the primary machine and then run this command to SSH into the worker from there:
57
65
```
58
-
su submitty_daemon -c ssh submitty@<ip-address>
66
+
su submitty_daemon -c ssh <worker-name>
59
67
```
60
-
The IP address of the worker machine will be indicated in the `.vagrant/workers.json` file.
68
+
69
+
The list of worker names can be displayed with `vagrant workers status`.
61
70
62
71
__NOTE__: Depending on the performance of your computer and the size of the autograding queue passed to the worker, the SSH command may hang for some time.
0 commit comments