5.1 PlateSpin Migrate Product Licensing

This section provides information about licensing and activating your PlateSpin Migrate product and managing your license keys.

NOTE:You cannot use the Licenses that you purchased for PlateSpin Migrate 9.3 and later versions with PlateSpin Migrate 9.2 and prior versions.

5.1.1 Activating Your Product License

For product licensing, you must have a license activation code. If you do not have a license activation code, request one through the Customer Center. A Micro Focus representative will contact you and provide the license activation code.

NOTE:If you are an existing PlateSpin customer and you do not have a Customer Center account, you must first create an account using the same email address as specified in your purchase order. See Create Account.

Before you activate a license, consider whether you want to split the license for different migration scenarios.

License Splitting

A license entitles you to one instance of PlateSpin Migrate per workload. Depending on the license you purchased, you can split a license either on a per-migration or a per-workload basis.

You can only split a license that has not yet been activated. For example, you can split a per-workload license of 1000 workloads into one license covering 400 workloads and another covering 600 workloads. You can split a per-migration license for 3000 migrations into one license for 1200 migrations and one license for 1800 migrations.

For assistance with multi-license scenarios, especially if you are uncertain how to utilize licenses across your network environment, see KB Article 7920876.

License Activation Using Migrate Client

When you launch the PlateSpin Migrate Client for the first time after installation, the License Activation Wizard opens and prompts you to activate your product license.

Figure 5-1 License Activation Wizard

You have two options for activating your product license: online or offline.

Online License Activation

Online activation requires that your PlateSpin Migrate Client have Internet access.

NOTE:HTTP proxies might cause failures during online activation. If you are using an HTTP proxy server and are having problems with online activation, try the offline activation method.

  1. In the License Wizard, select the Online Activation option and click Next.

  2. Enter the e-mail address that you provided when placing your order, and the activation code you received.

    The PlateSpin Migrate Client obtains the required license over the Internet and activates the product.

Offline License Activation

For offline activation, you obtain a license key over the Internet by using a machine that has Internet access.

  1. In the License Wizard, select the Offline Activation option and click Next.

    The Activate License dialog box is displayed:

  2. Save your hardware ID for use in the next steps.

  3. Use a computer with Internet access to obtain a license key through the Web-based license activation utility.

    To obtain a license key, you must have a Customer Center account. If you are an existing PlateSpin customer and you don’t have a Customer Center account, you must first create one. (See Create Account.) Use your existing PlateSpin username (a valid e-mail address registered with PlateSpin) as input for your Customer Center account username.

  4. Save your new license key in a location accessible to your PlateSpin Migrate Client.

  5. In the License Wizard, type the full path to, or browse to and select, the PlateSpin Migrate license file, then click Next.

    The product is activated based on the selected license.

License Activation Using the Web Interface

You have two options for activating your product license: online or offline.

Figure 5-2 License Activation Using Migrate Web Interface

Online License Activation

Online activation requires that your PlateSpin Migrate Web Interface has Internet access.

NOTE:HTTP proxies might cause failures during online activation. Offline activation is recommended for users in environments that use HTTP proxy.

To set up online license activation:

  1. In the PlateSpin Migrate Web Interface, click Settings > Licensing, then click Add license.

  2. Click Online Activation.

  3. Specify the email address that you provided when you placed your order and the activation code you received, then click Activate.

    The system obtains the required license over the Internet and activates the product.

Offline License Activation

For offline activation, you must first use a computer that has Internet access to obtain a PlateSpin Migrate license key.

  1. In the PlateSpin Migrate Web Interface, click Settings > Licensing, then click Add license.

  2. Click Offline Activation and copy the hardware ID displayed in the interface.

  3. Use a web browser on a computer that has Internet access to navigate to the PlateSpin Product Activation website. Log in with your Customer Center user name and password.

  4. Open the PlateSpin Activate Order page to generate a license key file. You need the following information:

    • activation code that you received

    • email address that you provided when you placed your order

    • hardware ID that you copied in Step 2

  5. Save the generated license key file, transfer it to the product host that does not have Internet connectivity, and use it to activate the product.

  6. In the PlateSpin Migrate Web Interface on the License Activation page, browse to the location of the license key file, then click Activate.

    The license key file is saved and the product is activated based on this file.

5.1.2 How Migration Licensing Works

