Troubleshooting V1 Kalabox Problems
There are a couple common problems that can occur with any Kalabox installation. Before submitting an issue, please make sure none of the following documents cover your problem (and if you do submit an issue, make sure it's not a duplicate!).
The most common installation error that seems to occur contains the following command:
mount -o vers=3 1.3.3.1:'/Users/USERNAME/kalabox/www' /var/www
If you see this command, or get other errors during installation the best thing to do is:
- Report the error(s) to errors@kalamuna.com
- Run the uninstall.tool packaged with the DMG
- Restart your computer.
- Rerun the installer
- Rejoice.
Some users have not noticed the password prompt that comes up during initial installation. We have tried to make this more apparent but alas some people are still missing it. Anyway, make sure you type your password into the following prompt.
The best bet here is to uninstall the plugin with the following command:
`vagrant plugin uninstall vagrant-vbguest
This has only appeared on a couple of installations so we are not yet completely sure how to treat it but here is what we know thus far.
Your box seems to go through the "Kalaboxing..." step but errs out shortly thereafter with an "Unexpected Token" error. This seems to be related to the box not being able to contact aliases.kala to pull in your sites. Here are some things to check.
- Open /etc/hosts and verify there are entries for start.kala, php.kala, solr.kala, grind.kala and aliases.kala
- Try to hit "http://start.kala" in your browser. If your request is hijacked with search results (which seems to happen with Cox) temporarily disable your internet connection, exit kalabox and then reopen it. If you see the dashboard reenable your internet connection.
We need to improve progress indication for this step but we have seen very few cases where Kalaboxing actually gets stuck. Just hang on tight! This step usually takes between 2-5 minutes using the Internet connection at Kalamuna HQ.
If you're having consistent issues with mounting the www folder from your host maching onto the virtual Kalabox environment, you may want to try using rsync instead of NFS. See this article on the Kalastack wiki: https://github.com/kalamuna/kalastack/wiki/Using-Rsync-Instead-of-NFS
Users who have the default Mac firewall enabled with the "Block all incoming connections" option will not be able to mount their files. This may result in Kalabox stalling on startup, or simply not being able to mount the webroot to their Mac OS host environment.
Additionally, selecting to "Enable stealth mode" may result in very, very slow requests to web services and pretty much all Kalabox operations.
- Make sure "Block all incoming connections" is disabled (Go to System Preferences > Security & Privacy > Firewall):
- Attempt starting Kalabox again; Mac OS should attempt to add "Node" to the list of allowed connections.
- If this does not solve your problem, try adding the following applications to your list of allowed connections:
/usr/sbin/rpcbind
/sbin/nfsd
/usr/sbin/rpc.statd
/usr/sbin/rpc.lockd
/usr/libexec/rpc.rquotad
(see https://github.com/mitchellh/vagrant/issues/1093#issuecomment-17209368 for reference)