Navigating Che using the Dashboard

The Dashboard is accessible on your cluster from a URL such as https://che-host:che-port/dashboard. This section describes how to access this URL on Minishift and OpenShift.

This section describes how to access the Eclipse Che Dashboard on Minishift.

Prerequisites

  • Che deployed on a running Minishift instance. See Installing Che locally.

  • Take note of the IP address of the Minishift console as displayed during Minishift startup.

  • Use the latest version of Google Chrome. Google Chrome is the officially supported browser for Eclipse Che 7.30

Procedure

  1. Log into the Minishift console at https://<IP-address>:8443/console/.

  2. Navigate to the mini-che project: https://<IP-address>:8443/console/project/mini-che/overview.

  3. Click on to the mini-che route link: http://che-che.<IP-address>.nip.io/.

Validation steps

  • The browser displays the Eclipse Che Dashboard.

Logging in to Che on OpenShift for the first time using OAuth

This section describes how to log in to Che on OpenShift for the first time using OAuth.

Prerequisites

  • Contact the administrator of the OpenShift instance to obtain the Eclipse Che URL.

Procedure

  1. Navigate to the Eclipse Che URL to display the Eclipse Che login page.

  2. Choose the OpenShift OAuth option.

  3. The Authorize Access page is displayed.

  4. Click on the Allow selected permissions button.

  5. Update the account information: specify the Username, Email, First name and Last name fields and click the Submit button.

Validation steps

  • The browser displays the Eclipse Che Dashboard.

Logging in to Che on OpenShift for the first time registering as a new user

This section describes how to log in to Che on OpenShift for the first time registering as a new user.

Prerequisites
Procedure

  1. Navigate to the Eclipse Che URL to display the Eclipse Che login page.

  2. Choose the Register as a new user option.

  3. Update the account information: specify the Username, Email, First name and Last name field and click the Submit button.

Validation steps

  • The browser displays the Eclipse Che Dashboard.

Logging in to Che using chectl

This section describes how to log in to Che using the chectl tool by copying login command from Che Dashboard.

Prerequisites
Procedure

  1. Using the upper-right corner of Dashboard, open the user’s pop-up menu.

  2. Select the Copy chectl login command option.

  3. Wait for the notification message The login command copied to clipboard to display.

  4. Paste the login command into a terminal and observe a successful login:

    $ chectl auth:login ...
Successfully logged into <server> as <user>

Finding Che cluster URL using the OpenShift 4 CLI

This section describes how to obtain the Che cluster URL using the OpenShift 4 command line interface (CLI). The URL can be retrieved from the OpenShift logs or from the checluster Custom Resource.

Prerequisites

  • An instance of Eclipse Che running on OpenShift.

  • User is located in a Che installation namespace.

Procedure

  1. To retrieve the Che cluster URL from the checluster CR (Custom Resource), run:

    $ oc get checluster --output jsonpath='{.items[0].status.cheURL}'

  2. Alternatively, to retrieve the Che cluster URL from the OpenShift logs, run:

    $ oc logs --tail=10 `(oc get pods -o name | grep operator)` | \
  grep "available at" | \
  awk -F'available at: ' '{print $2}' | sed 's/"//'