Test Kofax Capture Network Server Web Server Using a Web Browser

Issue

How can I test Kofax Capture Network Server web server using a Web browser?

 

Solution

The following URL has various parameters that can be used for troubleshooting purposes:

http://<host>/acis/config.acis?config=

where <host> = the Web server name or IP Address for Kofax Capture Network Server

The parameters are represented by the following:

•   =debug
  • This returns information that indicates whether ASP.NET is properly registered with MS IIS
•   =service 
  • This returns the KCN service(s) that are installed. If multiple services are installed, they will be cycled through as the page is refreshed.
•   =cache 
  • This returns the folder cache internal identification number. The expected value is ‘0’. If there are multiple cache folders, they will be cycled through as the page is refreshed. For example, if there are three folders, ‘0’ will be displayed in the browser, then ‘1’, and then ‘2’ as the page is refreshed.
•   =version
  • This returns the version of the Web server to determine compatibility
•   =write
  • Uses the IIS worker thread credentials to write a file to the Upload folders

 

When these URL’s fail to load or give proper response codes as expected, the Kofax Capture Network Server web server configuration or installation issues could be indicated and need to be investigated further.

URL Example:

http://<host>/acis/config.acis?config=service

Note: When SSL is enabled, the above URL would include https in place of http, as in:https://<host>/acis/config.acis?config=service

All config.acis? commands are handled by the Kofax Capture Network Server configured web Server component, running on the Web Server machine, and not by the Kofax Capture Network Service.

The config=cache command reads the web.config file to determine the number of the file cache folders configured in IIS. Then it validates the path and returns the next available file cache folder.

The config=service returns the next available Kofax Capture Network Service. The Kofax Capture Network Service web server component reads the flag files written by the Kofax Capture Network Services in the file cache folders and finds the next available and valid service, which is then  returning its location. This test performs a read in the KCNS\Services folder to find the servers that are configured with the KCN service.

The config=debug command returns useful information about the current HTTP connection and ASP.NET settings.

Sample output of the various commands:

• http://<host>/acis/config.acis?config=debug
  • http://localhost:2424/
  • Connection Limit: 2147483647
  • ConnectionName: http
  • CurrentConnections: 0
  • IdleSince: 7/7/2021 1:41:30 PM
  • MaxIdleTime: 100000
  • ProtocolVersion: 1.1
  • SupportsPipelining: True
  • ConnectionGroupName:
  • ThreadPool.GetMaxThreads: Worker 32767 CompletionPort 1000
  • ThreadPool.GetAvailableThreads: Worker 32766 CompletionPort 1000
  • Current User: Current Windows identity: domain\Administrator

• http://<host>/acis/config.acis?config=service
  • http://<HOST>:2424

• http://<host>/acis/config.acis?config=cache
  • 0

• http://<host>/acis/config.acis?config=version
  • ACI Server component version: 11.1.0.0.0.459
• http://<host>/acis/config.acis?config=write
  • Current user account: domain\Administrator
  • Write test successful for all file caches.

Level of Complexity 

Easy

 

Applies to  

Product	Version	Build	Environment	Hardware
Kofax Capture Network Server	11.x

References

10015

​