1.2 Installing Prerequisite Software

Before you install PlateSpin Migrate, ensure that you have installed the Prerequisite Software: Visual C++, ASP.NET, IIS, and .NET Framework. You can use the Install PlateSpin Migrate Prerequisites script provided on the NetIQ Download site to install any missing software and apply the appropriate configuration. You can alternatively install the prerequisite software manually using the procedures in this section.

To use the script to install prerequisite software:

  1. On the intended PlateSpin Migrate server, install a supported version of Microsoft Windows Server and activate the Windows license.

  2. Go to the NetIQ Downloads page, then search for and go to the PlateSpin Migrate Download page.

  3. Download the Install_PlateSpin_Migrate_Prerequisites.zip file.

  4. Extract the files to the intended PlateSpin Migrate host server:

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

    The BAT file executes the script without requiring that the user change the PowerShell execution policy to RemoteSigned.

  5. Run the PowerShell script.

    The script automatically installs and configures the prerequisite software.

  6. 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. On the intended PlateSpin Migrate server, install a supported version of Microsoft Windows Server and activate the Windows license.

  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. (Optional) Enable FIPS-compliant data encryption.

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

  5. 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. This software is required to properly install the Event Messaging service that is used by PlateSpin Transformation Manager. A redistributable package of Visual C++ 2013 is available in the PlateSpinMigrateSetup-12.2.1.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-12.2.1.X.exe to a location on the planned server host for PlateSpin Migrate.

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

  3. Run vcredist_x64.exe as Administrator.

1.2.2 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.

      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 3.5 Features (all installed)

        • .NET Framework 3.5 (includes .NET 2.0 and 3.0)

        • HTTP Activation

        • Non-HTTP Activation

      • .NET Framework 4.5 Features (all installed)

        • .NET Framework 4.5

        • ASP.NET 4.5

        • WCF Services (5 of 5 installed)

          • HTTP Activation

          • Message Queuing (MSMQ) Activation

          • Named Pipe Activation

          • TCP Activation

          • TCP Port Sharing

      • Windows Process Activation Service (all installed)

        • Process Model

        • .NET Environment

        • Configuration APIs

      • 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 (25 of 43 installed):

      • Web Server (19 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 (7 of 11 installed)

          • .NET Extensibility 3.5

          • .NET Extensibility 4.5

          • Application Initialization

          • ASP.NET 3.5

          • 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.

1.2.3 Installing Prerequisite Software on Windows Server 2008 R2 Systems

Use the following procedure to install prerequisite software on the Microsoft Windows Server 2008 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. Open Server Manager. Select Start > All Programs > Administrative Tools > Server Manager.

  3. Use Server Manager to install Web Server (IIS) with components required by PlateSpin Server:

    1. In Server Manager, select Roles in the left pane, then click Add Roles in the Roles pane.

    2. In the Add Roles wizard, proceed to the Server Roles tab, then continue through the wizard:

      Add Roles Wizard

      Action

      1. Server Roles

      Select Web Server (IIS), then click Next.

      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:

      • Web Server

        • Common HTTP Features (all installed)

          • Static Content

          • Default Document

          • Directory Browsing

          • HTTP Errors

          • HTTP Redirection

          • WebDAV Publishing

        • Application Development (4 of 7 installed)

          • ASP .NET

          • .NET Extensibility

          • ISAPI Extensions

          • ISAPI Filters

        • Health and Diagnostics (2 of 6 installed)

          • HTTP Logging

          • Request Monitor

        • Security (all installed)

          • Basic Authentication

          • Windows Authentication

          • Digest Authentication

          • Client Certificate Mapping

          • IIS Client Certificate Mapping

          • URL Authorization

          • Requesting Filtering

          • IP and Domain Restrictions

        • Performance (1 of 2 installed)

          • Static Content Compression

      • Management Tools (all installed)

        • IIS Management Console

        • IIS Management Script and Tools

        • Management Service

        • IIS 6 Management Compatibility (all installed)

          • IIS 6 Metabase Compatibility

          • IIS 6 WMI Compatibility

          • IIS 6 Scripting Tools

          • IIS 6 Management Console

      1. Confirmation

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

    3. Wait for the installation to complete, then close the Add Roles wizard.

  4. Use Server Manager to install additional software required by PlateSpin Server:

    1. In Server Manager, select Features in the left pane, then click Add Features in the Features pane.

    2. In the Add Features wizard, proceed to the Features tab, then continue through the wizard:

      Add Features Wizard

      Action

      1. Features

      Select the following required features and their sub-features as shown, then click Next.

      • .NET Framework (all installed)

        • .NET Framework 3.5.1

        • WCF Activation

          • HTTP Activation

          • Non-HTTP Activation

      • Windows Process Activation Service (all installed)

        • Process Model

        • .NET Environment

        • Configuration APIs

      • XPS Viewer

      1. Confirmation

      Review the features to be installed, then click Install.

    3. Wait for the installation to complete, then close the Add Features wizard.

  5. Exit Server Manager.

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

1.2.4 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\