Hotfix Instructions - Kentico 8.2 Source Code

✖
Copy to clipboard

Hotfixes allow you to fix problems in your installation of Kentico. You can view the list of fixed bugs on the Kentico DevNet portal.

To obtain source code hotfixes, please contact your Kentico sales representative.

The following instructions apply only to the source code version of Kentico. For standard installations, please see Hotfix Instructions - Kentico 8.2.

Note

Hotfixes are not tested for all possible scenarios, so you may experience issues after applying the hotfix.

Always backup your project files and database before applying a hotfix.

Table of Contents

Applying the hotfix to a local project

  1. If your system stores virtual objects on the file system (due to enabled Deployment mode or source control options), return the files to the database. After you apply the hotfix, re-enable deployment mode or source control and rebuild the solution.

  2. Run Kentico Hotfix Utility (Hotfix.exe) from the location where you installed the hotfix.

  3. Select your project folder using the Browse button or type in the path to the project manually.

  4. Use the application to back up your project files and/or database if you haven’t already done so.

  5. Select which components you want to update. Click Switch to advanced mode if you wish to change the settings. We recommend updating all components.

    • Source files - all files in the source code, except for the web project in the CMS folder
    • Setup files - the Kentico installer and external utilities (which are separate from the web project)
    • SQL script - the database structure and data
    • Kentico files - the web project files in the CMS folder

  6. Choose a method of taking the project offline and back online.

  7. Click Next to start the update procedure.

  8. After the update finishes, click Next to view any problems that may have occurred and the instructions to solve them.

  9. Open the project solution in Visual Studio and follow the compilation instructions.

  10. Rebuild the solution.

For more information, see Kentico Hotfix and Upgrade Utility.

Applying the hotfix to a remote project

If you cannot access your web project directly (for example when the project is located on a remote hosting server), you can use the Hotfix Utility to create the updated file structure and then upload them to your web project location. 

  1. Navigate to the location where you installed the hotfix.

  2. Run Hotfix.exe from the command line with the /deploy=net45app parameter.
    Example: Hotfix.exe /deploy=net45app
    This launches the Hotfix Utility, which then creates the files and folders necessary for updating the source code project and saves them into the folder chosen in the first step of the Hotfix Utility wizard.

    Additionally, you can provide the /path parameter, which tells the application where to create the file structure. This way you won’t have to set the path in the first step of the Hotfix Wizard.

    You can supply the /path parameter in two different formats — relative, which represents a folder in the location from which the utility was executed; or absolute, which can be any path to a local disk.

    Example: Hotfix.exe /deploy=net45app /path=Deploy
    This launches the Hotfix Utility, which then creates a folder named Deploy in the directory from which the utility was executed and copies all files and folders necessary for updating a source code project into that folder.

  3. Once you have the update files ready, take your website offline. You can do this by copying the App_Offline.htm file from the hotfix installation directory into the root of the remote web project.

  4. Upload the update files created by the Hotfix Utility into your remote web project (overwrite the original files).

    Important

    If you have previously modified some of the Kentico project files, DO NOT OVERWRITE these files. You could lose your modifications.

    You need to compare the modified files with the new versions and make appropriate changes manually.

  5. Manually execute the hotfix SQL scripts on your Kentico database.

    • If you do not use separated databases - run the Hotfix_separated.sql and Hotfix_default.sql script files located in the SQL folder of your hotfix installation directory. We recommend running the files in the described order.
    • If you use separated databases - run the Hotfix_separated.sql script file on the separated database and Hotfix_default.sql on your main database. The script files are located in the SQL folder of your hotfix installation directory.

  6. Open the project in Visual Studio, follow the compilation instructions, and rebuild the solution.

  7. Bring your website back online (delete the App_Offline.htm file).

After applying the hotfix

All users who work with the Kentico administration interface should clear the cache in their browsers after applying the hotfix. Otherwise, some features in the administration interface may not be displayed correctly.

Updating setup files and external utilities

