K2 4.5 Update KB001370 (4.10060.1.1370)

KB001370

Introduction

KB001370 updates all K2 blackpearl 4.5 and K2 blackpoint 4.5 installations with the latest product hotfixes, as detailed below. The installer will update K2 4.5 32-bit and 64-bit installations.

 Behavior Changes and Important Considerations

1. Prior to K2 4.5 with Update KB001230, it was possible to select SharePoint fields (including hidden fields) that would be retrieved from a SharePoint List or Library on the Metadata Mapping and Folio screen of the SharePoint Workflow Integration Wizard (for example, Created Date). In K2 4.5 with update KB1230 or higher, it is no longer possible to retrieve these SharePoint hidden fields within the wizard. These hidden fields  will be surfaced in the K2 Object Browser for processes that have been set up for K2 SharePoint Workflow Integration. The Workflow Integration creates an XML field called SharePoint_Item containing all the SharePoint Item metadata column values. This XML field is populated on workflow start and contains values for the SharePoint item at runtime. Note that the same behavior will be experienced in other SharePoint wizards that include the metadata control.
2. Changes were made to the K2 Services namespaces, read the changes are listed in the following KB article:KB001227: Namespace changes to K2 Services in Update KB001290.
3. As a result of improvements made to the K2 SharePoint Workflow Integration configured for Content Approval on a SharePoint publishing site there is a new requirement. Read the following article to obtain all the necessary information, KB001247 - New requirement for K2 SharePoint Workflow Integration configured for Content Approval on a SharePoint publishing site. 
4. When a machine does not have access to the internet certain issues such as timeouts and slow component startups could be experienced. This is caused by the Authenticode signed assemblies that require an internet connection for verification. This can be resolved by disabling the publisher verification. For more information read the troubleshooting tip in the documentation (Installation and Configuration > Troubleshooting > Slow startup for K2 components when machine has no internet access) or ready the related K2 Underground post at http://www.k2underground.com/blogs/johnny/archive/2010/07/14/slow-startup-for-k2-components-when-machine-has-no-internet-access.aspx
5. The K2 SmartObject Services configuration has been changed in this release. For more information on the configuration view the topic in the product documentation titled: Developer Reference > Services Reference > K2 SmartObject Services > REST Services > Configuration. The following known issue relates to the K2 SmartObject Services configuration:

The K2 Server will fail to start on an upgrade to K2 4.5 Update KB001370 that have existing static SmartObject endpoints defined with the optional “binding” attribute present on the “endpoint” node. 
Workaround:
Remove the binding attribute. If further specific binding information needs to be specified on an endpoint level, then follow the documentation to set the specific binding.
Example:
Old configuration:
     

New configuration:
    

Known Issues

 There are a few known issues with this update. For more information, download the PDF from the link available on the right hand menu bar and read the following KB article.

• KB001254 - Known Issue: An error occurs when enabling K2 SmartObject Services endpoints on a K2 Server that runs on .NET Framework 4.0

Installation

The latest K2 4.5 Update is available as an independent installation package that can be found at the following locations:
For K2 blackpearl 4.5 https://portal.k2.com/downloads/bp/default.aspx
For K2 blackpoint 4.5 https://portal.k2.com/downloads/k2blackpoint/default.aspx.

Installation Prerequisites

The following are prerequisites to K2 4.5 Update (4.10060.1.1370):

• K2 blackpearl 4.5 (4.10060.1.0)
  or
• K2 blackpoint 4.5 (4.10060.1.0)

Installation Steps

The K2 4.5 Update (4.10060.1.1370) installation package must be installed by running the K2 Update Manager (K2Setup.exe) found within the update package.

Note: This update package should be installed on all machines that have K2 components installed. The Configuration Manager will only be run for the K2 Server, K2 for SharePoint, K2 Workspace and K2 Designer for SharePoint. This update should be installed on machines running K2 blackpearl 4.5 (4.10060.1.0) or K2 blackpoint 4.5 (4.10060.1.0)

1. 1. Welcome Screen
      The Welcome Screen introduces the K2 Update Manager. An installation log will be created by default. Click Next to continue.
   2. Version Check
      The Checking for Latest Version Screen presents the K2 4.5 version to be installed and connects to the K2 Portal to determine what the most recent Update version available is.
      
   3. Components to Update
      The Components to Update page lists the K2 Components that the update manager will update. Click Update to continue.
   4. K2 Server
      The K2 Server must be stopped for the duration of the patch. If the server is running a warning screen will appear requesting that the K2 server be stopped.
   5. Reset IIS
      The K2 Update Manager will request and perform a reset of IIS.
   6. Ready
      The K2 Update Manager will install the update, and will show the progress of the update via the progress bars on the screen.
   7. Finished
      Once the update has completed installing, the wizard will show you the finished screen. A link to the log file that is created is available on this screen. Click Finish to close the installer.
   8. Configuration Manager
      After the K2 Update Manager finishes, the K2 Configuration Manager will run and must be allowed to complete to fully install and configure the new update.

      Note: If the K2 Configuration Manager does not complete successfully, the update will not be installed properly and your K2 installation will not function correctly.

   9. Expected behavior
      K2 uses Microsoft Windows Installer technology to install all updates.  When the Windows Installer patch (.msp file) is applied to its associated component it will return a status text of “Repairing” during the update process.  This happens even though an Update and not a Repair is being performed.
      
   10. Post Installation step (optional)
       Multiple Bindings Microsoft Framework .NET 3.5 does not support multiple bindings in IIS without configuring a single address and setting up a prefix filter as per the following MSDN KB (Refer to section ‘Multiple IIS Binding Support in .NET Framework 3.5’): http://msdn.microsoft.com/en-us/library/aa751841.aspx
       Some of the following errors may occur when bindings are incorrectly configured.
       
       • Could not find a base address that matches scheme http for the endpoint with binding WebHttpBinding. Registered base address schemes are o].
       • No protocol binding matches the given address 'http://api.denallix.com:85/K2Services/REST.svc/Worklist/Items'. Protocol bindings are configured at the Site level in IIS or WAS configuration.
       • The resource cannot be found.
       • This collection already contains an address with scheme http. There can be at most one address per scheme in this collection. Parameter name: item
       
       The K2 installation will not configure entries.  To configure K2 Services to support a web site with multiple bindings add a prefix entry for the binding you wish to support in the section of the K2 Services web.config found at eInstallation Directory]WebServicesK2Servicesweb.config.
       
       Example of supporting the http://api.denallix.com:81 binding on an IIS site with multiple bindings.

1. Post Installation step
   To view the new icons in K2 Designer for SharePoint clear your browser's cache.
2. Post Installation step (Recommended)
   It is recommended that the Design Template is updated for each K2 process that will be modified after the upgrade.

Components to Update

• K2 Server
• K2 for SharePoint 2007
• K2 Designer for SharePoint 2007
• K2 for SharePoint 2010
• K2 Designer for SharePoint 2010
• K2 Workspace (Runtime Web Services in K2 blackpoint)
• K2 for Visual Studio (2005/2008/2010)
• K2 Databases
• K2 for Reporting