Troubleshooting the Skytap provider for Vagrant and known issues
Troubleshooting timeout errors during vagrant up commands
If you get a timeout error after vagrant up
, check the following:
- Get the hostname of the VM using the command line
vagrant ssh-config
, and then use traceroute to make sure that you can connect to the VM. - Make sure your local machine is connected to a VPN in the same region as the source VM.
-
Make sure that the VM is able to accept a connection.
Notes
- Linux VMs must have an SSH service configured to run at startup
- Windows VMs must be configured for WinRM access.
- For more details, see https://docs.vagrantup.com/v2/boxes/base.html.
Logging
To enable logging while troubleshooting, see https://docs.vagrantup.com/v2/other/debugging.html.
Known issues
- If an older version of Vagrant can’t find the box file, set an environment variable for the alternative host with
export VAGRANT_SERVER_URL=https://app.vagrantup.com
. - If you try to install the provider with
vagrant up --provider skytap --install-provider
the process will fail. Install the provider before invokingvagrant up
. - Windows VMs must be configured for WinRM access. For more information about WinRM configurations, see Windows Boxes at https://docs.vagrantup.com/v2/boxes/base.html.
- WinRM credentials stored in Skytap VMs aren’t used. The user name and password for WinRM connections must be stored in the Vagrantfile:
config.winrm.username
andconfig.winrm.password
(unless you use the default vagrant/vagrant). - If you get a stale NFS file handle error after reloading a Skytap VM, use
vagrant up [<vm-name>]
to refresh any NFS mounts for that VM. This is a Vagrant known issue. - Vagrant public and private networks aren’t supported.
- UDP port forwarding isn’t supported.
vagrant port
isn’t supported.- You can’t change a VPN connection for a VM after it has been created.
Reporting problems
When you report an issue with the Skytap provider for Vagrant, include the output when using VAGRANT_LOG=debug
.
Remove your API token from the log file before sending or posting the log output.