1.2 Installing Prerequisite Software

Before you install PlateSpin Migrate on the intended PlateSpin Migrate host server, you must install a supported version of Microsoft Windows Server and activate the Windows license, then install the Prerequisite Software: Visual C++ (for batch-file installation), ASP.NET, IIS, and .NET Framework. You can optionally enable FIPS-compliant data encryption.

You can use the Install PlateSpin Migrate Prerequisites script provided on the Micro Focus Download site to install any missing software and apply the appropriate configuration on the intended PlateSpin Migrate server host. Alternatively, you can manually install and configure the prerequisite software on the intended PlateSpin Migrate server host by using the procedures in this section.

NOTE:The installation of prerequisite software might require a reboot of the intended PlateSpin Migrate host server. Depending on what prerequisite software needs to be installed, Internet access might be required.

To use the Install PlateSpin Migrate Prerequisites script to install prerequisite software:

  1. Log in to the intended PlateSpin Migrate server as a user with Administrator privileges.

  2. Launch a web browser, go to the Micro Focus Downloads page, search for PlateSpin Migrate and then proceed to the appropriate PlateSpin Migrate Download page.

  3. Download the Install_PlateSpin_Migrate_Prerequisites-2019_11.zip file to the intended PlateSpin Migrate host server.

  4. In a ZIP tool, use Extract > All files/folders to extract the files to a location on the server:

    • Install PlateSpin Migrate Prerequisites.ps1
    • Install PlateSpin Migrate Prerequisites.bat
    • readme.txt

  5. Ensure that Windows security does not block the exported files from opening or running.

    Open the file Properties, then look on the General tab for a Security field with an Unblock option. This field is present only if Windows is blocking the file. Click Unblock > OK.

  6. Run the BAT file to execute the Install PlateSpin Migrate Prerequisites.ps1 PowerShell script. In an Explorer browser, right-click Install PlateSpin Migrate Prerequisites.bat and select Open.

    The PowerShell script automatically installs and configures the prerequisite software only on a supported version of Microsoft Windows Server operating system where you have previously activated the Windows license. The installation of prerequisite software might require a reboot of the intended PlateSpin Migrate host server. Depending on what prerequisite software needs to be installed, Internet access might be required.

  7. Continue with Installing PlateSpin Migrate Software Components.

To manually install prerequisite software:

NOTE:Because the packaging and distribution of these software components varies among different versions of the supported Windows Server platforms, procedures vary slightly. Use the appropriate procedure for the target platform in the indicated order of installation and setup.

  1. Log in to the intended PlateSpin Migrate server as a user with Administrator privileges.

  2. Install Visual C++.

    See Installing Visual C++ 2013 for Batch-File Installation of PlateSpin Migrate.

  3. Install Windows Server components ASP .NET, IIS, and .NET Framework:

  4. To use Migrate API, install Microsoft .NET Core Hosting Bundle version 2.2 or higher.

    NOTE:If you installed .NET Framework, ensure that you reboot the Migrate Server host before you install the Hosting Bundle.

  5. (Optional) Enable FIPS-compliant data encryption.

    See Enabling Support for FIPS-Compliant Data Encryption Algorithms (Optional).

  6. Continue with Installing PlateSpin Migrate Software Components.

1.2.1 Installing Visual C++ 2013 for Batch-File Installation of PlateSpin Migrate

Before you perform a batch-file installation of PlateSpin Migrate server, you must install Visual C++ 2013 on the planned Migrate server. A redistributable package of Visual C++ 2013 is available in the PlateSpinMigrateSetup-2019.11.0.x.exe file. You can alternatively download the Visual C++ 2013 package from Microsoft and install it.

To install VC++ 2013 on the planned Migrate server:

  1. Extract the PlateSpinMigrateSetup-2019.11.0.x.exe to a location on the planned server host for PlateSpin Migrate.

  2. In a file browser, navigate to the ..\Migrate-2019_11\PlateSpinImage\VCruntime-x64 folder.

  3. Run vcredist_x64.exe as Administrator.

1.2.2 Installing SQL Server Native Client on the Host Server

To use a remote database instance with the Migrate Server, you must install Microsoft SQL Server Native Client on the host server.

  1. Log in to the host server as a user with Administrator permissions.

  2. To check if SQL Server Native Client is already installed on the host server, run regedit and navigate to find the following entry:

    Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server Native Client 11.0

  3. If SQL Server Native Client is not installed, download Microsoft SQL Server 2012 Native Client from the Microsoft Download site, then install it on the host server.

