3.4 Upgrading Migrate to a New Host Platform

You can upgrade your existing PlateSpin Migrate Server to a new host platform. For example, you can upgrade a PlateSpin Migrate server running on Windows Server 2012 R2 to Windows Server 2016 platform.

Use the information in this section to prepare the replacement PlateSpin Server host and re-install PlateSpin Migrate. You will export the database prior to the upgrade, and import it to a new database instance afterwards.

3.4.1 Preparing for Upgrade to a New Host Platform

Before you upgrade, ensure that you meet the prerequisites for upgrade to a new platform:

  • Contact Micro Focus Support to reset your activation code and licenses for your current PlateSpin Migrate server in preparation for moving them to the replacement server. Ensure that you are ready to move to the new platform when the licenses are reset.

  • Use Run Diagnostics to generate detailed diagnostic reports on jobs executed before the upgrade. Post upgrading, the diagnostics reports are not available for jobs that you executed prior to the upgrade. See Generating Diagnostic Reports in the PlateSpin Migrate 2019.2 User Guide.

  • Back up your custom blkwatch drivers that you will need for future migrations.

    See Backing Up Your Custom Linux blkwatch Drivers Before Upgrade.

  • Export your migration data. See Section 3.6.1, Exporting Workload Migration Data.

    Ensure that you copy the exported XML files to a location where they can be available for import after you have upgraded PlateSpin Server on a new platform.

3.4.2 Upgrading the Platform on Your Current PlateSpin Server Host

In this upgrade path, you upgrade the platform of the current PlateSpin Server host. It requires that you remove the installed PlateSpin components while you install and configure the upgraded prerequisite OS and software. After you export your database, you are ready to upgrade the prerequisite software and operating system for the current PlateSpin Server host.

  1. Log in to the current PlateSpin Server host as an administrative user.

    If the server is in a domain, you must log in as a domain user who is a member of the Domain Admin group and the local Admin group.

  2. Remove the installed PlateSpin Migrate components:

    1. Use Windows Control Panel to uninstall PlateSpin Migrate Client.

    2. Use Windows Control Panel to uninstall PlateSpin Migrate.

    3. (Conditional) If SQL Server Express Edition is installed on the PlateSpin Server host, use Windows Control Panel to uninstall it.

  3. On your PlateSpin Server host, upgrade to a supported Windows Server operating system and configure the required features and settings for that platform.

    See Operating System and Installing Prerequisite Software.

  4. Ensure that you install and reconfigure all prerequisite software for the PlateSpin Server host.

    See Prerequisite Software and Installing Prerequisite Software.

  5. Prepare your database server to work with the reconfigured PlateSpin Server host.

    See Installing the Database Server.

    If you are using SQL Server Express Edition, install the current version. After the upgrade is complete and the product license is re-activated, you should set a secure custom password for the re-installed SQL Server Express database server. See Modifying the Password for the SQL Server Express System Administrator User.

    If you are using your Microsoft SQL Server Standard Edition or Enterprise Edition, ensure that you create a new database instance and configure the settings to work with the upgraded platform. You will import the database to this new database instance after the upgrade is complete.

  6. Log in to the PlateSpin Server host as a user with administrative rights.

    If the server is a domain computer, you must log in as a domain user who is a member of the Domain Admin group and the local Admin group.

    If you use Windows Authentication for your SQL Server Standard Edition or Enterprise Edition database server, you must log in as the domain user with SQL Admin rights. This user must also have local administrator rights. In addition, the Service User you specify for SQL Server credentials must have local administrator rights.

  7. Install the current version of PlateSpin Migrate Server. See Installing PlateSpin Server.

  8. (Optional) Install the current version of PlateSpin Migrate Client. See Installing the PlateSpin Migrate Client.

  9. Activate the license for the PlateSpin Server host by using the reset activation code that you retrieved from Micro Focus Support before the upgrade.

    See Activating Your Product License in the PlateSpin Migrate 2019.2 User Guide.

  10. Import the exported database to the new database instance. See Importing Workload Migration Data.

  11. (Optional) Add other reset or re-activated licenses on the replacement server. See Managing License Keys for Workload Migrations in the PlateSpin Migrate 2019.2 User Guide.

  12. (Optional) After the upgrade, you should upload again any custom Linux blkwatch drivers you need for future migrations. See KB Article 7005873.

    See also Backing Up Your Custom Linux blkwatch Drivers Before Upgrade.

  13. (Conditional) If you used a Microsoft SQL Server Standard Edition or Enterprise Edition database server with the old PlateSpin Server host, remove the now unused database instance that was associated with the former PlateSpin Server host.

