diff --git a/aspnetcore/publishing/iis.md b/aspnetcore/publishing/iis.md index 9439cc234f..d87a9b1527 100644 --- a/aspnetcore/publishing/iis.md +++ b/aspnetcore/publishing/iis.md @@ -5,7 +5,7 @@ description: Windows Server Internet Information Services (IIS) configuration a keywords: ASP.NET Core, internet information services, iis, windows server, hosting bundle, asp.net core module, web deploy ms.author: riande manager: wpickett -ms.date: 01/18/2017 +ms.date: 03/01/2017 ms.topic: article ms.assetid: a4449ad3-5bad-410c-afa7-dc32d832b552 ms.technology: aspnet @@ -50,7 +50,7 @@ Proceed through the **Confirmation** step to install the web server role and ser ## Install the .NET Core Windows Server Hosting bundle -1. Install the [.NET Core Windows Server Hosting](https://go.microsoft.com/fwlink/?linkid=837808) bundle on the server. The bundle will install the .NET Core Runtime, .NET Core Library, and the [ASP.NET Core Module](../fundamentals/servers/aspnet-core-module.md). The module creates the reverse-proxy between IIS and the Kestrel server. Note: If the server doesn't have an Internet connection, obtain and install the *[Microsoft Visual C++ 2015 Redistributable](https://www.microsoft.com/en-us/download/details.aspx?id=53840)* before installing the .NET Core Windows Server Hosting bundle. +1. Install the [.NET Core Windows Server Hosting](https://go.microsoft.com/fwlink/?linkid=837808) bundle on the server. The bundle will install the .NET Core Runtime, .NET Core Library, and the [ASP.NET Core Module](xref:fundamentals/servers/aspnet-core-module). The module creates the reverse-proxy between IIS and the Kestrel server. Note: If the server doesn't have an Internet connection, obtain and install the *[Microsoft Visual C++ 2015 Redistributable](https://www.microsoft.com/en-us/download/details.aspx?id=53840)* before installing the .NET Core Windows Server Hosting bundle. 2. Restart the server or execute **net stop was /y** followed by **net start w3svc** from a command prompt to pick up a change to the system PATH. @@ -60,7 +60,7 @@ Proceed through the **Confirmation** step to install the web server role and ser > [!NOTE] > If you use an IIS Shared Configuration, see [ASP.NET Core Module with IIS Shared Configuration](xref:hosting/aspnet-core-module#aspnet-core-module-with-an-iis-shared-configuration). -For more information, see [ASP.NET Core Module overview](../fundamentals/servers/aspnet-core-module.md) and [ASP.NET Core Module Configuration Reference](../hosting/aspnet-core-module.md). +For more information, see [ASP.NET Core Module overview](xref:fundamentals/servers/aspnet-core-module) and [ASP.NET Core Module Configuration Reference](xref:hosting/aspnet-core-module). ## Install Web Deploy when publishing with Visual Studio @@ -266,6 +266,8 @@ Troubleshooting: Troubleshooting: +* Confirm that the application runs locally on Kestrel. A process failure might be the result of a problem within the application. For more information, see [Troubleshooting tips](#troubleshooting-tips). + * Confirm that you didn't set a `` in your *.csproj* that conflicts with the RID. For example, don't specify a `` of `x86` and publish with an RID of `win10-x64`, either by using *dotnet publish -c Release -r win10-x64* or by setting the `` in your *.csproj* to `win10-x64`. The project will publish without warning or error but fail with the above logged exceptions on the server. ### URI endpoint wrong or stopped website @@ -328,6 +330,8 @@ Troubleshooting: Troubleshooting: +* Confirm that the application runs locally on Kestrel. A process failure might be the result of a problem within the application. For more information, see [Troubleshooting tips](#troubleshooting-tips). + * Check the *processPath* attribute on the `` element in *web.config* to confirm that it is *dotnet* for a framework-dependent deployment or *.\my_application.exe* for a self-contained deployment. * For a framework-dependent deployment, *dotnet.exe* might not be accessible via the PATH settings. Confirm that *C:\Program Files\dotnet\* exists in the System PATH settings. @@ -352,6 +356,8 @@ Troubleshooting: Troubleshooting: +* Confirm that the application runs locally on Kestrel. A process failure might be the result of a problem within the application. For more information, see [Troubleshooting tips](#troubleshooting-tips). + * Examine the *arguments* attribute on the ** element in *web.config* to confirm that it is either (a) *.\my_applciation.dll* for a framework-dependent deployment; or (b) not present, an empty string (*arguments=""*), or a list of your application's arguments (*arguments="arg1, arg2, ..."*) for a self-contained deployment. ### Missing .NET Framework version @@ -388,6 +394,8 @@ Troubleshooting Troubleshooting +* Confirm that the application runs locally on Kestrel. A process failure might be the result of a problem within the application. For more information, see [Troubleshooting tips](#troubleshooting-tips). + * Confirm that you have correctly referenced the IIS Integration middleware by calling the *.UseIISIntegration()* method on the application's *WebHostBuilder()*. ### Sub-application includes a `` section @@ -412,7 +420,7 @@ Troubleshooting Troubleshooting -* This general exception indicates that the process failed to start, most likely due to an application configuration issue. Referring to [Directory Structure](../hosting/directory-structure.md), confirm that your application's deployed files and folders are appropriate and that your application's configuration files are present and contain the correct settings for your app and environment. +* This general exception indicates that the process failed to start, most likely due to an application configuration issue. Referring to [Directory Structure](../hosting/directory-structure.md), confirm that your application's deployed files and folders are appropriate and that your application's configuration files are present and contain the correct settings for your app and environment. For more information, see [Troubleshooting tips](#troubleshooting-tips). ## Resources