1.2.3 Installing Prerequisite Software on Windows Server 2016 Systems

Use the following procedure to install prerequisite software on the Microsoft Windows Server 2016 servers where you plan to install PlateSpin Migrate Server. Before you begin, ensure that you are familiar with the System Requirements for PlateSpin Server and General Guidelines for Server Installation.

To install required Microsoft software components:

  1. Use the Local User Administrator (LUA) account to log in to your intended PlateSpin Server host.

  2. Use Server Manager to install Web Server (IIS) and other software required by PlateSpin Server:

    1. Open Server Manager. Select Start > Windows Administrative Tools > Server Manager.

    2. In the Server Manager toolbar, select Quick Start > Configure this local server > Add roles and features.

    3. In the Add Roles and Features wizard, proceed to the Installation Type tab, then continue through the wizard:

      Add Roles and Features Wizard

      Action

      1. Installation Type

      Select Role-based or feature-based installation, then click Next.

      1. Server Selection

      Select your intended PlateSpin Server host, then click Next.

      1. Server Roles

      Select Web Server (IIS), then click Next.

      1. Pop-up prompt to Add features that are required for Web Server (IIS)

      Select Include management tools, click Add Features to confirm your selection, then click Next on the Server Roles page to proceed to the Features list.

      1. Features

      Keep the default set of features for the Web Server and add other required features along with their sub-features as shown, then click Next.

      • .NET Framework 4.6 Features (3 of 7 installed)

        • .NET Framework 4.6

        • ASP.NET 4.6

        • WCF Services (1 of 5 installed)

          • TCP Port Sharing

      • XPS Viewer

      1. Web Server (IIS)

      Read the information, then click Next.

      1. Role Services

      Keep the default set of role services for the Web Server and add other required role services along with their sub-role services as shown, then click Next.

      NOTE:.NET 4.6 is installed by the OS. PlateSpin Server will use .NET 4.7.1, as installed in Step 2.f.

      Web Server (IIS) > Role Services (23 of 43 installed):

      • Web Server (17 of 34 installed)

        • Common HTTP Features (4 of 6 installed)

          • Default Document

          • Directory Browsing

          • HTTP Errors

          • Static Content

        • Health and Diagnostics (2 of 6 installed)

          • HTTP Logging

          • Request Monitor

        • Performance (1 of 2 installed)

          • Static Content Compression

        • Security (5 of 9 installed)

          • Requesting Filtering

          • Basic Authentication

          • IP and Domain Restrictions

          • URL Authorization

          • Windows Authentication

        • Application Development (5 of 11 installed)

          • .NET Extensibility 4.6

          • Application Initialization

          • ASP.NET 4.6

          • ISAPI Extensions

          • ISAPI Filters

      • Management Tools (6 of 7 installed)

        • IIS Management Console

        • IIS 6 Management Compatibility (4 of 4 installed)

          • IIS 6 Metabase Compatibility

          • IIS 6 Management Console

          • IIS 6 Scripting Tools

          • IIS 6 WMI Compatibility

        • IIS Management Scripts and Tools

      1. Confirmation

      Review the roles, role services, and features to be installed, then click Install.

    4. Wait for the installation to complete, then close the Add Roles and Features wizard.

    5. Exit Server Manager.

    6. Download and install Microsoft .NET Framework 4.7.1 on your intended PlateSpin Server host.

1.2.4 Installing Prerequisite Software on Windows Server 2012 R2 Systems

Use the following procedure to install prerequisite software on the Microsoft Windows Server 2012 R2 servers where you plan to install PlateSpin Migrate Server. Before you begin, ensure that you are familiar with the System Requirements for PlateSpin Server and General Guidelines for Server Installation.