PlateSpin Migrate licenses are sold on a per-workload basis. A license entitles you to an unlimited number of migrations on a specific number of workloads. With every migration, a workload unit of the license is assigned to either the source or the target. The machine that has the workload unit assigned to it can subsequently be migrated an unlimited number of times. Each time a workload is assigned, the Workloads remaining number is decremented.

Following is a summary of the workload assignment behavior based on the end state of a source workload after a successful cutover of the workload. This license assignment is applicable only for workloads migrated with the transfer scope as full migration. For information about the end state, see Section 25.20, Post-Cutover End States for Source and Target Workloads.

Table 5-1 PlateSpin Migrate Workload License Assignment

Source Workload End State

Workload Assignment Behavior

Not shut down

A workload license remains with the source.

Shut down

A workload license is transferred from the source to the target.

5.1.3 Managing License Keys for Workload Migrations

You can add, delete, and monitor your PlateSpin licenses in the Migrate Client or Web Interface. Licenses can be used from migrations managed in either tool.

License Key Management with Migrate Client

You can manage available license keys on the License Manager’s Available License Keys tab.

  1. In PlateSpin Migrate Client, click Tools > License Manager > Available License Keys.

Figure 5-3 Available License Keys

The tab displays the license name (Module) along with its expiry date and entitlements. These depend on the license type.

The Number of Servers column indicates the number of machines you can discover. This is generally the same as the number of machines that you can migrate.

Use the buttons at the bottom for related license management tasks:

Table 5-2 License Manager Command Buttons

Command

Description

Add

Adds licenses.

Delete

Deletes expired licenses.

View Activation Code(s)

Select a license and click this button to see the activation code and the date it was activated.

Generate Licensing Report

Creates a *.psl file that is used by Technical Support to troubleshoot licensing issues.

License Key Management Using Migrate Web Interface

You can manage available license keys on the Licensing tab in the Web Interface settings. In addition, the License Summary on the Web Interface Dashboard shows the total number of licenses and the number currently available.

  1. In PlateSpin Migrate Web Interface, click Settings > Licensing > Available Licenses.

Figure 5-4 Available License Keys

The Licensing tab displays the license name (Module) along with its activation code, expiry date, and the number entitlements (workload licenses available, workload licenses used, workload licenses remaining, conversions available, conversions used, and conversions remaining) for workload migration.

The sum total of all workload licenses available and remaining is displayed at the bottom of the window.

Use the options for related license management tasks:

Table 5-3 Licensing Tab Options

Command

Description

Add License

Adds a new license.

Delete

Deletes expired licenses.

Generate Licensing Report

Creates a LicenseReport.txt file that is used by Technical Support to troubleshoot licensing issues.

5.1.4 Managing Workload Designations

You can view license allocations for workloads in the Migrate Client or Web Interface. However, the PlateSpin Migrate Client lets you manage license allocations also.

Managing Workload Designations Using Migrate Client

In the PlateSpin Migrate Client, you can view and manage license allocations on the License Manager’s Workload Designations tab.

  1. In PlateSpin Migrate Client, click Tools > License Manager > Workload Designations.

Figure 5-5 License Manager Workload Designations

The tab lists workloads with assigned licenses. In the PlateSpin Migrate Client Servers view, each of these servers has a key icon adjacent to it.

You can reset workload licensing so that a license is no longer assigned to a particular machine. For example, you might want to do this when decommissioning servers that are already in the inventory of the PlateSpin Server.

To reset workload licensing:

  1. On the License Manager’s Workload Designations tab, select the required workload and click Transfer Selected Workload.

    The Transfer License dialog box is displayed.

  2. Use the displayed Workload Transfer Request string to obtain a workload transfer code from the License Entitlement Web portal. Log in with credentials associated with your purchase order.

    You must have a Customer Center account. If you are an existing PlateSpin customer and you don’t have a Customer Center account, you must first create one. (See Create Account.) Use your existing PlateSpin username (a valid e-mail address registered with PlateSpin) as input for your Customer Center account username.

  3. Return to the License Manager and specify the newly obtained transfer code. Click Next.

    PlateSpin Migrate resets the selected workload.

Viewing Workload License Designations Using Migrate Web Interface

In the PlateSpin Migrate Web Interface, click Settings > Licensing > License Designations to view license allocations for workloads.

Figure 5-6 License Designations