Bookmark this page

Orientation to the Classroom Environment

In this course, the main computer system that is used for hands-on learning activities is workstation. The systems called bastion and classroom must always be running for proper use of the lab environment.

These three systems are in the lab.example.com DNS domain.

A Red Hat OpenShift Container Platform (RHOCP) 4.12 single-node (SNO) bare metal UPI installation is used in this classroom. Infrastructure systems for the RHOCP cluster are in the ocp4.example.com DNS domain.

All student computer systems have a standard user account, student, which has the student password. The root password on all student systems is redhat.

Figure 0.1: Classroom environment

Table 1. Classroom Machines

Machine nameIP addressesRole
bastion.lab.example.com172.25.250.254Router that links VMs to central servers
classroom.lab.example.com172.25.252.254Server that hosts the required classroom materials
idm.ocp4.example.com192.168.50.40Identity management server for cluster authentication and authorization support
master01.ocp4.example.com192.168.50.10An RHOCP single-node (SNO) cluster
registry.ocp4.example.com192.168.50.50Registry server to provide a private registry and GitLab services to the cluster
utility.lab.example.com192.168.50.254Server that provides supporting services that the RHOCP cluster requires, including DHCP, NFS, and routing to the cluster network
workstation.lab.example.com172.25.250.9Graphical workstation that students use

The primary function of bastion is to act as a router between the network that connects the student machines and the classroom network. If bastion is down, then other student machines do not function properly, or might even hang during boot.

The utility system acts as a router between the network that connects the RHOCP cluster machines and the student network. If utility is down, then the RHOCP cluster does not function properly, or might even hang during boot.

For some exercises, the classroom contains an isolated network. Only the utility system and the cluster are connected to this network.

Several systems in the classroom provide supporting services. The classroom server hosts software and lab materials for the hands-on activities. The registry server is a private Red Hat Quay container registry that hosts the container images for the hands-on activities. Information about how to use these servers is provided in the instructions for those activities.

The master01 system serves as the control plane and compute node for the RHOCP cluster. The cluster uses the registry system as its own private container image registry and GitLab server. The idm system provides LDAP services to the RHOCP cluster for authentication and authorization support.

Students use the workstation machine to access a dedicated RHOCP cluster, for which they have cluster administrator privileges.

Table 2. RHOCP Access Methods

Access methodEndpoint
Web consolehttps://console-openshift-console.apps.ocp4.example.com
APIhttps://api.ocp4.example.com:6443

The RHOCP cluster has a standard user account, developer, which has the developer password. The administrative account, admin, has the redhatocp password.

Classroom Registry

The DO280 course uses a private Red Hat Quay container image registry that is accessible only within the classroom environment. The container image registry hosts the container images that students use in the hands-on activities. By using a private container image registry, the classroom environment is self-contained to not require internet access.

The registry server provides the https://registry.ocp4.example.com:8443/ container image registry to the classroom environment. The registry is configured with a user account, developer, which has the developer password.

The following table provides the container image repositories that are used in this course and their public repositories.

Table 3. Classroom Container Image Repositories and Public Sources