Hotfixes provide bug fixes for all files related to the Kentico installation, which includes the installer and other external utilities, such as Kentico Installation Manager, Kentico Service Manager or the Kentico AD Import Utility.

To update these files and utilities, you need to apply the hotfix to the setup files:

  1. When running the hotfix utility, click Switch to advanced mode in the Change confirmation step.
  2. Select the Setup files checkbox.
  3. Click Next.
  4. In the Running applications step, stop any applications that are currently running from the setup files.
  5. Click Next and continue through the rest of the hotfix procedure.

The hotfix makes any required changes to the files in the directory where you installed your Kentico setup files.

Source code compilation instructions

After applying the hotfix, please perform the following steps in Visual Studio to ensure that the source code works correctly and can be compiled:

Hotfix 8.2.2

  • Add a reference to the Membership library in the FormEngine project.
  • Add a reference to the Localization library in the Chat project.

Hotfix 8.2.5

  • Add references to the following libraries in the WebAPI project: 
    • Helpers
    • Membership

Hotfix 8.2.12

  • Add a reference to the Microsoft.CSharp library in the OnlineMarketing project.
  • Add a reference to Newtonsoft.Json.dll (from the project’s CMS/CMSDependencies/Newtonsoft.Json.4.5.0.0/ folder) in the Personas project.

Hotfix 8.2.37

  • Add references to the following dlls in the WebAnalytics project:
    • /CMS/CMSDependencies/System.Net.Http.2.0.0.0/System.Net.Http.dll
    • /CMS/CMSDependencies/System.Net.Http.Formatting.4.0.0.0/System.Net.Http.Formatting.dll
    • /CMS/CMSDependencies/System.Web.Http.4.0.0.0/System.Web.Http.dll

Hotfix 8.2.50

  • Add a reference to ~\Lib\Microsoft.SqlServer.TransactSql.ScriptDom.dll in the DataEngine project.

Additional notes and workarounds

General

  • Marketing automation - When configuring the ‘Set contact property’ marketing automation action, the ’Property name’ selector contains unnecessary contact columns. To hide the columns, edit the Set contact property action on the Actions tab of the Marketing automation application and disable the ‘Show all columns’ option for the PropertyName parameter.
  • Dancing Goat sample site - The comparison of the password and password confirmation fields in the user registration form on the sample Dancing Goat was not case sensitive. Follow the steps below to resolve the problem:
    1. Open the Modules application.
    2. Edit the Membership module.
    3. Select the Classes tab and edit the User class.
    4. On the Alternative forms tab, edit the User Registration (Dancing Goat) form.
    5. Select the UserPassword field and click the existing Validation rule.
    6. Change the validation rule type to General condition.
    7. Copy the following macro code into the Enter text field: Value == Fields[“PasswordStrength”].Value|(casesensitive)true
    8. Click Apply and then Save the entire field.

8.2.4

  • Reporting - Hotfix 8.2.4 updates and overwrites the Proc_Analytics_Pivot stored procedure. If you have customized this stored procedure, you need to manually apply your changes again after installing the hotfix.

8.2.13

  • On-line forms - Hotfix 8.2.13 updates the generating of autoresponder and notification emails of forms to ensure HTML validity. For the changes to take effect, you need to manually resave the settings on the Email notification and Autoresponder tabs of your forms in the Forms application.

8.2.27

  • The Contact import functionality now enables the ‘Track activities’ property for imported contacts. If you’ve used Contact import before applying this hotfix and want the imported contacts’ activities tracked, you need to enable the property manually.

8.2.29

  • The CategoryOrder column in the CMS_PageTemplateCategory database table is no longer used by the system and the hotfix sets its values to NULL.
  • Culture dependent data used in the Property value of the Set contact property marketing automation action must always be entered in the ‘en-US’ culture format. For example, use the MDY format for dates (12.21.1989).

Fixed bugs

For a full list of bugs covered by the hotfix, open the Hotfixes page on DevNet and click Fixed bugs for the appropriate Kentico version.