Kofax Process Director 7.9 Configuration Guide

PROCESS DIRECTOR

Web Application Configuration Guide

Version: 7.4

Date: 2017-11-15

Kofax is a trademark of Kofax, Inc., registered in the U.S. and/or other countries. All other trademarks are the property of

their respective owners. No part of this publication may be reproduced, stored, or transmitted in any form without the

prior written permission of Kofax.

Table of Contents

About this guide ........................................................................................................................................ 11

Deploying the Web Application ............................................................................................................... 12

Architecture overview .............................................................................................................................. 13

Hardware requirements ........................................................................................................................... 13

Software requirements ............................................................................................................................ 14

Tested environments ............................................................................................................................... 15

Installation files ........................................................................................................................................ 16

Renaming the Web Application ............................................................................................................... 16

Deploying to Tomcat ................................................................................................................................ 17

Deploying to SAP NetWeaver Application Server ................................................................................... 17

Deploying to SAP NetWeaver Application Server JAVA <= 7.0 .......................................................... 17

Deploying to SAP NetWeaver Application Server JAVA >= 7.1 .......................................................... 18

Deploying multiple applications ............................................................................................................... 18

Renaming the applications .................................................................................................................. 19

Deploying the first application .............................................................................................................. 19

Deploying the second application ........................................................................................................ 19

Adjusting the memory pool for Java ........................................................................................................ 19

Increasing the number of connections .................................................................................................... 20

File and folders ........................................................................................................................................ 22

Configuration files ................................................................................................................................ 22

Specifying the location of pdweb-app.properties ................................................................................. 22

Upgrading ................................................................................................................................................ 23

Upgrading from version 7.1 and later .................................................................................................. 23

Upgrading from version 3.2 and earlier ............................................................................................... 24

Connecting to SAP systems .................................................................................................................... 26

Connection method ................................................................................................................................. 26

Configuration file ...................................................................................................................................... 26

Parameters .......................................................................................................................................... 26

Connecting to an SAP application server ................................................................................................ 27

Connecting to multiple application servers .............................................................................................. 28

Connecting to an SAP message server .................................................................................................. 28

Accessing multiple servers in one Worklist ............................................................................................. 29

Configuration file .................................................................................................................................. 29

Parameters .......................................................................................................................................... 29

Providing multiple Worklist configurations ............................................................................................... 29

SSO and external authentication ............................................................................................................. 30

Single Sign On (SSO).............................................................................................................................. 31

MySAP SSO2 ticket ............................................................................................................................. 31

Windows NT LAN Manager ................................................................................................................. 31

X.509 Client Certificate ........................................................................................................................ 33

External authentication services .............................................................................................................. 35

MSADAuthService ............................................................................................................................... 35

NovellAuthService................................................................................................................................ 37

LDAPSearchAndBind .......................................................................................................................... 37

External authentication with OpenSSO ............................................................................................... 40

Other authentication services .............................................................................................................. 42

Common configuration tasks .................................................................................................................. 42

Setting the display language ................................................................................................................... 43

Parameters .......................................................................................................................................... 43

Enabling users to edit their profiles ......................................................................................................... 44

Parameters .......................................................................................................................................... 44

Configuring user settings ......................................................................................................................... 45

Use Messages.properties keys ............................................................................................................ 45

Examples ............................................................................................................................................. 46

Enabling workflow recall for AP ............................................................................................................... 48

Creating your own buttons ...................................................................................................................... 48

Procedure ............................................................................................................................................ 48

Example ............................................................................................................................................... 49

Custom user searches (PD AP only) ....................................................................................................... 50

Customizing user searches ................................................................................................................. 51

Interface to search Email users ........................................................................................................... 51

Using another search function ............................................................................................................. 52

Adding a Help link .................................................................................................................................... 52

PROCESS DIRECTOR appearance .......................................................................................................... 54

Themes .................................................................................................................................................... 54

CSS ...................................................................................................................................................... 54

Print CSS ............................................................................................................................................. 54

Logos ................................................................................................................................................... 54

Other images ....................................................................................................................................... 55

Attachments display ................................................................................................................................ 55

Suppressing node counters ..................................................................................................................... 56

Number of rows displayed in tables ........................................................................................................ 56