Public Source RepositoryClassroom Registry Repository
quay.io/​jkube/​jkube-java-binary-s2i:0.0.9 registry.ocp4.example.com:8443/​jkube/​jkube-java-binary-s2i:0.0.9
quay.io/​openshift/​origin-cli:4.12 registry.ocp4.example.com:8443/​openshift/​origin-cli:4.12
quay.io/​redhattraining/​books:v1.4 registry.ocp4.example.com:8443/​redhattraining/​books:v1.4
quay.io/​redhattraining/​builds-for-managers registry.ocp4.example.com:8443/​redhattraining/​builds-for-managers
quay.io/​redhattraining/​do280-beeper-api:1.0 registry.ocp4.example.com:8443/​redhattraining/​do280-beeper-api:1.0
quay.io/​redhattraining/​do280-payroll-api:1.0 registry.ocp4.example.com:8443/​redhattraining/​do280-payroll-api:1.0
quay.io/​redhattraining/​do280-product:1.0 registry.ocp4.example.com:8443/​redhattraining/​do280-product:1.0
quay.io/​redhattraining/​do280-product-stock:1.0 registry.ocp4.example.com:8443/​redhattraining/​do280-product-stock:1.0
quay.io/​redhattraining/​do280-project-cleaner:v1.0 registry.ocp4.example.com:8443/​redhattraining/​do280-project-cleaner:v1.0
quay.io/​redhattraining/​do280-project-cleaner:v1.1 registry.ocp4.example.com:8443/​redhattraining/​do280-project-cleaner:v1.1
quay.io/​redhattraining/​do280-show-config-app:1.0 registry.ocp4.example.com:8443/​redhattraining/​do280-show-config-app:1.0
quay.io/​redhattraining/​do280-stakater-reloader:v0.0.125 registry.ocp4.example.com:8443/​redhattraining/​do280-stakater-reloader:v0.0.125
quay.io/​redhattraining/​exoplanets:v1.0 registry.ocp4.example.com:8443/​redhattraining/​exoplanets:v1.0
quay.io/​redhattraining/​famous-quotes:2.1 registry.ocp4.example.com:8443/​redhattraining/​famous-quotes:2.1
quay.io/​redhattraining/​famous-quotes:latest registry.ocp4.example.com:8443/​redhattraining/​famous-quotes:latest
quay.io/​redhattraining/​gitlab-ce:8.4.3-ce.0 registry.ocp4.example.com:8443/​redhattraining/​gitlab-ce:8.4.3-ce.0
quay.io/​redhattraining/​hello-world-nginx:latest registry.ocp4.example.com:8443/​redhattraining/​hello-world-nginx:latest
quay.io/​redhattraining/​hello-world-nginx:v1.0 registry.ocp4.example.com:8443/​redhattraining/​hello-world-nginx:v1.0
quay.io/​redhattraining/​loadtest:v1.0 registry.ocp4.example.com:8443/​redhattraining/​loadtest:v1.0
quay.io/​redhattraining/​php-hello-dockerfile registry.ocp4.example.com:8443/​redhattraining/​php-hello-dockerfile
quay.io/​redhattraining/​php-ssl:v1.0 registry.ocp4.example.com:8443/​redhattraining/​php-ssl:v1.0
quay.io/​redhattraining/​php-ssl:v1.1 registry.ocp4.example.com:8443/​redhattraining/​php-ssl:v1.1
quay.io/​redhattraining/​scaling:v1.0 registry.ocp4.example.com:8443/​redhattraining/​scaling:v1.0
quay.io/​redhattraining/​todo-angular:v1.1 registry.ocp4.example.com:8443/​redhattraining/​todo-angular:v1.1
quay.io/​redhattraining/​todo-angular:v1.2 registry.ocp4.example.com:8443/​redhattraining/​todo-angular:v1.2
quay.io/​redhattraining/​todo-backend:release-46 registry.ocp4.example.com:8443/​redhattraining/​todo-backend:release-46
quay.io/redhattraining/do280-roster:v1 registry.ocp4.example.com:8443/​redhattraining/​do280-roster:v1
quay.io/redhattraining/do280-roster:v2 registry.ocp4.example.com:8443/​redhattraining/​do280-roster:v2
quay.io/​redhattraining/​wordpress:5.7-php7.4-apache registry.ocp4.example.com:8443/​redhattraining/​wordpress:5.7-php7.4-apache
registry.access.redhat.com/​rhscl/​httpd-24-rhel7:latest registry.ocp4.example.com:8443/​rhscl/​httpd-24-rhel7:latest
registry.access.redhat.com/​rhscl/​mysql-57-rhel7:latest registry.ocp4.example.com:8443/​rhscl/​mysql-57-rhel7:latest
registry.access.redhat.com/​rhscl/​nginx-18-rhel7:latest registry.ocp4.example.com:8443/​rhscl/​nginx-18-rhel7:latest
registry.access.redhat.com/​rhscl/​nodejs-6-rhel7:latest registry.ocp4.example.com:8443/​rhscl/​nodejs-6-rhel7:latest
registry.access.redhat.com/​rhscl/​php-72-rhel7:latest registry.ocp4.example.com:8443/​rhscl/​php-72-rhel7:latest
registry.access.redhat.com/​ubi7/​nginx-118:latest registry.ocp4.example.com:8443/​ubi7/​nginx-118:latest
registry.access.redhat.com/​ubi8/​httpd-24:latest registry.ocp4.example.com:8443/​ubi8/​httpd-24:latest
registry.access.redhat.com/​ubi8:latest/​ registry.ocp4.example.com:8443/​ubi8:latest/​
registry.access.redhat.com/​ubi8/​nginx-118:latest registry.ocp4.example.com:8443/​ubi8/​nginx-118:latest
registry.access.redhat.com/​ubi8/​nodejs-10:latest registry.ocp4.example.com:8443/​ubi8/​nodejs-10:latest
registry.access.redhat.com/​ubi8/​nodejs-16:latest registry.ocp4.example.com:8443/​ubi8/​nodejs-16:latest
registry.access.redhat.com/​ubi8/​php-72:latest registry.ocp4.example.com:8443/​ubi8/​php-72:latest
registry.access.redhat.com/​ubi8/​php-73:latest registry.ocp4.example.com:8443/​ubi8/​php-73:latest
registry.access.redhat.com/​ubi8/​ubi:8.0 registry.ocp4.example.com:8443/​ubi8/​ubi:8.0
registry.access.redhat.com/​ubi8/​ubi:8.4 registry.ocp4.example.com:8443/​ubi8/​ubi:8.4
registry.access.redhat.com/​ubi8/​ubi:latest registry.ocp4.example.com:8443/​ubi8/​ubi:latest
registry.access.redhat.com/​ubi9/​httpd-24:latest registry.ocp4.example.com:8443/​ubi9/​httpd-24:latest
registry.access.redhat.com/​ubi9/​nginx-120:latest registry.ocp4.example.com:8443/​ubi9/​nginx-120:latest
registry.access.redhat.com/​ubi9/​ubi:latest registry.ocp4.example.com:8443/​ubi9/​ubi:latest
registry.redhat.io/​redhat-openjdk-18/​openjdk18-openshift:1.8 registry.ocp4.example.com:8443/​redhat-openjdk-18/​openjdk18-openshift:1.8
registry.redhat.io/​redhat-openjdk-18/​openjdk18-openshift:latest registry.ocp4.example.com:8443/​redhat-openjdk-18/​openjdk18-openshift:latest
registry.redhat.io/​rhel8/​mysql-80:1-211.1664898586 registry.ocp4.example.com:8443/​rhel8/​mysql-80:1-211.1664898586
registry.redhat.io/​rhel8/​mysql-80:latest registry.ocp4.example.com:8443/​rhel8/​mysql-80:latest
registry.redhat.io/​rhel8/​postgresql-13:1-7 registry.ocp4.example.com:8443/​rhel8/​postgresql-13:1-7
registry.redhat.io/​rhel8/​postgresql-13:latest registry.ocp4.example.com:8443/​rhel8/​postgresql-13:latest
registry.redhat.io/​ubi8/​ubi:8.6-943 registry.ocp4.example.com:8443/​ubi8/​ubi:8.6-943

