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 appropriate VMware Virtual Disk Development Kit (VDDK) agent to perform the snapshot operations on the VMware VM disk.

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 click Migration & Disaster Recovery. Under Cloud Migrations, click Remote Connections.
    2. Under Remote connections, click Agent dependencies.
    3. On the Agent dependencies page, click Create agent dependency.
    4. In the Create agent dependency window, perform one of the following options to generate a dependency:

      • Create agent dependency by selecting from object storage.

        1. Click Select from Object Storage and provide the following information:
          • Select the compartment where you want to create the agent dependency.
          • Enter a name.
          • (Optional) Enter a description for the agent dependency. Avoid entering confidential information.
          • In the Dependency type field, select VDDK.
        2. In the Select your dependency package from object storagesection, select one of the following options:
          • Import from an object storage bucket : If you select this option, choose a bucket and object name. For example: VDDK library version can 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 where the agent dependency package exists.
        3. Click Create.

          When the agent dependency is getting created, it is in the verifying state.

      • Create agent dependency from existing agent dependencies.

        1. Click Select from existing agent dependencies and choose from the list of agent dependencies by selecting the compartment in which the source agent dependency exists.
        2. Click Add dependencies.

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

        3. Click Close and return to the page with a list of agent dependencies.

      • Create agent dependency by uploading a new dependency package.

        1. Click Upload new dependency package and enter the following information:
          • Select the compartment where you want to create the agent dependency.
          • Enter a name.
          • (Optional) Enter a description for the agent dependency. Avoid entering confidential information.
          • In the Dependency type field, select VDDK.
          • In the Upload your dependency package to object storage section, provide the following details:
            • Select a bucket.
            • (Optional) Provide the object name prefix to be uploaded.
            • Select a storage tier.
            • Add the VDDK library from the local device.
        2. Click Upload.

          The new dependency package is uploaded to the Object Storage.

          To create an agent dependency after the package is successfully uploaded, click Create.

    5. (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 are not sure whether to apply tags, skip this option (you can apply tags later) or ask your administrator.

    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.