minishift: Instructions for manual installation of xhyve driver do not work on Sierra

I have followed documented instructions for manual installation of xhyve driver and was then unable to start minishift properly:

cdkqe-mac-01:bin hudson$ sudo curl -L  https://github.com/zchee/docker-machine-driver-xhyve/releases/download/v0.3.1/docker-machine-driver-xhyve -o /usr/local/bin/docker-machine-driver-xhyve
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   617    0   617    0     0    453      0 --:--:--  0:00:01 --:--:--   453
100 12.6M  100 12.6M    0     0  1126k      0  0:00:11  0:00:11 --:--:-- 2118k
cdkqe-mac-01:bin hudson$ sudo chown root:wheel /usr/local/bin/docker-machine-driver-xhyve

cdkqe-mac-01:bin hudson$ ls -l docker-machine-driver-xhyve 
-rw-r--r--  1 root  wheel  13241508 12 Jul 00:30 docker-machine-driver-xhyve
cdkqe-mac-01:bin hudson$ sudo chmod u+s /usr/local/bin/docker-machine-driver-xhyve
cdkqe-mac-01:bin hudson$ ls -l docker-machine-driver-xhyve 
-rwSr--r--  1 root  wheel  13241508 12 Jul 00:30 docker-machine-driver-xhyve
cdkqe-mac-01:bin hudson$ which docker-machine-driver-xhyve 

cdkqe-mac-01:bin hudson$ minishift start --vm-driver xhyve
Starting local OpenShift cluster using 'xhyve' hypervisor...
E0712 00:42:27.786796   15896 start.go:275] Error starting the VM: Driver "xhyve" not found. Do you have the plugin binary "docker-machine-driver-xhyve" accessible in your PATH?. Retrying.
E0712 00:42:27.787557   15896 start.go:275] Error starting the VM: Driver "xhyve" not found. Do you have the plugin binary "docker-machine-driver-xhyve" accessible in your PATH?. Retrying.
E0712 00:42:27.787588   15896 start.go:275] Error starting the VM: Driver "xhyve" not found. Do you have the plugin binary "docker-machine-driver-xhyve" accessible in your PATH?. Retrying.
Error starting the VM: Driver "xhyve" not found. Do you have the plugin binary "docker-machine-driver-xhyve" accessible in your PATH?
Driver "xhyve" not found. Do you have the plugin binary "docker-machine-driver-xhyve" accessible in your PATH?
Driver "xhyve" not found. Do you have the plugin binary "docker-machine-driver-xhyve" accessible in your PATH?

Since using brew for installation Minishift works as expected.

When discussing on Minishift IRC channel @gbraad also pointed out that there are not any instructions for installation of actual xhyve - could be brew install --HEAD xhyve which mentions xhyve documentation. Whole section is focused on setting up the driver plugins but as parts for Fedora and Debian/Ubuntu mention actual installation of kvm we could think of aligning xhyve part with it also.

About this issue

Original URL
State: closed
Created 7 years ago
Comments: 30 (23 by maintainers)

Commits related to this issue

Issue #1123 update xhyve manual install instructions — committed to thatdocslady/minishift by thatdocslady 7 years ago
Issue #1123 Updating xhyve manual install instructions — committed to minishift/minishift by thatdocslady 7 years ago

Most upvoted comments

Problem is our manual instructions doesn’t put details about how to install dependencies for docker-machine-driver-xhyve and that’s reason it fails. I don’t mind to remove this manual instruction completely and only rely on brew install docker-machine-driver-xhyve because then it will pull down all required dependencies.

praveenkumar on Jul 12, 2017

No additional information needed. as @hferentschik mentioned, he rather leaves the docker-machine reference out.

If people install this, they have done so on their own… which means they haven’t followed documentation

gbraad on Jul 20, 2017

Let’s just change the instructions.

hferentschik on Jul 20, 2017

Next step is adding execution rights. Last two steps are identical with current docs.

So making the binary executable is the missing bit then, right? I think it is less about adding a step, but rather fixing step 4:

sudo chmod u+xs /usr/local/bin/docker-machine-driver-xhyve

The binary must be executable and run as root.

Based on @gbraad findings it could be maybe good to add a sentence about fact, that machine-docker-driver-xhyve contains/vendors xhyve in itself and thus there is no need for installation of xhyve binary.

Not so sure about this. Why making things more complicated? This is an implementation detail a user should not have to know/think about.

hferentschik on Jul 12, 2017

So I guess execution rights are needed. Tried to add sudo chmod +x /usr/local/bin/docker-machine-driver-xhyve after the download and now I am able to start minishift.

Now trying to figure out if dependencies installed by brew are needed.

agajdosi on Jul 12, 2017