An unfortunate result of maintaining a project with so many moving parts is that it’s prone to have issues. Although I do my best to keep everything working and run automated build tests once per week, sometimes issues slip through the cracks.
Be sure to check the GitHub issues page for solved issues related to your problem: https://github.com/clong/DetectionLab/issues
Here are some strategies for resolving common problems:
Issue: You run into an error while provisioning a host
Solution: Each problem is different. Take a look at the error text and see if you can determine what the exact problem is based on the error message. Often times, running
vagrant reload <hostname> --provision is enough to get things back on track. That command will simply restart the VM and start provisioning over again. If that doesn’t work, try destroying the host via
vagrant destroy <hostname> and then re-creating it using
vagrant up <hostname>. If you continue to run into the same error, search DetectionLab issues. Finally, if you can’t find a solution to your problem, please open a new issue!
Issue: You get stuck and want to start fresh
Solution: Navigate to DetectionLab/Vagrant and run
vagrant destroy -f to force destroy all VMs. Afterwards, delete the
.vagrant hidden folder inside of DetectionLab/Vagrant to ensure the VMs and their metadata have been properly removed. Optionally, delete and re-clone the entire DetectionLab git repo after those steps have been completed.
Issue: I get an “ERR_TOO_MANY_REDIRECTS” when trying to connect to the Exchange server over HTTPS
Workarounds: This often happens when you try to connect to Exchange while the server is still initializing. Wait 5-10 minutes, then try again. If the issue persists, please file an issue on GitHub.
Issue: Splunk says “Your Splunk license has expired or you have exceeded your license too many times”
vagrant destroy -f logger; vagrant up logger
Issue: Vagrant reports:
Message: HTTPClient::KeepAliveDisconnected: while provisioning.
$ vagrant reload <hostname> --provision
Vagrant timed out while attempting to connect via WinRM after Win10 host joins the domain.
Workaround Documented in #21. Just run
$ vagrant reload win10 --provision
Issue: Vagrant is unable to forward a port for you.
Workaround: Documented in #11. There are a few possibilities:
vagrant reload <hostname> --provision. For whatever reason
vagrant updoesn’t fix conflicts but reload does.
sudo lsof -n -iTCP:<port_number>
Issue: Your primary hard drive doesn’t have enough space for DetectionLab.
Issue: You’re having problems running Virtualbox while Hyper-V or CredentialGuard are enabled
Workaround: This is not a supported configuration. See https://stackoverflow.com/questions/37955942/vagrant-up-vboxmanage-exe-error-vt-x-is-not-available-verr-vmx-no-vmx-code and https://github.com/clong/DetectionLab/issues/433
Issue: You see an error message like
VBoxManage: error: Unknown option: --clipboard
Workaround: This should be fixed in Virtualbox 6.1.4, but please see this issue for details on how to fix this.