Skip to content

Commit 956e973

Browse files
authored
[Documentation:Developer] add vagrant-timezone plugin (#612)
This may help fix clock skew on Vagrant (currently a problem on Mac machines?) This PR also adds some instructions for cleaning up an old vagrant installation that has the now-unnecessary Guest Additions.
1 parent 715fb9e commit 956e973

File tree

3 files changed

+51
-1
lines changed

3 files changed

+51
-1
lines changed

_docs/developer/getting_started/vm_install_using_vagrant.md

+1
Original file line numberDiff line numberDiff line change
@@ -135,6 +135,7 @@ If you using an Intel-based Mac, you will follow the instructions below._
135135
```
136136
brew install --cask virtualbox
137137
brew install --cask vagrant
138+
vagrant plugin install vagrant-timezone
138139
```
139140
140141
* **Windows**

_docs/developer/getting_started/vm_install_using_vagrant_apple_silicon.md

+2
Original file line numberDiff line numberDiff line change
@@ -59,6 +59,8 @@ the installation process.
5959
6060
$ brew install --cask vagrant
6161
62+
$ vagrant plugin install vagrant-timezone
63+
6264
$ vagrant plugin install vagrant-qemu
6365
```
6466
Note: It is possible that you may need to install Rosetta before installing vagrant. Run the following command to install Rosetta:

_docs/developer/troubleshooting/installation_troubleshooting.md

+48-1
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,7 @@ with no explanation, then there are a couple of things that may be going wrong:
5656
brew reinstall --cask vagrant
5757
vagrant plugin update
5858
vagrant box update
59+
vagrant plugin install vagrant-timezone
5960
```
6061
6162
If you continue to have errors on Mac with `vagrant up` after
@@ -98,11 +99,25 @@ with no explanation, then there are a couple of things that may be going wrong:
9899
directories/repositories to clean up unwanted VMs.
99100
100101
The following command can help locate misplaced repositories/VMs:
101-
102102
```
103103
vagrant global-status
104104
```
105105
106+
If you see unnecessary VMs, you can clean them up with (replace
107+
`1a2b3c4d` with the id of the VM you wish to destroy):
108+
```
109+
vagrant destroy 1a2b3c4d
110+
```
111+
112+
If the command above does not successfully destroy and remove the VM from the
113+
global-status list, you may see an error similar to: `The machine
114+
with the name 'ubuntu-20.04' was not found configured for this
115+
Vagrant environment.` You can try to clean up these undestroyed VMs record by
116+
running:
117+
```
118+
vagrant global-status --prune
119+
```
120+
106121
* If you might have old, forgotten VMs from previous OS versions
107122
hanging around it can be helpful to completely delete the `.vagrant`
108123
folder in your repository. Also check to see if you have multiple
@@ -169,3 +184,35 @@ broadcast 192.168.56.255
169184
```
170185
171186
References and useful links: [https://gist.github.com/pjdietz/5768124](https://gist.github.com/pjdietz/5768124) and [http://christophermaier.name/2010/09/01/host-only-networking-with-virtualbox/](http://christophermaier.name/2010/09/01/host-only-networking-with-virtualbox/)
187+
188+
189+
## Guest Additions
190+
191+
192+
Submitty vagrant no longer uses Virtual Box Guest Additions. If you
193+
see errors about version mismatch with Guest Additions, and if the VM
194+
hangs trying to update the version of Guest Additions to match the
195+
host version of Guest Additions, you may have old versions of the
196+
development process on your machine and may need to more completely
197+
uninstall and reinstall Virtual Box and Vagrant to reset your system.
198+
199+
**NOTE: THESE ACTIONS WILL DELETE ALL VMS ON YOUR SYSTEM.**
200+
201+
Some things to check:
202+
203+
* From your main Submitty repository, e.g. `<SOMETHING>/GIT_CHECKOUT/Submitty/`
204+
run `rm -rf .vagrant`
205+
206+
(you may need to put sudo in front)
207+
208+
* Check all files on your filesystem for vagrant. Run 'locate
209+
vagrant' and remove any old library / installation files you see.
210+
E.g.:
211+
212+
```
213+
rm /Applications/VirtualBox.app/Contents/MacOS/VBoxGuestAdditions.iso
214+
rm -rf /opt/vagrant/
215+
rm -rf /Users/MY_HOME_DIRECTORY/.vagrant.d/
216+
rm -rf /Users/MY_HOME_DIRECTORY/.gem/specs/rubygems.org%443/quick/Marshal.4.8/vagrant-vbguest-0.31.0.gemspec
217+
```
218+

0 commit comments

Comments
 (0)