How to update the ASP.Net version for UiPath Orchestrator?
Synopsis:
ASP.NET Core IIS Module, also known as AspNetCoreModule (ANCM), is a native IIS module that manages and forwards HTTP requests to ASP.NET Core applications.
Essentially, it acts as a reverse-proxy, handling requests between IIS and your ASP.NET Core application. It ensures the application is always running and serving requests without needing its own process manager. This module is vital for the successful hosting of ASP.NET Core applications like the UiPath Orchestrator in an IIS environment.
Update Steps:
To update the ASP.Net version for the UiPath Orchestrator, follow the steps below:
- Begin by halting the Orchestrator. This action can be performed either directly through the Internet Information Services (IIS) Manager or by executing the command 'IISRESET /STOP' in CMD.
- With the Orchestrator paused, you may now proceed to uninstall the existing version of ASP.NET from your system. You can do so by launching the Control Panel and opening up the list of Programs to uninstall. See below for reference.
Note that when you install the ASP.Net Core via the .Net Hosting Bundle, it installs several other components such as the .NET runtime, the .NET Core libraries, and the .NET SDK for development. However, only the Core module is required for the Orchestrator application. Hence, you may consider uninstalling the required components.
- Following this, initiate the installation of .NET 8 on your server. You can find the link in our Prerequisites doc here as a part of the Hosting Bundle. Be mindful of using the link that is suited for the version of your Orchestrator.
- Post successful installation, it's crucial to restart your machine. The server restart is an indispensable step as it instigates the onset of changes.
- Upon the server’s revival, ensure checking the Orchestrator's event logs to corroborate its correct functionality. If everything is working correctly, you would see successful "Info" level application logs from the sources like 'Orchestrator', 'IdentityService', '.NET Runtime', 'ASP.NET xxxx', 'IIS AspNetCoreModule V2', etc. within the Event Viewer.
- It is paramount to guarantee that the ASP.NET Core Hosting Bundle is installed, as it forms an integral component of the Orchestrator's functional capacity.
What Next?
If any errors relating to .NET appear in the logs, contact UiPath Support and provide the logs along with their timestamps for further investigation.(How to get Application Logs from the Event Viewer.)