Chapter 6. Running the data virtualization operator to deploy a virtual database

Installing on OpenShift 3.11

1. From a terminal window, log in to the OpenShift cluster as a cluster administrator.

   oc login

2. Create or open a project where you want to deploy a virtual database.

3. Type the following commands:

   export OP_ROOT=https://raw.githubusercontent.com/teiid/teiid-operator/7.6-0.0.x/deploy
   oc create -f $OP_ROOT/crds/virtualdatabase.crd.yaml  1
   oc create -f $OP_ROOT/service_account.yaml
   oc create -f $OP_ROOT/role.yaml
   oc create -f $OP_ROOT/role_binding.yaml
   oc create -f $OP_ROOT/operator.yaml

   1

   If you previously created a CRD in the cluster, the command returns an error, reporting that the CRD already exists. You can ignore the message.

4. Type the following commands to create a pull secret that you can use to access the Red Hat image registry:

   oc create secret docker-registry dv-pull-secret /
   --docker-server=registry.redhat.io /
   --docker-username=$username / 1
   --docker-password=$password /
   --docker-email=$email_address
   oc secrets link builder dv-pull-secret
   oc secrets link builder dv-pull-secret --for=pull

   1

   Substitute the user name and password that you use to log in to the Red Hat Customer Portal.

   If the command completes with no errors, the operator is deployed to your OpenShift instance within the current OpenShift project.

5. To enable the data virtualization operator to retrieve images from the Red Hat registry so that you can create virtual databases, link the secret that you created in Step 4 to the service account for the operator.

   oc secrets link dv-operator dv-pull-secret --for=pull

Installing on OpenShift 4.2 or greater

1. From a terminal window, type the following commands to log in to the OpenShift cluster and create a pull secret that you can use to access the Red Hat image registry:

   oc login
   oc create secret docker-registry dv-pull-secret /
   --docker-server=registry.redhat.io /
   --docker-username=$username /  1
   --docker-password=$password /
   --docker-email=$email_address
   oc secrets link builder dv-pull-secret
   oc secrets link builder dv-pull-secret --for=pull

   1

   Use your Red Hat Customer Portal login credentials.

2. Log in to the OpenShift web console as a cluster administrator.
3. From the OpenShift menu, expand Operators and click OperatorHub.
4. Click Data Virtualization Operator 7.6.0 provided by Red Hat, Inc., and then click Install.

5. From the Create Operator Subscription page, verify that the selected namespace matches the name of the project where you want to install the operator, and then click Subscribe.

   The Installed Operators page lists the Data Virtualization Operator and reports the status of the installation.

6. From the OpenShift menu, expand Workloads and click Pods to check the status of the operator pod. After a few minutes, the pod for the operator service begins to run.

7. To enable the data virtualization operator to retrieve images from the Red Hat registry so that you can create virtual databases, link the secret that you created in Step 1 to the service account for the operator.

   oc secrets link dv-operator dv-pull-secret --for=pull

Procedure

1. From a terminal window, log in to OpenShift and open the project where you want to create the virtual database.
2. On your computer, change to the directory that contains the .yaml file that contains the CR.

3. Type the following command to run the operator to create the virtual database:

   oc create -f <cr_filename.yaml>

   Replace <cr_filename.yaml> with the name of the CR file for your data source. For example,

   oc create -f dv-customer.yaml

   After the deployment completes, a virtual database service is added to the OpenShift cluster. The name of the service matches the name that is specified in the custom resource.

4. Type the following command to verify that the virtual database is created:

   oc get vdbs

   OpenShift returns the list of virtual databases in the project. To see whether a particular virtualization is available, type the following command: