Upgrading from InstantKB.NET 2.0.2 to 2.0.3

Expand / Collapse
 

Upgrading from InstantKB.NET 2.0.2 to 2.0.3


This document details the steps necessary to upgrade an existing InstantKB.NET 2.0.2 installation to the InstantKB.NET 2.0.3 release. We've listed below all the web files that you will need to replace to upgrade your existing installation to InstantKB.NET 2.0.3. A complete list of fixes & additions included within the InstantKB.NET 2.0.3 update is provided below...

2.0.3 Fixes
  • Fixed issue with certain attachment types showing as binary data within browsers as opposed to downloading the file.
  • Fixed issue with tab icons & tab option images within the Admin CP not loading correctly under https (SSL) connections.
  • Fixed issue with custom field template default values not working.
  • Fixed issue with field templates associated with staff permission sets not being applied.
  • Fixed issue with "Propagate groups to all child articles" option not copying permissions to articles within the root category.
  • Fixed validation issue when updating a members password or email address through the Admin & Staff CP.
  • Fixed issue with online staff panel within Admin CP & Staff CP sometimes throwing a "Object Reference" error.
  • Fixed exception when adding or editing content if you partially created a selectbox custom field for the field template.
  • Fixed broken image links within RoundedTable control.
  • Fixed issue with invalid "CauseValidation" several Admin CP buttons.
  • Fixed issue with "[Last Modified By]" & "[Assigned To]" workflow notification options not working correctly.
  • Fixed issue sorting columns when viewing tag page.
  • Fixed issue with "[RecipientUsername]" quick tag and not the username appearing within workflow step notification email's.
  • Fixed issue with InstantASP.InstantKB.Business.Articles.SelectArticles not returning small record sets.
  • Fixed issue with paging controls showing incorrect values if a search for a member returned no results.
  • Fixed issue with attachments not appearing within list if you delete an attachment then upload a new attachment.
  • Fixed rendering issue in FireFox on ViewArticle.ascx if little or no article text was provided.

2.0.3 Additions

  • Added ability to define maximum size for images, flash or videos uploaded within the WYSIWYG editor. By default this limit will be the size specified within the web.configs httpruntime maxrequestlength attribute...

    <httpRuntime maxRequestLength="30720" />
    You can optionally override this setting by providing a web.config application settings (shown below) to set the maximum size allowed size for image, flash & video uploads within the WYSIWYG editor...

    <add key="InstantASP_HttpMaxRequestLength" value="20480" />
    The value is the maximum size in kilobytes you wish to allow for image, flash and video uploads within the WYSIWYG editor. For example to limit or increase the allowed size of image, flash or video uploads to 20mb you would set this value to 20480. There are 20,480 kilobytes in 20mb.

  • Added validation to "Application URL" setting within Admin CP to ensure this setting is always provided in the correct format.

  • Added callback validation control to Skins\Classic\Admin\AdminEditMemberDetails.ascx.

  • Added animation effect to SimpleMenu control to better indicate a meny has popped up.

  • Made API changes to allow sorting of results returned by the InstantASP.InstantKB.Business.Articles.SelectArticles method.

2.0.3 Database Changes

InstantKB.NET 2.0.3 features two small database changes to provide support for our Active Directory module in the coming months. These changes are listed below...

  • LdapUsername nvarchar(255) column added to InstantASP_Users tab;e
  • iasp_sp_InsertUpdateUser stored procedure updated to accommodate LDAPUsername column.

These changes don't effect API useage of our InstantASP.Common.Business.User.InsertUpdateUser method as this method simply acceots a InstantASP.Common.Components.User object.

---------------------------------------------------------

How to upgrade from InstantKB.NET 2.0.2 to 2.0.3

1. Download InstantKB.NET 2.0.3

Download the 2.0.3 update from your My.InstantASP area. If your an existing 2.x customer the 2.0.3 download will be available automatically on your My Licenses page at http://my.instantasp.co.uk/MyLicenses.aspx. Download the 2.0.3 update and extract the contents of the zip file to your desktop. This will create a new folder on your desktop called InstantKB203DEV or InstantKB203EUL.

2. Update your existing 2.0.2 files

Update your existing files. The quickest way to update is to simply copy the entire contents of the "InstantKB20" folder (excluding web.config file) again to your current InstantKB.NET installation. This will replace all existing 2.0.2 files. If you choose to replace all files you may wish to skip the web.config and Skin\Classic\MasterPage.master file to preserve your database connection string and any visual customization's. If you own a single server license or are behind a firewall and received a file based license you should ensure you have a backup of your "\Bin\InstantASP_Licenses.config" file to restore this once the update is complete.

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.3 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.3 download.

3. Update your existing 2.0.2 database

Once you've updated your files you'll need to run a script against your InstantKB.NET SQL Server database to upgrade this to 2.0.3. There are two small database changes in 2.0.3. To update your database you'll need to first connect to your database within SQL Server Management Studio or Enterprise Manager.

Once connected you'll need to open the "InstantKB20\DatabaseScripts\UpgradeScripts\2.0.2_to_2.0.3.sql" file and execute this SQL file against your current InstantKB.NET database. You can also find the upgrade script attached to at the bottom of this article.

-------------------------------------------------

Updated InstantKB.NET 2.0.3 Files

The following files have been updated with the 2.0.3 update. You will need to ensure all the files listed below are replaced in order to upgrade successfully. Once the files are updated please ensure you also update the database as shown in step 3 above.

Updated Assemblies / DLL files

You will need to update the following assemblies within your bin directory with the 2.0.3 versions...

  • 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

Updated Skin Files

You will need to replace the following skin files with the update 2.0.3 versions. If you've created a custom skin you will also need to replace the files within your custom skin with the updated versions.

  • \RadControls\Input\Skins\Classic\Styles.css
  • \Skins\Classic\Admin\AdminEditMemberDetails.ascx
  • \Skins\Classic\Controls\ViewArticle.ascx
  • \Skins\Classic\Styles\Skins\Classic\Styles\InstantASP.InstantKB.UI.css

Updated JavaScript Files

You will need to update the following JavaScript files with the latest 2.0.3 versions...

  • \JavaScript\InstantASPCommon.js
  • \JavaScript\InstantASPTransitions.js
  • JavaScript\InstantASPTreeView.js

That's It!

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.



Rate this Doc:
     

Attachments


2.0.2_to_2.0.3.zip 2.0.2_to_2.0.3.zip (1.24 KB, 463 views)

Add Your Comments


Name: *
Email Address:
Web Address:
   
  
 
 
   
Verification Code:
*
 

Details
Category: Upgrading
Product: InstantKB.NET
Version: 2.0
Type: HOWTO
Level: Intermediate
Rated 3 stars based on 2 votes.
Article has been viewed 5,317 times.
Last Modified By: Ryan Healey
Last Modified:12th August 2008
Options

Home | Products | Purchase | Services | Support | Company | Contact Us
Privacy Statement | © 1999-2009 InstantASP Limited. All Rights Reserved.