Migration process overview

Understand the complete migration workflow including preparation, export, artifact creation, import, reconciliation, and validation steps for moving between Ansible Automation Platform installation types.

Important:

You can only migrate to a different installation type of the same Ansible Automation Platform version. For example, you can migrate from RPM version 2.6 to containerized 2.6, but not from RPM version 2.4 to containerized 2.6.

Ansible Automation Platform supports two approaches for migrating between installation types.

Basic migration

A consulting engagement is required to ensure that the new environment meets your requirements. Contact your Red Hat representative for further details.

The following items are included in a basic migration:

  • Organizations
  • Labels
  • Credential types
  • Unencrypted credentials
  • Credential input sources
  • Execution environments objects (not containers themselves)
  • Projects (with sync wait)
  • Inventories
  • Inventory sources (with auto-sync wait)
  • Constructed inventories
  • Inventory groups (with nested hierarchy)
  • Hosts (bulk operations, 200/batch) and host-group associations
  • Notification templates
  • Job templates (with survey specs and notification associations)
  • Workflow job templates (with nodes, survey specs, and notification associations)
  • System job templates
  • Schedules
  • Users
  • Teams
Full migration

To migrate from RHEL 8 to RHEL 9, back up your Ansible Automation Platform environment, and restore it onto a new RHEL 9 environment running Ansible Automation Platform 2.4. You must have a complete mirror of the original environment to do the restoration. Red Hat strongly recommends a consulting engagement to ensure a successful migration. Contact your Red Hat representative for details.

Use the ansible.aap_snapshot collection to migrate from an RPM-based deployment to OpenShift Container Platform.

For all other migration paths, a manual approach using platform backup and restore tooling is available.

The migration between Ansible Automation Platform installation types follows this general workflow:

  1. Prepare and assess the source environment
  2. Export the source environment
  3. Create and verify the migration artifact
  4. Prepare and assess the target environment
  5. Import the migration content to the target environment
  6. Reconcile the target environment post-import
  7. Validate the target environment