Notes about my own experience migrating from RC1 to RC2

[Bartmax]

@davidfowl asked me for notes so here they are. You may want to scroll down to the pain points section below :)

Migration RC1 to RC2

Easy/expected changes:

Tools

install RC2 tooling.
The lastest tools can be found here: https://github.com/dotnet/cli
We first started with https://dotnet.github.io/getting-started/ but it's outdated.

global.json

Update version of global.json to match RC2

"version": "1.0.0-rc1-update1" // BEFORE
"version": "1.0.0-rc2-20221" // AFTER

Nuget.config

add ci builds to nuget config

<add key="AspNetCiDev" value="https://www.myget.org/F/aspnetcidev/api/v3/index.json" />

project.json

Dependencies

Update all dependencies from Microsoft.AspNet.xxx to Microsoft.AspNetCore.xxx except Microsoft.AspNet.WebApi.Client

Update all dependencies from x.EntityFramework.x to x.EntityFrameworkCore.x
Downgrade version to 1.0 on all dependencies renamed.

Some package rename were by hand because it wasn't a straight convention,
Microsoft.AspNetCore.Diagnostics.Entity
Microsoft.EntityFrameworkCore.SqlServer

Some low-impact packages were removed:
Microsoft.VisualStudio.Web.BrowserLink.Loader

External dependency Moq changed package name

"Moq": "", // BEFORE
"moq.netcore": "4.4.0-beta8", // AFTER

Frameworks

Update TFM. This change was a complete copy paste of some sample code. We had no idea what this change means.
before:

  "frameworks": {
    "dnx451": { },
    "dnxcore50": { }
  },

after:

  "frameworks": {
    "netcoreapp1.0": {
      "imports": [ "dnxcore50", "portable-net45+win8" ]
    }
  },

Code Changes

NOTE: BEFORE code may contain AspNetCore
because of the initial rename of all using directive.

Usings

Rename all using directives in *.cs, *.cshtml
Find all and replace: using Microsoft.AspNet. -> using Microsoft.AspNetCore.
About 122 occurrence(s).

Controllers

HttpNotFound // BEFORE 60 ocurrences
NotFound // AFTER 

HttpBadRequest() // BEFORE 5 ocurrences
BadRequest() // AFTER 

Entity Framework

GraphBehavior.X does not exist anymore on EF context methods.

using Microsoft.AspNetCore.Identity.EntityFramework; // BEFORE 2 ocurrences
using Microsoft.AspNetCore.Identity.EntityFrameworkCore; // AFTER

using Microsoft.Data.Entity; // BEFORE 40 ocurrences
using Microsoft.EntityFrameworkCore; // AFTER

using Microsoft.Data.Entity.Metadata; // BEFORE 35 ocurrences
using Microsoft.EntityFrameworkCore.Metadata; // AFTER

using Microsoft.Data.Entity.Migrations; // BEFORE 47 ocurrences
using Microsoft.EntityFrameworkCore.Migrations; // AFTER

using Microsoft.Data.Entity.Infrastructure; // BEFORE 24 ocurrences
using Microsoft.EntityFrameworkCore.Infrastructure; // AFTER

_context.Phones.Add(phone, GraphBehavior.IncludeDependents); // SAMPLE
_context.Phones.Add(phone); // SAMPLE AFTER

Extensions

using Microsoft.AspNetCore.FileProviders; // AFTER 3 ocurrences
using Microsoft.Extensions.FileProviders; // BEFORE

using Microsoft.Extensions.OptionsModel; // BEORE 1 ocurrences
using Microsoft.Extensions.Options; // AFTER

Identity

User.GetUserId() and User.IsSignedIn() doesn't exist. it was removed and added to UserManager and SignInManager.

ExternalLoginInfo.ExternalPrincipal was renamed to ExternalLoginInfo.Principal

User.GetUserId() // BEFORE 6 ocurrences
_userManager.GetUserId(User) // AFTER

User.IsSignedIn() // BEFORE 2 ocurrences
_signInManager.IsSignedIn(User) // AFTER

info.ExternalPrincipal // BEFORE
info.Principal // AFTER

Startup

services.AddEntityFramework()
                .AddSqlServer() // BEFORE

