If you want to upgrade your classic e-Business site with the Aptify 6.2 updates (Telerik Upgrade and .Net 4.8 Framework upgrade), the main items to address are the site's bin directory contents and new entries in the web.config.
...
- Telerik.Windows.Controls.dll
- Telerik.Windows.Data.dll
- Telerik.Windows.Documents.dll
- Telerik.Windows.Documents.FormatProviders.Html.dll
- Telerik.Windows.Documents.FormatProviders.OpenXml.dll
- Telerik.Windows.Documents.FormatProviders.Rtf.dll
- Telerik.Windows.RadUploadHandler.dll
Assemblies That Need to be Added
The following assemblies are additional assemblies that are needed for classic e-Business Telerik Upgrade and need to be downloaded from telerik Telerik Site and added in the bin directory.
- Kendo.Mvc.dll
- Kendo.Mvc
- Telerik.Documents.Core.dll
- Telerik.Documents.Fixed.dll
- Telerik.Documents.SpreadsheetStreaming.dll
- Telerik.Documents.SpreadsheetStreaming
- Telerik.Web.Design.dll
- Telerik.Web.Device.Detection.dll
- Telerik.Web.Device.Detection
- Telerik.Web.PDF.dll
- Telerik.Web.Spreadsheet.dll
- Telerik.Web.Spreadsheet
- Telerik.Web.UI.dll
- Telerik.Web.UI.Skins.dll
- Telerik.Web.UI
- Telerik.Windows.Documents.Core.dll
- Telerik.Windows.Documents.Core
- Telerik.Windows.Documents.Fixed.dll
- Telerik.Windows.Documents.Fixed
- Telerik.Windows.Documents.Flow.dll
- Telerik.Windows.Documents.Flow.FormatProviders.Pdf.dll
- Telerik.Windows.Documents.Flow.FormatProviders.Pdf
- Telerik.Windows.Documents.Flow
- Telerik.Windows.Documents.Spreadsheet.dll
- Telerik.Windows.Documents.Spreadsheet.FormatProviders.OpenXml.dll
- Telerik.Windows.Documents.Spreadsheet.FormatProviders.OpenXml
- Telerik.Windows.Documents.Spreadsheet.FormatProviders.Pdf.dll
- Telerik.Windows.Documents.Spreadsheet.FormatProviders.Pdf
- Telerik.Windows.Documents.Spreadsheet
- Telerik.Windows.Zip.dll
- Telerik.Windows.Zip.Extensions.dll
- Telerik.Windows.Zip.Extensions
- Telerik.Windows.Zip
- Telerik.Zip.dll
Updating web.config
New required entries in the application config file must be manually added to web.config for existing sites. There are two common types of entries to account for with every version upgrade: new appSettings entries and new binding redirects. These entries are documented in the general release notes for the core upgrade, as they typically apply to all products that are being upgraded. If you are upgrading your site from more than one version of Aptify, you will need to consult the documentation for those releases to understand all entries that potentially need to be added.
- Whether you have done an OR sync on your e-Business bin or not, you should change the .NET framework to 4.8. Search for "targetFramework" in the web.config and update it to target .NET 4.8, like this: <compilation debug="true" targetFramework="4.8">
...
Update the web config to update the binding redirect to the 2020 version:
Code Block title Web Config collapse true <runtime>
...
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
...
<dependentAssembly>
...
<assemblyIdentity name="Telerik.Web.UI" publicKeyToken="121FAE78165BA3D4" culture="neutral" />
...
<bindingRedirect oldVersion="2015.2.623.40" newVersion="2020.2.617.45" />
...
</dependentAssembly>
...
</assemblyBinding>
...
</runtime>
3. Add the following key
- Add this key: <add key="ValidationSettings:UnobtrusiveValidationMode" value="None" />
...
- Save and close your web.config.
Test
Now that your web.config and bin directory are updated you must test the site.
...
Another common error is around required binding redirects, so make sure to Read our release notes on the topic here.
Pop-Ups not displaying correctly.:
Another common error observed is popup dialogs getting distorted and UI disturbed due to the same. Perform the following changes for the same.
- Locate your eBusiness css style sheet (eBusinessStyles.css ) in the e-Business installed path. The name of the css style sheet might be different in your installed path
Open the file and add below CSS changes at the end of file:
Code Block language css title CSS changes collapse true .rwWindowContent > div { width: inherit !important; height: inherit !important; } .RadWindow .rwIcon{ margin-top: 8px !important; top: 0 !important; } .RadWindow .rwTable { height: 100% !important; } .popup-win-adminedit-Contactinfo{ height:auto !important; }- Locate the data_from.css file in the e-Business installed path. (Folder path for Non CMS <eBusiness installed path\App_Themes\Aptify\)
Open the file and update Line Number 3067 and the following add width details:#ctl00_MainContentArea_Profile1_radwindowProfileImage_C{height: 589px !important;width: 478px !important;} - Save and close the file.
- Restart the IIS.