Skip to main content
Kofax

Install ComposerUI for ASP.NET

Article # 3025059 - Page views: 126

Summary

The manual for installing ComposerUI for ASP.NET is outdated. This How-To article contains the updated steps for installing ComposerUI for ASP.NET.

Prequisites

The following Windows Server features must be installed:clipboard_ea595341fc47cf3779371a04a2d725de3.png

  • .NET Framework 3.5 Features -> .NET Framework 3.5 (includes .NET 2.0 and 3.0).
  • .NET Framework 4.x Features -> .NET Framework 4.x

The following Windows Server role with features must be installed:

  • Web Server (IIS)
    • Web Server (IIS) -> Web Server -> Application Development -> ASP.NET 4.x
    • Web Server (IIS) -> Web Server -> Authentication -> URL Authorization
    • Web Server (IIS) -> Web Server -> Authentication -> Windows Authentication

 

 

 

Installation

01). Run as administrator the installer from ..\KCM\Programs\<version>\Legacy Installers\ITPOnlineASP.NET.exe
02). Click Next.
03). Choose the ComposerUI applications folder location and click Next.
04). Choose the ComposerUI virtual directory name and ComposerUI virtual directory physical path and click Next.
05). Choose the ComposerUI public directory name and ComposerUI public directory physical path and click Next.
06). Click Next to start the installation.
07). Click Finish to close the installer.

Post-installation

Note: The installer from KCM 5.4 and higher is affected by a defect. If you are using KCM 5.4 or higher,  then first follow the instructions from this KB Article (link) before proceeding.

Set file system permissions

The following file permissions must be set. The default locations for the mentioned locations are:
ComposerUI virtual directory: C:\inetpub\wwwroot\itp
ComposerUI public directory: C:\inetpub\wwwroot\itppublic
ComposerUI applications folder: C:\ITPOnLineApps
ComposerUI log folder: C:\ITPOnLineApps\itplog
ComposerUI sessiondata: C:\ITPOnLineApps\sessiondata

Location Account Permission type
ComposerUI virtual directory Administrators Full Control
  IIS_IUSRS Read & Execute
  IUSR Read & Execute
  NETWORK SERVICE Read & Execute
  Users Read & Execute
ComposerUI public directory Administrators Full Control
  IIS_IUSRS Modify
  IUSR Read & Execute
  NETWORK SERVICE Modify
  Users Read & Execute
ComposerUI applications folder Administrators Full Control
  Users None
ComposerUI log folder Administrators Full Control
  NETWORK SERVICE Modify
  Users None
ComposerUI sessiondata Administrators Full Control
  NETWORK SERVICE Modify
  Users None

 

Convert virtual directory to an application clipboard_e96be578ca90ffa543bcaf5c2f251ac7d.png

01). Open IIS Manager.
02). Right click the virtual directory and click “Convert to application” .
03). Set the application pool .NET v.4.x Classic.
04). Close the dialog.

Configure the application pool

01). Open IIS Manager.
02). Go to application pools.
03). ”Select “.NET v4.x Classic” and click Advanced to open the advanced properties.
04). Under “Process Model” ,change Identity to built-in account: NETWORK SERVICE.
05). Under “Process Model”, change Idle Time-out (minutes) to 0.
06). Close the dialog.
07). Under “Edit Application Pool” click Recycling… (while the application pool .NET v4.5x Classic is still selected).
08). Deselect “Regular time intervals (in minutes):”.
09). Tick “Specific time(s):” and enter a time outside business hours when no users are using ComposerUI for ASP.NET. For example 23:00.
10. Click next and subsequently click finish.

Configure feature delegation

1). Open IIS Manager.
2). In the Connections panel on the left-hand side, select the element that represents the entire web server.
3). In the middle panel, double click Feature Delegation to open the Feature Delegation configuration page.

clipboard_e5fff0ce603e35a5e51e343fb988dee09.pngclipboard_ef5b1aeaaa68def1ad6fb73eba104f150.png

Configure ComposerUI

01). Go to the ComposerUI applications folder (default C:\ITPOnlineApps).
02). Extract the contents of NewSample.zip to Newsample (C:\ITPOnlineApss\NewSample)
02). Run Internet Explorer as administrator.
03). Open http://localhost/itp/configure.aspx. If you changed the virtual directory name from itp to something else, then you must replace itp with the different virtual directory name.
Note: This page can only be opened when internet explorer is opened as administrator.
04). Optionally, if KCM is installed on a different machine, change ITP/Server Host to the hostname of the KCM server. Otherwise you can use localhost.
05). Change ITP/Server port to 3003 for instance 1. If you want to use a different KCM instance, then you can use the following formula. 3001 + (2 x instance number).
E.g. for instance 3. 3001 + ( 2 x 3 ) = 3007.
06). Click Submit to save the new settings and click continue.
07). In the application name text box at the bottom of the page enter “NewSample” (without quotes).
08). Click Submit to save the new settings and click continue.
09). Click on the link Deploy located on the right of NewSample.
10). You have finished the post-configuration.

Test the installation

You can use the following URL for testing the installation.
http ://localhost/itp/app/newsample/modelbegin.aspx?model=<rep uri>

For testing document template Example Letter DKC Blue from project InstallationTest (rep%3A//localhost:2587/documenttemplate/installationtest/example letter dkc blue):
http ://localhost/itp/app/newsample/modelbegin.aspx?model=rep%3A//localhost:2587/documenttemplate/installationtest/example%20letter%20dkc%20blue

  • Was this article helpful?