7.4 Assigning a Migrate Connector Instance

You can assign a Migrate Connector to the PlateSpin Transformation Manager server, or to a specific project.

The PlateSpin Transformation Manager Appliance includes an instance of the PlateSpin Migrate Connector that is automatically installed and configured to work with the Transformation Manager server on the Appliance. It works with all projects by default. After you set up projects in Transformation Manager, you can add a ptm_project_id to the /opt/microfocus/migrate_connector/config/settings.cfg file on the Appliance to assign the Connector instance to a specific project.

You must manually configure each PlateSpin Migrate Connector instance that you deploy on your own SUSE Linux Enterprise Server 11. SP4 server.

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

    ptm_username

    Specify the email address of a valid user account on your PlateSpin Transformation Manager server that has been assigned a System Administrator role.

    ptm_username=john.doe@example.com

    NOTE:We recommend that you create a dedicated user account in PlateSpin Transformation Manager for the connector to use. We recommend System Administrator privileges for the account in order to allow Migrate Connector to execute on any project. The user account must have at least Project Architect level privileges for the projects on which the Connector should execute.

    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:

    1. In the Web Interface, go to Planning > Projects.

    2. Select the project, then click Edit.

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