3.2 Configuring a Project Assignment for a Connector Instance

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

    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:

    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.