To install required Microsoft software components:

  1. Use the Local User Administrator (LUA) account to log in to your intended PlateSpin Server host.

  2. Use Server Manager to install Web Server (IIS) and other software required by PlateSpin Server:

    1. Open Server Manager. Select Start > All Programs > Administrative Tools > Server Manager.

    2. In the Server Manager toolbar, select Manage > Add Roles and Features.

    3. In the Add Roles and Features wizard, proceed to the Installation Type tab, then continue through the wizard:

      Add Roles and Features Wizard

      Action

      1. Installation Type

      Select Role-based or feature-based installation, then click Next.

      1. Server Selection

      Select your intended PlateSpin Server host, then click Next.

      1. Server Roles

      Select Web Server (IIS), then click Next.

      1. Pop-up prompt to Add features that are required for Web Server (IIS)

      Select Include management tools, then click Add Features to confirm your selection, then click Next on the Server Roles page to proceed to the Features list.

      1. Features

      Keep the default set of features for the Web Server and add other required features along with their sub-features as shown, then click Next.

      NOTE:.NET 4.5 is installed by the OS. PlateSpin Server will use .NET 4.7.1, as installed in Step 2.f.

      • .NET Framework 4.5 Features (3 of 7 installed)

        • .NET Framework 4.5

        • ASP.NET 4.5

        • WCF Services (1 of 5 installed)

          • TCP Port Sharing

      • XPS Viewer

      1. Web Server (IIS)

      Read the information, then click Next.

      1. Role Services

      Keep the default set of role services for the Web Server and add other required role services along with their sub-role services as shown, then click Next.

      Web Server (IIS) > Role Services (23 of 43 installed):

      • Web Server (17 of 34 installed)

        • Common HTTP Features (4 of 6 installed)

          • Default Document

          • Directory Browsing

          • HTTP Errors

          • Static Content

        • Health and Diagnostics (2 of 6 installed)

          • HTTP Logging

          • Request Monitor

        • Performance (1 of 2 installed)

          • Static Content Compression

        • Security (5 of 9 installed)

          • Requesting Filtering

          • Basic Authentication

          • IP and Domain Restrictions

          • URL Authorization

          • Windows Authentication

        • Application Development (5 of 11 installed)

          • .NET Extensibility 4.5

          • Application Initialization

          • ASP.NET 4.5

          • ISAPI Extensions

          • ISAPI Filters

      • Management Tools (6 of 7 installed)

        • IIS Management Console

        • IIS 6 Management Compatibility (4 of 4 installed)

          • IIS 6 Metabase Compatibility

          • IIS 6 Management Console

          • IIS 6 Scripting Tools

          • IIS 6 WMI Compatibility

        • IIS Management Scripts and Tools

      1. Confirmation

      Review the roles, role services, and features to be installed, then click Install.

    4. Wait for the installation to complete, then close the Add Roles and Features wizard.

    5. Exit Server Manager.

    6. Download and install Microsoft .NET Framework 4.7.1 on your intended PlateSpin Server host.

1.2.5 Enabling Support for FIPS-Compliant Data Encryption Algorithms (Optional)

PlateSpin Migrate supports data encryption algorithms that are compliant with FIPS (Federal Information Processing Standards, Publication 140-2).

If compliance with FIPS is required, it must be enabled on the intended PlateSpin Server host prior to the installation of the PlateSpin Server. This is because PlateSpin Migrate runs in FIPS-compliant mode only if it detects that a workload’s operating system is running in FIPS-compliant mode.

NOTE:FIPS-compliant mode has a performance impact and might slow down the data transfer rate up to 30%.

To enable FIPS-compliant algorithms:

  1. Enable FIPS-compliant algorithms in the security options of your PlateSpin Migrate host’s local security policies:

    1. Run secpol.msc and browse to Local Policies > Security Options.

    2. Enable the System cryptography: Use FIPS compliant algorithms for encryption security option.

  2. Configure ASP.NET for FIPS support:

    1. Access the machine.config file located in the following directory of your PlateSpin Server host:

      ..Windows\Microsoft.Net\Framework\vX.X.XXXXX\Config

    2. Add the following under the <system.web> element:

      <machineKey validationKey="AutoGenerate,IsolateApps" decryptionKey="AutoGenerate,IsolateApps" validation="3DES" decryption="3DES"/>

  3. Access the web.config file in each of the below listed directories of your PlateSpin Server host and add the following under the <system.web> element of each of the web.config file:

    <machineKey validationKey="AutoGenerate,IsolateApps" decryptionKey="AutoGenerate,IsolateApps" validation="3DES" decryption="3DES"/>

    • PlateSpin Migrate Install Directory\PlateSpin Forge\web\

    • PlateSpin Migrate Install Directory\Web\

    • PlateSpin Migrate Install Directory\ConfigurationEditor.Web\

    • PlateSpin Migrate Install Directory\Protection.WebServices\

    • PlateSpin Migrate Install Directory\OfxWeb\