File format conversion ............................................................................................................................. 57

Requirements ....................................................................................................................................... 57

Parameters .......................................................................................................................................... 57

Administration tools and logs ................................................................................................................. 58

Logs ......................................................................................................................................................... 58

Web server log files ............................................................................................................................. 58

SAP log files ......................................................................................................................................... 58

Administrator mode ................................................................................................................................. 59

Initial configuration ................................................................................................................................... 59

Configuration files .................................................................................................................................... 60

Parameter syntax and path notation ....................................................................................................... 61

pdweb-app.properties .............................................................................................................................. 61

accounting.copy.FIELD (PD AP only) .................................................................................................. 61

accounting.modifycount (PD AP only) ................................................................................................. 61

accounting.preset (PD AP only) ........................................................................................................... 62

accounting.preset.STEPID (PD AP only) ............................................................................................ 62

addlanguages ...................................................................................................................................... 62

administratorN ...................................................................................................................................... 63

autodetailmode (PD AP only) .............................................................................................................. 63

browserlocale ....................................................................................................................................... 63

createtaxes (PD AP only) .................................................................................................................... 64

csvDownloadList .................................................................................................................................. 64

editmasterdata ..................................................................................................................................... 65

editpassword ........................................................................................................................................ 65

editpersonalsettings ............................................................................................................................. 65

editprofile ............................................................................................................................................. 66

editprofilesap ........................................................................................................................................ 66

editsubstitutes ...................................................................................................................................... 66

editusercustfields (PD AP only) ........................................................................................................... 66

extsearch.default.................................................................................................................................. 67

extsearch.STEPID ............................................................................................................................... 67

formspath (PD AP only) ....................................................................................................................... 67

helpconfig ............................................................................................................................................. 67

history.attachfile (PD AP only) ............................................................................................................. 68

history.onlyapprovals (PD AP only) ..................................................................................................... 68

history.stateselection (PD AP only) ..................................................................................................... 68

ignorefieldstateinlist (PD AP only) ....................................................................................................... 69

imageattach (PD AP only) ................................................................................................................... 69

imageattach.STEPID (PD AP only) ..................................................................................................... 69

imageconvertjpg (Web Service only) ................................................................................................... 70

imageconvertpdf .................................................................................................................................. 70

imageconvertpdf.permissions .............................................................................................................. 70

imageconvertpng (Web Service only) .................................................................................................. 71

imageinlist (PD AP only) ...................................................................................................................... 71

invoice.createatonce (PD AP only) ...................................................................................................... 71

languages ............................................................................................................................................ 72

languageselection ................................................................................................................................ 72

lineitems.editable (PD AP only) ........................................................................................................... 72

lineitems.modifycount (PD AP only) .................................................................................................... 73

logconfig ............................................................................................................................................... 73

loginheader .......................................................................................................................................... 73

logo ...................................................................................................................................................... 74

logoff_redirect_url ................................................................................................................................ 74

logoheight ............................................................................................................................................ 74

maxresult.search.................................................................................................................................. 75

messageconfig ..................................................................................................................................... 75

multiaccounting.check ......................................................................................................................... 76

multiaccounting.check.STEPID ........................................................................................................... 76

multiprocessing.approve ...................................................................................................................... 76

multiprocessing.approve.checksteps ................................................................................................... 77

multiprocessing.forward ....................................................................................................................... 77

multiprocessing.forward.checksteps .................................................................................................... 77

multiprocessing.reject .......................................................................................................................... 78

multiprocessing.reject.checksteps ....................................................................................................... 78

multiprocessing.substitution ................................................................................................................. 78

normaltimeout ...................................................................................................................................... 78

ntlmauthenticate................................................................................................................................... 79

ntlmauthenticate.error .......................................................................................................................... 80

pd_attachment_list_minimized ............................................................................................................ 80

pd_bg_search_def ............................................................................................................................... 81

pd_client_download_url ....................................................................................................................... 82

pd_date_format .................................................................................................................................... 82

pd_doc_navigate.................................................................................................................................. 83

pd_extended_search ........................................................................................................................... 83

pd_field_help_delay ............................................................................................................................. 84

pd_filter_list .......................................................................................................................................... 85

