| Eclipse Che Documentation

Procedure

To install Che on OpenShift 4:

Create the che project:
1. Click the Projects tab and click the Create Project button.
2. In the Name field, type che and click the Create button.
Install the operator:
1. In the left panel, expand Catalog and click OperatorHub.
2. In the Search by keyword field, type eclipse che.
3. Click Eclipse Che.
4. Click the Install button in the Eclipse Che pop-up window.
5. In the A specific namespace on the cluster field, in the cluster drop-down list, select che. Click the Subscribe button.
  
  The operator is successfully installed and is available in the Installed Operators section.
Deploy Che:
1. Navigate to the Catalog → Installed Operators section.
  
  Eclipse Che is displayed as an installed operator having the InstallSucceeded status.
2. To deploy Che, click Eclipse Che in the list of installed operators.
3. Click the Create New link in Provided APIs section.
4. Leave the default values as they are and click the Create button in the bottom-left corner of the window.
  
  The Eclipse Che cluster is created.

Track the Che deployment:

Click the eclipse-che cluster.

Click the Resources tab.

The user can also track the deployment using the command line and the following two commands:

$ oc project che
$ oc get pods
NAME                            READY     STATUS    RESTARTS   AGE
che-8495f4946b-jrzdc            0/1       Running   0          86s
che-operator-578765d954-99szg   1/1       Running   0          42m
keycloak-74fbfb9654-g9vp5       1/1       Running   0          4m32s
postgres-5d579c6847-w6wx5       1/1       Running   0          5m14s

Viewing che-operator logs

To view the che-operator logs, run the following command:

$ oc logs --tail=10 -f che-operator-578765d954-99szg
time="2019-07-12T09:48:29Z" level=info msg="Exec successfully completed"
time="2019-07-12T09:48:29Z" level=info msg="Updating eclipse-che CR with status: provisioned with OpenShift identity provider: true"
time="2019-07-12T09:48:29Z" level=info msg="Custom resource eclipse-che updated"
time="2019-07-12T09:48:29Z" level=info msg="Creating a new object: ConfigMap, name: che"
time="2019-07-12T09:48:29Z" level=info msg="Creating a new object: ConfigMap, name: custom"
time="2019-07-12T09:48:29Z" level=info msg="Creating a new object: Deployment, name: che"
time="2019-07-12T09:48:30Z" level=info msg="Updating eclipse-che CR with status: Che API: Unavailable"
time="2019-07-12T09:48:30Z" level=info msg="Custom resource eclipse-che updated"
time="2019-07-12T09:48:30Z" level=info msg="Waiting for deployment che. Default timeout: 420 seconds"

To obtain the Eclipse Che URL, wait for the logs to show the following information:

time="2019-07-12T09:50:13Z" level=info msg="Updating eclipse-che CR with Eclipse Che server URL: http://che-che.apps.cluster-fre-f0a2.fre-f0a2.openshiftworkshop.com"
time="2019-07-12T09:50:13Z" level=info msg="Custom resource eclipse-che updated"
time="2019-07-12T09:50:13Z" level=info msg="Eclipse Che is now available at: http://che-che.apps.cluster-fre-f0a2.fre-f0a2.openshiftworkshop.com"
time="2019-07-12T09:50:13Z" level=info msg="Updating eclipse-che CR with version: 7.0.0-RC-2.0"

The URL is also displayed in the Eclipse Che cluster on the Installed Operators window in the ECLIPSE CHE URL field.

Click the Eclipse Che URL link to display the Eclipse Che login page.
To log in, use OpenShift OAuth or register as a new user. To use OAuth, the user must grant permissions to log in to Eclipse Che.
Update the account information.

Once logged in, the user can create a workspace using the Eclipse Che Dashboard.