Troubleshooting Miscellaneous

Overview

This section contains solutions to common problems that you might encounter while using various components of Minishift.

The root filesystem of the Minishift VM exceeds overlay size

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.

Special characters cause passwords to fail

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: '<password>'

Cannot access web console with Microsoft Edge

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.

Workaround: Use an alternative web browser to access the OpenShift web console. Mozilla Firefox and Google Chrome both work as expected.

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

Removing subscription password from OS native keychain

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.

Windows

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>

Linux

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>

macOS

On macOS, the password is stored using Keychain Access. Run the following command to delete the stored password:

$ security delete-generic-password -s minishift