3.3 Configuring Global Settings for Connectors

If your migration environment involves different networks, you deploy a PlateSpin Migrate Connector server in each network. You assign each connector to your PlateSpin Transformation Manager server as described in Section 3.2, Configuring a Project Assignment for a Connector Instance.

The connectors inherit their default behavior from the settings you provide in System Configuration > Migrate Connector in the Transformation Manager Web Interface.

3.3.1 About Global Options for Connectors

On the System Configuration > Migrate Connector page in PlateSpin Transformation Manager, a System Administrator can customize the default workflow of migration projects that leverage one or more PlateSpin Migrate servers to execute workload migrations.

NOTE:You must restart each instance of PlateSpin Migrate Connector after you modify global options in order to apply the changes.

General Settings

Missed Event Poll Interval

Specify the number of seconds between polls for workload migration events.

The default value is 300 seconds (5 minutes). A lower value puts more stress on your PTM server and Migrate servers.

Reconnect Retry Interval

Specify the number of seconds to wait after a connection fails to a PlateSpin Migrate server before the PTM Server tries to reconnect.

The default value is 1500 seconds (25 minutes).

Pause for Manual Pre-Cutover Testing

Specify whether to pause the Transformation Workflow in a Transforming / Incremental Replication state until the Migrate user manually triggers Pre-Cutover Testing.

The default is to disable manual pre-cutover testing.

Pause for Manual Post-Cutover Testing

Specify whether to pause the Transformation Workflow in a Cutover / Waiting for User state until the Migrate user manually triggers Post-Cutover Testing.

The default is to disable manual post-cutover testing.

Migrate Server Settings

Add Workload to Migrate

Specify the number of days before the start date to add the workload migration job to an auto-assigned PlateSpin Migrate server.

This option is disabled by default with a value of 0 (zero). When you submit a transformation plan, the Migrate Connector immediately auto-assigns a Migrate server, adds a workload migration job, then waits until the start date to execute the migration. The job consumes capacity and a Migrate license while it waits for start date. Consuming capacity before it is needed might block migration of workloads with earlier start dates.

Set a value of 1 or greater to enable automation control to wait until the specified pre-start-date interval to begin the preparation for migration. You can submit the workload transformation plans as they are ready without immediately consuming capacity or a license on a Migrate server.

Maximum Workloads

Specify the maximum number of workloads to allow for a PlateSpin Migrate server at a time.

The default value is 100. To determine an appropriate value for your PlateSpin Migration Factory environment, see Performance in the PlateSpin Migrate 12.2.1 User Guide.

NOTE:Capacity to add more workloads can be regained by doing the following:

Maximum Targets

Specify the maximum number of discovered targets for a PlateSpin Migrate server.

The default value is 27.

Pre-Cutover Testing Days

Specify the maximum number of before cutover to begin automated pre-cutover testing.

The default value is 3 days.

Verify SSL Certificate

Specify whether to enable the validation of SSL certificates for connections to the PlateSpin Migrate servers.

The default is to disable certificate validation. Select the check box to enable it.

Remove Workload After Cutover

Specify whether to clean up the workload information from the PlateSpin Migrate servers after a cutover completes.

The default is enabled. Deselect the check box to disable it.

Remove after (days)

Specify the number of days after a workload is cut over to clean up the workload information from the PlateSpin Migrate server.

The default value is 3 days.

Customer-Provided Scripts

Run Custom Import Script

Specify whether to automatically execute the Custom Import callout script after initial workload discovery.

The default is disabled.

Run Submit Validation Script

Specify whether to automatically execute the Submit Validation callout script before adding the workload to Migrate.

The default is disabled.

Run Pre-Cutover Testing Script

Specify whether to automatically execute the Pre-Cutover Testing callout script after workload replication.

The default is disabled.

Run Post-Cutover Testing Script

Specify whether to automatically execute the Post-Cutover Testing callout script after workload cutover.

The default is disabled.

Sample Custom Callout scripts are available on the PTM Appliance in the /opt/microfocus/migrate_connector/custom_callouts/ folder.

When it first compiles Custom Callout scripts, PTM reports any discovered coding errors as sub-states for the workload in the Workloads list and Workload dialog. Pause over the error sub-state to view additional debugging information as a tooltip. Scripts that fail for coding or validation failure reasons can be retried. A script success must occur before the migration workflow can proceed. PTM forces a reload of Custom Scripts each time they are run to ensure the most recent code changes are applied.

3.3.2 Viewing Global Migrate Connector Settings

The System Administrator, Project Manager, and Project Architect can view the global settings for the PlateSpin Migrate Connector instance associated with the PTM Server.

To view the connector settings:

  1. In the Web Interface toolbar, select Configuration.

  2. In the System Configuration dialog, select Migrate Connector.

  3. View the settings:

  4. When you are done, click Close to exit the System Configuration dialog.

3.3.3 Configuring Global Settings for Migrate Connector

The System Administrator or a user with the Administrator role can modify any of the global settings for the PlateSpin Migrate Connector instances that are assigned to the PTM Server. The changes apply throughout the product for all transformation projects.

To configure global settings for Migrate Connector:

  1. In the Web Interface toolbar, select Configuration.

  2. In the System Configuration dialog, select Migrate Connector.

  3. In the Migrate Connector dialog, specify appropriate option settings for the following:

  4. Click Save.

  5. Click Close to exit the System Configuration dialog.

  6. For each PlateSpin Migrate Connector server that is connected to your PTM Server, log in to the Connector server as the root user and restart the Connector service. In a terminal console, enter

    rcps_migrate_connector restart