Introduction

In K2 blackpearl version 4.6.9, a number of configuration files have been consolidated into a single configuration file to simplify the management of configuration settings.

When upgrading to K2 4.6.9 or greater, any existing environment configuration values are preserved and will be added to the new consolidated configuration file.

The following table lists the configuration files that have been consolidated into the K2HostServer.exe.Config file, which is located in the \K2 blackpearl\Host Server\Bin folder on the K2 Server.
The connection strings previously stored in these files are now retrieved from the K2HostServer.exe.Config file.

File Name Previous Location
DependancyService.config ..\Host Server\Bin\
DiscoveryService.config ..\Host Server\Bin\
SourceCode.Categories.Runtime.config ..\Host Server\Bin\
SourceCode.EnvironmentServices.Server.config ..\Host Server\Bin\
SourceCode.EnvironmentSettings.Runtime.config ..\Host Server\Bin\
SourceCode.EventBus.Assemblies.config ..\Host Server\Bin\
SourceCode.EventBus.ClientRecorder.dll.config ..\Host Server\Bin\
SourceCode.EventBus.ClientRecorder.dll.config ..\WebServices\SP15EventService\Bin\
SourceCode.EventBus.Deployment.dll.config ..\Bin
SourceCode.EventBus.EventAdmin.dll.config ..\Host Server\Bin\
SourceCode.EventBus.EventAssemblies.dll.config ..\Host Server\Bin\
SourceCode.EventBus.ManagementServer.config ..\Host Server\Bin\
SourceCode.EventBus.Mapping.dll.config ..\Host Server\Bin\
SourceCode.EventBus.Scheduler.ManagementServer.config ..\Host Server\Bin\
SourceCode.EventBus.Scheduler.Server.config ..\Host Server\Bin\
SourceCode.EventBus.Server.config ..\Host Server\Bin\
SourceCode.EventBus.Server.MessageQueueHelper.dll.config ..\Host Server\Bin\
SourceCode.SmartObjects.Runtime.config ..\Host Server\Bin\
SourceCode.SmartObjects.Runtime.config ..\ServiceBroker\
SourceCode.Workflow.Runtime.Management.config ..\Host Server\Bin\
SourceCode.Workspace.Runtime.config ..\Host Server\Bin\

The configuration entries for Client Tools and Authoring APIs has also been moved from all the .Net Machine.Config files to the individual application config files. This change can impact the APIs used to author K2 Projects, SmartObjects and Workflows. If building a custom application to make use of the APIs, and the entries are missing, the following exception will get raised:
'Please ensure that the needed configuration nodes are configured in your configuration file. Please refer to the help documentation for further details.'
To resolve this exception, the following configuration entries needs to be configured in your applications config file:

<configSections>
    <section
        name="sourcecode.configuration"
        type="SourceCode.Configuration.ConfigurationManager, SourceCode.Framework, 
        Version=4.0.0.0, Culture=neutral, PublicKeyToken=16a2c5aaaa1b130d" />
</configSections>

<sourcecode.configuration
   managerConfigFile="[SOURCECODECOMMONAPPDATA]ConfigurationManager.config"
   productPath="[INSTALLDIR]Bin"
   templateConfigFile="" />

<connectionStrings>
    <add
        name="HostServer"
        connectionString="Integrated=True;IsPrimaryLogin=True;Authenticate=True;
        EncryptedPassword=False;Host=[HOSTSERVERNAME];Port=[HOSTSERVERPORT]"
        providerName="[LICENSEDPRODUCT]" />
<connectionStrings>


Here is an example of the configuration taken from a Denallix environment:

 

<configuration>
    <configSections>
          <section
              name="sourcecode.configuration"
              type="SourceCode.Configuration.ConfigurationManager, SourceCode.Framework, 
              Version=4.0.0.0, Culture=neutral, PublicKeyToken=16a2c5aaaa1b130d" />
    </configSections>

    <sourcecode.configuration
        managerConfigFile="C:\Program Files (x86)\K2 blackpearl\Configuration\ConfigurationManager.config"
        productPath="C:\Program Files (x86)\K2 blackpearl\Bin"
        templateConfigFile="" />

    <connectionStrings>
        <add
           name="HostServer"
           connectionString="Integrated=True;IsPrimaryLogin=True;Authenticate=True;
           EncryptedPassword=False;Host=dlx;Port=5555"
           providerName="K2BLACKPEARL" />
    </connectionStrings>
</configuration>