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

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.

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

4.1.3 Removing PlateSpin Software

The procedure below outlines the required steps for uninstalling the software components of PlateSpin Migrate and performing an optional manual cleanup. This might be necessary when upgrading or recovering from problems with a previous installation.

For information on a post-migration cleanup of source workloads, see Post-Migration Tasks in the PlateSpin Migrate 2018.11 User Guide.

NOTE:This procedure does not remove license information from the server.

  1. Use the Windows Control Panel to uninstall the PlateSpin Migrate Client.

  2. Use the Windows Control Panel to uninstall the PlateSpin Server.

  3. (Optional) If you opted to install the local database server from within the PlateSpin Migrate installation program and if you no longer need it, use the Windows Control Panel to uninstall Microsoft SQL Server Express Edition.

  4. Ensure that the program directories of PlateSpin Migrate components were removed:

    1. Make sure the PlateSpin Server home directory was removed:

      ..\PlateSpin Migrate Server

    2. Make sure the PlateSpin Migrate Client home directory was removed:

      ..\PlateSpin Migrate Client

    3. (Optional) If you installed a local Microsoft SQL Server Express Edition database server and if you chose to uninstall it, remove the directory:

      ..\Program Files\Microsoft SQL Server

      WARNING:Do not delete the SQL directory if you have another SQL server installed on the PlateSpin Migrate server host.

  5. Open IIS Manager and ensure that the ofxweb and PlateSpinMigrate virtual directories are deleted.

  6. Reboot the host.