Configuration file consolidation in K2 blackpearl 4.6.9
KB001637
PRODUCT
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 blackpearlHost ServerBin 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 ServerBin |
| DiscoveryService.config | ..Host ServerBin |
| SourceCode.Categories.Runtime.config | ..Host ServerBin |
| SourceCode.EnvironmentServices.Server.config | ..Host ServerBin |
| SourceCode.EnvironmentSettings.Runtime.config | ..Host ServerBin |
| SourceCode.EventBus.Assemblies.config | ..Host ServerBin |
| SourceCode.EventBus.ClientRecorder.dll.config | ..Host ServerBin |
| SourceCode.EventBus.ClientRecorder.dll.config | ..WebServicesSP15EventServiceBin |
| SourceCode.EventBus.Deployment.dll.config | ..Bin |
| SourceCode.EventBus.EventAdmin.dll.config | ..Host ServerBin |
| SourceCode.EventBus.EventAssemblies.dll.config | ..Host ServerBin |
| SourceCode.EventBus.ManagementServer.config | ..Host ServerBin |
| SourceCode.EventBus.Mapping.dll.config | ..Host ServerBin |
| SourceCode.EventBus.Scheduler.ManagementServer.config | ..Host ServerBin |
| SourceCode.EventBus.Scheduler.Server.config | ..Host ServerBin |
| SourceCode.EventBus.Server.config | ..Host ServerBin |
| SourceCode.EventBus.Server.MessageQueueHelper.dll.config | ..Host ServerBin |
| SourceCode.SmartObjects.Runtime.config | ..Host ServerBin |
| SourceCode.SmartObjects.Runtime.config | ..ServiceBroker |
| SourceCode.Workflow.Runtime.Management.config | ..Host ServerBin |
| SourceCode.Workspace.Runtime.config | ..Host ServerBin |
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 blackpearlConfigurationConfigurationManager.config"
productPath="C:Program Files (x86)K2 blackpearlBin"
templateConfigFile="" />
<connectionStrings>
<add
name="HostServer"
connectionString="Integrated=True;IsPrimaryLogin=True;Authenticate=True;
EncryptedPassword=False;Host=dlx;Port=5555"
providerName="K2BLACKPEARL" />
</connectionStrings>
</configuration>
