This section contains solutions to common problems that you might encounter while using various components of Minishift.
Installing additional packages or copying large files to the root filesystem of the Minishift VM might exceed the allocated overlay size and lock the Minishift VM.
Cause: The Minishift VM root filesystem contains core packages that are configured to optimize running the Minishift VM and containers. The available storage on the root filesystem is determined by the overlay size, which is smaller than the total available storage.
Workaround: Avoid installing packages or storing large files in the root filesystem of the Minishift VM. Instead, you can create a sub-directory in the /mnt/sda1/ persistent storage volume or define and mount host folders that can share storage space between the host and the Minishift VM.
If you want to perform development tasks inside the Minishift VM, it is recommended that you use containers, which are stored in persistent storage volumes, and reuse the Minishift Docker daemon.
Depending on your operating system and shell environment, certain special characters can trigger variable interpolation and therefore cause passwords to fail.
Workaround: When creating and entering passwords, wrap the string with single quotes in the following format:
Attempting to access the OpenShift web console using Microsoft Edge can result in the following error:
Site not reachable.
Alternatively, the OpenShift web console may be rendered as a blank page.
Cause: This is an inconsistent error caused by Microsoft Edge.
X.509 certificate is valid for 10.0.2.15, 127.0.0.1, 172.17.0.1, 172.30.0.1, 192.168.99.100, not 192.168.99.101
Starting a stopped Minishift VM can produce the following X.509 certificate error:
$ minishift start -- Checking if requested hypervisor 'kvm' is supported on this platform ... OK -- Checking the ISO URL ... OK -- Starting local OpenShift cluster using 'kvm' hypervisor ... -- Starting Minishift VM ......................... OK [...] FAIL Error: cannot access master readiness URL https://192.168.99.101:8443/healthz/ready Details: No log available from "origin" container Caused By: Error: Get https://192.168.99.101:8443/healthz/ready: x509: certificate is valid for 10.0.2.15, 127.0.0.1, 172.17.0.1, 172.30.0.1, 192.168.99.100, not 192.168.99.101 Error during 'cluster up' execution: Error starting the cluster.
The reason for the above error is that OpenShift cluster certificates contain the IP of the Minishift VM. The certificates are generated only when Minishift VM is freshly started. After restart, the Minishift VM might be assigned a new IP address and if this happens the certificate become invalid.
Workaround: Delete the existing Minishift VM and start again.
$ minishift delete --force $ minishift start
These steps only applies if you are using a subscription capable ISO image like Red Hat Enterprise Linux with Minishift which needs registration using username and password.
On Windows, the password is stored using Credential Manager. Run the following command in Command Prompt to delete the stored password:
CMD> cmdkey /delete:minishift:<username>
On Linux, the feature needs to store the password using D-Bus Secret Service API, which is provided by GNOME libsecret. Run the following command to delete the stored password:
$ secret-tool clear service minishift username <username>