initial commit for beta6 known issues

known-issues.md

@@ -1,5 +1,65 @@
 # Known issues for ASP.NET 5 support in Visual Studio 2015
 
+## ASP.NET 5 Beta6
+
+#### First F5 with IIS Express may not work
+
+Sometimes, after you create an ASP.NET Web Application project for the first time, when you hit F5 for the first time, iisexpress.exe will exit with error code 666.
+
+![iisexpress-error](./images/beta6-iisx-error.png)
+
+**Workaround**
+
+If you run into this error you should be able to hit F5 again to get the project to launch correctly.
+
+#### Access Denied when installing DNX runtime using DNVM
+
+In some cases, when creating an ASP.NET 5 project, DNVM fails to install the DNX runtime, and you will see the following error in the DNVM log:
+
+```
+Installing to C:\Users\balach\.dnx\runtimes\dnx-clr-win-x86.1.0.0-beta6
+Move-Item : Access to the path 'C:\Users\balach\.dnx\runtimes\temp\dnx-clr-win-x86.1.0.0-beta6' is denied.
+At C:\Program Files\Microsoft DNX\Dnvm\dnvm.ps1:1156 char:17
++                 Move-Item $UnpackFolder $RuntimeFolder
++                 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+    + CategoryInfo          : WriteError: (C:\Users\balach...x86.1.0.0-beta6:DirectoryInfo) [Move-Item], IOException
+    + FullyQualifiedErrorId : MoveDirectoryItemIOError,Microsoft.PowerShell.Commands.MoveItemCommand
+
+Cannot find dnx-clr-win-x86.1.0.0-beta6, do you need to run 'dnvm install 1.0.0-beta6'?
+At C:\Program Files\Microsoft DNX\Dnvm\dnvm.ps1:1268 char:9
++         throw "Cannot find $runtimeFullName, do you need to run '$Com ...
++         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+    + CategoryInfo          : OperationStopped: (Cannot find dnx...l 1.0.0-beta6'?:String) [], RuntimeException
+    + FullyQualifiedErrorId : Cannot find dnx-clr-win-x86.1.0.0-beta6, do you need to run 'dnvm install 1.0.0-beta6'?
+
+Installing to C:\Users\balach\.dnx\runtimes\dnx-coreclr-win-x86.1.0.0-beta6
+Adding C:\Users\balach\.dnx\runtimes\dnx-coreclr-win-x86.1.0.0-beta6\bin to process PATH
+Compiling native images for dnx-coreclr-win-x86.1.0.0-beta6 to improve startup performance...
+```
+
+**Workaround**
+
+Restart Visual Studio and try creating the project again. DNVM should succeed this time.
+
+#### For a project targeting only CoreCLR (dnxcore50), you could run into a failure during Publish
+
+If you update your ASP.NET 5 web project to target only CoreCLR (only dnxcore50 in project.json), you might run into the following failure when you try to Publish with the default Publish settings.
+
+```
+The "Dnu" task failed unexpectedly.
+The project being published does not support the runtime 'dnx-clr-win-x86.1.0.0-beta6'
+```
+
+**Workaround**
+
+In the Settings tab of the Publish dialog, explicitly select dnx-coreclr as the target rather than using the 'Default'. See the image below.
+
+![visual-studio-publish-dialog-dnx-selector](./images/beta6-pub-dnx.png)
+
+## ASP.NET Beta5 / Visual Studio 2015 RTM
+
+## Visual Studio 2015 RC
+
 #### applicationHost.config file appears as an untracked file in Solution
 
 The applicationHost.config file will sometimes appear as an untracked file in Solution Explorer. This file should not be checked in as it has user specific paths which will not work in team environments.