If your solution is under source control using a system which requires explicit file check out, you must check out the data source project file and each presentation project file before starting the upgrade process. The data source project file has an extension of McpT27Proj, McpCobolProj, OpenDtpProj, TipProj, UTSProj or ABSEAEProj. A presentation project file has an extension of csproj.

Sometimes a solution that requires an upgrade might load without launching the upgrade wizard; however, the data source project is not loaded. In this case, Solution Explorer displays the note "(Needs Migration)" next to the data source project. In this case, right-click the data source project and select Reload Project to launch the upgrade wizard.

The build process has been optimized to improve build performance. Refer to Building Your ePortal Solution for more information. As part of this optimization, generated C# files in the Generated Component Code folder (for a data source project) and in the App_Code folder (for a WCF Web Service presentation project) are no longer members of the Visual Studio project. The upgrade wizard excludes these files from the project. If your solution is in source control, you may be prompted whether or not to delete these files from source control. You should delete these files from source control, as the files are not user-editable and are regenerated as needed by the build process.

The Visual Studio upgrade process ensures that the data source project is targeting at least .NET 4.0. If the data source targets less than .NET version 4.0, then the version is set to 4.0; otherwise it is left unchanged. The .NET version for presentation projects is also not changed. If you wish to upgrade your projects to a newer version of .NET, refer to Multi-Targeting Issues for more information.

If you are upgrading from the earlier versions of ePortal Developer to a supported version, ensure to update NuGet packages before attempting to build. Refer to Updating NuGet Packages for more information.

After the upgrade completes, and you update the NuGet packages (if applicable), you must perform a full rebuild of your solution by selecting Rebuild Solution from the Build menu for the first build on a particular development system. Refer to Rebuilding the Solution for more information. Performing a Build Solution is not sufficient.