Knowledge Base Article

All about .NET ..... with your v8+ Upgrade

Let's talk .NET in non-technical terms and describe it's impact on OneStream Platform v8+ uprades.

.NET is the development platform used by OneStream to build the Platform.  Prior to Platform v8.0, OneStream used versions of .NET referred to as .NET Framework versions.  The v7.x Platform release used .NET 4.8.  

The development of Platform v8.0 used .NET6, referred to as a .NET Core version.  The .NET Core versions leverage modern development paradigms and are much faster!  OneStream customers upgrading to Platform v8+ are observing performance improvements in memory intensive operations such as Consolidation processing, and several data loading / copying processes.  

The modern paradigms of .NET Core had an impact on OneStream Business Rule compilation - older syntax and library references that were not .NET Core compatible failed compilation.  This required some minor updates to MP Solutions and customer created Business Rules.  No sweat - a one time adjustment with your pre-v8 to v8+ Platform upgrade.

OneStream plans to follow Microsoft's Long Term Support (LTS) release cadence for .NET Core versions - every two years.  Platform v8.0 and Platform v8.1 used .NET6.  The next two years of releases beginning with Platform v8.2, we will use .NET8.   See the chart below:

OneStream customers must ensure all desktop/laptops providing Windows Client access to OneStream have the corresponding version of .NET Desktop Runtime installed.  With v8.0 and v8.1, we recommended version 6.0.14 or higher (within the 6,x line).  With v8.2 (target late March 2024), we recommend version 8.0.2 or higher (within the 8.x line). 

Note: The OneStream Windows Client WILL NOT connect to a v8.0 or v8.1 Server without the existence of a version 6.x of the .NET Desktop Runtime.  In other words, a .NET8 Desktop Runtime install isn't 'backwards' compatible.  However, .NET8 and .NET6 Desktop runtimes may co-exist together and live in harmony 🙂

See the Microsoft .NET page for support dates and downloads.

Notice that Microsoft has indicated an End-of-Service date for .NET6 at November 2024.  After this date, Microsoft will not issue patches for issues related to .NET6.  OneStream recommends maintaining compliance with Microsoft's .NET support dates - therefore customers running Platform v8.0 or v8.1 should plan an upgrade to Platform v8.2 or higher by the end of 2024.  OneStream is targeting Platform releases in March, July, and November of 2024.  Platform upgrades from v8+ to higher versions follow tranditional (simple!) upgrade processes.   See the chart below to see the .NET6 End of Service impact:

 

We hope this information provides you insightful background on all things .NET!  If you have further questions or require clarification, feel free to add your comment in a reply below or you can always signup to attend OneStream's v8+ Upgrade Office Hours, staffed by several Subject Matter Experts!  

 

 

Updated 10 months ago
Version 2.0
Business Rule
MP Solution
  • MadihaBouankoud's avatar
    MadihaBouankoud
    New Contributor
    10 months ago

    Hello,

    Can Onestream V8 run on machines that use .Net V4?

    Thank you in advance for your answer

    Best regards

    Madiha

  • tschilling's avatar
    tschilling
    New Contributor III
    10 months ago

    Hello - Is there a timetable or Support Matrix on when versions 7.x will not be supported as well?

  • djcorbett's avatar
    djcorbett
    Contributor
    10 months ago

    MADIHA_DKT - OneStream v8.0 and v8.1 require a .NET 6 version of the Desktop Runtime to operate the Windows Client - we recommend 6.0.14 or higher, the current version is 6.0.27.  OneStream v8.2 (target late March 2024) requires.NET 8 version of the Desktop Runtime to operate the Windows Client - we recommend 8.0.2 or higher, the current version is 8.0.2.

    The existence of earlier versions (such as .NET 4) of the .NET Desktop Runtime do not conflict with the .NET 6 or .NET 8 versions of the .NET Desktop Runtime.  They may co-exist simultaneously on a desktop/laptop - My machine has all flavors.  The Windows Client accesses the version it needs to make server connection.

  • djcorbett's avatar
    djcorbett
    Contributor
    10 months ago

    TSCHILLING - All SaaS customers are subject to OneStream's Product Support and Maintenance policy for their Platform and MP Solutions.    The policy states that a Platform releases carry 18 months of Engineering support (eligible for Hot fix patching of critical issues) and an additional 12 months of General support.  Release dates for Platform versions can be found on the Platform page of the Solution Exchange.

    For example, v7.4.x was released March-2023, and 30 total months of support results in an End of Support date of September-2025*. [ * Keep in mind VPN End of Service date for August 31, 2024 ].

    Of course, seeing that this is the v8+ Upgrade Group of ONECommunity .... we strongly recommend a Platform v8+ upgrade to realize technology modernization and platform performance improvements as soon as you can manage!   OneStream resources are here to help!       - I hope that clarifies your question.

  • allanaklepko's avatar
    allanaklepko
    New Contributor III
    9 months ago

    When would clients running OS version 7.4.2 be required to update to version 8.2?  thank you.

  • TomABC's avatar
    TomABC
    Contributor II
    7 months ago

    Thanks Dave good info and indication of our ongoing connection between OneStream and .NET