" /> PlateSpin Migrate Connector 2019.5 Installation Quick Start

PlateSpin Migrate Connector 2019.5 Installation Quick Start

June 2019

PlateSpin Migrate Connector 2019.5 is a component of PlateSpin Transformation Manager 2019.5. The Connector discovers details about source workloads and target VMware vCenter Server platforms. In a PlateSpin Migration Factory environment, Migrate Connector integrates PTM with one or more PlateSpin Migrate 2019.5 servers to automate migrations or to track external migrations performed with Migrate servers.

NOTE:PlateSpin Migrate Connector 2019.5 is not backwards compatible with prior releases of PlateSpin Transformation Manager and PlateSpin Migrate.

Use the information in this quick start to deploy instances of the PlateSpin Migrate Connector in your PlateSpin Migration Factory environment.

1.0 Deployment Guidelines

Consider the following guidelines as you deploy PlateSpin Migrate Connectors in your migration environment:

  • For source workload discovery, deploy at least one Migrate Connector server in each source network (the network where source workloads reside).

  • For target platform discovery in VMware environments on premises or in VMware Cloud (VMC) on Amazon Web Services, deploy a Migrate Connector instance in each target network to enable discovery of VMware vCenter Server platforms and their platform resources.

  • Configure each Migrate Connector server to work with your PTM Server.

    • There is no set limit to the number of Connectors you can register for a PTM Server.

    • Each Migrate Connector instance can register with only one PTM Server.

    • Each Migrate Connector instance can be available to all projects (the default), or it can be dedicated to a single project.

  • Associate each PlateSpin Migrate Connector instance with one or more PlateSpin Migrate servers.

  • Assign each Migration Server resource to only one Connector.

    It is not supported to assign a PlateSpin Migrate server to multiple Migrate Connectors in the same project or in different projects.

2.0 Software Requirements

PlateSpin Migrate Connector supports installation on SUSE Linux Enterprise Server (SLES) 15 servers.

The Migrate Connector installation RPM includes dependent software. See Supported Connector Host OS and Dependent Software in the PTM 2019.5 Administrator Guide.

3.0 Download

The installation files for PlateSpin Migrate Connector 2019.5 are available on the Micro Focus Downloads website. Select PlateSpin Transformation Manager, then follow the Download link for PlateSpin Transformation Manager 2019.5 in the results. Use your Micro Focus Customer Center account credentials to log in to this site. Download the RPM file and the PTM public key file.

4.0 Installation

To install PlateSpin Migrate Connector:

  1. Log in to the Migrate Connector host as the root user.

  2. Copy the RPM and KEY files that you downloaded to a location on the server.

  3. Import the PTM Public Key to your keyring.

    Launch a terminal, then enter one of the following commands as the root user:

    gpg --import <ptm-public-key-filename>
    
    or
    
    rpm --import <ptm-public-key-filename>
  4. Open a terminal console, then install the RPM:

    rpm -ih <ptm-connector-rpm-filename>
  5. Enable the Connector service. Enter

    systemctl enable ps_migrate_connector.service
  6. Start the Connector service. Enter

    systemctl start ps_migrate_connector.service
  7. Verify the Connector service. Enter

    systemctl status ps_migrate_connector.service

5.0 Configuration

Configure the PlateSpin Migrate Connector instance to work with your PlateSpin Transformation Manager server. See Table 1 for a checklist of Connector configuration tasks.

Table 1 PlateSpin Migrate Connector Configuration Checklist

Connector Configuration Task

Description

  1. (Optional, recommended) In PTM, create a special-purpose user for each Migrate Connector.

We recommend that you create a unique user identity in PTM for each Connector instance. Specify these user credentials in the Connector configuration file. The user name appears in logs and transformation histories for actions performed by its associated Connector instance.

Users with Administrator permissions can create PTM users. See Creating a User for Connector Login in the PTM 2019.5 Administrator Guide.

Users with root user privileges on the Connector host can modify the Connector configuration file. See Configuring PTM Server Settings for a Connector in the PTM 2019.5 Administrator Guide.

  1. Configure each Connector instance to work with your PTM Server.

Users with root user privileges on the Connector host can modify the Connector configuration file. See Configuring PTM Server Settings for a Connector in the PTM 2019.5 Administrator Guide.

  1. (Optional) Configure the Connector instance to work with a specific project instead of with all projects.

By default, a Connector instance works with all projects on the PTM Server. Associate the Connector with a Project ID to dedicate its services to that project. It ignores messages for all other projects.

As a PTM user, retrieve the Project ID on the Edit Project dialog. Pause over the Project icon in the dialog header to view the Project ID in an infotip. Specify the Project ID in the Connector configuration file.

Users with root user privileges on the Connector host can modify the Connector configuration file. See Configuring a Dedicated Project for a Connector in the PTM 2019.5 Administrator Guide.

  1. (PlateSpin Migration Factory) Add one or more PlateSpin Migrate servers as Migration Server resources and associate them with a Connector instance.

In a PlateSpin Migration Factory environment, a Connector instance is required for automating migrations or tracking migrations performed on your PlateSpin Migrate servers. Each Migrate server is associated to a single Connector. A Connector can be associated to multiple Migrate Servers.

Users with Project Manager or Project Architect permissions can assign a Connector by creating or editing a Migration Server resource. See Connector in About Migration Server Resources and Associating a Connector with a Migration Server Resource in the PTM 2019.5 User Guide.

Users with Administrator permissions can add one or more Migration Server resources to a Connector by editing a Connector in the Connectors list. See Associating Migration Servers with a Connector in the PTM 2019.5 Administrator Guide.

  1. Configure Migrate Connector global settings.

Migrate Connector settings in PTM apply to all Migrate Connectors associated with the PTM Server across all projects.

Users with Administrator permissions can set the Migrate Connector global settings. See Configuring Global Settings for PlateSpin Migrate Connector in the PTM 2019.5 Administrator Guide.