Kofax Process Director 7.9 Configuration Guide

Type
Configuration Guide

This manual is also suitable for

PROCESS DIRECTOR
Web Application Configuration Guide
Version: 7.4
Date: 2017-11-15
© 2017 Kofax. All rights reserved.
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
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 6
Web application server
Apache Tomcat 6.0
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 1 1
  • Page 2 2
  • Page 3 3
  • Page 4 4
  • Page 5 5
  • Page 6 6
  • Page 7 7
  • Page 8 8
  • Page 9 9
  • Page 10 10
  • Page 11 11
  • Page 12 12
  • Page 13 13
  • Page 14 14
  • Page 15 15
  • Page 16 16
  • Page 17 17
  • Page 18 18
  • Page 19 19
  • Page 20 20
  • Page 21 21
  • Page 22 22
  • Page 23 23
  • Page 24 24
  • Page 25 25
  • Page 26 26
  • Page 27 27
  • Page 28 28
  • Page 29 29
  • Page 30 30
  • Page 31 31
  • Page 32 32
  • Page 33 33
  • Page 34 34
  • Page 35 35
  • Page 36 36
  • Page 37 37
  • Page 38 38
  • Page 39 39
  • Page 40 40
  • Page 41 41
  • Page 42 42
  • Page 43 43
  • Page 44 44
  • Page 45 45
  • Page 46 46
  • Page 47 47
  • Page 48 48
  • Page 49 49
  • Page 50 50
  • Page 51 51
  • Page 52 52
  • Page 53 53
  • Page 54 54
  • Page 55 55
  • Page 56 56
  • Page 57 57
  • Page 58 58
  • Page 59 59
  • Page 60 60
  • Page 61 61
  • Page 62 62
  • Page 63 63
  • Page 64 64
  • Page 65 65
  • Page 66 66
  • Page 67 67
  • Page 68 68
  • Page 69 69
  • Page 70 70
  • Page 71 71
  • Page 72 72
  • Page 73 73
  • Page 74 74
  • Page 75 75
  • Page 76 76
  • Page 77 77
  • Page 78 78
  • Page 79 79
  • Page 80 80
  • Page 81 81
  • Page 82 82
  • Page 83 83
  • Page 84 84
  • Page 85 85
  • Page 86 86
  • Page 87 87
  • Page 88 88
  • Page 89 89
  • Page 90 90
  • Page 91 91
  • Page 92 92
  • Page 93 93
  • Page 94 94
  • Page 95 95
  • Page 96 96
  • Page 97 97
  • Page 98 98
  • Page 99 99
  • Page 100 100
  • Page 101 101
  • Page 102 102
  • Page 103 103
  • Page 104 104
  • Page 105 105
  • Page 106 106
  • Page 107 107
  • Page 108 108
  • Page 109 109
  • Page 110 110
  • Page 111 111
  • Page 112 112
  • Page 113 113
  • Page 114 114
  • Page 115 115
  • Page 116 116
  • Page 117 117
  • Page 118 118
  • Page 119 119
  • Page 120 120
  • Page 121 121
  • Page 122 122
  • Page 123 123
  • Page 124 124
  • Page 125 125
  • Page 126 126
  • Page 127 127
  • Page 128 128
  • Page 129 129
  • Page 130 130
  • Page 131 131
  • Page 132 132
  • Page 133 133
  • Page 134 134
  • Page 135 135
  • Page 136 136
  • Page 137 137
  • Page 138 138
  • Page 139 139
  • Page 140 140
  • Page 141 141
  • Page 142 142

Kofax Process Director 7.9 Configuration Guide

Type
Configuration Guide
This manual is also suitable for

Ask a question and I''ll find the answer in the document

Finding information in a document is now easier with AI