Configuration for KCM ComposerUI ASP.NET

Some configuration settings of KCM ComposerUI ASP.NET edition are not available through the generic configuration pages. However, they can be specified using the web.config file, which resides in the IIS virtual directory of KCM ComposerUI ASP.NET.

Virtual directory location is configured during the installation. Default is C:\Inetpub\wwwroot\itp.

The configuration file is an XML document, and the KCM ComposerUI ASP.NET configuration settings are stored in the XML element <appSettings>, like shown below:

<?xml version="1.0" encoding="UTF-8"?> 
<configuration xmlns="http://schemas.microsoft.com/.NetConfiguration/v2.0">
  <appSettings>
    <add key="itp_log_dir" value="C:\ITPOnLineApps\itplog" />
    <add key="itp_temp_dir" value="C:\ITPOnLineApps\sessiondata" />
    <add key="itp_applications_dir" value="C:\ITPOnLineApps" />
    <add key="itp_log_count" value="10" />
    <add key="itp_max_log_size_kb" value="1024" />
  </appSettings>
<!-- ... -->
</configuration>

The following table describes these configuration settings.

Setting

Description

itp_log_dir

The folder where KCM ComposerUI ASP.NET stores its log files. In a default installation, this is the itplog subfolder of the KCM ComposerUI application folder.

If this setting is changed to a different folder, then the permissions described in the KCM Installation Guide must be applied to that folder, too. It is also recommended to remove the permissions from the old folder when they are no longer needed.

itp_temp_dir

The folder where KCM ComposerUI ASP.NET stores its temporary files and its session information. In a default installation, this is the subfolder sessiondata of the KCM ComposerUI application folder.

If this setting is changed to a different folder, then the permissions described in the KCM Installation Guide must be applied to that folder, too. It is also recommend to remove the permissions from the old folder when they are no longer needed.

itp_applications_dir

The KCM ComposerUI applications folder. Subfolders of this folder contain the sources of the custom applications installed in KCM ComposerUI ASP.NET.

If this setting is changed to a different folder, then the permissions described in the KCM Installation Guide must be applied to that folder, too. It is also recommended to remove the permissions from the old folder when they are no longer needed.
itp_public_dir Specifies the folder of the virtual directory in IIS, which is used to store resources (previews, results) during a composition run.
itp_public_uri Specifies the name of the virtual directory in IIS, which is used to expose the resources (previews, results) during a composition run.

itp_log_count

The maximum number of old log files that KCM ComposerUI ASP.NET retains.

Default value is 10.

itp_max_log_size_kb

The size (in KB) that an KCM ComposerUI ASP.NET log file may reach before it is archived as an old log file.

Default is 1024 KB.

secure_mode_public_files

This value is set automatically at the installation and should not be changed. It refers to the following file types:

*.js;*.aspx;*.png;*.gif;*.jpg;*.htm;*.html;*.css

After running the CompuserUI for ASP.NET installer, some settings in web.config file may not have the expected values specified during the installation (the placeholders will be included instead). So, you need to set these values in web.config manually, like shown below:
  • itp_log_dir - to C:\ITPOnLineApps\itplog
  • itp_temp_dir - to C:\ITPOnLineApps\sessiondata
  • itp_applications_dir - to C:\ITPOnLineApps
  • itp_public_dir - to C:\inetpub\wwwroot\itppublic
  • itp_public_uri - to itppublic