Deploying your OpenShift cluster and jump host

This topic takes you through the steps of creating the Red Hat® OpenShift® on IBM Cloud® cluster and your jump host.

Before you begin

When you create the Red Hat OpenShift on IBM Cloud cluster, it is important that the flavor meets SAP's sizing recommendations and your expected workload characeterisitcs, as well as the expected data volumes. The flavor used in this provisioning scenario is appropriate for a test environment. Use this scenario to create your own test environment or adapt the scenario for your needs. Refer to the most recent SAP documentation when creating your cluster. The following implementation scenario is based on Minimum Sizing for SAP Data Hub 2.7. When planning to setup and deploy a production cluster you must consult Sizing Guide for SAP Data Hub 2.7.

Please check that your IBM Cloud account is set up to create clusters. For more information and the steps to set up your account, see Prepare to create clusters at the account level.

Provisioning your OpenShift cluster

Use the following steps to create your Red Hat OpenShift on IBM Cloud cluster. The values used in this scenario are suggestions for a test environment. Select the optional values that will fit your needs.

The Information button provides field-specific information on how to use a field.

Log in to IBM Cloud console and click Create +.
Review the Red Hat OpenShift on IBM Cloud version details, Red Hat OpenShift on IBM Cloud 3.11.x (stable)
Check your OCP entitlement - Leave the value set to Purchase additional licenses for this worker pool
Select Classic for Infrastructure.
Select Single zone for Availability.
Select the Geography and the Worker zone based on your geographic location.
Private VLAN and Public VLAN default based on your zone selections. You can change these values if necessary.

Your clusters, VLAN, and jump host must be in the same worker zone, or data center.
Select 8 vCPUs, 32 GB RAM for Flavor and at least 3 Worker nodes per data center for the test environment.
Enter a Cluster name and optionally Tags.
In the Summary pane, review the order summary and then click Create.

For additional information on the fields, see Creating a classic standard cluster in the console.

Provisioning your jump host

The instructions for implementing SAP Data Hub on the Red Hat OpenShift on IBM Cloud cluster follow SAP Data Hub 2 on OpenShift Container Platform 3, which lays out the jump host's requirements. You can either use a suitable jump server that is connected to the Red Hat OpenShift on IBM Cloud cluster in IBM Cloud, or you can use the following steps to create an IBM® Virtual Servers instance to serve as your jump host.

Once you've confirmed that the Red Hat OpenShift on IBM Cloud cluster is building, select the Menu icon > Classic Infrastructure > Device List.
Click Order devices + -
Select Virtual Servers for Classic.
Leave the default values for Type of virtual server, Quantity, and Billing.
Enter a name, for example jump4sdh, for Hostname. Click Information for formatting specifics.
Enter a name, for example, sdh.com for Domain. Domain is the identification string that defines administrative control within the internet. Click Information for formatting specifics.
Select your Placement group, default is None.
Select the Location of the data center (zone) where you set up your Red Hat OpenShift on IBM Cloud cluster.
Click All profiles and select B1.4x16, which is the minimum requirement.
Provide your SSH key for SSH Keys or leave the default None. For more information on SSH keys, see About SSH keys.
Select Red Hat 7xMinimal (64 bit) - HVM for Image.
Leave the default values for Attached storage disks and Network interface.
Click Third-Party Service Agreements and click Create.

Your Red Hat OpenShift on IBM Cloud cluster and your virtual server should be available in about 15 minutes.

Preparing the jump host

Prepare your jump host to connect to the Red Hat® OpenShift® on IBM Cloud® cluster that you created to host SAP Data Hub.

Before you begin

It's recommended you become familiar with the Managing your IBM Cloud accounts. Your IBM Cloud user ID must have the cluster Administrator role.

Install the IBM Cloud and Red Hat OpenShift on IBM Cloud client Command Line Interfaces (CLI)

Use the following commands to download and install the CLIs you use to configure the connection between your Red Hat OpenShift on IBM Cloud cluster and your jump host.

curl -sL https://ibm.biz/idt-installer | bash
```    For more information on IBM Cloud CLI, see [Getting started with the IBM Cloud CLI and Developer Tools](/docs/cli?topic=cli-getting-started){: external}.

Download and install the Red Hat OpenShift on IBM Cloud 3.11 CLI oc.

Click here for the repository of all oc versions. If you are not sure which version to select, navigate to the IBM Cloud console and look at the Version details for the Red Hat OpenShift on IBM Cloud cluster you created. For example, 3.11.232, which matches the current version.

Download the appropriate version.
```
wget http://mirror.openshift.com/pub/openshift-v3/clients/3.11.232/linux/oc.tar.gz
```
Unpack the Red Hat OpenShift on IBM Cloud client.
```
tar -xf oc.tar.gz
```
Move it to the local executables directory.
```
mv oc /usr/local/bin
```
Download and install kubectl. For Red Hat OpenShift on IBM Cloud 3.11, release v1.11 of kubectl is required.

Download the appropriate version.
```
curl -LO https://dl.k8s.io/release/v1.11.10/bin/linux/amd64/kubectl
```
Set the executable attribute.
```
chmod +x ./kubectl
```
Move it to the local executables directory.
```
mv kubectl /usr/local/bin
```
Download a script from The Kubernetes Package Manager and execute it with the latest release of helm for your SAP Data Hub (SDH) release. The helm version is v2.11.0 for SAP Data Hub 2.4, 2.5, 2.6 and 2.7.
```
curl --silent https://raw.githubusercontent.com/kubernetes/helm/master/scripts/get | \
DESIRED_VERSION=v2.11.0 bash
```

Download and install docker through the standard Red Hat repositories.

Enable the appropriate Red Hat repositories.

subscription-manager repos --enable=rhel-7-server-rpms \
 --enable=rhel-7-server-extras-rpms \
 --enable=rhel-7-server-optional-rpms

Install docker and some dependent packages.

yum install -y docker device-mapper-libs device-mapper-event-libs
```    Start the docker process.
``` {: pre}
systemctl enable --now docker.service

Verify the installation of the IBM Cloud CLI.

ibmcloud dev -v

Example output:

ibmcloud dev version 2.4.0
```    Verify kubectl.
``` {: pre}
kubectl version

Example output:

Client Version: version.Info{Major:"1", Minor:"11", GitVersion:"v1.11.10", GitCommit: ...
```    Verify docker.
``` {: pre}
systemctl status docker

Example output:

● docker.service - Docker Application Container Engine
Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; vendor preset: disabled)
Active: active (running) since ...

Log in to IBM Cloud.
```
ibmcloud login [--sso]
```
a. If you're logging in to IBM Cloud for the first time, create an IBM Cloud API key file.

The command is ibmcloud iam api-key-create <APIKeyName> -d <description> --file <APIKeyFilename>. The API key file will be stored in your current directory.
```
ibmcloud iam api-key-create myAK4sdh -d "This is your API Key for SAP Data Hub" \
--file myAK4sdh_file
```
b. For all subsequent logins use the API Key file that you created earlier during step a. The command is ibmcloud login --apikey @<APIKeyFilename>.
```
ibmcloud login --apikey @myAK4sdh_file
```

Access the Red Hat OpenShift on IBM Cloud cluster

After logging in to the jump host you must complete the following steps before you can work with your cluster.

Determine the cluster ID on which you want to install SAP Data Hub.

ibmcloud oc cluster ls

Name                     ID                     State    Created        Workers   ...
RH_OS_DataHub_SAP_Test   bm****************kg   normal   3 months ago   3         ...

Download the Kubernetes configuration files and certificates to connect to your cluster.

The command is ibmcloud oc cluster config --cluster <clusterID> --admin. Copy the cluster ID from the previous step.

You can copy the export command from the response of the ibmcloud oc cluster config command.
```
ibmcloud oc cluster config --cluster bm****************kg --admin
```
```
export KUBECONFIG=/root/.bluemix/plugins/container-service/clusters/......-RH_OS_DataHub_SAP_Test.yml
```

You have created an Red Hat OpenShift on IBM Cloud cluster and prepared the jump host.

Choosing the Dynamic Storage Provisioner

Dynamic volume provisioning allows storage volumes to be created on-demand. IBM Cloud provides several storage classes that can be used as storage providers.

Use the steps below to define the default IBM Cloud storage class.

Select the appropriate storage class that will fit your needs.

For SAP Data Hub the ibmc-block-bronze storage class is recommended.

Remove the current default storage class:

oc annotate sc --all storageclass.beta.kubernetes.io/is-default-class- \
storageclass.kubernetes.io/is-default-class-

Run the following command to define ibmc-block-bronze as the default storage class.

oc annotate storageclass ibmc-block-bronze storageclass.kubernetes.io/is-default-class=true

The SAP Data Hub installation command lets you provide different storage classes for the different SAP Data Hub storage types.

Setting up the IBM Cloud Container Registry

In Install the IBM Cloud and OpenShift client Command Line Interfaces (CLI), you installed the IBM Cloud CLI, which installed the CLI plug-ins for IBM Cloud® Kubernetes Service and IBM Cloud® Container Registry. Next, you'll set up the external image registry.

Use the following commands to set up the external image registry.

Log in to IBM Cloud with your API key file that you have generated in step 7a in the section Install the IBM Cloud and OpenShift client Command Line Interfaces (CLI).
```
ibmcloud login --apikey @myAK4sdh_file
```
Create a new Container Registry namespace, ibmcloud cr namespace-add <my_namespace>. For this example, the namespace name is sdh_cr_os, which is an acronym for SAP Data Hub - Container Registry - OpenShift.
```
ibmcloud cr namespace-add sdh_cr_os
```
Verify that the namespace is created.
```
ibmcloud cr namespace-list
```

Next Steps

Complete the setup following Red Hat instructions and then continue to deployment:

Go to the Red Hat article and do these steps:
Continue with Deploying Red Hat's SAP Data Hub (SDH) Observer.