Creating a VMware Asset Source

Learn how to create an asset source in an Oracle Cloud Migrations environment.

Before you create an asset source, ensure that you have defined the required vSphere privileges. See Required vSphere Privileges.
    1. Open the navigation menu  and select Migration & Disaster Recovery. Under Cloud Migrations, select Discovery.
    2. On the Asset sources list page, select Create asset source.
    3. For Asset source type, select VMware.
    4. In the Asset source information section, provide the following details:
      • Name: Enter a name for the asset source. Avoid entering confidential information.
      • Remote endpoint: Enter the path to the VMware vCenter SDK endpoint of the external environment.
      • Compartment: Select a compartment for the asset source.
      • Target compartment: Select the compartment in which the inventory assets are created.
    5. In the Remote connections source environment section, select the source environment.
    6. In the Discovery credentials section, use one of the following options:
      • Select Use existing secret and select a vault and secret for existing discovery credentials.
      • Select Create secret, enter a name and description for the secret, select a vault and encryption key, and then enter the username and password for the vCenter sign in credentials with discovery privileges. See Required vSphere Privileges for Discovery.
    7. (Optional) In the Replication credentials section, use one of the following options or None:
      • Select Use discovery credentials to use the same credentials selected in the previous section.
      • Select Use existing secret and select a vault and secret for existing replication credentials.
      • Select Create secret , enter a name and description for the secret, select a vault and encryption key, and then enter the username and password for vCenter sign in credentials with replication privileges. See Required vSphere Privileges for Replication.
    8. In the Discovery schedules section, select one of the following options to perform the discovery job:
      • To perform an on-demand or manual asset discovery, select No discovery schedule.
      • To use an existing discovery schedule, select Select existing schedule.
      • To create a wanted discovery schedule, select Create schedule.

        You can keep asset information up-to-date by using the discovery scheduling mechanism as a recurring task. After creating a discovery schedule, you can attach or detach it from an existing asset source to begin or stop scheduling discovery jobs for external asset discovery and metadata collection.

    9. In the Metrics section, select one or more of the following options:
      • To give permission to collect historical metrics of the assets, select Enable collection of historical metrics
      • To give permission to collect real-time metrics of the assets, select Enable collection of real-time metrics
    10. (Optional) Add tags to organize your 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.
    11. Select Create asset source.
    You're redirected to the asset source details page after the asset source is created successfully.

    On the Connections tab, you can view each connector to the source environment. These connectors are automatically instantiated using the discovery plugin in the external environment. The connectors change their state to active after they have verified their connection and credentials with the vCenter server.

    You can now create a discovery work request.
  • To create an asset source, use the create command.

    oci cloud-bridge discovery asset-source create --assets-compartment-id asset_compartment_ID --compartment-id target_compartment_ID --environment-id target_environment_ID --inventory-id assets_inventory_ID --type asset_source_type --discoveryCredentials credentials --vcenterEndpoint vcenterendpoint [OPTIONS]
    The required parameters for the create command are:
    • --assets-compartment-id: Specifies the OCID of the compartment that is used to create assets.
    • --compartment-id: Specifies the OCID of the compartment for the resource.
    • --environment-id: Specifies the OCID of the environment.
    • --inventory-id: Specifies the OCID of the inventory that contains the created assets.
    • --type: Specifies the type of asset in the external environment. The accepted value is VMWARE.
    • --discovery-credentials: Specifies the credentials information such as username and password of the vSphere login credentials. The value cannot be null.
    • --vcenter-endpoint: Specifies the path to the VMware vCenter SDK endpoint of the external environment. The value cannot be null.

    To get all the commands for discovery asset-source, run:

    oci cloud-bridge discovery asset-source -h

    To get help for the create command, run:

    oci cloud-bridge discovery asset-source create -h

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

  • To create an asset source, use the CreateAssetSource operation.