1.2 Installing Prerequisite Software

This section provides information on installing the required ASP.NET, IIS, and .NET Framework software components. Because the packaging and distribution of these software components varies among different versions of the supported Windows Server platforms, procedures vary slightly. Use the indicated order of installation and setup.

1.2.1 Installing Prerequisite Software on Windows Server 2012 Systems

The following procedure applies to Microsoft Windows Server 2012 (64-bit) servers where you plan to install PlateSpin Migrate.

To install required Microsoft software components:

  1. Ensure that you are familiar with the System Requirements (PlateSpin Server) and General Guidelines for Server Installation.

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

  3. Use Server Manager to install the Web Server (IIS) role and its role services. Keep the default set of role services for the Web Server, and add the following required role services along with their sub-role services as shown. (Select Start > All Programs > Administrative Tools > Server Manager, select Manage > Add Roles and Features, then proceed through the wizard to Select Server Roles and Select Role Services for the Web Server.)

    • Web Server (IIS) (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)

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

            • IIS 6 Metabase Compatibility

            • IIS 6 Management Console

            • IIS 6 Scripting Tools

            • IIS 6 WMI Compatibility

          • IIS Management Scripts and Tools

  4. Use Server Manager to install the following required features and sub-features as shown. (In Server Manager, select Manage > Add Roles and Features, then proceed through the wizard to Select Features.)

    • .NET Framework 3.5 Features (all)

    • NET Framework 4.5 Features (all)

    • Windows Process Activation Service (all)

    • XPS Viewer

1.2.2 Installing Prerequisite Software on Windows Server 2008 R2 Systems

The following procedure applies to Microsoft Windows Server 2008 R2 servers where you plan to install PlateSpin Migrate.

To install required Microsoft software components:

  1. Ensure that you are familiar with the System Requirements (PlateSpin Server) and General Guidelines for Server Installation.

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

  3. Use Server Manager to add the Web Server (IIS) role and its role services. Keep the default set of role services for the Web Server, and add the following required role services along with their sub-role services as shown. (Select Start > All Programs > Administrative Tools > Server Manager, click Add Roles, then proceed through the wizard to Select Server Roles and Select Role Services for the Web Server.)

    • Web Server (IIS)

      • 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

            • IIS 6 Metabase Compatibility

            • IIS 6 WMI Compatibility

            • IIS 6 Scripting Tools

            • IIS 6 Management Console

  4. Use Server Manager to install the following required features and sub-features as shown. (In Server Manager, click Add Features.)

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

  5. (Conditional) On Windows Server 2008 R2, download and install the Microsoft .NET Framework 4.5 package.

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