Oracle Cloud Infrastructure Documentation

Configuring VDDK as an Agent Dependency for VMware vSphere

The Oracle Cloud Migrations replication function running on the remote agent appliance depends on the VMware Virtual Disk Development Kit (VDDK) agent to perform snapshot operations on the VMware VM disk.

Refer to Managing Agent Dependencies for supported VDDK versions and requirements.

You can create an agent dependency of type VDDK for a source environment by:
  1. Selecting the name for AgentDependency as VDDK.
  2. Providing the bucket name to which you upload the VDDK library.
  3. Providing the name of the VDDK object that you upload.
Note

When creating an agent dependency, you don't need to provide the VDDK version. The VDDK version is automatically populated after you complete creating an agent dependency.

To upload the VDDK library, you can use any of the following options:

  • Select from Object Storage: Manually upload the VDDK library to a bucket, and then select the existing bucket and VDDK object when creating the dependency.
  • Upload a new dependency package: Select an existing bucket and upload the VDDK library into the Create agent dependency window.
  • Select an existing agent dependency: When configuring an agent dependency for an environment, select a configured agent dependency that exists. For example, you can define a dependency once and use it for multiple agents in specific environments.

    1. Open the navigation menu  and select Migration & Disaster Recovery. Under Cloud Migrations, select Remote Connections.
    2. In the navigation pane, select Agent Dependencies.
    3. On the Agent dependencies list page, select Create agent dependency.
      The Create agent dependency panel opens. First select how you want to generate the agent dependency, and then provide the necessary information.
    4. To create the agent dependency by selecting from Object Storage, select Select from object storage and enter the following information:
      • Compartment: Select the compartment where you want to create the agent dependency.
      • Name: Enter a name for the dependency. Avoid entering confidential information.
      • Description: (Optional) Enter a description for the agent dependency. Avoid entering confidential information.
      • Dependency type: Select VDDK.
      • Select your dependency package from object storage: Select one of the following options:
        • Import from an object storage bucket : If you select this option, select a bucket and object name. For example: VDDK library version could be, VMware-vix-disklib-7.0.2-17696664.x86_64.tar.gz.
        • Import from an object storage URL: If you select this option, provide the URL of the Object Storage bucket where the agent dependency package exists.

      Skip to step 7.

    5. To create the agent dependency by uploading a new dependency package to Object Storage, select Upload new dependency package and enter the following information:
      • Compartment: Select the compartment where you want to create the agent dependency.
      • Name: Enter a name for the dependency. Avoid entering confidential information.
      • Description: (Optional) Enter a description for the agent dependency. Avoid entering confidential information.
      • Dependency type: Select VDDK.
      • Upload your dependency package to object storage: In this section, follow these steps to upload the package to Object Storage:
        1. Select a bucket.
        2. (Optional) Provide the object name prefix to be uploaded.
        3. Select a storage tier.
        4. Add the VDDK library from the local device.
        5. Select Upload.

          The new dependency package is uploaded to the Object Storage bucket.

      After the package is successfully uploaded, skip to step 7.

    6. To create agent dependency from existing agent dependency, select Select from existing agent dependencies and follow these steps:
      1. Select the compartment in which the source agent dependency exists.
      2. Select the agent dependency to use.
      3. Select Add agent dependencies.

        The Create agent dependency confirmation window appears if you added the dependency successfully.

      4. Select Close.

      The Agent dependencies tab lists the dependency. You're done with this task.

    7. (Optional) Add tags to organize the resource. To apply a defined tag, you must have permissions to use the tag namespace. For more information about tagging, see Resource Tags. If you're not sure whether to apply tags, skip this option (you can apply tags later) or ask your administrator.
    8. Select Create.
      When the agent dependency is being created, it's in the verifying state.

    You can now perform an external asset discovery.

  • To create or configure an agent dependency for VMware vSphere, use the create command.

    oci cloud-bridge ocb-agent-svc agent-dependency create --bucket bucket_name --compartment-id target_compartment_id --dependency-name target_dependency_name --display-name dependency_display_name --namespace object_storage_namespace --object-name dependency_object_name [OPTIONS]
    The required parameters for the create command are:
    • --bucket: Specifies the name of the object storage bucket where you upload the agent dependency.
    • --compartment-id: Specifies the OCID of the compartment.
    • --dependency-name: Specifies the type of agent dependency. For example, VDDK.
    • --display-name: Specifies the display name for the agent dependency.
    • --namespace: Specifies the Object Storage namespace associated with your tenancy.
    • --object-name: Specifies the name of the dependency object that you upload.

    To get all the commands for ocb-agent-svc agent-dependency, run:

    oci cloud-bridge ocb-agent-svc agent-dependency -h

    To get help for the create command, run:

    oci cloud-bridge ocb-agent-svc agent-dependency create -h

    For a complete list of flags and variable options for CLI commands, see the CLI Command Reference.

  • To create an agent dependency, use the CreateAgentDependency operation.