Skip to content

Commit 3c18b1e

Browse files
author
Tom Maher
committed
more docs about vagrant setup
1 parent 19f9c7d commit 3c18b1e

File tree

1 file changed

+10
-2
lines changed

1 file changed

+10
-2
lines changed

test/support/vm/openldap/README.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,18 +8,22 @@ goes away when you run `vagrant destroy`.
88
## Install Vagrant
99

1010
*NOTE*: The Vagrant gem (`gem install vagrant`) is
11-
[no longer supported](https://www.vagrantup.com/docs/installation/)
11+
[no longer supported](https://www.vagrantup.com/docs/installation/). If you've
12+
previously installed it, run `gem uninstall vagrant`. If you're an rbenv
13+
user, you probably want to follow that up with `rbenv rehash; hash -r`.
1214

1315
If you use Homebrew on macOS:
1416
``` bash
1517
$ brew update
1618
$ brew cask install virtualbox
1719
$ brew cask install vagrant
1820
$ brew cask install vagrant-manager
21+
$ vagrant plugin install vagrant-vbguest
1922
```
2023

2124
Installing Vagrant and virtualbox on other operating systems is left
22-
as an exercise to the reader.
25+
as an exercise to the reader. Note the `vagrant-vbguest` plugin is required
26+
to update the VirtualBox guest extensions in the guest VM image.
2327

2428
## Run the tests
2529

@@ -54,3 +58,7 @@ $ time bundle exec rake
5458
$ cd test/support/vm/openldap
5559
$ vagrant destroy
5660
```
61+
62+
If at any point your VM appears to have broken itself, `vagrant destroy`
63+
from the `test/support/vm/openldap` directory will blow it away. You can
64+
then do `vagrant up` and start over.

0 commit comments

Comments
 (0)