Introduction

K2 4.6.1 (4.12060.1500.0) updates all K2 blackpearl 4.6 and K2 blackpoint 4.6 installations with the latest product hotfixes, as detailed below. The installer will update K2 4.6 32-bit and 64-bit installations.

Update Options
  • For customers who already have K2 blackpearl 4.6 or K2 blackpoint 4.6 installed, download and install this update.
  • For customers who do not have K2 blackpearl or K2 blackpoint installed, download the full K2 4.6.1 (4.12060.1500.0) installer from portal.k2.com.

The following versions of K2 can be upgraded to K2 4.6.1:

  1. K2 blackpearl 0807 (4.8210.x.690) with KB00690
  2. K2 blackpearl 4.5 (4.10060.1.x)
  3. K2 blackpoint 4.5 (4.10060.1.x)  
  4. K2 blackpoint 0902 (4.9040.x.610) with KB000610
         
Note: Clients on a version prior to those listed above need to first upgrade to K2 4.5 and then upgrade to K2 4.6.1.

Issues Resolved

The following issues have been fixed and are contained within this update: 

KB001285 - Hotfix: User Tasks for K2 SharePoint Workflow Integrated Processes will not be generated when starting a workflow instance on SharePoint items that exist within a SharePoint Document Library folder or SharePoint List folder.
KB001286 - Hotfix: Configuration options for Active Directory User Manager message logging.
KB001291 - Hotfix: A timeout error occurs in a K2 Designer for Visual Studio process when using high volumes of E-mail Events that contain large attachments.
KB001294 - Hotfix: A SharePoint SmartObject GetList method created from a Document Library with many records results in a timeout error.
KB001499 - K2 4.6.1 High Priority Fixes

New Features

K2 4.6.1 contains new K2 Features. For more information, download the PDF from the link available on the right hand menu bar.

Important Considerations and Behavioral changes made in the minor K2 4.6 release that you should be aware of:

    1. Changes have been made to the K2 Documentation, namely:
      1. The K2 documentation has been removed from the main K2 4.6 installer. This will mean that the K2 4.6 installer will not install the K2 documentation.
      2. The I buttons in K2 Studio and K2 designer for Visual Studio will open the online help located at http://help.K2.com.
      3. The documentation has been split into three guides, namely, K2 Getting Started Guide, User Guide and the Developer Reference.
      4. A new K2 Documentation Installer has been created that can be run on an environment with K2 4.6 and will install the User Guide and Developer Reference CHMs
    2. Read KB001280 to understand all the changes made to the documentation in K2 4.6.  
    3. On a clean install of K2 4.6 the shortcut icons will not be installed on the desktop, however on upgrades the icons will remain on the Desktop.
    4. The K2HostServer.config name has been changed to K2HostServer.exe.config. The following will occur at installation:

Upgrade:

The original K2HostServer.config file is backed up to [INSTALLDIR]\Setup\Configuration\Backup\[DATE] folder

During upgrade the K2HostServer.exe.config is added and the existing settings are preserved.

Clean install:

Only the K2HostServer.exe.config will be available in the [INSTALLDIR]\K2 blackpearl/ blackpoint\Host Server\Bin

    1. See KB000686 for information relating to Using .NET 4.0 in a K2 4.6 Configuration.
    2. Repairing the Database Rebuild Indexing task in the Analysis tool will stop the K2 blackpearl/blackpoint service.  If you choose to close the wizard while the task executes in the background the service will need to be manually started after the Agent Jobs complete.  If you keep the Analysis tool open the task will start the service again automatically as soon as the jobs complete.
    3. In K2 4.6 the database name has changed from K2HostServer to K2.

 K2 4.6 Clean installation

The default database name will be K2.

 K2 4.6 Upgrade

The installer will identify the previous K2 database name and will populate the installer screen with the previous name.

Known Issues

For the Known Issues for K2 4.6.1 (4.12060.1500.0) download the PDF from the link available on the right hand menu bar.

Installation

K2 4.6.1 (4.12060.1500.0) is available as an independent installation package.  The installer handles 32-bit and 64-bit installations.Refer to the K2 4.6.1 documentation available in the installation package for detailed installation instructions.

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

Important: 
From K2 4.6.1 onwards there will only be one installer. The installer caters for a clean full install as well as an upgrade from a previous K2 version. The installer detects that K2 is installed and will guide you through the upgrade. The installer always contains the latest update.

 

Installation Steps

The K2 4.6.1 installation package must be installed by running the K2 Setup Manager (K2Setup.exe) found within the package.

Note: This installation package should be installed on all machines that have K2 components installed. There is only one K2 Setup Manager.exe to run for clean installs and upgrades. The installer will detect if there is a previous K2 version installed and will run the upgrade.

To install this package on an environment that already has K2 4.6 installed , follow the steps below:
  1. K2 Maintenance Screen
    The K2 Maintenance Screen presents the options to Upgrade the environment using the previously configured system values or to provide new values. The option to remove K2 is also available. Select the Upgrade option and check the Use previously configured values check box. Click Next to continue.
  2. Version Check
    The Checking for Latest Version Screen presents the K2 4.6.1 version to be installed and connects to the K2 Portal to determine what the most recent Update version available is.
  3. Upgrade Summary
    The Upgrade Summary screen lists the current installed K2 Components and shows what the component will be upgraded to. Click Next to continue.
  4. HostServer Databases
    On the HostServer Database screen the name of the current K2 server will be displayed. You may test the connection or configure Authentication. Click Next to continue.
  5. SQL Reporting Services Configuration
    On this screen you can enable and configure SQL reporting by adding the Web Service URL or testing any existing URL. Click Next to continue. 
  6. CRM Configuration
    If CRM integration is required select the check box, provide the Server URL and Organization. Click Next to continue.
  7. Configuration Summary
    The summary screen lists the information that you have entered in the Setup Manager. Be sure to scroll through the information and make sure everything is accuate. Once you have reviewed the information click Next.
  8. Additional Actions
    The Additional Actions screen shows any necessary steps that need to be completed before the upgrade can proceed. The actions can be performed automatically by the Setup Manager or by or manually. Click Next for the actions to be performed and for the upgrade to continue.
  9. Installing
    The Installing screen will upgrade the environment. The progress bar will show the status of each component as well as the total progress. This may take a few minutes.
  10. Configuration Status
    The Setup Manager will now apply your settings to all of the K2 components. The progress bar will show the status of each component as well as the total progress.
  11. Configuration Analysis
    The Configuration Analysis Tool will detect if there are any errors. Automatically repair the errors by clicking on Repair All. Once all the errors have been resolved, click Next to continue.
  12. Finished
    Once the upgrade 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.
  13. K2 for SharePoint Configuration Wizard 
    After the K2 Setup Manager finishes, the K2 for SharePoint Configuration wizard will run and must be allowed to complete to fully update the K2 Features in SharePoint with any changes.
Note: If the K2 for SharePoint Configuration wizard is not run, the update will not be installed properly and your K2 installation will not function correctly.