minishift: Pre-flight check for libvirt default network fails when LANG is set to Swiss-German

General information

  • Minishift version: 1.14.0
  • OS: Linux, Ubuntu 16.04
  • Hypervisor: KVM and VirtualBox should be availablle, how do I choose one if them?!?

Steps to reproduce

  1. Goto https://www.openshift.org/minishift/
  2. Follow link to https://github.com/minishift/minishift/releases
  3. Download latest minishift release
  4. Back to previous document, follow link to https://docs.openshift.org/latest/minishift/getting-started/installing.html
  5. In Linux, Follow link to https://docs.openshift.org/latest/minishift/getting-started/setting-up-driver-plugin.html
  6. execute the commands: sudo curl -L https://github.com/dhiltgen/docker-machine-kvm/releases/download/v0.7.0/docker-machine-driver-kvm -o /usr/local/bin/docker-machine-driver-kvm sudo chmod +x /usr/local/bin/docker-machine-driver-kvm sudo apt install libvirt-bin qemu-kvm sudo usermod -a -G libvirtd marc newgrp libvirtd
  7. Back to last page, look for next instuctions, after a while found it in the left navigation, click https://docs.openshift.org/latest/minishift/getting-started/quickstart.html
  8. execute minishift start

Expected

Minishift starts without error.

Actual

Aborts

Logs

-- Starting profile 'minishift'
-- Checking if requested OpenShift version 'v3.7.1' is valid ... OK
-- Checking if requested OpenShift version 'v3.7.1' is supported ... OK
-- Checking if requested hypervisor 'kvm' is supported on this platform ... OK
-- Checking if KVM driver is installed ... 
   Driver is available at /usr/local/bin/docker-machine-driver-kvm ... 
   Checking driver binary is executable ... OK
-- Checking if Libvirt is installed ... OK
-- Checking if Libvirt default network is present ... OK
-- Checking if Libvirt default network is active ... FAIL
   See the 'Setting Up the Driver Plug-in' topic (https://docs.openshift.org/latest/minishift/getting-started/setting-up-driver-plugin.html) for more information

The given URL does not help,I already follwed all steps mentioned there.

Notes

Opened new issue as requested by @gbraad in #1998

BTW: Documentation is a mess!

My target: I would like to setup a OpenShift scenario in Virtual Box.

About this issue

  • Original URL
  • State: closed
  • Created 6 years ago
  • Comments: 18 (11 by maintainers)

Commits related to this issue

Most upvoted comments

My target: I would like to setup a OpenShift scenario in Virtual Box.

in that case, use --vm-driver virtualbox.

can we keep a constructive tone?

BTW: Documentation is a mess!

Can you eloborate more why you say the documentation is a mess? We have an issue already, being worked on #1817 to streamline the installation descriptions.Although, some pointers to the what can be impoved can be helpful. /cc @robin-owen

well, that’s bad programming

Also, calling something bad programming is generally not very helpful. It does not really move us forward with the issue at hand. We try to set cmd.Env = cmdUtils.ReplaceEnv(os.Environ(), "LC_ALL", "C"), but for some reason this fails on your machine? We have tested this under several circumstances and this is an identical fix as provided by an outside contributor. It worked in the tested situations (nb; we all seem to work on English workstations… :-s) See: #1631 #1593

So please mark this ticket as bug and fix minishift so that LANG is reset, then everything else will work fine…

So, in your case LANG is also set. OK, we will add this to the check and will continue on #1584 and related tasks for Linux and macOS. However, at this stage we haven’t had bandwidth to handle all of this at once. If possible, you can help us test and/or provide a bugfix. Thanks for finding this…

Thanks for the detailed description. It certainly will help.

Note: I also want to protect my team of course… hope you understand. 😉. Although we are quite thick-skinned, we might take this back home or out onto the family 😛

@mwaeckerlin I noticed the LANG=, but perhaps this is acted on differently in Ubuntu. Needs some investigation.

But yeah, I can agree that the --vm-driver stuff is hidden away. It is mentioned on https://docs.openshift.org/latest/minishift/getting-started/quickstart.html#starting-minishift and tucked away in a note. If you can have a look at the PR I provided earlier… maybe it provides what you look for? If not, we can try to change it with your input. @robin-owen, please have a look at the comments in the above message.

@gbraad, Sorry, I criticize with the idea of helping to make things better. I thought my problems regarding documentation was obvious from my description. Reading was not so straight-forward, so at the end, when the script did not work as expected, I had no idea whether it was because of a bug in the script or because I missed something in the documentation.

Starting at https://www.openshift.org/minishift/, the links to xhyve, Hyper-V, VirtualBox just lead to the respective homepages, they are not relevant, but the KVM leads to important instructions. So on this page, some links should be followed, others not, but all links look the same. The same minishift-download link is linked twice, once on top, then on bottom left. So the structure of this page is a bit chaotic in my eyes.

The link to «installation document» leads to https://docs.openshift.org/latest/minishift/getting-started/installing.html, which is better structured, so the page https://www.openshift.org/minishift/ is simply an unnecessary duplicate.

My suggestion: On page https://www.openshift.org/minishift/ remove the «Get Started» part, and in the «Resources» part replace «Download» by «Installation» with link directly to https://docs.openshift.org/latest/minishift/getting-started. This would improve the navigation.

On page https://docs.openshift.org/latest/minishift/getting-started/installing.html, everything is understandable and clear. But at the end of the page, I missed some information, where I should continue reading. After a while, I found my position in the left menu and clicked the next item, Minishift Quickstart.

My suggestion: At the end of page, add a link to the next page,something like: «Next step: Minishift Quickstart» with link to https://docs.openshift.org/latest/minishift/getting-started/quickstart.html

In general: Since you have a paged documentation, a «back» and «next» link on every page would help.

Hope that helps. 😉