16.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.

16.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 16-2.

Table 16-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 16-3.	Same events reported for PTM automated migrations.

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

Table 16-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)

16.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 16-4.

Table 16-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 2018.11 Installation and Upgrade Guide.
	For each Migrate server, enable the Event Messaging port (61613) for communication with the PlateSpin Migrate Connector instance associated with the Migrate server.	See Enabling Event Messaging for PlateSpin Migration Factory in the PlateSpin Migrate 2018.11 User Guide.
	Ensure that your network environment meets the PTM requirements for networking.	See Section 1.6, Network Connectivity and Access Requirements.
	Deploy and configure a PlateSpin Migrate Connector for the PTM project in the source network.	See Installing PlateSpin Migrate Connector in the PTM 2 Administrator Guide. See Configuring a Connector Instance for PTM in the PTM 2 Administrator Guide.
In PlateSpin Transformation Manager:
	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 EnvironmentPreparing Your Migration Environment in the PlateSpin Migrate 2018.11 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 2018.11 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 2018.11 User Guide..
	Execute the migration using the Migrate Client or Migrate Web Interface, as appropriate.	See Executing Migrations in the PlateSpin Migrate 2018.11 User Guide..