Oracle Cloud Infrastructure Documentation

Creating Migration Prerequisites

Describes the steps to create Oracle Cloud Migrations prerequisites.

Using the Console

  1. Open the navigation menu  and select Migration & Disaster Recovery. Under Cloud Migrations, select Overview.
  2. On the Overview page, select the compartment where you want to create the Resource Manager stack.
  3. Select Create prerequisites. If you have an existing prerequisites stack, or if you don't see Create prerequisites, follow the instructions at Updating the Prerequisites to update the stack to the latest version.
  4. In the Create stack window, in the Stack information section, perform the following actions:
    • Select the Oracle terms of use checkbox.
    • (Optional) Change the stack name.
    • (Optional) Enter the stack description.
    • (Optional) Select the compartment where you want to create the stack.
    • (Optional) Select the latest Terraform version.
    • (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 the administrator.
  5. Select Next.
  6. In the Configure variables section, provide the following details:
    Field name Required Default Description
    Primary Prerequisite Stack Yes true

    If this is an initial onboarding to Oracle Cloud Migrations, select this option to create all migration prerequisite resources, including IAM resources the OCM services require (tags, groups, and policies). Clear this checkbox only if the required IAM resources are already being managed by another Resource Manager stack (the Primary Prerequisite Stack).

    When this checkbox is cleared, the stack is intended for secondary-region use and does not create or modify IAM resources. The stack expects the Migration and MigrationSecrets compartments to already exist under the selected Migration Root Compartment and fails if they can't be found.
    Enabled Migration Scenario Yes none Select the primary migration scenario for this prerequisite stack. Additional scenarios can be enabled using the check boxes below.

    Note: VMware to OLVM (Limited Availability) migration is available for selected customers only during the LA phase.
    VMware to OCI No false Optionally enable VMware to OCI migrations in addition to the primary scenario.
    VMware to OLVM (Limited Availability) No false Optionally enable VMware to OLVM migrations in addition to the primary scenario.

    Note: VMware to OLVM (Limited Availability) migration is available for selected customers only during the LA phase.
    AWS to OCI No false Optionally enable AWS to OCI migrations in addition to the primary scenario.
    Replication Bucket Name No ocm_replication Name of the Object Storage bucket to create or reuse for Oracle Cloud Migrations replication data.
    Create New Replication Bucket No true Leave this enabled for the default setup. Clear this checkbox only when you want to reuse an existing bucket. If enabled, a new Object Storage bucket is created with the name specified in the Replication Bucket Name field in the Migration child compartment created by this stack (not the same as Migration Root Compartment).
    Migration Service User Groups No false Select this option to create operator and administrator groups and policies that allow users in your tenancy to use and manage migration resources. If this checkbox is cleared, you must manually create the groups and policies before users in your tenancy can start a migration. See VMWare Migration User Policies and AWS Migration User Policies for details.
    Enable Remote Agent Appliance logging No false Select this option to create the IAM resources that allow Remote Agent Appliances to upload logs to the OCB service log bucket. If this checkbox is cleared, the OCB service team can't access Remote Agent Appliance logs which can impede troubleshooting. (This option is shown only when VMware scenarios are enabled.)
    Oracle Cloud Bridge Service Tenancy No preset The OCID of the Oracle Cloud Bridge service tenancy used by the Remote Agent Appliance logging policy. Leave the default unless Oracle instructs you to override it.
    Enable Hydration Agent logging No false Select this option to create the IAM resources that allow Hydration Agents to upload logs to the OCM service log bucket. If this checkbox is cleared, the OCM service team can't access Hydration Agent logs which can impede troubleshooting. (This option is shown only when migration-to-OCI scenarios are enabled.)
    Oracle Cloud Migrations Service Tenancy No preset The OCID of the Oracle Cloud Migrations service tenancy used by the Hydration Agent logging policy. Leave the default unless Oracle instructs you to override it.
    Migration Root Compartment Yes preset

    The parent compartment where the Migration and MigrationSecrets working compartments are created or reused. Defaults to the compartment where you create the stack.

    We recommend that you leave this aligned with the stack creation compartment. Change it only if you intentionally want Oracle Cloud Migrations working compartments created in a different location. Resources created under this compartment include the Migration and MigrationSecrets child compartments, a KMS vault and key, an Object Storage bucket (if enabled), and compartment-level IAM policies.
  7. Select Next.
  8. In the Review section, review the information you entered, optionally clear the Run apply checkbox and select Create.
  9. After the stack is created, you can plan and apply the stack.
  10. After a successful apply, the stack produces structured outputs that summarize what was created. You can view these on the Job details page under Outputs.
    Output Description
    prerequisite_stack_version Version of the prerequisite stack that was applied.
    prerequisite_stack_mode Whether this run was a primary stack (creates IAM, tags, compartments) or secondary (reuses existing tenancy-level resources).
    migration_root_compartment_id The parent compartment under which the Migration and MigrationSecrets compartments were created or found.
    migration_compartment_id OCID of the Migration compartment.
    migration_secrets_compartment_id OCID of the MigrationSecrets compartment.
    enabled_scenarios Migration scenarios enabled by this prerequisite stack.
    dynamic_group_ids Map of dynamic group names to OCIDs created by this stack. Empty for secondary stacks.
    policy_ids Map of IAM policy names to OCIDs created by this stack. Empty for secondary stacks.
    tag_namespace_id OCID of the CloudMigrations tag namespace. Empty for secondary stacks.
    kms_vault_id OCID of the KMS vault created in MigrationSecrets for migration credential storage.
    kms_key_id OCID of the KMS key created for migration secret encryption.
    replication_bucket_name Name of the Object Storage replication bucket, if created by this stack.