Controlling Your Systems

You are assigned remote computers in a Red Hat Online Learning (ROLE) classroom. Self-paced courses are accessed through a web application that is hosted at . Log in to this site with your Red Hat Customer Portal user credentials.

Controlling the Virtual Machines

The virtual machines in your classroom environment are controlled through web page interface controls. The state of each classroom virtual machine is displayed on the Lab Environment tab.

Figure 0.2: An example course Lab Environment management page

Table 4. Machine States

Virtual machine stateDescription
buildingThe virtual machine is being created.
activeThe virtual machine is running and available. If it just started, it still might be starting services.
stoppedThe virtual machine is shut down. On starting, the virtual machine boots into the same state that it was in before shutdown. The disk state is preserved.

Table 5. Classroom Actions

Button or actionDescription
CREATE Create the ROLE classroom. Creates and starts all the virtual machines that are needed for this classroom.
CREATING The ROLE classroom virtual machines are being created. Creation can take several minutes to complete.
DELETE Delete the ROLE classroom. Destroys all virtual machines in the classroom. All saved work on those systems' disks is lost.
START Start all virtual machines in the classroom.
STARTING All virtual machines in the classroom are starting.
STOP Stop all virtual machines in the classroom.

Table 6. Machine Actions

Button or actionDescription
OPEN CONSOLE Connect to the system console of the virtual machine in a new browser tab. You can log in directly to the virtual machine and run commands, when required. Normally, log in to the workstation virtual machine only, and from there, use ssh to connect to the other virtual machines.
ACTIONStart Start (power on) the virtual machine.
ACTIONShutdown Gracefully shut down the virtual machine, preserving disk contents.
ACTIONPower Off Forcefully shut down the virtual machine, while still preserving disk contents. This action is equivalent to removing the power from a physical machine.
ACTIONReset Forcefully shut down the virtual machine and reset associated storage to its initial state. All saved work on that system's disks is lost.

At the start of an exercise, if instructed to reset a single virtual machine node, click ACTIONReset for only that specific virtual machine.

At the start of an exercise, if instructed to reset all virtual machines, click ACTIONReset on every virtual machine in the list.

If you want to return the classroom environment to its original state at the start of the course, then click DELETE to remove the entire classroom environment. After the lab is deleted, then click CREATE to provision a new set of classroom systems.

Warning

The DELETE operation cannot be undone. All completed work in the classroom environment is lost.

The Auto-stop and Auto-destroy Timers

The Red Hat Online Learning enrollment entitles you to a set allotment of computer time. To help to conserve your allotted time, the ROLE classroom uses timers, which shut down or delete the classroom environment when the appropriate timer expires.

To adjust the timers, locate the two + buttons at the bottom of the course management page. Click the auto-stop + button to add another hour to the auto-stop timer. Click the auto-destroy + button to add another day to the auto-destroy timer. Auto-stop has a maximum of 11 hours, and auto-destroy has a maximum of 14 days. Be careful to keep the timers set while you are working, so that your environment is not unexpectedly shut down. Be careful not to set the timers unnecessarily high, which could waste your subscription time allotment.

Revision: do280-4.14-08d11e1