InstantKB 2011-1 to 2011-2



This article details the steps necessary to update an existing InstantKB 2011-1 installation to the InstantKB 2011-2 release. You can also find information in this article on the additions, updates & fixes included within InstantKB 2011-2.

The primary focus for this release has been to resolve issues reported since the 2011-1 release and to improve various areas based on issues we've identified since the previous release and customer feedback.

InstantKB 2011-2 Improvements

Improved Rules

Added options which allow you to now send rule generated emails to the ticket author, assigned to, last modified by etc. This is helpful if you wish to automate an email confirmation for new ticket replies. Or for example you may wish to generate an email to the person who the ticket is assigned to via the rule.

Search By Category in Staff CP

We've now added the ability to filter by category when searching within the staff control panel. Within the advanced search view you'll see a small arrow within the keywords field. This will display a tree with check boxes allowing you to select specific categories to return. 

This has been added for all tabs - knowledgebase, troubleshooter, downloads & tickets.



HTML Support within Email Templates

Added support for HTML within the Emails.XML templates. As this is a XML file you'll need to use [ ] instead of < > however you can use any HTML tag. For example if you wanted to include your company logo within emails generated by InstantForum you can now add the following markup to the Emails.xml fileā€¦

[img src="https://company.com/images/logo.gif" /]

This will work for any HTML tag for example [strong] [a href="https://domain.com"]my link[/a] [h1]. The important thing to remember to simple replace the greater than (>) and lesser than (<) characters with square brackets [ ] as < > are special entities within XML. You will also need to ensure emails are sent as HTML within the InstantForum.NET email settings page.

Improved support for InstantForum & InstantKB SSO 

With InstantForum 2010-5 and InstantKB 2011-2 Single Sign On (SSO) has been improved to ensure you can use both the InstantASP.InstantForum and InstantASP.InstantKB APIs / assemblies from the same Visual Studio.NET project.

We'll be publishing a sample application and further documentation here within our online documentation soon.


InstantKB 2011-2 Fixes

  • Fixed issues with work flow notifications within tickets
  • Fixed issues with work flow step edit permissions within tickets
  • Fixed issue with submitting new tickets with attachments
  • Fixed issue with articles assigned to me counts
  • Fixed issue with ticket assigned to me counts
  • Fixed issues when deleting tickets or ticket replies from user control panel
  • Fixed issue with work flow next steps not applying when responding to tickets
  • Removed workflow drop down from work flow change actions - caused confusion
  • Fixed issue with work flow step field templates in tickets not being applied
  • Fixed issue with automated email sent to users when staff reply to tickets
  • Fixed issue which prevented you from removing assigned to
  • Fixed issue which caused trouble shooter steps to not display when updating workflow
  • Fixed issues with SLA sort options not working correctly

Upgrade from 2011-1 to 2011-2

1. Download InstantKB 2011-2

Download the InstantKB 2011-2 update from your My.InstantASP area.

If your an existing 2011 customer the 2011-2 download will be available automatically on your My Licenses page at https://my.instantasp.co.uk/MyLicenses.aspx.

Download the 2011-2 update and extract the contents of the zip file to your desktop. This will create a new folder on your desktop called InstantKB2011-2DEV or InstantKB2011-2EUL depending on your license.

2. Update your existing InstantKB 2011-1 files

The quickest way to update is to simply copy the entire contents of the "InstantKB2011" folder (excluding web.config file) again to your current InstantKB 2011-1 installation.

This will replace all existing 2011-1 files. If you choose to replace all files you may wish to keep your existing master page. If so you can 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 files you may wish to simply copy only the updated files into your installation. There are no new files with this update. You'll need to ensure you update the existing files with the latest versions from the InstantKB 2011-2 download. You can find below a complete list of all updated files within the InstantKB 2011-2 release.

3. Update your existing 2011-1 database

We have updated a number of stored procedures with 2011-2. To apply the update to your InstantKB 2011-1 database  please run the file located within the 2011-2 download at...

[InstallPath]\InstantKB2011\DatabaseScripts\UpgradeScripts\2011-1_to_2011-2.sql

Updated InstantKB 2011-2 Files

The following files have been updated with the InstantKB.NET 2011-2 update. If you wish to only apply the updated files you should copy the files from the InstantKB 2011-2 download listed below into your existing InstantKB 2011-1 installation.

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

Skin Files Updates

If you've created your own skin for InstantKB 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\{SkinName}\ControlPanelMyIssues.ascx
  • \Skins\{SkinName}\Staff\Controls\StaffInsertUpdateTicketReply.ascx

CSS Files

  • \Skin\Classic\Styles\InstantASP.Common.UI.css

JavaScript Files

The following JavaScript files will require updating...

  • \js\jb.js

Language Pack Files

To accommodate for the new strings within 2011 you will need to replace your Resources.xml file.

  • \Globalization\en-US\Resources.xml
  • \Globalization\en-US\Emails.xml

Database Changes

We have updated a number of stored procedures with 2011-2. To apply the update to your InstantKB.NET 2011-1 database  please run the file lcoated within the 2011-1 download at...

  • [InstallPath]\InstantKB2011\DatabaseScripts\UpgradeScripts\2011-1_to_2011-2.sql

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.