Optionally provide private feedback to help us improve this article...

Thank you for your feedback!


InstantForum 2015 to 2016

This article details the steps necessary to update an existing InstantForum 2015 installation to the InstantForum 2016 release. You can also find information in this article on the additions, updates & fixes included within InstantForum 2016.

Our InstantForum 2016 update introduces a number of new features & improvements. For a complete list please refer to our InstantForum 2016 Release Notes.

Upgrade from InstantForum 2015 to 2016

1. Download InstantForum 2016

Download the InstantForum 2016 update . If your an existing 2015 customer the 2016 download will be available automatically on your My Licenses page at http://my.instantasp.co.uk/MyLicenses.aspx.

You will need to click the "Download" button to the right of the InstantForum 2016 listing.

After you've completed the download extract the contents of the zip file to your desktop. This will create a new folder on your desktop called InstantForum2016_DEV or InstantKForum016_EUL depending on your license.

2. Update your existing InstantForum 2015 files

The quickest way to update is to simply copy the entire contents of the "InstantForum2016" folder within the InstantForum 2016 download (excluding the web.config file) again to your current InstantForum 2015 installation.

This will replace all existing 2015 files. If you choose to replace all files you may wish to keep your existing master page or any custom CSS.

New & Updated CSS Classes

The following CSS has been added to 1-debug-common.css...

.simple-menu::-webkit-scrollbar { background:#242424; width: 12px; }
.simple-menu::-webkit-scrollbar-thumb:vertical { margin: 0 12px; background-color: #888; -webkit-border-radius: 0; }
.simple-menu::-webkit-scrollbar-button:start:decrement,
.simple-menu::-webkit-scrollbar-button:end:increment {
height: 0; display: block;
}

.simple-menu iframe::-webkit-scrollbar { background:#242424; width: 12px; }
.simple-menu iframe::-webkit-scrollbar-thumb:vertical { margin: 0 12px; background-color: #888; -webkit-border-radius: 0; }
.simple-menu iframe::-webkit-scrollbar-button:start:decrement,
.simple-menu iframe::-webkit-scrollbar-button:end:increment {
height: 0; display: block;
}
/* controls the icon & no results text shown when views have no data */
.no-results { text-align: center; }
.no-results h2 { color:#ccc; font-family:"Segoe UI Light"; font-weight: normal !important; margin: 12px 0; }
.no-results i { font-size: 100px; color:#ddd; }

The following CSS classes have also been updated...

  • .FormInputCheckBox
  • .ajax__validatorcallout_icon_cell
  • .FormInputHighlight
  • .rtb_MenuTableLinkList

Within 3-debug-forum.css the following CSS class has been added...

  • .mod-options-wrapper

MasterPage

As this release uses the latest version of the AjaxControlToolKit we have updated the <CompositeScript> element within the MasterPage.Master file. If you would like to re-use an existing MasterPage created with InstantForum 2015 within InstantForum 2016 you will simply need to update the <CompositeScript> element within your 2015 master page to match the <CompositeScript> element within the 2016 MasterPage.Master.

Replacing only the updated files

If you've customized / modified a number of InstantForum 2015 files you may wish to simply copy only the updated 2016 files into your installation. You'll need to ensure you update the current existing files with the latest versions from the InstantForum 2016 download. You can find below a complete list of all updated files & folders within the InstantForum 2016 release.

3. Update your existing 2015 database

You will need to open & execute the 2015_to_2016.sql file against your existing InstantForum 2015 database. This file can be found within the InstantForum 2016 download within theInstantForum2016\DatabaseScripts\UpgradeScripts folder.

BACKUP: As always before running any upgrade script we would strongly recommend you take a back-up of your current existing database. Whilst it's unlikely you'll receive errors during the execution of our upgrade scripts it's good practice to take a back-up of your database before making any major changes.

Updated InstantForum 2016 Files

The following files have been updated with the InstantForum 2016 update. If you wish to only apply the updated files you should copy the files & folders listed below from the InstantForum 2016 download into your existing InstantForum 2015 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.InstantForum.dll
  • InstantASP.InstantForum.Data.dll
  • InstantASP.InstantForum.UI.dll

New Assemblies

The following new assemblies are required to take advantage of the new ASP.NET Identity / OWIN support. Theses assemblies can be found within the InstantForum 2016 Bin folder. These assemblies are added as NuGet packages to our InstantASP.Common project.

  • System.Web.Http.Owin.dll
  • Microsoft.Owin.dll
  • Microsoft.Owin.Host.SystemWeb.dll
  • Microsoft.Owin.Security.Cookies.dll
  • Microsoft.Owin.Security.dll
  • Microsoft.Owin.Security.OAuth.dll
  • Owin.dll

New Files

The following configuration class has been added into the "App_Code" folder to help you configure how the ASP.NET Identity / OWIN support works. You will need to copy the StartUp.Auth.cs file into your existing InstantForum 2015 installation if you include the OWIN assemblies. Further changes to the InstantForum web.config file are required as detailed further below to support OWIN authentication.

  • App_Code\Startup.Auth.cs

Skin File Updates

If you've created your own skin for InstantForum 2015 you will need to copy the following 2016 files into your skin folder from the Classic skin folder within the 2016 download. Please ensure you copy the skin controls to each skin you use within your installation.

Skin Folders

  • \Skins\{SkinName}\Admin\
  • \Skins\{SkinName}\Controls\
  • \Skins\{SkinName}\Dialogs\

Configuration Files

  • URLRewrite.Config​
  • Pages.config

JavaScript Files

The following JavaScript files will require updating...

  • \js\3-debug-common.js
  • \js\4-debug-jPlugIns.js
  • \js\5-debug-forum.js
  • \js\core.js

Language Files

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

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

Web.Config Change

The following section may need to be added to your existing InstantForum 2015 web.config to take advantage of the new OWIN based authentication system and Windows Azure Blob Storage.​ The <runtime> section can be added below the closing <system.webServer> element.

 <runtime>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="Microsoft.Owin" publicKeyToken="31bf3856ad364e35" culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-3.0.1.0" newVersion="3.0.1.0" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-6.0.0.0" newVersion="6.0.0.0" />
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Microsoft.WindowsAzure.Storage" publicKeyToken="31bf3856ad364e35" culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-6.0.0.0" newVersion="6.0.0.0" />
</dependentAssembly>
</assemblyBinding>
</runtime>

That's It!

Once you've updated the files listed above and updated your database you should visit your existing InstantForum installation. If everything was successful you should be able to continue using your community as before. As always if you have any questions or run into any problems during the upgrade don't hesitate to open a support ticket or contact us.