Occasionally AppSight users may encounter the message “The .NET framework version <version number> is not supported” in the Messages pane of AppSight System console. This will usually happen when a build of the .Net framework that was not available at the time when the installed AppSight version was released is present on the machine where blackbox is running.
Microsoft issues new minor versions of the .Net framework in several methods: as hotfixes that need to be explicitly downloaded by the user if they wish to do so; as part of the Windows Automatic Updates; as part of an operating system service pack (e.g. the recent release of Windows 2003 SP2); or due to the installation of a new version of a major Microsoft product (e.g. Office, Visual Studio). In many cases the user is unaware of the fact that the version of the .NET framework has changed, and will notice it only at the next time he runs AppSight. The change is usually only to the last (fourth) number of the version, e.g. 1.1.4322.2379.
- The following message appears in the Messages tab of the AppSight System console:
The .NET framework version <version number> is not supported
- .NET operations are not recorded by the blackbox
Solution 1 - Automatic NEF Update
This version of BMC AppSight includes a new feature that automates the process of supporting new .NET versions. Previously, when a new .NET version was deployed at the Black Box machine the user was required to contact BMC AppSight and get support binary files with a .nef extension needed to extend the recording capabilities of the new version. The files had to be deployed manually to the target machine.
This version of BMC AppSight allows the embedding of the .nef files into the recording profile. When the recording profile is deployed to the Black Box, the updated .nef files will be extracted from it and used automatically. This flow allows for automated mass updates for connected Black Boxes, and also Black Boxes in standalone mode using the COM API.
The new feature is available though the UI of the recording profile dialog, as well as the command line tool RPRUpdateTool.exe (C:\Program Files (x86)\BMC Software\BMC AppSight\AppSight for Windows\Bin).
Solution 2 - Manual NEF Update
If you encountered the above symptoms check whether the version indicated in the error message appears in the list “Supported .NET Framework Versions” below.
If it does:
- Download the file DnInfo.nef from the link in the bottom of this page.
- Shut down all AppSight components. (The "DnInfo.nef" must be replaced for the AppSight BlackBox, Server, and Console.)
- Backup the existing "DnInfo.nef" (C:\Program Files\BMC Software\BMC AppSight\AppSight for Windows\Bin) to another folder.
- Save the latest "DnInfo.nef" to the AppSight "bin" (C:\Program Files\BMC Software\BMC AppSight\AppSight for Windows\Bin) directory.
- Re-record the problem.
* The location of the AppSight "bin" directory my vary by component or version.
In case it is unclear, the updated "DnInfo.nef" will not correct existing Recording Sessions. The "DnInfo.nef" must be replaced for the AppSight BlackBox, Server, and Console. Specifically, the BlackBox from which the recording originated must contain the updated "DnInfo.nef" in the "bin" directory and the related processes will need to be re-recorded.
If the latest DnInfo.nef does not include support for the target .NET Framework, please Submit a New Issue by email (http://www.bmc.com/support/issue-management/42313367.html) or through the website (http://www.bmc.com/support/issue-management). Include the following file(s) from the relevant .NET Framework CLR folder(s):
v1.#.####.#### : mscorwks.dll, mscorsvr.dll
v2.#.####.#### : mscorwks.dll
v3.#.####.#### : coreclr.dll
v4.#.####.#### : clr.dll, coreclr.dll
* Note there are separate folders for each Framework; .NET Framework version 1.x, 2.x, and 4.x can co-exist, make sure you collect the correct files.
Supported .NET Framework Versions
This technote will be updated routinely with the most current versions of the supported .NET Frameworks.
|.NET FW 1.0||.NET FW 1.1||.NET FW 2.0|
|.NET FW 3.0||.NET FW 4.0|
Current DnInfo.nef File Version