This article details the steps necessary to update an existing InstantKB.NET 2.0.6 installation to the InstantKB.NET 2.0.6 release. You can also find information in this article on the additions, updates & fixes included within 2.0.6.
Export PDF
Improved PDF export option. Now supports formatting (underline, bold, italics, bulleted lists), images, links & PDF properties...
To take advantage of the new PDF export option you will need to run InstantKB.NET in full trust. You can do this by modifying the following line within the web.config...
<trust level ="Full"/>
If your not able to run InstantKB.NET in full trust (for example your on a shared server) please add the line below to the web.config and this will ensure InstantKB.NET falls back onto the medium trust PDF parser. This does not produce as good results as the full trust parser however it will ensure you can at least export a basic PDF without any exceptions.
Add the following application setting to your "web.config" file if your running InstantKB.NET in medium trust to ensure the PDF export feature works...
<add key="InstantASP_MediumTrust" value="True"/>
New Skin
We've updated the default "Classic" skin to bring this more inline with the forthcoming InstantForum.NET 4.2 update.
If you still prefer the older skin you can still use this by selecting the "ClassicOld" skin as your default skin within the application settings.
Improved Search UI
Made some nice improvements to search...
The Visual Studio.NET solution has been updated to 2008 by default
The Visual Studio.NET solution has been updated to Visual Studio.NET 2008 by default and you won't be able to open the 2.0.6 solution file in Visual Studio.NET 2005. InstantKB.NET 2.0.6 will of course still work with either the .NET 2.0 or 3.5 frameworks so this should not affect production installations.
Our forthcoming InstantForum.NET 4.2 update requires at minimum the .NET 3.5 SP1 framework. This is because we use some of the AJAX features that where introduced with .NET 3.5 SP1 update (things like JSON serialization & the history control). These are not supported in ASP.NET AJAX 1.0. Extensions
We want to start using these features within InstantKB.NET and as such as of InstantKB.NET 2.1 we will be moving to .NET 3.5.
- Fixed rendering issue with WYSIWYG editor in IE8 on add / edit article pages
- Staff & Admin CP Notepads now both use AJAX
- Fixed issue with German / Umlaut characters when adding categories to the tree-view
- Consolidated R.a.d Controls into our own skinning system (no need for a separate folder)
- Reports will now work in a medium trust ASP.NET hosting environments
- Accessibility & SEO improvements to the various dynamic menus used throughout InstantKB.NET
- Fixed issue with some login & search redirects if you have the "Search Engine Friendly URLs" option enabled
- Fixed issue sorting secondary categories if they are added to a datagrid view
- Fixed a number of pages which were not strict W3C XHTML
------------------------------------------------
1. Download InstantKB.NET 2.0.6
Download the 2.0.6 update from your My.InstantASP area.
If your an existing 2.x customer the 2.0.6 download will be available automatically on your My Licenses page at http://my.instantasp.co.uk/MyLicenses.aspx. Download the 2.0.6 update and extract the contents of the zip file to your desktop. This will create a new folder on your desktop called InstantKB205DEV or InstantKB205EUL depending on your license.
2. Update your existing 2.0.5 files
The quickest way to update is to simply copy the entire contents of the "InstantKB20" folder (excluding web.config file - see changes below) again to your current InstantKB.NET installation. This will replace all existing 2.0.5 files. If you choose to replace all files you may wish to skip the Skin\Classic\MasterPage.master file to preserve any changes to your existing master page.
Replacing only the updated files
If you've customized / modified a number of InstantKB.NET files you may wish to simply copy only the updated files into your installation. You can find a list below of all updated files within the 2.0.6 release. There are no new files with this update. You'll need to ensure you update the existing files with the latest versions from the 2.0.6 download.
3. Update your existing 2.0.5 database
No database changes are required to move from 2.0.5 to 2.0.6.
The following files have been updated with the 2.0.6 update. If you wish to only apply the updated files you should copy the files from the InstantKB.NET 2.0.6 download listed below into your existing 2.0.5 installation.
Web.config
You will need to add the following HTTP handlers to your web.config...
<httpHandlers>
<!-- required telerik httphandlers -->
<add verb="*" path="Telerik.RadUploadProgressHandler.ashx" type="Telerik.Web.UI.Upload.RadUploadProgressHandler, Telerik.Web.UI"/>
<add verb="*" path="Telerik.Web.UI.DialogHandler.aspx" type="Telerik.Web.UI.DialogHandler, Telerik.Web.UI, Culture=neutral, PublicKeyToken=121fae78165ba3d4"></add>
<add verb="*" path="Telerik.Web.UI.SpellCheckHandler.axd" type="Telerik.Web.UI.SpellCheckHandler, Telerik.Web.UI, Culture=neutral, PublicKeyToken=121fae78165ba3d4"></add>
<add verb="*" path="ChartImage.axd" type="Telerik.Web.UI.ChartHttpHandler, Telerik.Web.UI, Culture=neutral, PublicKeyToken=121fae78165ba3d4" validate="false"/>
<add path="Telerik.Web.UI.WebResource.axd" verb="*" type="Telerik.Web.UI.WebResource, Telerik.Web.UI" validate="false"/>
<add verb="*" validate="false" path="Telerik.Web.UI.SpellCheckHandler.axd" type="Telerik.Web.UI.SpellCheckHandler, Telerik.Web.UI"/>
<!-- /required telerik httphandlers -->
</httpHandlers>
Updated Assemblies
The following assemblies will need updating...
- InstantASP.Common.dll
- InstantASP.Common.Configuration.dll
- InstantASP.Common.Data.dll
- InstantASP.Common.UI.dll
- InstantASP.InstantKB.dll
- InstantASP.InstantKB.Data.dll
- InstantASP.InstantKB.UI.dll
New Assemblies
You will need to add the new Telerik.Web.UI.dll to your existing 2.0.5 installation.
Old Assemblies
You can safely delete the following assemblies once upgraded to 2.0.6...
- RadCalendar.Net2.dll
- RadChart.Net2.dll
- RadEditor.Net2.dll
- RadInput.Net2.dll
- RadSpell.NET2.dll
Root Web File Changes
The following files within the root of your InstantKB.NET installation will need updating...
Root Web Folder Changes
The "JavaScript" folder within the root of the InstantKB.NET web site has been renamed to "js".
Root Web Updated Folder
You should delete your existing "RadControls" folder within the root of your InstantKB.NET 2.0.x installation and replace this with the RadControls folder within the root of the InstantKB20 folder provided within InstantKB.NET 2.0.6.
The updated RadControls folder within the web site root with 2.0.6 should now only contain a single child folder called "Editor". This folders contains the various configuration & toolbar files for the editor used within InstantKB.NET. The skins for the editor have now been moved into each skin folder (see below).
New Skin Folder
IMPORTANT: You will need to copy the "RadControls" folder from any of the InstantKB.NET 2.0.6 skins (\Skins\Classic\RadControls) into your previous InstantKB.NET 2.0.x skin(s). This is shown below...
Skin Files Updates
If you've created your own skin for InstantKB.NET you will need to copy the following files into your skin folder. If you've customized the CSS for your skin we would suggest using a tool like WinMerge to see the changes we've introduced and apply these to your CSS.
- \Skins\Classic\Admin\admindefault.ascx
- \Skin\Classic\Admin\admineditfieldtemplate.ascx
- \Skin\Classic\Admin\admineditworkflowstep.ascx
- \Skin\Classic\Admin\admininsertfieldtemplate.ascx
- \Skin\Classic\Admin\adminmanagefieldtemplates.ascx
- \Skin\Classic\Admin\Controls\adminappversion.ascx
- \Skin\Classic\Admin\Controls\admingettingstarted.ascx
- \Skin\Classic\Admin\Controls\admininsertupdatemember.ascx
- \Skin\Classic\Admin\Controls\adminleftpane.ascx
- \Skin\Classic\Admin\Controls\adminleftpaneonlinestaff.ascx
- \Skin\Classic\Admin\Controls\adminnotepad.ascx
- \Skin\Classic\Admin\Controls\adminsettingsdatabasetables.ascx
- \Skin\Classic\Admin\Controls\adminviewfieldtemplates.ascx
- \Skin\Classic\Admin\Controls\adminviewreport.ascx
- \Skin\Classic\Admin\Controls\adminviewviews.ascx
- \Skin\Classic\Admin\Controls\adminviewworkflownextsteps.ascx
- \Skin\Classic\Admin\Controls\adminviewworkflownotifications.ascx
- \Skin\Classic\Admin\Controls\adminviewworkflowpermissions.ascx
- \Skin\Classic\Admin\Controls\adminviewworkflows.ascx
- \Skin\Classic\Admin\Controls\adminviewworkflowstepwizard.ascx
- \Skin\Classic\Controls\addarticlecomments.ascx
- \Skin\Classic\Controls\footeroptions.ascx
- \Skin\Classic\Controls\mainnavigation.ascx
- \Skin\Classic\Controls\usercpeditsettings.ascx
- \Skin\Classic\Controls\usercpeditsignature.ascx
- \Skin\Classic\Controls\usercpnotepad.ascx
- \Skin\Classic\Controls\viewarticles.ascx
- \Skin\Classic\Controls\viewglossary.ascx
- \Skin\Classic\Controls\viewsearchoptions.ascx
- \Skin\Classic\Controls\viewtab.ascx
- \Skin\Classic\exportpdf.ascx
- \Skin\Classic\Staff\Controls\staffinsertupdatearticleattachments.ascx
- \Skin\Classic\Staff\Controls\staffinsertupdatearticlerelatedlinks.ascx
- \Skin\Classic\Staff\Controls\staffinsertupdatearticletags.ascx
- \Skin\Classic\Staff\Controls\staffinsertupdatecomment.ascx
- \Skin\Classic\Staff\Controls\staffinsertupdateglossaryterm.ascx
- \Skin\Classic\Staff\Controls\staffinsertupdatetroubleshooterstep.ascx
- \Skin\Classic\Staff\Controls\staffleftpane.ascx
- \Skin\Classic\Staff\Controls\staffnotepad.ascx
CSS Files
- \Skin\Classic\Styles\InstantASP.Common.UI.Admin.css
- \Skin\Classic\Styles\InstantASP.Common.UI.css
- \Skin\Classic\Styles\InstantASP.InstantKB.UI.css
- \Skin\Classic\Styles\RadEditorCssClasses.xml
New Skin Image Filers
- \Skins\Classic\Images\PanelBarFooterBG.gif
- \Skins\Classic\Images\PanelBarFooterLeft.gif
- \Skins\Classic\Images\PanelBarFooterRight.gif
- \Skins\Classic\Images\PanelBarHeaderBG.gif
- \Skins\Classic\Images\PanelBarHeaderLeft.gif
- \Skins\Classic\Images\PanelBarHeaderRight.gif
- \Skins\Classic\Images\PanelBar_SubHeaderBG.gif
JavaScript Files
The following JavaScript files will require updating...
- \js\InstantASP_Common.js
- \js\InstantASPTreeView.js
- \js\IInstantKB.js
You can delete \js\InstantASPTransitions.js as of InstantKB.NET 2.0.6.
Language Pack Files
To accomodate for the new strings within 2.0.6 you will need to replace your Respirces.xml file.
- \Globalization\en-US\Resources.xml
- \Globalization\en-US\Strings.js
No changes required.
Once you've updated the files listed above and updated your database you should visit your existing InstantKB.NET installation. If everything was successful you should be able to continue using your knowledgebase as before. As always if you have any questions or run into any problems during the upgrade don't hesitate to leave your comments below, open a support ticket or contact us.