pd_formats_from_sap .......................................................................................................................... 85

pd_group_message ............................................................................................................................. 86

pd_header_display_mode ................................................................................................................... 86

pd_help_icon_pos ................................................................................................................................ 87

pd_ics_only_quickstart (PD AP only)................................................................................................... 87

pd_ignore_att_url (Web Service only) ................................................................................................. 88

pd_imagedocking_width ...................................................................................................................... 88

pd_initialsplit ........................................................................................................................................ 88

pd_message_mode ............................................................................................................................. 88

pd_node_counters ............................................................................................................................... 89

pd_notes_in_detail ............................................................................................................................... 89

pd_number_format............................................................................................................................... 89

pd_page_size_list ................................................................................................................................ 90

pd_page_size_hdr_table ..................................................................................................................... 90

pd_page_size_search .......................................................................................................................... 90

pd_page_size_table ............................................................................................................................. 91

pd_print_full_text.................................................................................................................................. 91

pd_print_page ...................................................................................................................................... 91

pd_search_on_change ........................................................................................................................ 92

pd_searchhelpkey ................................................................................................................................ 92

pd_select_last_node ............................................................................................................................ 93

pd_select_mode................................................................................................................................... 93

pd_show_last_note .............................................................................................................................. 94

pd_show_old_messages ..................................................................................................................... 94

pd_show_tif_embedded ....................................................................................................................... 95

pd_skip_selection_screen ................................................................................................................... 95

pd_subtable_first.................................................................................................................................. 95

pd_suggest_jpa.................................................................................................................................... 96

pd_suggest_mode ............................................................................................................................... 96

pd_text_search_key ............................................................................................................................. 97

pd_user_profile_as_node .................................................................................................................... 98

pd_user_settings.................................................................................................................................. 98

pd_warning_new_version .................................................................................................................... 98

pdap_mark_unread (PD AP only) ........................................................................................................ 98

pdap_show_processed ........................................................................................................................ 99

pdap_use_pd_field_names (PD AP only) ............................................................................................ 99

pluginconfig .......................................................................................................................................... 99

portalmode ........................................................................................................................................... 99

profile.department.editable ................................................................................................................ 100

profile.phone.editable ........................................................................................................................ 100

saplogconfig ....................................................................................................................................... 100

saplogging .......................................................................................................................................... 101

saplogonconfig ................................................................................................................................... 101

showimagebutton ............................................................................................................................... 101

showlastlogin ..................................................................................................................................... 102

showlinks ........................................................................................................................................... 102

showtaxes (PD AP only) .................................................................................................................... 102

sso-cookiename ................................................................................................................................. 103

template.createfrom (PD AP only) ..................................................................................................... 103

template.save (PD AP only) ............................................................................................................... 103

theme.pdweb ..................................................................................................................................... 103

undo (PD AP only) ............................................................................................................................. 104

upload.html.pdfconverter ................................................................................................................... 104

userformat.profile ............................................................................................................................... 104

userformat.workflow.status (PD AP only) .......................................................................................... 105

userpriority ......................................................................................................................................... 105

wb_create (PD AP only) .................................................................................................................... 105

wcallowsapsubst ................................................................................................................................ 106

wintitle ................................................................................................................................................ 106

xss_security_header.n ....................................................................................................................... 106

saplogon.properties ............................................................................................................................... 106

sapsystem .......................................................................................................................................... 106

sysid.activate ..................................................................................................................................... 106

sysid.ashost ....................................................................................................................................... 107

sysid.client ......................................................................................................................................... 107

sysid.ext_auth_svc............................................................................................................................. 107

sysid.ext_search ................................................................................................................................ 107

sysid.group ......................................................................................................................................... 107

sysid.jcotrace ..................................................................................................................................... 107

sysid.lang ........................................................................................................................................... 107

sysid.maxconnections ........................................................................................................................ 107

sysid.msghost .................................................................................................................................... 108

sysid.passwd ...................................................................................................................................... 108

sysid.sso ............................................................................................................................................ 108

sysid.ssouser ..................................................................................................................................... 108

sysid.sysnr ......................................................................................................................................... 108

sysid.system ...................................................................................................................................... 109

sysid.user ........................................................................................................................................... 109

