Manual Upgrade of .NET Core Runtime

You can manually upgrade the .NET Core runtime for the Commvault software.

Symptoms

The .NET Core runtime minor version that was deployed by Commvault is vulnerable to security issues.

Causes

The .NET Core runtime minor version deployed by Commvault is not the most recent.

Resolution

The Commvault software is deployed with a long-term support release of .NET Core. If you need a newer minor version of .NET Core than the one provided by the Commvault installer, you can manually upgrade it using the procedure described below.

Note:

• Manually upgrading the .NET Core runtime is supported only for SP36 and more recent feature releases.
• Commvault performs comprehensive testing of our software using the .NET Core version that is deployed with the software. The .NET Core is a third-party product, and while security patch updates are not supposed to affect compatibility, we cannot guarantee that all Commvault components will continue to work properly if you manually upgrade the .NET Core. Therefore, you must thoroughly test the Commvault software before deploying .NET Core changes in a production environment.
• You must only upgrade to a more recent security or patch version of the currently installed .NET Core. Do not upgrade to a major version, because that is very likely to cause breakages. For example, if .NET Core 8.0.5 is installed, you can upgrade to 8.0.6, but not 9.0.1.

Procedure

Steps to upgrade .NET Core on Windows Computer

1. Install the .NET Windows hosting bundle.
   1. Download the .NET hosting bundle from .NET Downloads (Linux, macOS, and Windows).
   2. On your local computer where you plan to upgrade the .NET Core version, stop all the Commvault services.
   3. Install the .NET hosting bundle on your local computer.
   4. Open the command prompt and run the following command: dotnet --info This must return the version of the .NET hosting bundle that is currently installed.  
   5. Restart all the Commvault services.
2. Download .NET Core runtime binaries
   1. Download the .NET Core runtime from .NET Downloads (Linux, macOS, and Windows).
   2. On your local computer where you plan to upgrade the .NET Core version, stop all the Commvault services.
   3. Back up and remove all the current data available on the Commvault DotNetCore folder located at **commvault_contentstore_installation_folder**DotNetCore.
   4. Extract the data from the .zip file to a temporary location and copy the new .NET Core data to the Commvault DotNetCore folder.
   5. Open the command prompt, navigate to commvault_contentstore_installation_folder\DotNetCore location, and run the following command: dotnet --info This must return the version of the .NET Core that is currently installed.
   6. Restart all the Commvault services.

If any issues are encountered, restore the original version of .NET Core that you backed up, or use the Commvault installation media to perform a repair operation.

Steps to upgrade .NET Core on UNIX Computer

1. Download the .NET Core runtime from .NET Downloads (Linux, macOS, and Windows).
2. On your local computer where you plan to upgrade the .NET Core version, stop all the Commvault services.
3. Back up and remove all the current data available on the  DotNetCore folder located at commvault_contentstore_installation_folder/DotNetCore.
4. Extract the data from the tar.gz file to a temporary location, and copy the new .NET Core data to the Commvault DotNetCore folder.
5. Open the terminal, navigate to commvault_contentstore_installation_folder/DotNetCore location, and run the following command: ./dotnet --info This must return the version of the .NET Core that is currently installed.
6. Restart all the Commvault services.

If any issues are encountered, restore the original version of .NET Core that you backed up, or use the Commvault installation media to perform a repair operation.