diff options
| author | varac <varacanero@zeromail.org> | 2013-09-27 14:50:18 +0200 |
|---|---|---|
| committer | varac <varacanero@zeromail.org> | 2013-09-27 15:11:44 +0200 |
| commit | 79a794f67d1f2ae1d363ec2123e97d780654c3a9 (patch) | |
| tree | ac2dc8c6c0695f7c46375a3a9a2b10e0c482d60f /docs/platform/development.md | |
| parent | 70d14b86fff9c0f249ab45bfd474f98f909ed10b (diff) | |
added TOC, vagrant troubleshooting and working combinations
Diffstat (limited to 'docs/platform/development.md')
| -rw-r--r-- | docs/platform/development.md | 30 |
1 files changed, 30 insertions, 0 deletions
diff --git a/docs/platform/development.md b/docs/platform/development.md index 02ee068..070d14b 100644 --- a/docs/platform/development.md +++ b/docs/platform/development.md @@ -1,4 +1,5 @@ @title = "Development Environment" +@toc = true If you are wanting to make local changes to your provider, or want to contribute some fixes back to LEAP, we recommend that you follow this guide to build up a development environment to test your changes first. Using this method, you can quickly test your changes without deploying them to your production environment, while benefitting from the convenience of reverting to known good states in order to retry things from scratch. @@ -181,3 +182,32 @@ More information ---------------- See `leap help local` for a complete list of local-only commands and how they can be used. + + +Troubleshooting Vagrant +======================= + +To troubleshoot vagrant issues, try going through these steps: + +* Try plain vagrant using the [Getting started guide](http://docs.vagrantup.com/v2/getting-started/index.html). +* If that fails, make sure that you can run virtual machines (VMs) in plain virtualbox (Virtualbox GUI or VBoxHeadless). + We don't suggest a sepecial howto for that, [this one](http://www.thegeekstuff.com/2012/02/virtualbox-install-create-vm/) seems pretty decent, or you follow the [Oracale Virtualbox User Manual](http://www.virtualbox.org/manual/UserManual.html). There's also specific documentation for [Debian](https://wiki.debian.org/VirtualBox) and for [Ubuntu](https://help.ubuntu.com/community/VirtualBox). If you succeeded, try again if you now can start vagrant nodes using plain vagrant (see first step). +* If plain vagrant works for you, you're very close to using vagrant with leap ! If you encounter any problems now, please [contact us](https://leap.se/en/about-us/contact) or use our [issue tracker](https://leap.se/code) + +Known working combinations +-------------------------- + +Please consider that using other combinations might work for you as well, these are just the combinations we tried and worked for us: + + +Debian Wheezy +------------- + +* `virtualbox-4.2 4.2.16-86992~Debian~wheezy` from Oracle and `vagrant 1.2.2` from vagrantup.com + + +Ubuntu Raring 13.04 +------------------- + +* `virtualbox 4.2.10-dfsg-0ubuntu2.1` from Ubuntu raring and `vagrant 1.2.2` from vagrantup.com + |