(PE-40371) Add migration plan for standard architecture

This commit adds a migration plan which utilises backup, install and
restore plans to install and restore PE on new infrastructure with a
standard architecture.

This commit also introduces a new 'migration' option for backup and
restore plans, enabling a new migration plan.

Author: petergmurphy

plans/backup.pp

@@ -12,7 +12,7 @@
   Peadm::SingleTargetSpec     $targets,
 
   # backup type determines the backup options
-  Enum['recovery', 'custom']  $backup_type = 'recovery',
+  Enum['recovery', 'custom', 'migration']  $backup_type = 'recovery',
 
   # Which data to backup
   Peadm::Recovery_opts        $backup = {},

plans/migrate.pp

@@ -0,0 +1,34 @@
+plan peadm::migrate (
+  # This plan should be run on the primary server
+  Peadm::SingleTargetSpec $old_primary_host,
+  Peadm::SingleTargetSpec $new_primary_host,
+) {
+  peadm::assert_supported_bolt_version()
+
+  $backup_file = run_plan('peadm::backup', $old_primary_host, {
+      backup_type => 'migration',
+  })
+
+  $local_backup_path = 'pe_migration_backup.tar.gz'
+
+  download_file($backup_file['path'], 'backup', $old_primary_host)
+
+  $backup_filename = basename($backup_file['path'])
+  $remote_backup_path = "/tmp/${backup_filename}"
+  $current_dir = system::env('PWD')
+
+  upload_file("${current_dir}/downloads/backup/${old_primary_host}/${backup_filename}", $remote_backup_path, $new_primary_host)
+
+  run_plan('peadm::install', {
+      primary_host                => $new_primary_host,
+      console_password            => 'Puppetlabs123!',
+      code_manager_auto_configure => true,
+      download_mode               => 'direct',
+  })
+
+  run_plan('peadm::restore', {
+      targets => $new_primary_host,
+      restore_type => 'migration',
+      input_file => $remote_backup_path,
+  })
+}

plans/restore.pp

@@ -12,7 +12,7 @@
   Peadm::SingleTargetSpec $targets,
 
   # restore type determines the restore options
-  Enum['recovery', 'recovery-db', 'custom'] $restore_type = 'recovery',
+  Enum['recovery', 'recovery-db', 'custom', 'migration'] $restore_type = 'recovery',
 
   # Which data to restore
   Peadm::Recovery_opts $restore = {},