ASP.Net Core 1.0 RC2 : What are LAUNCHER_PATH and LAUNCHER_ARGS mentioned in web.config?

by

From github IISSample (thank you @Pawel and Luke), here are the value possibilities:

<!-- This set of attributes are used for launching the sample using IISExpress via Visual Studio tooling -->
<aspNetCore processPath="%LAUNCHER_PATH%" arguments="%LAUNCHER_ARGS%" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" forwardWindowsAuthToken="false"/>

<!-- This set of attributes are used for launching the sample for full CLR (net451) without Visual Studio tooling -->
<aspNetCore processPath=".\IISSample.exe" arguments="" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" forwardWindowsAuthToken="false"/>

<!-- This set of attributes are used for launching the sample for Core CLR (netcoreapp1.0) without Visual Studio tooling -->
<aspNetCore processPath="dotnet" arguments=".\IISSample.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" forwardWindowsAuthToken="false"/>

After several hours dealing with them, I found there are two web.configs that we need to deal with: src\ProjectName\wwwroot\web.config and src\ProjectName\web.config . If you dont have the latter, VS2015 publish will generate one for you with %LAUNCHER_PATH% and %LAUNCHER_ARGS% by default.

To have the project run and debuggable locally under VS2015 via IISExpress, both web.config need to have the default value below. Replacing LAUNCHER_PATH and LAUNCHER_ARGS to something else causes VS2015 to hang indefinitely.

<aspNetCore processPath="%LAUNCHER_PATH%" arguments="%LAUNCHER_ARGS%" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" forwardWindowsAuthToken="false"/>

However, upon deploying to IIS (I am using 8.5 on WinServer 2012 R2), the value on src\ProjectName\web.config must be replaced with the following. If configured, the dotnet publish-iis command suppose to do the replacement for you (see below).

<aspNetCore processPath="dotnet" arguments=".\ProjectName.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" forwardWindowsAuthToken="false"/>

If you are migrating from RC1, change the http bound directory as well to Project root folder, not wwwroot. Example: from C:\inetpub\ProjectName\wwwroot to C:\inetpub\ProjectName.

To configure publish-iis to do automatic replacement, add this snippet to your project.json: (Thank you @Pawel) 

  "tools": {
    "Microsoft.AspNetCore.Server.IISIntegration.Tools": {
      "version": "1.0.0-preview1-final"
    }
  },
  "scripts": {
    "postpublish": "dotnet publish-iis --publish-folder %publish:OutputPath% --framework %publish:FullTargetFramework%"
  }

The IISIntegration tool segment converts these Launcher variables to the appropriate deployment values. Without it, you will get the following error:

No executable found matching command "dotnet-publish-iis"

I am using RC2 Toolkit Preview 1.

More Related Contents:

  1. Why would one use a third-party DI Container over the built-in ASP.NET Core DI Container?
  2. What is the equivalent of Server.MapPath in ASP.NET Core?
  3. ASP.NET Core with IIS – HTTP Verb Not Allowed
  4. Return PDF to the Browser using ASP.NET Core
  5. How to run ‘dotnet dev-certs https –trust’?
  6. What is Kestrel (vs IIS / Express)
  7. OAuth Authorization Service in ASP.NET Core
  8. The specified CGI application encountered an error and the server terminated the process
  9. ASP.NET Core change EF connection string when user logs in
  10. What’s the difference between ASP.NET 5, .NET Core, and ASP.NET Core 5? [closed]
  11. ASP.NET Core Dependency Injection with Multiple Constructors
  12. ASP.NET 5 project hosting on IIS
  13. What is the difference between ‘dependencies’ and ‘frameworkAssemblies’ in project.json?
  14. Project template for Visual Studio 2015
  15. Duplicate ‘Content’ items were included. The .NET SDK includes ‘Content’ items from your project directory by default
  16. ASP.NET core JWT authentication always throwing 401 unauthorized
  17. ASP.NET Core RC2 SignalR Hub Context outside request thread
  18. System.Diagnostics.Process.Start not work from an IIS
  19. Disable Session state per-request in ASP.Net MVC
  20. Dropdownlist control with s for asp.net (webforms)?
  21. Asp.net Identity password hashing
  22. How to delete a row from GridView?
  23. How to add Header and Subheader in Gridview
  24. ASP.NET restarts when a folder is created, renamed or deleted
  25. Cross-page posting. Is it a good pratice to use PreviousPage in Asp.net?
  26. Replicate VS2008 “Publish Web Site” from command line
  27. ASP.NET MVC and Windows Authentication with custom roles
  28. How to extend the ValidationSummary HTML Helper in ASP.NET MVC?
  29. Windows 7 Could not create SSL/TLS secure channel.”} System.Net.WebException
  30. call aspx page to return an image randomly slow

Leave a Comment