services.AddEntityFrameworkSqlServer()
                .AddEntityFrameworkSqlServer() // AFTER

services.AddCaching(); // NOT FOUND ??? REMOVED 
app.UseDatabaseErrorPage(); // NOT FOUND ??? REMOVED

app.UseRequestLocalization(
    new RequestCulture(
        new CultureInfo("en-us"))); // BEFORE
app.UseRequestLocalization(
    new RequestLocalizationOptions() { 
        DefaultRequestCulture = new RequestCulture(
            new CultureInfo("en-us")) }); // AFTER

app.UseIISPlatformHandler(options => options.AuthenticationDescriptions.Clear()); // NEED MORE INVESTIGATION. OPTIONS REMOVED.

This change is a complete copy/paste from sample. No idea what's going on here.

// Entry point for the application. BEFORE
        public static void Main(string[] args) => WebApplication.Run<Startup>(args);

// Entry point for the application. AFTER
        public static void Main(string[] args)
        {
            var host = new WebHostBuilder()
                        .UseKestrel()
                        .UseContentRoot(Directory.GetCurrentDirectory())
                        .UseDefaultHostingConfiguration(args)
                        .UseIIS()
                        .UseStartup<Startup>()
                        .Build();

            host.Run();
        }

---

## Pain points: ### DotNet Restore

This was executed multiple times, at different point of migration.
Mostly all the output was kinda useless. Too much information, to many unknowns.
We tried to switch to -v warning with no luck.
It took some time to get to -v Minimal to get a usefull output from dotnet restore.

App Settings

We found a runtime Error with regarding appsettings. The error was clear, the options available not.
The fix was to change Verbose to Information

"Logging": {
    "IncludeScopes": false,
    "LogLevel": {
      "Default": "Information", // BEFORE: "Verbose"
      "System": "Information",
      "Microsoft": "Information"
    }
  }

We used POCO Configuration with code like:

services.Configure<StorageSettings>(Configuration.GetSection("StorageSettings"));

we dig into lots of documents, code, issues.
We hope this would be on Announcements repo but we couldn't find it.
we ended up with a hack

services.Configure<StorageSettings>(x => x.ConnectionString = Configuration["StorageSettings:ConnectionString"]);

Code

Some inner workings of razor,views,engines,etc changes weren't mentioned anywhere.
We have a simple taghelper that render partial views, this was impossible to figure out how to update it.
NTaylorMullen helped there.

Compile success!

Great, right... right?

Environment

Visual Studio environment variable wasn't respected. We first thought that ConfigureDevelopment were removed.
The problem here was that dotnet run shows the enviroment but an error was throw before.
Also this environment variable was changed twice for RC2. The announcement issue shows the old one with a note at the bottom that was changed again.
We wasted lot of time dealing with environment. mostly because of not understading the problem straight.

cshtml

@Inject namespaces had to be renamed,
taghelpers, etc.
because this was after hitting a specific page it was more painful than the cs code.
we also lost intellisense so... we had to rely on error messages.

tooling

We literally copy pasted every tooling sample until we got this:

  "tools": {
    "dotnet-publish-iis": "1.0.0-*",
    "dotnet-ef": "1.0.0-*",
    "dotnet-watch": "1.0.0-*",
    "dotnet-razor-tooling": "1.0.0-*"
  },

We still have no idea how those exactly works.
The only one that was really needed was EF because migrations (see next point).
We tried for several hours to get dotnet-watch to run without success.

EF Changes

I hit this issue: Invalid object name 'TableName'
before an announcement were created here:
EF Core: Table names now taken from DbSet names (starting in RC2).

While it was a simple ask repo and got a solution very quickly, it was like a neverending error trip.
At this point we were tired.

... And runs! ..., almost

we hit the web application but we seen no static files served!
DAMN!
We looked everywhere until we figure out that no gulp build was executed! even we had that on prepublish.
and well.. then

it worked.

[Bartmax]

just remember one undocumented note:
i deleted .dnx folder at some point and app stopped working.
it was fixed with dnvm install/upgrade

not sure exactly what was the problem... and don't remember clearly.

[Bartmax]

one more undocumented note:

IFormFile.SaveAsync was removed because it was impossible to test. aspnet/HttpAbstractions#610

