1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-07 09:46:53 +01:00
Files
openshift-docs/modules/virt-creating-vddk-image.adoc

80 lines
2.3 KiB
Plaintext

// Module included in the following assemblies:
//
// * virt/virtual_machines/importing_vms/virt-importing-vmware-vm.adoc
[id="virt-creating-vddk-image_{context}"]
= Creating and using a VDDK image
You can download the VMware Virtual Disk Development Kit (VDDK), build a VDDK image, and push the VDDK image to your image registry. You then add the VDDK image to the `v2v-vmware` config map.
.Prerequisites
* You must have access to an {product-title} internal image registry or a secure external registry.
.Procedure
. Create and navigate to a temporary directory:
+
[source,terminal]
----
$ mkdir /tmp/<dir_name> && cd /tmp/<dir_name>
----
. In a browser, navigate to link:https://code.vmware.com/home[VMware code] and click *SDKs*.
. Under *Compute Virtualization*, click *Virtual Disk Development Kit (VDDK)*.
. Select the VDDK version that corresponds to your VMware vSphere version, for example, VDDK 7.0 for vSphere 7.0, click *Download*, and then save the VDDK archive in the temporary directory.
. Extract the VDDK archive:
+
[source,terminal]
----
$ tar -xzf VMware-vix-disklib-<version>.x86_64.tar.gz
----
. Create a `Dockerfile`:
+
[source,terminal]
----
$ cat > Dockerfile <<EOF
FROM busybox:latest
COPY vmware-vix-disklib-distrib /vmware-vix-disklib-distrib
RUN mkdir -p /opt
ENTRYPOINT ["cp", "-r", "/vmware-vix-disklib-distrib", "/opt"]
EOF
----
. Build the image:
+
[source,terminal]
----
$ podman build . -t <registry_route_or_server_path>/vddk:<tag> <1>
----
<1> Specify your image registry:
+
* For an internal {product-title} registry, use the internal registry route, for example, `image-registry.openshift-image-registry.svc:5000/openshift/vddk:<tag>`.
* For an external registry, specify the server name, path, and tag, for example, `server.example.com:5000/vddk:<tag>`.
. Push the image to the registry:
+
[source,terminal]
----
$ podman push <registry_route_or_server_path>/vddk:<tag>
----
. Ensure that the image is accessible to your {VirtProductName} environment.
. Edit the `v2v-vmware` config map in the *openshift-cnv* project:
+
[source,terminal]
----
$ oc edit configmap v2v-vmware -n openshift-cnv
----
. Add the `vddk-init-image` parameter to the `data` stanza:
+
[source,yaml]
----
...
data:
vddk-init-image: <registry_route_or_server_path>/vddk:<tag>
----