15.1 About Migrate Connector Configuration Options

The PlateSpin Transformation Manager Appliance includes an instance of the PlateSpin Migrate Connector that is automatically installed and configured to work with the PTM Server on the Appliance. It works with all projects by default. After you set up multiple projects in Transformation Manager, you can add a specific Project ID to the Connector configuration file to dedicate the Connector services for that project.

You must manually configure each remote PlateSpin Migrate Connector instance that you deploy to connect to your PTM Server. Settings are located in the /opt/microfocus/migrate_connector/config/settings.cfg file on the Connector host server.

15.1.1 Configurable PTM Server Parameters

Table 15-1 describes the configurable parameters in the PlateSpin Transformation Manager Server section and their default values.

Table 15-1 Configurable PTM Server Parameters for PlateSpin Migrate Connector

Parameter

Description

Example

ptm_host

Specify the host name or IPv4 address of the PTM Appliance.

The Migrate Connector instance on the Appliance uses localhost for this setting.

ptm_host=localhost

ptm_host=10.10.10.101

ptm_host=myptm.example.com

ptm_port

Specify the port to use for HTTPS (secure) or HTTP (not secure) communications with the PTM Server application on the PTM Appliance. The default ports are 8183 for HTTPS or 8182 for HTTP.

NOTE:Ensure that you open this port in the firewall on the Connector host and on network firewalls between the Connector host and the PTM Server.

ptm_port=8183

ptm_ssl

Specify a value of true to use SSL to connect to the PTM Server. Valid values are true and false.

ptm_ssl=true

verify_ptm_ssl_cert

Specify whether you want to require the certificate to be validated for connections to the PTM Server. Valid values are false or true. The default is to disable validation (false).

NOTE:We recommend that you enable verification of the PTM Server certificate for remote instances of the Connector. Certificate validation is not necessary for the Connector instance installed on the Appliance.

verify_ptm_ssl_cert=true

local_ptm_ssl_cert

Specify one of the following:

  • The local PTM Server certificate store for authenticating the PTM Server certificate

  • The directory location to use a local certificate authority for certificate validation

  • If no value is set, the Connector will use Mozilla’s root certificates.

local_ptm_ssl_cert=

ptm_username

Specify the email address of a System user account on your PTM Server that has been assigned at least a Project Architect role at the Project level. The account is required for communications with the PTM Server.

The Transformation History and logs track Connector actions that are initiated by this user account. Using a dedicated user account for each Connector makes it possible to identify which Connector performs the actions, and distinguishes Connector actions from other actions performed by the same user.

NOTE:We recommend that you create a dedicated user account in PTM for the Connector instance to use. Create this special user account as a System user, then assign it a Project Architect role at the Project level. Create a dedicated user account for each Connector instance with permissions appropriate for its assigned project. See Creating a User for Connector Login in the PTM 2019.5 Administrator Guide.

ptm_username=connector102@example.com

ptm_password

Specify the password for the user account.

NOTE:When you save the settings.cfg file and restart the Connector service, the password is encrypted and the file is modified to store the encrypted password instead of plain text.

ptm_password=yourpassword

15.1.2 Configurable Connector Parameters

Table 15-2 describes the configurable parameters in the Connector Settings section and their default values.

Table 15-2 Configurable Connector Parameters for PlateSpin Migrate Connector

Parameter

Description

Example

log_level

Valid options are CRITICAL, ERROR, WARNING, INFO, or DEBUG. The default is INFO.

log_level=INFO

log_level=DEBUG

log_file_path

The path to the log file on the Connector host server, including the log file name.

log_file_path=/var/opt/microfocus/migrate_connector/logs/migrate_connector.log

ptm_project_id

(Optional) Specify the numeric project ID for the project in Transformation Manager to restrict the Connector to a single project instead of making it available for all projects. The Connector processes only events and actions within the assigned project.

Comment out this parameter if the Migrate Connector should be available to all projects.

ptm_project_id=1234