Vagrant Usage¶
- Author:
Stephan Meissl
- Contact:
stephan.meissl at eox.at
- Author:
Jeff McKenna
- Contact:
jmckenna at gatewaygeomatics.com
- Last Updated:
2023-08-21
Probably the simplest way to run MapServer regression tests is using Vagrant as described below.
Installation and Initial Configuration¶
Install VirtualBox & Vagrant. The configuration is tested with:
Install Vagrant add-ons:
Highly recommended: vagrant-vbguest to check for Virtualbox Guest Additions
Optional: vagrant-cachier to cache yum/apt/etc. packages
Optional: sahara for sandboxing
vagrant plugin install vagrant-vbguest
vagrant plugin install vagrant-cachier
vagrant plugin install sahara
Clone MapServer:
git clone https://github.com/MapServer/MapServer.git
cd MapServer/
You will notice that an msautotest subdirectory (inside MapServer) exists after your checkout.
Run Vagrant¶
To initialize Vagrant simply run the following from the MapServer directory:
vagrant up
vagrant ssh
You're all set to run the tests as described in Regression Testing (msautotest).
Troubleshoot Vagrant¶
If the provisioning didn't finish during vagrant up or after changes try: vagrant provision
(Re-)Install virtualbox guest additions in case it complains about not matching versions: vagrant vbguest -f
Slow performance: Check "Enable IO APIC", uncheck "Extended Features: Enable PAE/NX", and uncheck "Enable Nested Paging" in VirtualBox Manager.
Symlinks with VirtualBox 4.1 not working: vi /opt/vagrant/embedded/gems/gems/vagrant-1.3.5/plugins/providers/virtualbox/driver/version_4_1.rb and add those changes: https://github.com/mitchellh/vagrant/commit/387692f9c8fa4031050646e2773b3d2d9b2c994e