Chapter 2. Installing the Migration Toolkit for Virtualization

Procedure

1. In the OpenShift Container Platform web console, click Operators OperatorHub.
2. Use the Filter by keyword field to search for mtv-operator.
3. Click the MTV Operator and then click Install.
4. On the Install Operator page, click Install.
5. Click Operators Installed Operators to verify that the MTV Operator appears in the openshift-mtv project with the status Succeeded.
6. Click the MTV Operator.
7. Under Provided APIs, locate the ForkliftController, and click Create Instance.
8. Click Create.
9. Click Workloads Pods to verify that the MTV pods are running.

Procedure

1. Log in to the OpenShift Container Platform web console.
2. Click Networking Routes.
3. Select the openshift-mtv project in the Project: list.
4. Click the URL for the forklift-ui service to open the login page for the MTV web console.

Procedure

1. Create the openshift-mtv project:

   $ cat << EOF | oc apply -f -
   apiVersion: project.openshift.io/v1
   kind: Project
   metadata:
     name: openshift-mtv
   EOF

2. Create an OperatorGroup CR called migration:

   $ cat << EOF | oc apply -f -
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: migration
     namespace: openshift-mtv
   spec:
     targetNamespaces:
       - openshift-mtv
   EOF

3. Create a Subscription CR for the Operator:

   $ cat << EOF | oc apply -f -
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: mtv-operator
     namespace: openshift-mtv
   spec:
     channel: release-v2.0.0
     installPlanApproval: Automatic
     name: mtv-operator
     source: redhat-operators
     sourceNamespace: openshift-marketplace
     startingCSV: "mtv-operator.v2.0.0"
   EOF

4. Create a ForkliftController CR:

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: ForkliftController
   metadata:
     name: forklift-controller
     namespace: openshift-mtv
   spec:
     olm_managed: true
   EOF

5. Verify that the MTV pods are running:

   $ oc get pods -n openshift-mtv

   Example output

   NAME                                  READY  STATUS   RESTARTS  AGE
   forklift-controller-788bdb4c69-mw268  2/2    Running  0         2m
   forklift-operator-6bf45b8d8-qps9v     1/1    Running  0         5m
   forklift-ui-7cdf96d8f6-xnw5n          1/1    Running  0         2m

Procedure

1. Obtain the MTV web console URL:

   $ oc get route virt -n openshift-mtv \
     -o custom-columns=:.spec.host

   Example output

   https://virt-openshift-mtv.apps.cluster.openshift.com.

2. Launch a browser and navigate to the MTV web console.