Preparing and Installing SAP Data Hub

Deploying Red Hat's SAP Data Hub (SDH) Observer

Deploying the SAP Data Hub (SDH) Observer lets the SAP Data Hub installer and runtime components access images in the IBM Cloud® Container Registry to provide the image pull secret for the project. In the Red Hat article, the project name is 'sdh'.

The project's namespace and Container Registry names used in the following steps are the same as those used in previous steps.

1. Copy the local pull image secret from the default area to the sdh project. For more information, see Copying an existing image pull secret.

   The source secret should match your region, for example, 'de' for Central Europe. In this example, the source secret default-de-icr-io is copied to sdh-de-icr-io.

   Find your region.

   ibmcloud cr api
   ```    The region code precedes the domain - in this example the domain is `icr.io` and the region code is `de`.    
   ``` {: screen}
   Registry API endpoint   https://de.icr.io/api
   

   The command line is: oc patch secret --dry-run -o yaml -n default <local_secret> -p '{"metadata":{"namespace": "<project_name>"}}' | oc -n sdh create -f -

   oc patch secret --dry-run -o yaml -n default default-de-icr-io -p '{"metadata": {"namespace": "sdh", "name": "sdh-de-icr-io"}}' | oc -n sdh create -f -
   

2. Link the secret sdh-de-icr-io to the default service account’s pods.

   oc secrets link -n sdh --for=pull default sdh-de-icr-io
   

3. Deploy the SAP Data Hub Observer in the sdh namespace.

   Review the Required Input Parameters to confirm the deployment instructions and the source URL are valid.

   oc process -f https://raw.githubusercontent.com/redhat-sap/sap-datahub/master/sdh-observer.yaml \
   BASE_IMAGE_TAG=v3.11 SDH_NAMESPACE=sdh MAKE_VSYSTEM_IPTABLES_PODS_PRIVILEGED=true NAMESPACE=sdh \
   REGISTRY=de.icr.io/sdh_cr_os | oc create -f -
   

Preparing IBM Cloud IBM Cloud Object Storage for SAP Vora Checkpoint

For production environments, storage for the SAP Vora Checkpoint must be set up. Follow these instructions to set up IBM Cloud IBM Cloud Object Storage and to define the parameters that will be handed over to the installation dialog.

For test and evaluation environments, you may skip this topic and go directly to the Manual Installation using an installation script (manual) instructions, and the instructions for running the installation script for the IBM Cloud specific parameters.

The service instance name for the following example is `sdh_cos_k8`. Choose a name that fits your needs when creating your service instance.
{: note}

### Locating the Installation Dialog parameters {: #rhos-find-parameters}

During installation of SAP Data Hub, you're prompted to:

`Enable Vora checkpoint store? (yes/no)`.

If you're setting up a test environment, you can select **yes** or **no**. However, for a production environment, select **yes**. You're next asked for the following parameters:

  ``` {: screen}
Please provide the following parameters for Vora's checkpoint store
Please enter type of shared storage (oss/s3/wasb/gcs/webhdfs):
Please enter S3 access key:
Please enter S3 secret access key:
Please enter S3 host (empty for default 'https://s3.amazonaws.com'):
Please enter S3 region you want to connect to (empty for default 'us-east-1'):
Please enter connection timeout in seconds (empty for default 180):
Please enter S3 bucket and directory (in the form my-bucket/directory):
Do you want to validate the checkpoint store? (yes/no)

Running the installation shell script

We recommend manually installing the SAP Data Hub.

yum install unzip

Provide the Modeler's Access Credentials for the IBM Cloud Container Registry

After installation has finished and the SAP Data Hub Launchpad is available, log in to SAP Data Hub, and provide the proper credentials for the Modeler in System Management.

Use the following commands to provide the modeler's access credentials to the IBM Cloud® Container Registry.

1. Retrieve your user's API key that you have created during step 7a in Install the IBM Cloud and OpenShift client Command Line Interfaces (CLI).

   cat myAK4sdh_file
   {
       "name": "myAK4sdh",
       "description": "This is your API Key for SAP Data Hub",
       "apikey": "********************************************",
       "createdAt": "2019-12-18T10:40+0000",
       "locked": false,
       "uuid": "ApiKey-********-****-****-****-************"
   }
   # copy the API key shown after "apikey".
   

2. Follow the instructions in Provide Access Credentials for a Password Protected Container Registry. Be sure to use the following parameters, including pasting the copied API key into the password field.

   cat >/tmp/vsystem-registry-secret.txt <<EOF
   username: "iamapikey"
   password: "********************************************"
   EOF