log.properties ......................................................................................................................................... 109

Sample log entry ................................................................................................................................ 109

appName ........................................................................................................................................... 109

dailyFile .............................................................................................................................................. 110

dateFormat ......................................................................................................................................... 110

host .................................................................................................................................................... 110

level .................................................................................................................................................... 110

logDir .................................................................................................................................................. 111

logName ............................................................................................................................................. 111

separator ............................................................................................................................................ 111

showDate ........................................................................................................................................... 111

timeFormat ......................................................................................................................................... 111

log4sap.properties ................................................................................................................................. 112

plugin_configuration.properties ............................................................................................................. 112

PDDataProvider ................................................................................................................................. 112

OtherPool_1 ....................................................................................................................................... 112

OtherPool_16 ..................................................................................................................................... 112

icon_mapping.properties ....................................................................................................................... 112

mimetypes.properties ............................................................................................................................ 113

Messages.properties ............................................................................................................................. 113

customer_buttons.properties ................................................................................................................. 114

Syntax ................................................................................................................................................ 114

Parameters ........................................................................................................................................ 114

help_configuration.properties ................................................................................................................ 116

user_settings.xml ................................................................................................................................... 117

_default.json .......................................................................................................................................... 118

connections ........................................................................................................................................ 119

authConfig .......................................................................................................................................... 121

displayMode ....................................................................................................................................... 121

systemWorklistconfigs ....................................................................................................................... 122

tenants.properties .................................................................................................................................. 123

Appendix A - Windows and SSO ........................................................................................................... 124

Requirements ........................................................................................................................................ 124

Procedure .............................................................................................................................................. 124

Installing IIS ........................................................................................................................................... 125

Copying Tomcat files to IIS ................................................................................................................... 127

Creating Tomcat files for IIS SSO ......................................................................................................... 128

jk2.properties ..................................................................................................................................... 129

server.xml .......................................................................................................................................... 129

uriworkermap.properties .................................................................................................................... 130

workers.properties ............................................................................................................................. 130

Registry entries for Windows 2003 ........................................................................................................ 131

Configuring ntlmauthenticate to use IIS ................................................................................................ 131

Configuring IIS ....................................................................................................................................... 131

Add an ISAPI Restriction ................................................................................................................... 132

Add an ISAPI Filter ............................................................................................................................ 133

Create virtual directories .................................................................................................................... 134

SSO configuration for Windows 7 users................................................................................................ 136

Internet Explorer ................................................................................................................................ 136

Windows 7 ......................................................................................................................................... 136

SSO configuration for Firefox users ...................................................................................................... 137

Appendix B – JRE, Tomcat & JCo ......................................................................................................... 138

Overview ................................................................................................................................................ 138

Installing Java Runtime Environment .................................................................................................... 138

Installing Tomcat ................................................................................................................................... 139

Installing SAP Java Connector .............................................................................................................. 140

Installation .......................................................................................................................................... 140

Appendix C - Troubleshooting .............................................................................................................. 142

PROCESS DIRECTOR 7.4 Web Application Configuration Guide

11

About this guide

This guide describes how to deploy and configure the PROCESS DIRECTOR Web Application. It

assumes you are already familiar with the general concepts and basic use of PROCESS DIRECTOR.

The guide contains the following chapters:

 Deploying the Web Application

Lists the system requirements, describes the configuration files, and explains how to deploy the

PROCESS DIRECTOR Web Application to Tomcat and SAP NetWeaver Application Server.

 Connecting to SAP systems

Explains how to connect to one or more SAP application servers, as well as to an SAP message

server.

 SSO and external authentication

Explains the two authentication options available for logging on to the Web Application: using Single

Sign On (SSO) or an external authentication system.

 Common configuration tasks

Explains some of the most common tasks you normally perform after deploying the Web Application.

 PROCESS DIRECTOR appearance

Looks at the different ways you can change the PROCESS DIRECTOR user interface, such as

changing themes and text strings.

 Administration tools and logs

Provides important information for administrators of the PROCESS DIRECTOR Web Application.

 Configuration files

Explains all the settings in the PROCESS DIRECTOR Web Application, including those in the main

configuration file, pdweb-app.properties.

 Appendix A - Windows and SSO

