7.3 Configuring the Connector to Work with Your PTM Server

By default, the PlateSpin Migrate Connector instance on the appliance is configured to work with the PTM Server running on the same appliance. When you deploy a Connector Appliance to use as a remote Connector host, you must re-configure the Connector instance to work with the actual PTM Server in your PlateSpin Migration Factory environment.

  1. In the Appliance Management Console, enable the SSH service.

    1. Click System Services .

    2. In the Available System Services list, select SSH, then click Action > Start.

      Wait for the Status to change to Running before you continue.

    3. Click Close to exit System Services.

  2. On your management computer, launch an SSH session on port 22, and connect to the Connector Appliance VM as the root user.

  3. Configure the Connector settings on the Connector Appliance as you do for other remote Connector instances.

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

    2. Use the following checklist to configure the Connector settings.

      See About Migrate Connector Configuration Options in the PTM 2019.5 Administrator Guide.

      Connector Configuration Tasks

      Description

      Configure the Connector instance on the Connector Appliance to work with your PTM Server on the PTM Appliance.

      See Configuring PTM Server Settings for a Connector PTM 2019.5 Administrator Guide.

      (Optional) Configure the Connector instance to work with a specific project on the PTM Server.

      After you create a project on the PTM Server, you can use its Project ID to configure a Connector instance to work with a specific project.

      See Configuring a Dedicated Project for a Connector in the PTM 2019.5 Administrator Guide.

      (Optional, recommended) Create a special-purpose user account in PTM to use for this remote Migrate Connector instance, then modify the user credentials in the Connector configuration file.

      The default instance of Migrate Connector on the PTM Appliance uses the credentials of the PTM System Administrator user to perform actions. We recommend that you create a unique user identity for the Connector instance instead. Having a unique Connector user for each Migrate Connector helps you more easily distinguish actions performed by the Connector instance in logs and transformation histories.

      To create a unique user account for the Connector instance, see Creating a User for Connector Login in the PTM 2019.5 Administrator Guide.

      To modify the username and password to use for the Connector, see Configuring the PTM User Credentials Used by a Connector in the PTM 2019.5 Administrator Guide.

      (Optional) Customize the Connector logging settings.

      See Setting the Logging Level for the Connector in the PTM 2019.5 Administrator Guide.

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

    4. Restart the Connector service. Enter

      systemctl restart ps_migrate_connector.service

    5. Verify the Connector service. Enter

      systemctl status ps_migrate_connector.service

  4. At the terminal prompt, enter exit to close the SSH session.

  5. (Optional) In the Appliance Management Console, disable the SSH protocol on the Appliance.

    1. Click System Services .

    2. Select the SSH service.

    3. Select Action > Stop.

    4. Click Close to exit System Services.

  6. Log out of the Appliance Management Console and close the web browser.

  7. Continue with Post-Installation Tasks for a Connector Appliance.