We added what we found on old source code:

public static class FormFileExtensions
    {
        private static int DefaultBufferSize = 80 * 1024;
        /// <summary>
        /// Asynchronously saves the contents of an uploaded file.
        /// </summary>
        /// <param name="formFile">The <see cref="IFormFile"/>.</param>
        /// <param name="filename">The name of the file to create.</param>
        public async static Task SaveAsAsync(
            this IFormFile formFile,
            string filename,
            CancellationToken cancellationToken = default(CancellationToken))
        {
            if (formFile == null)
            {
                throw new ArgumentNullException(nameof(formFile));
            }

            using (var fileStream = new FileStream(filename, FileMode.Create))
            {
                var inputStream = formFile.OpenReadStream();
                await inputStream.CopyToAsync(fileStream, DefaultBufferSize, cancellationToken);
            }
        }
    }

[josh-sachs]

Nice feedback. What was your experience with EntityFramework tooling after upgrading? Are you able to do migrations/scaffolding and everything as expected? I hit a roadblock with "ef dbcontext scaffold" and had to revert back to the DEC 2015 builds of RC2 but maybe I'm an anomaly.

[Bartmax]

@kudoz83 I had no issues, i just did 1 migration dotnet ef migrations add ... and went back to rc1 because of not being able to save and refresh.

[cvs79]

Any problems using VS2015. Any tooling or debugging issues you ran into. Or does the Asp.net RC1 tooling installer still work.

[Bartmax]

@cvs79 no tooling for you sir. They are working on the tooling side, but those weren't released yet. Most notably Intellisense on razor pages is broken :(

[fescoffier]

Thanks for the complete nice feedback. I was planning to migrate my own project from RC1 to RC2, this will help me for sure!

[Lutando]

This is good.
Also the ASPNET_ENV/Hosting:Environment moniker has changed to ASPNETCORE_ENVIRONMENT

[RobDeVoer]

I am enjoying the positive vibe here. Have no active projects and some time on my hands so let me know if anyone needs me to try anything out and offer feedback.

[tuespetre]

Added "Microsoft.Extensions.Options.ConfigurationExtensions": "1.0.0-rc2-*" to our project.json to get the 'POCO configuration binding' extension methods back.

[Bartmax]

@tuespetre thank you! I'll give it a try!

[nil4]

@tuespetre I am using the Microsoft.Extensions.Configuration.Binder package to get the binder extension methods. I could not find Microsoft.Extensions.Options.ConfigurationExtensions on the aspnetcirelease feed; are you sure that's the right package name?

[tuespetre]

I don't know about aspnetcirelease, but it is there on aspnetvnext and aspnetcidev.

[Cowlephant]

What's going to be easier for me in the long run... updating now in this sort of tumultuous state from RC1, or waiting a while?

[Bartmax]

@twilliamsgsnetx if you use Visual Studio, wait a few more days...

if you use VS Code i guess it's ok to update now.

just my personal opinion. It's always up to you to balance the pro/cons.

[Cowlephant]

Yeah I have a site currently in production that is using many aspecst... mvc, identity, entity. And I am using Visual Studio as well. I'll give it a shot.

[Cowlephant]

Well I worked out all the hundreds of errors. @Bartmax guide really helped in some areas. Others required some researching. This really helped me for tons of the errors regarding System.RunTime

aspnet/dnx#2334

Doesn't actually seem to want to run however... so still some more research to be done. Just spins and spins. I'm actually currently on 1.0.0-rc3-20550

When trying to dotnet run

Unhandled Exception: System.Reflection.ReflectionTypeLoadException: Unable to load one or more of the requested etrieve the LoaderExceptions property for more information. at System.Reflection.RuntimeModule.GetTypes(RuntimeModule module) at System.Reflection.RuntimeAssembly.get_DefinedTypes() at Microsoft.AspNetCore.Hosting.Internal.ServerLoader.ResolveServerFactoryType(String assemblyName) at Microsoft.AspNetCore.Hosting.WebHostBuilder.BuildHostingServices() at Microsoft.AspNetCore.Hosting.WebHostBuilder.Build() at DataPlatform.Startup.Main(String[] args) in C:\Github\Data-Platform\src\DataPlatform\Startup.cs:line 124

[dodyg]

Wait there's already an RC3 build? I still cannot manage to migrate to RC2 from RC1

I got

 error CS7069: Reference to type 'IFormFile' claims it is defined in 'Microsoft.AspNetCore.Http.Abstractions', but it could not be found

[guardrex]

@dodyg No, there is no RC3 build; however, there are RC3 packages. The word on the street is that there will not be an RC3 release at all; this is merely being done to hold packages under development but that need to be kept off of RC2 stabilization for RC2 release. They get pulled into your app depending on which feeds you're using. If you stick with the CI Release feed right now, you will only get RC2 packages even when you make your deps -* (as opposed to having to -rc2-* them). If you want to use other feeds with RC3 packages on them but limit dependencies to RC2, then go with -rc2-* versions.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear />
    <add key="AspNetCI" value="https://www.myget.org/F/aspnetcirelease/api/v3/index.json" />
    <add key="NuGet.org" value="https://api.nuget.org/v3/index.json" />
</configuration>

[dodyg]

Thanks for the tips. Let me try this migration thing one more time.

[vsg24]

Well...I think I'm not gonna update to RC2 anytime soon!

[MaximRouiller]

Well... to be fair... RC2 is still "in-development" and is still not stable with the new dotnet-cli.

Even the team itself had trouble creating a "working experience" a few weeks ago with all the pieces.

If you want to be in the meat grinder and see how the sausage is made? Try RC2! You'll find full of issues and help the team improve ASP.NET by finding bugs and everything. That's what "devbuild" and "nightlies" are for.

Just want to build software on something stable? Back to RC1. 😃

[dodyg]

What would this be in the RC 2

 "frameworks": {
        "dnx451": {
            "frameworkAssemblies": {
                "System.ComponentModel": "4.0.0.0"
            }
        }
    },

I want to target .NET 4.5/4.6. I am using packages that only work on Windows.

[dodyg]

Now I hit this bug NuGet/Home#2644

[dodyg]

OK I fixed NuGet/Home#2644 by adding imports statement.

  "tools": {
    "dotnet-publish-iis": { 
        "version": "1.0.0-*",
        "imports":["portable-net40+sl5+win8+wp8+wpa81"]
    },
    "dotnet-ef": { 
        "version": "1.0.0-*",
        "imports":["portable-net40+sl5+win8+wp8+wpa81"]
    },
    "dotnet-watch": { 
        "version": "1.0.0-*",
        "imports":["portable-net40+sl5+win8+wp8+wpa81"]
    },
    "dotnet-razor-tooling": { 
        "version": "1.0.0-*",
        "imports":["portable-net40+sl5+win8+wp8+wpa81"]
    }
  },

[dodyg]

I got it to compile yay! until I hit this dotnet/efcore#5076 and this aspnet/Announcements#167

[dodyg]

Now I got this problem regarding TagHelpers

     Connection id "0HKRFAFEBCLGM": An unhandled exception was thrown by the application.
Microsoft.AspNetCore.Mvc.Razor.Compilation.CompilationFailedException: One or more compilation failures occurred:
Error @ (164:5,17)(31) - [Cannot resolve TagHelper containing assembly 'Microsoft.AspNet.Mvc.TagHelpers'. Error: Could not load file or assembly 'Microsoft.AspNet.Mvc.TagHelpers' or one of its dependencies. The system cannot find the file specified.] (5,17) Cannot resolve TagHelper containing assembly 'Microsoft.AspNet.Mvc.TagHelpers'. Error: Could not load file or assembly 'Microsoft.AspNet.Mvc.TagHelpers' or one of its dependencies. The system cannot find the file specified.

I fixed it by changing

@addTagHelper "*, Microsoft.AspNet.Mvc.TagHelpers"

to

@addTagHelper "*, Microsoft.AspNetCore.Mvc.TagHelpers"

from _ViewImports.cshtml

I GOT IT WORKING!!! At least a home page. 🎆 🎆 🎆 😂

[smbecker]

I was making good progress on my own upgrade until I hit dotnet/cli@2429: Object reference not set to an instance of an object. No luck getting around it yet.