Instructions for configuring your system to enable automatic logon to the PROCESS DIRECTOR Web

Application using the logon credentials of the current Windows user ("Single Sign-On").

 Appendix B – JRE, Tomcat & JCo

Instructions for installing the Java Runtime Environment (JRE), Apache Tomcat, and the SAP Java

Connector (SAP JCo).

PROCESS DIRECTOR 7.4 Web Application Configuration Guide

12

Deploying the Web Application

 Architecture overview

 Hardware requirements

 Software requirements

 Tested environments

 Installation files

 Renaming the Web Application

 Deploying to Tomcat

 Deploying to SAP NetWeaver Application Server

 Deploying multiple applications

 Adjusting the memory pool for Java

 Files and folders

 Upgrading

Examples in this guide use Apache Tomcat as the Web Application server. Although other Web

Application servers can be used, Tomcat is the recommended server and provides the best default

behavior for the PROCESS DIRECTOR Web Application.

The PROCESS DIRECTOR Web Application only works if PROCESS DIRECTOR is installed. See the

guide Importing PROCESS DIRECTOR into SAP for instructions on installing PROCESS DIRECTOR.

For performance reasons, we do not recommend using the Web Application for documents with more

than 100 line items. Such documents should be processed in the SAP GUI only.

PROCESS DIRECTOR 7.4 Web Application Configuration Guide

13

Architecture overview

The PROCESS DIRECTOR Web Application is part of a larger solution. The following diagram illustrates

the architecture of a typical solution and the place of the PROCESS DIRECTOR Web Application within it.

Note that PROCESS DIRECTOR also resides in SAP, as well being a Web Application.

Hardware requirements

The PROCESS DIRECTOR Web Application should run on its own server. Installation on systems

running other applications is also possible, as well as installation on a Virtual Machine.

The following table lists the minimum hardware requirements.

Item

Requirement

RAM

About 30 MB per concurrent user session are recommended. Thus, if 100 users are logged on

simultaneously, you can expect memory usage of around 3 GB.

For information about support for mobile devices, please contact your local Lexmark Enterprise Software

representative or Enterprise Software Support.

PROCESS DIRECTOR 7.4 Web Application Configuration Guide

14

Software requirements

The following table lists the recommended software as well as the minimum requirements:

Item

Recommendation

Minimum requirement

Operating system

Windows 7

Windows 2012 Server

Windows Server 2008 or 2008

R2

Windows Server 2003

Any operating system supported by the other

software components below.

Web browser

(No recommendation)

Internet Explorer, versions 10 and 11

Microsoft Edge

Mozilla Firefox, version 3 and higher

Safari, version 4 and higher

Google Chrome

Java Runtime

Environment (JRE)

JRE 7

JRE 8

JRE 6

Web application server

Apache Tomcat 6.0

Apache Tomcat 7.0

Apache Tomcat 8.0 (with JRE 7

or 8)

Apache Tomcat 9.0 (with JRE 7

or 8)

SAP NetWeaver CE version 7.3

or higher

J2EE compatible

Java Servlet 2.4

Java Server Pages (JSP) 2.0

Java Connector (JCo)

3.0 (see Using JCo 3.0)

2.1.10

Important: The parameter pd_suggest_jpa must be set to no for NetWeaver installations.

Notes:

 If using a 64bit version of JRE, the other components must also be 64bit.

 The PROCESS DIRECTOR Web Application only works if PROCESS DIRECTOR is installed. See

the Importing PROCESS DIRECTOR into SAP for instructions on installing PROCESS DIRECTOR.

PROCESS DIRECTOR 7.4 Web Application Configuration Guide

15

Using JCo 3.0

With JCo3, if you deploy several instances of the Web Application on Tomcat, only the first instance that

connects to JCo3 after restarting Tomcat will work. This also applies if you deploy one instance of the

PROCESS DIRECTOR Web Application together with other web applications such as MOBILE

APPROVAL and INFO MAIL. If you wish to use multiple instances or web applications, you must move

the jcolayer library to the Tomcat main library folder and remove it from all Web Application library folders.

1. Deploy all instances of the Web Application(s) that you wish to use.

2. Start Tomcat.

