Chapter 3. Starting and configuring the Single-node OpenShift Cluster for the Fabric8 Launcher tool

This chapter contains instructions for starting the Single-node OpenShift Cluster and configuring it to execute the Fabric8 Launcher tool.

Note

Starting your Single-node OpenShift Cluster can trigger a download of large virtual machines or Linux container images. This can take a long time. Subsequent startups are expected to be shorter as long as the virtual machines and Linux container images remain cached.

Important

Because a Single-node OpenShift Cluster is intended for development purposes, it uses HTTPS for the web console and only provides a self-signed certificate. If your browser prevents you from accessing the page due to an SSL error, you must allow your browser to bypass SSL security policies for the Single-node OpenShift Cluster URL to use it. The screenshot below shows the warning message in the Google Chrome browser.

SSL warning

Prerequisites

Procedure

  1. Start the Single-node OpenShift Cluster with the default virtual machine driver:

    Note

    Depending on your operating system, virtual machine driver, and the number of boosters you run, the memory allocated Single-node OpenShift Cluster can be insufficient. In this case, increase the memory allocation. 

    $ minishift start --memory=4096
...
OpenShift server started.

The server is accessible via web console at:
    https://192.168.42.152:8443

    Alternatively, specify a virtual machine driver other than the default using the --vm-driver flag: 

    $ minishift start --memory=4096 --vm-driver=virtualbox

    Depending on your system configuration, it is possible that you must manually specify an alternative virtual machine driver. You must have virtual machine software, such as VirtualBox, installed before you specify it.

    Note

    On macOS, the default virtual machine driver, xhyve, can be unreliable. If you experience issues, specifying VirtualBox is a reliable alternative.

  2. Open the Single-node OpenShift Cluster Web console. 

    $ minishift console

    Alternatively, use the URL provided in the log information.

  3. Log in using the developer username and an arbitrary password.

  4. Optionally, delete the preconfigured project:

    1. Next to the project name, click the three-dot menu icon.

    2. Select Delete Project.

      OpenShift Console Home