Help and Miscellaneous

Upgrade Troubleshooting

Incorrect Installation Order

Follow the steps in order as outlined in the Before Upgrading section. Use the following checks to help determine installation issue resolutions.

To check that you have the latest .NET versions installed, run the following command in the PowerShell:

Copy 
dotnet --info

NOTE: The hosting bundle should be Microsoft.AspNetCore.App 8.0.x and the desktop runtime should be Microsoft.WindowsDesktop.App 8.0.x

To check that IIS is properly installed, run the following command in the PowerShell:

Copy 
get-webglobalmodule

NOTE: The output must contain AspNetCoreModuleV2.

Resolution: Uninstall the hosting bundle and ensure that IIS is properly installed.

Execution Policy when running PowerShell Script

Resolution: Run the following commands in the PowerShell:

  • PS C:\WINDOWS\system32> Set-ExecutionPolicy Unrestricted

  • PS C:\WINDOWS\system32> Set-ExecutionPolicy

Internet Explorer End-of-Use

When using ClickOnce, it must be invoked using Microsoft Edge. For more information, see ClickOnce in the Installation and Configuration Guide.

More details for IE end-of-use details are as follows:

As of July 2022, if you have an Internet Explorer ClickOnce shortcut to the OneStream Desktop Client application, it will not launch the application of any version when IE is disabled inside your organization. Starting with 7.0, newly created shortcuts will be created using Windows PresentationHost.exe. Upgrading to 7.0 will not automatically update existing shortcuts. You must manually create new ones or edit existing ones. To update an existing shortcut of any OneStream platform version, follow these steps:

  1. Right-click on the existing desktop shortcut and go to Properties.

  2. Copy and paste the text in the Target field into the notepad.

  3. Replace this section “C:\Program Files\Internet Explorer\iexplore.exe” with C:\Windows\System32\PresentationHost.exe-launchApplication (note that the “ “ are removed).

  4. Copy and paste the whole text into the target field inside the shortcut's properties, click Apply, then click OK.

You will not be able to view embedded external web pages inside OneStream when IE is disabled inside your organization. Starting with 7.0, the external web pages will be embedded using the Microsoft Edge WebView2 runtime control. Microsoft automatically installs the WebView2 runtime on Windows 10 machines. You can verify if the component is installed on your machine through Add or Remove Programs. It can also be downloaded directly from Microsoft.

Once IE is disabled within your organization, embedded web pages will no longer render inside OneStream on versions 6.8 and older, even if you have WebView2 installed. If your application uses features that embed external web pages, usually through properties that allow pointing to a URL, an upgrade to 7.0+ will be required with the WebView2 runtime control. Key OneStream features that enable embedding external web pages:

  • Dashboard component Web Content

  • Dashboard component File Viewer

  • Dashboard component Button

  • A drill back Business Rule in Transformation Rules Connector