3. After the WAR files are unpacked, go to the Tomcat/webapps/pdweb-app/WEB-INF/lib folder of the

newest Web Application and copy the jcolayer*.jar file to the Tomcat/lib folder (the name of this file

may vary; for example, it could be jcolayerB030204.jar or jcolayer-1.0-SNAPSHOT.jar).

4. Remove the jcolayer*.jar file from the Tomcat/webapps/pdweb-app/WEB-INF/lib folder of all deployed

Web Application instances.

5. Restart Tomcat.

Note: When using JCo 3.0, the maximum number of SAP connections specified in the

saplogon.properties file is not multiplied by 10 internally (unlike in JCo 2, where maxconnections=10

actually means 100).

Tested environments

Note: All tests with our web applications are performed within Microsoft Windows environments only.

Item

Tested with

Operating system

 Windows 7

 Windows Server 2008 R2, 2008 and 2003

 SUSE Linux Enterprise Server 11.4

Java Runtime Environment (JRE)

 Java 6 (JRE 6)

 Java 7 (JRE 7)

 Java 8 (JRE 8)

Web application server

 Apache Tomcat 6.0

 Apache Tomcat 7.0

 Apache Tomcat 8.0 (with Java 7 or 8)

 Apache Tomcat 9.0 (with Java 7 or 8)

SAP Java Connector (JCo)

 2.1.10

 3.0

PROCESS DIRECTOR 7.4 Web Application Configuration Guide

16

Installation files

The PROCESS DIRECTOR Web Application is a Java Web Application. The files you need depend on

the Web Application server.

Web server

File

Description

Apache Tomcat

pdweb-app.war

The PROCESS DIRECTOR Web

Application.

wcconfig.war

Configuration files.

SAP NetWeaver

pdweb-app.ear

Contains pdweb-app.war and some

configuration files in the META-INF folder.

wcconfig.ear

Configuration files.

These files are sent as ZIP files and are password protected (to ensure they are not blocked by email

server protection filters). The password is readsoft.

Renaming the Web Application

You can rename the Web Application in order to:

 Have a different URL.

The path after the server name can be changed.

Example: http://localhost:8080/newname/init.do

 Deploy more than one Web Application on the same machine.

To rename the Web Application:

1. Rename the pdweb-app.war file (that is, before deploying it!)

Example: pdweb-app_TEST.war.

2. Deploy the Web Application.

Two folders are created: One with the new name (for example, pdweb-app_TEST) and wcconfig.

3. Rename the pdweb-app.properties file in the ../webapps/wcconfig/ folder.

Important! The name must be the same as the renamed WAR file.

Example: pdweb-app_TEST.properties.

4. Rename the pdweb-app folder in the ../webapps/wcconfig/ folder.

Important! The name must be the same as the renamed WAR file.

Example: pdweb-app_TEST.

PROCESS DIRECTOR 7.4 Web Application Configuration Guide

17

Deploying to Tomcat

1. Stop Tomcat (if it is running).

2. Place pdweb-app.war and wcconfig.war in the ../Tomcat/webapps/ folder.

3. Start Tomcat.

Tomcat decompresses the WAR files to two new folders: pdweb-app and wcconfig.

Deploying to SAP NetWeaver Application Server

Deploying to SAP NetWeaver Application Server JAVA <= 7.0

It is recommended to use the SAP Software Deployment Manager (SDM) to deploy the PROCESS

DIRECTOR Web Application.

1. Run RemoteGui.bat to start SDM.

The file is located in the c:\usr\sap\<instance_id>\JC00\SDM\program\ folder.

2. Connect to your SDM server.

3. In the Deployment tab, add the two PROCESS DIRECTOR EAR files.

Click the Add button and select pdweb-app.ear and wcconfig.ear.

4. Deploy the EAR files.

1. Click the Next button twice until you reach the Step 3 of 4 screen.

2. Click the Start button to start the deployment.

PROCESS DIRECTOR 7.4 Web Application Configuration Guide

18

5. Click the Confirm button to finish the deployment.

This button appears after the Web Application has been successfully deployed.

Important: Do not use the parameter pd_suggest_jpa=yes for NetWeaver installations.

Deploying to SAP NetWeaver Application Server JAVA >= 7.1

