MediaWiki-Vagrant/Troubleshooting

Puppet failures
If Puppet fails to configure your machine,  will terminate with the following error message:

This error may be caused by run-time failure to connect to Ubuntu package repositories or Gerrit. In such cases, you can simply trigger another Puppet run by running.

If your problem persists, collect detailed information using  and attach to a new bug report in Phabricator.

Vagrant / VirtualBox failures
In general, Vagrant and VirtualBox get along quite well. Once in a blue moon, a VM crash in a way that causes Vagrant to lose the ability to manage the machine or inspect its status. If this should happen, you can usually fix things by running VirtualBox's management console and rebooting the machine there.

Some users may see an error:

VT-x features locked or unavailable in MSR. (VERR_VMX_MSR_LOCKED_OR_DISABLED). Result Code: NS_ERROR_FAILURE (0x80004005)

upon trying to bring up the MediaWiki VM.

Click settings, accept the recommended change, and discover that the VM image is 40G in size and a FAT filesystem only supports files up to 16G in size. VirtualBox suggests a filesystem such as ext3 with sufficient size for image files.

Connection failures
If you try to connect to http://localhost:8080 and you can't connect:
 * Is your Vagrant VM up and running?
 * Do you have any other proxies setup on port 8080?
 * Are there any other browser add-ons, plugins, or proxies wired up that could interfere with connections to localhost?
 * Do you have the Xdebug settings in place, but no tool to intercept the Xdebug connect back calls for PHP scripts?
 * Have you tried...
 * From within a  session,  ?
 * From your host a  and  ?
 * Stashing any file changes you've made in the code and running the pristine code?

If you're trying to connect to http://dev.wiki.local.wmftest.net:8080/ while offline: 127.0.0.1 dev.wiki.local.wmftest.net
 * Make sure to have the following in your  file (outside the VM). Edit by running
 * 1) Access MediaWiki-Vagrant when offline

Updating guest additions
After updating mediawiki-vagrant to the latest version, you might get a random error like "The following SSH command responded with a non-zero exit status." To fix this, you should update your guest additions. vagrant ssh update-guest-additions cd /tmp sudo su #need to be root cd guest-additions.* # the ending is going to be some random string of characters ./VBoxLinuxAdditions.run install

The last command may end with "Installing the Window System drivers ...fail!", but that's ok. Now you should log out of vagrant, and run  and  !