3.4.3 Upgrading to a Replacement PlateSpin Server Host

In this upgrade path, you set up a replacement PlateSpin Server host, then decommission the current PlateSpin Server host. It requires that you stop all migration services on the old host while you install and configure the upgraded prerequisite OS and software on a new machine. After you export your database, you are ready to prepare a replacement PlateSpin Server host with the prerequisite software and operating system.

  1. On the new intended PlateSpin Server host, install a supported Windows Server operating system and configure the required features and settings for that platform.

    See Operating System and Installing Prerequisite Software.

  2. Ensure that you install and configure all prerequisite software. See Prerequisite Software.

  3. Prepare your database server to work with the new PlateSpin Server host. See Installing the Database Server.

    If you are using SQL Server Express Edition, install the current version. After the upgrade is complete and the product license is re-activated, you should set a secure custom password for the re-installed SQL Server Express database server. See Section 1.7, Modifying the Password for the SQL Server Express System Administrator User.

    If you are using your Microsoft SQL Server Standard Edition or Enterprise Edition, ensure that you create a new database instance. You will import the database to this new database instance after the upgrade is complete.

  4. Log in to the replacement PlateSpin Server host as a user with administrative rights.

    If the server is a domain computer, you must log in as a domain user who is a member of the Domain Admin group and the local Admin group.

    If you use Windows Authentication for your SQL Server Standard Edition or Enterprise Edition database server, you must log in as the domain user with SQL Admin rights. This user must also have local administrator rights. In addition, the Service User you specify for SQL Server credentials must have local administrator rights.

  5. Install the current version of PlateSpin Migrate Server. See Installing PlateSpin Server.

  6. (Optional) Install the current version of PlateSpin Migrate Client. See Installing the PlateSpin Migrate Client.

  7. Activate the license for the replacement PlateSpin Server host by using the reset activation code that you retrieved from Micro Focus Support before the upgrade.

    See Activating Your Product License in the PlateSpin Migrate 2019.2 User Guide.

  8. Import the exported database to the new database instance. See Section 3.6.2, Importing Workload Migration Data.

  9. (Optional) Add other reset or re-activated licenses on the replacement server. See Managing License Keys for Workload Migrations in the PlateSpin Migrate 2019.2 User Guide.

  10. (Optional) After the upgrade, you should upload again any custom Linux blkwatch drivers you need for future migrations. See KB Article 7005873.

    See also Backing Up Your Custom Linux blkwatch Drivers Before Upgrade.

  11. Remove PlateSpin Migrate components from the former PlateSpin Server host to decommission it as a PlateSpin server:

    1. Log in to the former PlateSpin Server host as an administrative user.

      If the server is in a domain, you must log in as a domain user who is a member of the Domain Admin group and the local Admin group.

    2. Use Windows Control Panel to uninstall PlateSpin Migrate Client.

    3. Use Windows Control Panel to uninstall PlateSpin Migrate.

    4. (Conditional) If SQL Server Express Edition is installed on the old PlateSpin Server host, use Windows Control Panel to uninstall it.

  12. (Conditional) If you used a Microsoft SQL Server Standard Edition or Enterprise Edition database server with the old PlateSpin Server host, remove the now unused database instance that was associated with the former PlateSpin Server host.