4.1 Installation Issues

Review the following sections for troubleshooting the PlateSpin Migrate installation issues:

4.1.1 Common Installation Issues and Solutions

Problems or Messages

Solutions

An unexpected error occurs when trying to install the PlateSpin Server to a non-default location.

When you install the PlateSpin Server in a non-default directory, you must also grant the ASP.NET user account full access to that directory. For example, if you want to install the server in D:\PM_9, you must make sure that the ASP.NET user account has full access to D:\PM_9.

HTTP 403 Error occurs.

PlateSpin Migrate uses ASP.NET for its Web services. If ASP.NET is not installed on the server, the Web services do not function correctly, and the installation fails with this error.

ASP.NET is included as part of the .NET Framework. When you install the .NET Framework, IIS must already be installed on the server for ASP.NET to be configured. If the .NET Framework was installed prior to IIS, simply uninstall and reinstall the .NET Framework.

Cannot connect to IIS with http or https.

During installation, an error message appears indicating that PlateSpin Migrate cannot connect to IIS with HTTP or HTTPS, when Setup attempted to connect with the existing IIS Server. The cause of this error generally indicates a problem with the IIS Server.

  • Ensure that IIS and ASP.NET are installed properly. See KB Article 7920595.

  • To ensure that ASP.NET is properly registered with IIS, run the following command:

    "C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis.exe" -i

If the above steps do not resolve the issue, refer to the detailed instructions for reinstalling IIS and configuring IIS for isolation mode in KB Article 7920710.

Installing PlateSpin Migrate on a computer that has other applications running on IIS.

This can cause problems during and after installation. If possible, avoid installing the product on a computer that has other applications running on IIS. Use a dedicated host for PlateSpin Migrate.

An anti-virus application is installed and running on the intended PlateSpin Migrate server host.

The anti-virus application might improperly quarantine the PlateSpin Server Installation/Upgrade file, which causes the installation or upgrade to fail.

Do either of the following during the PlateSpin Migrate installation or upgrade:

  • Disable the anti-virus software.

  • Add the folder where you extract the PlateSpin Install/Upgrade file to the anti-virus application exclude list. The %TEMP% folder is the default location for extraction.

See also PlateSpin Migrate and Anti-Virus Applications in the PlateSpin Migrate 2020.2 User Guide.

Microsoft SQL Server 2012 Native Client Is required

During the Migrate server installation, the Validate Credentials action fails on the Database Administrative Credentials dialog with the following error if Microsoft SQL Server 2012 Native Client is not installed:

The Microsoft SQL Server 2012 Native Client is required. Install this package and rerun the PlateSpin Migrate Install.

The PlateSpin Migrate Installer requires Microsoft SQL Server 2012 Native Client for communications with remote SQL Server databases. See Prerequisite Software in the Installation and Upgrade Guide.

4.1.2 Knowledgebase Articles about Installation Troubleshooting

ID

Description

7920710

ERRMSG: Install Error: Cannot connect to IIS with http or https...

7920718

INFO: IIS and NTFS Permissions requirements for PlateSpin Migrate

7920595

INFO: Installing IIS and ASP.NET v2.0