[dodyg]

This is my project.json http://pastebin.com/KTrXnFSX

[johnmckinzie]

@e9-dbeech Do I need to add an additional using to use Bind()? I'm getting the following error:

'IConfigurationSection' does not contain a definition for 'Bind' and no extension method 'Bind' accepting a first argument of type 'IConfigurationSection' could be found (are you missing a using directive or an assembly reference?)

[nil4]

@johnmckinzie you need to reference the Microsoft.Extensions.Configuration.Binder package

[e9-dbeech]

I believe it's part of nuget package Microsoft.Extensions.Configuration.Binder

using Microsoft.Extensions.Configuration;

[johnmckinzie]

Thanks for the quick response @nil4 and @e9-dbeech. Much appreciated!

[Cowlephant]

Now that this has officially released, I'm trying it again. I've viewed Shawn Wildermuth's blog as well on how to migrate from RC1 to RC2. Much of the same as last time, and I'm still stuck in the same situation as last time.

I have no more errors, everything looks good... and I launch the site but it just continues to wait for localhost and never finishes. No clues or errors on where I might determine the issue. Any thoughts?

[guardrex]

@twilliamsgsnetx Did you run down the Troubleshooting at https://docs.asp.net/en/latest/publishing/iis.html?

[ghost]

services.AddCaching(); // NOT FOUND ??? REMOVED 

AddCaching() was renamed to AddMemoryCache();

In project.json

    "Microsoft.Extensions.Caching.Memory": "1.0.0-rc2-final",

[Cowlephant]

@guardrex I certainly did with my production site for RC1. I can't even get it running in my development environment with IIS Express though. I didn't read anything about there being any changes that need to be made to an IIS Express environment in Visual Studio?

[guardrex]

@twilliamsgsnetx You might need to put up a repo and/or chat with devs on Slack to walk through config to get it running. IISExpress should be fine now with the VS that was just dropped with RC2 release. http://tattoocoder.com/aspnet-slack-sign-up/

[Cowlephant]

@guardrex Actually I figured it out. I'm not sure what I did, since I made quite a few changes, but it's working now.

Now to deal with the issue of my Angular 2 stuff not showing due to these changes. Something is borked with URL rewriting.

[guardrex]

Cross-linking Converting a .csproj to .xproj RC2

[MrAntix]

Update all dependencies from Microsoft.AspNet.xxx to Microsoft.AspNetCore.xxx except Microsoft.AspNet.WebApi.Client

do you know where the extensions in Microsoft.AspNet.WebApi.Client are now?
PostAsJsonAsync for example?

[describeme]

Hell guys, I keep getting this error for Object, Func<>...

using this in project.json:

"frameworks": {

    "netcoreapp1.0": {
        "dependencies": {
            "Microsoft.NETCore.App": {
                "version": "1.0.0-*",
                "type": "platform"
            }
        },
        "imports": [
            "portable-net40+sl5+win8+wp8+wpa81",
            "portable-net451+win8",
            "netstandardapp1.3",
            "net451"
        ]
    },
    "net451": {
        "frameworkAssemblies": {
            "System.Runtime": "4.0.10.0"
        }
    }

}

Any ideas or suggestions? Thank you in advance!

[StephenLujan]

This was a great resource. Thanks. I haven't implemented everything in this document yet, but I've made good headway on a migration tool. https://github.com/StephenLujan/dot-net-core-dnx-rc2-converter

[dazinator]

Hi Guys - Here' my upgrade tool, it not only deals with project.json, xproj and global.json but it also migrates old RC1 NuGet packages to the appropriate RC2 ones, and does some basic code refactoring for you using Roslyn (at the moment it does some simple using statement correction). Please try it out on an RC1 solution if you get a chance. After it's done it also clears the project.lock.json files ready for a dotnet resotre. I'll keep adding stuff to it until I run out of time / ideas.

[gjsduarte]

Hey guys,
Anyone has an idea how check is if a view is partial during rendering, since the IsPartial property was removed from IRazorPage?

[dougbu]

Anyone has an idea how check is if a view is partial during rendering, since the IsPartial property was removed from IRazorPage?

