7.4 Assigning a Migrate Connector Instance

To configure the Connector instance for a PTM server or for a specific project:

1. Log in to the SLES 11 SP4 server with a root user account.

2. In a text editor, open the /opt/microfocus/migrate_connector/config/settings.cfg file.

3. Configure the values in the top section called [PlateSpin Transformation Manager Server].

   Option	Description
   ptm_host	Specify the host name or IP address of the Transformation Manager server. For example, the Migrate Connector instance on the Appliance is localhost. ptm_host=localhost
   ptm_port	Specify the port used for the Transformation Manager server. The default port for HTTPS is 8183. The default port for HTTP is 8182. ptm_port=8183
   ptm_ssl	Specify a value of true to use SSL to connect to the Transformation Manager 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 PlateSpin Transformation Manager server. Valid values are false or true. The default is to disable validation (false). verify_ptm_ssl_cert=false We recommend verifying the PTM Server certificate for remote instances of the Connector. Certificate validation is not necessary for the Connector instance installed on the Appliance.
   local_ptm_ssl_cert	Specify local PTM server certificate store for authenticating the PTM server certificate. Specify 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 valid System user account on your PlateSpin Transformation Manager server that has been assigned a at least a Project Architect role at the Project level. ptm_username=john.doe@example.com The Transformation History can distinguish Connector-initiated actions by the User object if you create a unique dedicated User object to use for the Connector login credentials instead of using a real User object. NOTE:We recommend that you create a dedicated user account in PlateSpin Transformation Manager for the Connector instance to use. Create this special User object as a System user, then assign it a Project Architect role at the Project level. Create a different User object for each Connector instance with permissions appropriate for its assigned project.
   ptm_password	Specify the password for the user account. ptm_password=yourpassword
   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. ptm_project_id=1234 To discover the numeric ID associated with a project in PlateSpin Transformation Manager: In the Web Interface, go to Planning > Projects. Select the project, then click Edit. In the Edit Project dialog, mouse over the project name in the dialog title area. A tooltip displays the numeric ID of the project.

4. Save the file, then exit the text editor.

5. Start or restart PlateSpin Migrate Connector. In the terminal console, enter

   rcps_migrate_connector restart

   For the Migrate Connector instance installed on the PlateSpin Transformation Manager Appliance, you can alternatively restart the Connector from the Appliance Management Console.