To deploy the PROCESS DIRECTOR Web Application to SAP Netweaver JAVA >= 7.1, complete the

following steps.

1. Call the program using telnet localhost 5<XX>08.

2. Log in using an administrator user or a user with administration rights.

3. Deploy using one of the following commands:

 DEPLOY c:\path\to\file.sca version_rule=all on_prerequisite_error=stop

 DEPLOY /path/to/file.sca version_rule=all on_prerequisite_error=stop

Note: This procedure can also be used to undeploy software components.

See SAP Note 1921719 for more information on how to deploy the same version of the

software/development component into the JAVA system by using the telnet command for 7.1x onward.

Deploying multiple applications

You can deploy more than one Web Application on the same machine. For example, you may want to

have one instance for testing, and another for production.

Note: If you are using JCo3, you must also move the jcolayer library to the Tomcat main library folder and

remove it from all Web Application library folders. See Using JCo 3.0.

PROCESS DIRECTOR 7.4 Web Application Configuration Guide

19

Renaming the applications

The first thing to do is to name the applications you want to deploy differently.

See Renaming the application.

Example: pdweb-app_TEST.war and pdweb-app_PRODUCTION.war.

Deploying the first application

1. Deploy the first Web Application.

2. If you have renamed the WAR file you deployed, you must also rename the pdweb-app.properties file

and pdweb-app folder as described in Renaming the application.

Deploying the second application

1. Rename the WAR file.

Example: pdweb-app_PRODUCTION

2. Make a duplicate of the configuration folder, using the same name as the WAR file.

Example: Make a duplicate of the ../webapps/wcconfig/pdweb-app_TEST folder and call

it ../webapps/wcconfig/pdweb-app_PRODUCTION.

Result: You now have two configuration folders in ../webapps/wcconfig/:

* pdweb-app_TEST

* pdweb-app_PRODUCTION

3. Deploy the second Web Application.

Important! Only deploy the main WAR file (for example, pdweb-app_PRODUCTION). Do not deploy a

second wcconfig.war file!

4. Copy the ../webapps/<WebApplication2>/WEB-INF/conf/web-app.properties file to the

../webapps/wcconfig/ folder.

5. Rename the web-app.properties file using the same name as the WAR file you deployed.

Example: web-app_PRODUCTION.properties

Adjusting the memory pool for Java

For some deployments, the default memory allocated for Java to use may not be enough. As a result, you

may receive memory overflow exception errors. You can fix this problem by specifying your own values.

ReadSoft recommends about 30 MB per concurrent user session. Thus, if 100 users are logged on

simultaneously, you can expect memory usage of around 3 GB.

If you are experiencing high memory loads, you should also set the parameter pd_suggest_jpa to no.

To change memory values for Apache Tomcat:

1. Open the Monitor Tomcat utility program.

2. Go to the Java tab.

PROCESS DIRECTOR 7.4 Web Application Configuration Guide

20

3. Specify the Initial memory pool and Maximum memory pool, as shown below.

Increasing the number of connections

The maximum number of simultaneous connections permitted from the Web Application to the SAP

system is controlled by the sysid.maxconnections parameter in the saplogon.properties file.

The SAP Java connector (JCo) has a built-in default limit of 100 connections. This means that setting

sysid.maxconnections to a value higher than 100 will have no immediate effect, because JCo does not

allow more than 100 connections. In the PROCESS DIRECTOR Web Application, a connection is

allocated when the user logs on and released when he logs off or closes the browser, or when a session

timeout occurs. When many users are logged on simultaneously, the default value of the

sysid.maxconnections parameter may often be exceeded.

You can increase the maximum number of connections to more than 100 by setting the operating system

environment variable CPIC_MAX_CONV on the server where JCo is installed, that is, for the web

application server that runs the application that uses JCo. For example, if you want to set

sysid.maxconnections=300, you must set CPIC_MAX_CONV=300.

You can set this variable in the startup script of the application server using the following commands:

 Windows: set CPIC_MAX_CONV=300

 Unix: export CPIC_MAX_CONV=300

Page is loading ...

Kofax Process Director 7.9 Configuration Guide

This manual is also suitable for

Kofax Process Director 7.9 Configuration Guide

Related papers

Other documents