Introduction

This guide provides troubleshooting tips for installing and configuring MigrationStudio. It contains general information about how to approach troubleshooting, important documentation to review. Also provided are fixes to difficulties that you may encounter during installation.


TABLE OF CONTENTS



Issue 1: Code 2103


When opening MigrationStudio, you get an Unhandled error in Silverlight Application code: 2103


Solution: Ensure the following features installed on the IIS server:

  • Windows Feature Web Server
  • Windows Common HTTP feature
  • Windows Static Content

Issue 2: Server Error in '/' Application

When launching MigrationStudio, you received a "Server Error in '/' Application.



Solution: Check the IIS server and ensure you have converted MigrationStudio to an Application

Issue 3: SQL Network Error

You have successfully installed the Inventory Reports Connector following this documentation, however when you attempt to test the SQL connection, you get a "A network-related or instance-specific error occurred while establishing a connection to SQL Server. The server was not found or was not accessible. Verify that the instance name is correct and that SQL Server is configured to allow remote connections. (provider: SQL Network Interfaces, error: 26 - Error locating Server/Instance specified)"


Solution: Ensure the connection string in the web.config is set correctly.


Issue 4: Server Error in '/MigrationStudio

While attempting to launch MigrationStudio, you get the following "Server Error in '/MigrationStudio' Application. Could not retrieve license.


Solution: This is likely to be an issue with the connection string in the we.config file.



Issue 5: HTTP 500 - Anon Auth

Whilst attempting to browse to the MigrationStudio homepage, you receive a "HTTP 500 - Internal Server Error" or the page opens but the content is a blank screen. 


Solution: This may be an issue with anonymous authentication. Here's how to fix this:

  • Launch the Internet Information Services (IIS) Manager
  • Expand the folders and select the MigrationStudio site (1)
  • Double click Authentication (2)



  • Select Anonymous Authentication and ensure this is Enabled (1)
  • Click Edit (2)
  • If you are using a service account to run the MigrationStudio website, then change the setting to Application pool identity


Issue 6: Arg_NullReferenceException

Whilst attempting to access the MigrationStudio website, you get the following error [Arg_NullReferenceException] Arguments: Debugging resource strings are unavailable.


Solution: You may need to add the following Windows feature:

  • .NET Framcework 4.x\WCF services\HTTP Activation

Issue 7: InvalidUriScheme

Error 'InvalidUriScheme. Arguments:https,http


Solution: It could be possible, you may have used the wrong MigrationStudio installation zip file. If you are using SSL, ensure you downloaded the SSL specific installation zip file for the main IIS website.


Issue 8: Secure cookies

When you attempt to launch the MigrationStudio website, you get the following error in IE "Server Error in '/Latest' Application.

The application is configured to issue secure cookies. These cookies require the browser to issue the request over SSL (https protocol). However, the current request is not over SSL.



Solution: Browse to the Web.config file and make the following amendments:

  • From:

 <authentication mode="Forms">

      <forms name=".AppTracker_INSTANCE_ASPXAUTH" timeout="10080" slidingExpiration="true" loginUrl="~/Portal/Default.aspx" />


    </authentication>


    <membership defaultProvider="AspNetSqlMembershipProvider">




  • To:

<authentication mode="Forms">

<forms name=".AppTracker_INSTANCE_ASPXAUTH" timeout="10080" slidingExpiration="true" requireSSL="false" loginUrl="~/Portal/Default.aspx" />

</authentication>

<httpCookies requireSSL="false" httpOnlyCookies="false" />

   <membership defaultProvider="AspNetSqlMembershipProvider">


Issue 9: HTTP Error 404.7 - Not Found

You receive a HTTP Error 404.7 - Not Found

The request filtering module is configured to deny the file extension.



Solution: The most likely cause is the request filtering is configured for the Web server and the file extension for this request is explicitly denied. Here's how to fix this:

  • Launch the Internet Information Services (IIS) Manager
  • Expand the folders and select the MigrationStudio site (1)
  • Double click Request Filtering (2)



  • Select Edit Feature Settings (1)
  • Ensure all 3 checkboxes are ticked (2)
  • Click OK (3)



Issue 10: System.Security.SecurityException

Whilst attempting to launch MigrationStudio website you get the following error in IE.

Server Error in '/Latest' Application.

Security Exception

Description: The application attempted to perform an operation not allowed by the security policy. To grant this application the required permission please contact your system administrator or change the application's trust level in the configuration file

Exception Details: System.Security.SecurityException:Request for the permission of type 'System.Security.Permissions.FileIOPermission, mscorlib, version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a6c561934e089' failed.



Solution: Here's how to fix this:

  • Launch the Internet Information Services (IIS) Manager
  • Expand the folders and select the MigrationStudio site (1)
  • Double click .NET Trust Levels (2)


  • Select Full (Internal) from the Trust level dropdown menu (1)
  • Click Apply (2) to commit the changes

Issue 11: Login is from an untrusted domain


Whilst attempting to launch MigrationStudio website you get the following error in IE.

Server Error in '/MigrationStudio' Application.

Login failed. The login is from an untrusted domain and cannot be used with integrated authentication.

Description: An unhandled exception occurred during the execution of the currentwebrequest. Please review the stack trace for more information about the error and where it originated in the code.



Solution: The most likely cause is the Service account used to run MigrationStudio. Check that the service account's isn't disabled/locked out or has had its password expired in AD.

Further Support

If you require further assistance with your installation, please get in touch with the service desk via support@migrationstudio.com