We removed this little-used property early in the RC2 milestone. The name was incorrect and it only controls whether or not _ViewStart.cshtml files are used, nothing after views are found. The isMainPage concept remains and is exposed e.g. ViewLocationExpanderContext.IsMainPage.

If you have a scenario where something like IsMainPage is needed during view execution, please open a separate issue.

[ghost]

@dodyg Got same problem as you with RTM version. Can you share the project.json that you used to get a Windows-specific .NET 4.5 (not core) project to build and deploy ?

[dodyg]

@bluemmc thanks for note. I just remember to upgrade now lol. Here's my project.json.

{
    "version": "1.0.0-*",
    "compilationOptions": {
        "emitEntryPoint": true,
        "preserveCompilationContext": true
    },
    "runtimeOptions": {
        "configProperties": {
            "System.GC.Server": true,
            "System.GC.Concurrent": true
        }
    },
    "dependencies": {
        "Crucible.Models": "1.0.0-*",
        "Crucible.Core": "1.0.0-*",
        "CommonMark.NET": "0.11.0",
        "SK.Framework": "1.0.0-*",
        "Microsoft.AspNetCore.Http": "1.0.0-*",
        "Microsoft.AspNetCore.Http.Abstractions": "1.0.0-*",
        "Microsoft.AspNetCore.Authentication": "1.0.0-*",
        "Microsoft.AspNetCore.Authentication.Cookies": "1.0.0-*",
        "Microsoft.AspNetCore.Hosting": "1.0.0-*",
        "Microsoft.AspNetCore.Hosting.Abstractions": "1.0.0-*",
        "Microsoft.EntityFrameworkCore.SqlServer": "1.0.0-*",
        "Microsoft.AspNetCore.Mvc": "1.0.0-*",
        "Microsoft.AspNetCore.Diagnostics": "1.0.0-*",
        "Microsoft.AspNetCore.Diagnostics.EntityFrameworkCore": "1.0.0-*",
        "Microsoft.AspNetCore.StaticFiles": "1.0.0-*",
        "Microsoft.AspNetCore.Server.Kestrel": "1.0.0-*",
        "Microsoft.AspNetCore.Session": "1.0.0-*",
        "Microsoft.Extensions.Configuration.Json": "1.0.0-*",
        "Microsoft.Extensions.Configuration.FileExtensions": "1.0.0-*",
        "Microsoft.Extensions.Caching.Memory": "1.0.0-*",
        "Microsoft.Extensions.Caching.Abstractions": "1.0.0-*",
        "Microsoft.Extensions.Options.ConfigurationExtensions": "1.0.0-*",
        "Microsoft.Extensions.Logging.Console": "1.0.0-*",
        "Microsoft.Extensions.Logging": "1.0.0-*",
        "Microsoft.AspNetCore.Server.IISIntegration": "1.0.0-*",
        "Microsoft.EntityFrameworkCore.Tools": {
            "version": "1.0.0-*",
            "type": "build"
        }
    },
    "tools": {
        "Microsoft.DotNet.Watcher.Tools": {
            "version": "1.0.0-*",
            "imports": "portable-net451+win8"
        },
        "Microsoft.EntityFrameworkCore.Tools": {
            "version": "1.0.0-*",
            "imports": "portable-net451+win8"
        },

        "Microsoft.AspNetCore.Server.IISIntegration.Tools": {
            "version": "1.0.0-*",
            "imports": "portable-net45+wp80+win8+wpa81+dnxcore50"
        }
    },

    "frameworks": {
        "net452": {
            "frameworkAssemblies": {
                "System.ComponentModel": "4.0.0.0"
            }
        }
    },
    "scripts": {
        "postpublish": "dotnet publish-iis --publish-folder %publish:OutputPath% --framework %publish:FullTargetFramework%"
    },
    "publishOptions": {
        "exclude": [
            "wwwroot",
            "node_modules"
        ]
    },
    "buildOptions": {
        "copyToOutput": [
        "wwwroot",
        "views",
        "areas/admin/views",
        "config.json",
        "emailtemplates"]        
    }
}

[aspnet-hello]

This issue is being closed because it has not been updated in 3 months.

We apologize if this causes any inconvenience. We ask that if you are still encountering this issue, please log a new issue with updated information and we will investigate.