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 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.2 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.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\