21.6 Tracking Workload Status for External Migrations

PlateSpin Transformation Manager tracks external migration workflow for imported workloads with matching workload migrations performed on PlateSpin Migrate servers. Transformation Manager reports the status, but it does not automate or control the workflow. The PlateSpin Migrate Connector retrieves state change events as a subscriber of each Migrate server’s event messaging system, and sends state information to the appropriate project and workload.

NOTE:Transformation Manager ignores migrations on the project’s PlateSpin Migrate servers for workloads that have not been imported to your project. After you import a workload, the Connector seeks a match during subsequent scans of the Migrate servers, then begins tracking states for the matching workload.

The tracked status displays in the Status column of the Workloads list and in the header area of the Workload dialog for the workload.

21.6.1 About Tracking External Migrations

PlateSpin Transformation Manager tracks the status of external migrations for matching workloads on the Migrate server, whether they are initiated through the Migrate Web Interface or the Migrate Web Client. The Migrate REST APIs return more information for migrations configured and executed using the Migrate Web Interface, as identified in Table 21-2.

Table 21-2 Information Reported by Migrate for External Migrations

Information

Migrate Client

Migrate Web Interface

Proposed configuration

Not available to PTM

Displayed as read only in the Workload dialog.

State events

Limited events. See Table 21-3.

Same events reported for PTM automated migrations.

Table 21-3 describes the status events for migrations in the Migrate Client.

Table 21-3 States Reported for Migrations Executed in PlateSpin Migrate Client

Migrate Client Migration Job Status

Description

Added

The source workload has been added to Migrate Client.

In Progress

A replication has started.

Replicated

A replication has ended.

Copied

A replication has ended. The source is up.

Completed

The workload has been cut over to the target workload. The source is down.

Removed

The workload has been removed from Migrate Client.

Stuck

A recoverable error occurred.

Error

A non-recoverable error occurred.

You can import workloads to PTM and the project’s Migrate servers in any order. When you import workloads using the PlateSpin Transformation Manager discovery service, the Connector scans the Migration Server resources to match the workload with external migration jobs you set up using the Migrate Client. It does not match workloads set in Automated Mode.

The Connector checks for matching external workloads on the project’s PlateSpin Migrate servers when the following events occur:

  • When you import workloads to PTM for a project set to Planning Mode

  • When you modify the Mode from Automated to Planning for an individual workload

  • When you launch or restart the Migrate Connector

  • When you add a Migrate Server as a Migration Server resource for the project

  • When the Connector subscribes to event messages from a new Migration Server resource

  • When the Connector polls for events (every 5 minutes by default)

21.6.2 Checklist for Tracking External Migrations

PlateSpin Transformation Manager begins tracking an external migration when the PlateSpin Migrate Connector matches an imported workload in Planning Mode with a discovered workload on any of the project’s PlateSpin Migrate servers. Tracking capabilities require that you complete the tasks outlined in the checklist in Table 21-4.

Table 21-4 Checklist for Tracking External Migrations

Status

Task

Notes

In your PlateSpin Migration Factory environment:

Deploy one or more PlateSpin Migrate servers.

See the PlateSpin Migrate 12.2.1 Installation and Upgrade Guide.

For each Migrate server, enable the Event Messaging port (61613) for communication with the PlateSpin Migrate Connector instance assigned to the project.

See Enabling Event Messaging for PlateSpin Migration Factory in the PlateSpin Migrate 12.2.1 User Guide.

Ensure that your network environment meets the PTM requirements for networking.

See Section 2.3, Network Connectivity and Access Requirements.

Deploy and configure a PlateSpin Migrate Connector for the PTM project in the network with source servers.

See Installing, Upgrading, or Uninstalling PlateSpin Migrate Connector in the PlateSpin Migrate Connector Quick Start.

See Configuring a Project Assignment for a Connector Instance in the PlateSpin Migrate Connector Quick Start.

In PlateSpin Transformation Manager:

Enable Planning Mode for the Project if you want workloads to inherit the Planning Mode setting on import.

See About Projects.

After import, you can set the Mode value to Planning on an individual workload by using the Workload dialog. See Transformation Plan.

Configure one or more Credential resources to use for access to your PlateSpin Migrate servers.

See Creating a Credential.

Configure your PlateSpin Migrate servers as Migration Server resources in the project, and specify a valid Credential resource.

See Creating a Migration Server Resource.

Import and discover workloads for PTM.

See Importing and Discovering Workloads.

Tracking begins when Migrate Connector matches the imported workload in the PTM project with an external workload on any one of the PlateSpin Migrate servers.

On the project’s PlateSpin Migrate servers:

Prepare your target migration environment.

See Preparing Your Migration Environment in the PlateSpin Migrate 12.2.1 User Guide.

Discover and prepare the workload on any one of the project’s Migrate servers.

See Discovering and Preparing Workloads and Targets in the PlateSpin Migrate 12.2.1 User Guide.

Tracking begins when Migrate Connector matches the discovered Migrate workload with an imported workload in the PTM project.

Configure the workload for migration using the Migrate Client or Migrate Web Interface, as appropriate for the target platform.

See Configuring Workloads in the PlateSpin Migrate 12.2.1 User Guide.

Execute the migration using the Migrate Client or Migrate Web Interface, as appropriate.

See Executing Migrations in the PlateSpin Migrate 12.2.1 User Guide.