Kofax RPA 11.1.0 Installation guide

Category
Network management software
Type
Installation guide
Kofax RPA
Installation Guide
Version: 11.1.0
Date: 2020-09-16
©
2015–2020 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
Preface.......................................................................................................................................................... 4
Related Documentation...................................................................................................................... 4
Offline Documentation............................................................................................................. 6
Training............................................................................................................................................... 9
Getting help with Kofax products....................................................................................................... 9
Chapter 1: Dependencies and Prerequisites......................................................................................... 11
Chapter 2: Install Kofax RPA................................................................................................................... 19
Install on Windows........................................................................................................................... 20
Install Desktop Automation Service.......................................................................................21
Install Document Transformation Components..................................................................... 23
Install Kapplets.......................................................................................................................35
Install on Linux................................................................................................................................. 41
Silent Installation on Windows......................................................................................................... 42
Install and Configure CyberArk........................................................................................................ 43
Important Folders in Kofax RPA...................................................................................................... 46
White-label Kofax RPA..................................................................................................................... 48
Chapter 3: Provide License Information.................................................................................................49
License Keys.................................................................................................................................... 49
Concurrent Robot Execution License...............................................................................................50
Kofax RPA Compute Units...............................................................................................................51
Enter License in Design Studio........................................................................................................52
Chapter 4: Switch Display Language for Management Console and Design Studio......................... 53
Chapter 5: Kofax RPA Initial Configuration........................................................................................... 55
Chapter 6: Quick Start Guide.................................................................................................................. 56
Install the software........................................................................................................................... 56
Start Management Console and RoboServer.................................................................................. 56
Access Management Console and enter license key......................................................................57
Configure Management Console settings........................................................................................ 57
Management Console authentication...............................................................................................58
Configure Management Console before running robots.................................................................. 59
Build Robots..................................................................................................................................... 62
Upload Robots.................................................................................................................................. 62
Run robots........................................................................................................................................ 62
3
Preface
This guide, which explains how to install Kofax RPA in a development environment, covers both
interactive and "silent" installation procedures for Windows, as well as standard and "headless"
procedures for Linux.
Note If you plan to install Kofax RPA in a production environment, see the Administrator's Guide.
In a production environment, we strongly recommend deployment of the Management Console on a
stand-alone Tomcat server. This recommendation is based on, but not limited to the following.
Derby is used as a system database in embedded mode, which is not recommended for production
environment.
Management Console on Tomcat:
Can use an enterprise class database for improved performance and data security.
Can integrate with LDAP and SAML.
Tomcat can be configured to customer requirements.
Before installing Kofax RPA, you must decide whether to install the 32-bit or the 64-bit version. The key
issues to consider are:
Your operating system may only support one of the versions. 64-bit Windows supports both. On Linux,
only the 64-bit version is supported.
The 64-bit version is mainly useful on servers where you want to run a RoboServer that uses significant
RAM. (You will need to configure the allowed amount of RAM after installation, as described in the
"Changing the RAM Allocation" section in the Administrator's Guide).
This guide describes:
How to install Kofax RPA, either interactively or "silently" (without user interaction).
How to enter license information so that you can start Kofax RPA.
How to configure Kofax RPA.
How to set up Kofax RPA server applications to start automatically when the computer restarts.
Related Documentation
The documentation set for Kofax RPA is available here:
1
https://docshield.kofax.com/Portal/Products/RPA/11.1.0_vwsnqu4c9o/RPA.htm
1
You must be connected to the Internet to access the full documentation set online.
4
Kofax RPA Installation Guide
You can also access individual guides and online help directly from your Kofax RPA installation. When you
click the help button in Design Studio, Management Console, Desktop Automation Service, and Process
Discovery, online documentation appears in a new browser window.
Note If the security policy for your organization restricts Internet access or the Internet connection is not
stable, you can access the documentation in offline mode while using the product.
In addition to this guide, the documentation set includes the following items:
Kofax RPA Release Notes
Contains late-breaking details and other information that is not available in your other Kofax RPA
documentation.
Kofax RPA Technical Specifications
Contains information on supported operating systems and other system requirements.
Kofax RPA Upgrade Guide
Contains instructions on upgrading Kofax RPA and its components to a newer version.
Kofax RPA Administrator's Guide
Describes administrative and management tasks in Kofax RPA.
Help for Kofax RPA
Describes how to use Kofax RPA. The Help is also available in PDF format under the title of Kofax RPA
User's Guide.
Kofax RPA Best Practices Guide for Robot Lifecycle Management
Offers recommended methods and techniques to help you optimize performance and ensure success
while using Robot Lifecycle Management in your Kofax RPA environment.
Kofax RPA Getting Started with Desktop Automation Guide
Provides a tutorial that walks you through the process of using Kofax RPA Desktop Automation to build a
robot.
Kofax RPA Getting Started with Document Transformation Guide
Provides a tutorial that explains how to use Document Transformation functionality in a Kofax RPA
environment, including OCR, classification, extraction, field formatting, and validation.
Kofax RPA Desktop Automation Service Configuration Guide
Describes how to configure the Desktop Automation Service required to use Desktop Automation on a
remote computer.
Kofax RPA Developer's Guide
Contains information on the API that is used to execute robots on the RoboServer.
5
Kofax RPA Installation Guide
Kofax RPA Integration API documentation
Contains information about the Kofax RPA Java API and the Kofax RPA .NET API, which provide
programmatic access to the Kofax RPA product. The Java API documentation is available from both the
online and offline Kofax RPA documentation, while the .NET API documentation is available only offline.
Note The Kofax RPA APIs include extensive references to RoboSuite, the original product name. The
RoboSuite name is preserved in the APIs to ensure backward compatibility. In the context of the API
documentation, the term RoboSuite has the same meaning as Kofax RPA.
Offline Documentation
To make the documentation available for use in offline mode, obtain the documentation files from the
Kofax RPA product package that you downloaded from the Kofax Fulfillment Site. The product package
includes the following documentation files for offline use:
KofaxRPADocumentation_11.1.0_EN.zip
Contains the entire Kofax RPA documentation set in English.
KofaxRPADocumentation_11.1.0_JA.zip
Contains the entire Kofax RPA documentation set in Japanese.
After you install the Kofax RPA product, extract the contents of the documentation .zip files for the
languages you require. The .zip file for each language contains the following folders:
API
Best Practices
Design Studio
Desktop Automation Service
Management Console
Process Discovery
After you extract the files, the documentation folder for Design Studio, Desktop Automation Service, and
Process Discovery will have the following structure:
EN and/or JA (for English and Japanese, respectively)
print and/or help (for PDF documentation and Help for Kofax RPA, respectively)
For Management Console, there are no documentation or language code folders, and only the
ManagementConsoleHelp.war file will be added to the Management Console program files.
When the offline documentation is installed for an RPA component according to the instructions below,
the component will use the offline version of the documentation by default, even if an active Internet
connection exists.
Offline API documentation
The API folder contains the API references in English.
1. Copy the API folder from the English .zip file extracted above to any folder on your computer.
2. In this folder, double-click Overview.html to open the API documentation.
6
Kofax RPA Installation Guide
Offline documentation for Design Studio
1. Open the Design Studio folder from the English .zip file extracted above and copy the EN folder to
one of the following folders, depending on your installation:
C:\Program Files(x86)\Kofax RPA 11.1.0.0 x32\documentation
C:\Program Files\Kofax RPA 11.1.0.0 x64\documentation
2. If you require the Japanese documentation, open the Design Studio folder from the Japanese .zip
file extracted above and copy the JA folder to the same location.
3. Start Design Studio and navigate to Settings > Design Studio Settings.
4. On the General tab, in Documentation location, select Offline in the list.
5. Save the changes.
To switch to online mode, select Online in Design Studio Settings and save the changes.
Note If you try to access the online documentation from Kofax RPA without Internet access, the
Retrieving help and documentation warning is displayed. If you select Do not show this notification
again and later you want to reset this option, select Show documentation retrieval notifications on
the General tab in Design Studio Settings.
Offline documentation for Management Console
1. Open the Management Console folder from the English .zip file extracted above and copy the
ManagementConsoleHelp.war file to:
C:\<Tomcat installation folder>\Tomcat <version>\webapps
Note The English and Japanese .zip files contain the same .war file, which includes both English
and Japanese documentation. If you copied the .war file from the English .zip file and you require
the Japanese version of documentation, no further actions are needed.
2. Start Management Console.
3. In the Settings section, open the Base URL settings.
4. Select Use local documentation. In Local documentation base URL, specify the URL to the
Tomcat website containing the documentation.
Example: http://localhost:8080/ManagementConsoleHelp/
5. Save the changes.
You may need to refresh Management Console for the changes to take effect.
To switch to online mode, clear Use local documentation in the Base URL settings and save the
changes.
7
Kofax RPA Installation Guide
Offline documentation for Desktop Automation Service
1. Navigate to the folder documentation that resides in:
C:\Program Files(x86)\RPA DesktopAutomation 11.1.0.0 x32
2. Open the Desktop Automation Service folder from the English .zip file extracted above and
copy the EN folder to the documentation folder.
3. If you require the Japanese documentation, open the Desktop Automation Service folder from
the Japanese .zip file extracted above and copy the JA folder to the same location.
To switch to online mode, delete or move the documentation folder from the RPA
DesktopAutomation 11.1.0.0 x32 folder.
Offline documentation for Process Discovery
1. In each of the following folders, create a new folder called documentation.
C:\Program Files (x86)\Kofax RPA Process Discovery Agent 11.1.0.0 x32
C:\Program Files (x86)\Kofax RPA Process Discovery Analyzer 11.1.0.0 x32
2. Open the Process Discovery folder from the English .zip file extracted above and copy the EN
folder to the newly created documentation folders.
3. If you require the Japanese documentation, open the Process Discovery folder from the
Japanese .zip file extracted above and copy the JA folder to the same locations.
To switch to online mode, delete or move the documentation folder from the Kofax RPA Process
Discovery Agent 11.1.0.0 x32 and Kofax RPA Process Discovery Analyzer 11.1.0.0
x32 folders.
Offline documentation for Kapplets
The offline documentation for Kofax RPA Kapplets is contained in the same .war file as for Management
Console, which you have already copied from the English.zip file to the required location on your
computer (Tomcat installation folder). To use the Kapplets documentation in offline mode, follow these
steps.
1. Depending on whether Kapplets are installed in embedded mode, on Tomcat, or on Docker,
configure the required properties in a respective configuration file. For information on each
installation scenario, see "Install Kapplets" in the Kofax RPA Installation Guide.
Embedded mode. Create an application-help.properties using the following template
and place it next to the application.properties file in the folder from where Kapplets are
run.
kapplets.services.mc.connection.url=http:// <host-url>:<port>/ManagementConsole
kapplets.services.mc.connection.username=<username>
kapplets.services.mc.connection.password=<password>
kapplets.services.help.languages-map[en]=EN
kapplets.services.help.languages-map[ja]=JA
kapplets.services.help.base-url=http://<host-url>:<port>/ManagementConsoleHelp/
@@language@@/help/kap_help/kapplets
8
Kofax RPA Installation Guide
kapplets.services.help.landing-url=http://<host-url>:<port>/
ManagementConsoleHelp/@@language@@/help/kap_help/kapplets/c_rpakappletsmain.html
Note In this scenario, the offline documentation can be used only if the Management Console is
deployed on Tomcat.
On Tomcat. To the kapplets.xml file, add the following properties at the end of the file.
<Environment name="kapplets.services.help.languages-map[en]" value="EN"
type="java.lang.String" override="false"/>
<Environment name="kapplets.services.help.languages-map[ja]" value="JA"
type="java.lang.String" override="false"/>
<Environment name="kapplets.services.help.base-url" value="http://<host-
url>:<port>/ManagementConsoleHelp/@@language@@/help/kap_help/kapplets"
type="java.lang.String" override="false"/>
<Environment name="kapplets.services.help.landing-url" value="http://<host-
url>:<port>/ManagementConsoleHelp/@@language@@/help/kap_help/kapplets/
c_rpakappletsmain.html" type="java.lang.String" override="false"/>
On Docker. In the docker-compose.yml file, add the following properties to the environment
section at the end of the file.
- KAPPLETS_SERVICES_HELP_LANGUAGES-MAP[en]=EN
- KAPPLETS_SERVICES_HELP_LANGUAGES-MAP[ja]=JA
- KAPPLETS_SERVICES_HELP_BASE-URL=http://<host-url>:<port>/
ManagementConsoleHelp/@@language@@/help/kap_help/kapplets
- KAPPLETS_SERVICES_HELP_LANDING-URL=http://<host-url>:<port>/
ManagementConsoleHelp/@@language@@/help/kap_help/kapplets/c_rpakappletsmain.html
2. Save the file. You may need to restart the Tomcat server for the changes to take effect.
To switch to online mode, delete the four properties from the configuration file, save the changes, and
restart the server.
Training
Kofax offers both classroom and computer-based training to help you make the most of your Kofax RPA
solution. Visit the Kofax Education Portal at https://learn.kofax.com/ for details about the available training
options and schedules.
Also, you can visit the Kofax Intelligent Automation SmartHub at https://smarthub.kofax.com/ to explore
additional solutions, robots, connectors, and more.
Getting help with Kofax products
The Kofax Knowledge Base repository contains articles that are updated on a regular basis to keep you
informed about Kofax products. We encourage you to use the Knowledge Base to obtain answers to your
product questions.
To access the Kofax Knowledge Base, go to the Kofax website and select Support on the home page.
9
Kofax RPA Installation Guide
Note The Kofax Knowledge Base is optimized for use with Google Chrome, Mozilla Firefox or Microsoft
Edge.
The Kofax Knowledge Base provides:
Powerful search capabilities to help you quickly locate the information you need.
Type your search terms or phrase into the Search box, and then click the search icon.
Product information, configuration details and documentation, including release news.
Scroll through the Kofax Knowledge Base home page to locate a product family. Then click a product
family name to view a list of related articles. Please note that some product families require a valid
Kofax Portal login to view related articles.
Access to the Kofax Customer Portal (for eligible customers).
Click the Customer Support link at the top of the page, and then click Log in to the Customer Portal.
Access to the Kofax Partner Portal (for eligible partners).
Click the Partner Support link at the top of the page, and then click Log in to the Partner Portal.
Access to Kofax support commitments, lifecycle policies, electronic fulfillment details, and self-service
tools.
Scroll to the General Support section, click Support Details, and then select the appropriate tab.
10
Chapter 1
Dependencies and Prerequisites
This chapter lists components and required configuration settings to use different Kofax RPA features. For
information on supported platforms and versions, see the Kofax RPA Technical Specifications document
on the Kofax RPA Product Documentation site.
Real-time data: If you have a solution where users are waiting for results in real-time, CPU speed is
normally the bottleneck, and you should buy the fastest CPU available for your hardware platform.
Dedicated hardware: For best performance, we recommend that you always run RoboServer,
Management Console, or Document Transformation Service each on dedicated hardware. That means
that you should not run database servers and other services on the same hardware with your RoboServer,
Management Console, or Document Transformation Service.
Any email field in Kofax RPA can contain up to 255 characters. Do not exceed the number of characters in
the email field.
Windows installation prerequisites
If you get the error: "Module <modulename> not found," install the following update.
https://support.microsoft.com/en-us/kb/2999226
Note that <modulename> can be "automationnative", "cef" or any other Kofax RPA module name.
If the Windows update is not available on your system, use the following workaround.
1. Create a c:\temp\976571 folder.
2. Use the following command to extract the contents of the MSU file:
Expand -F:* c:\kb976571\Windows6.1-KB976571-v2-x64.msu c:\temp\976571
This command extracts multiple files, from Windows6.1-KB976571-v2-x64.cab.
3. Run the following command:
DISM.exe /Online /Add-Package /PackagePath:c:\temp\976571\Windows6.1-
KB976571-v2-x64.cab
For more information, see How to use DISM to install a hotfix from within Windows on the Microsoft
Technet website https://blogs.technet.microsoft.com.
11
Kofax RPA Installation Guide
Linux installation dependencies
When installing on Ubuntu, Ubuntu 14.04 LTS with the libqt5webkit5 library is required.
The minimal Linux installation must include the following libraries to be able to run robots created with the
default browser engine.
libX11.so.6
libGL.so.1
libXext.so.6
To use cross-platform authentication (Negotiate and NTLM protocols), your Linux installation must include
these Generic Security Service API (GSS-API) libraries:
libgssapi_krb5.so.2
libgssapi.so.4
libgssapi.so.2
libgssapi.so.1
Note Kofax RPA supports libssl1.0.2 or below.
Use the yum install or sudo apt-get command to install necessary libraries on a Linux platform.
You must also install fonts on a headless Linux server for the WebKit robots to work.
Instructions for installing fonts for CentOS / RedHat
Instructions for installing fonts for Ubuntu
Databases
Important Please create and maintain the Kofax RPA product databases according to the
recommendations in the product documentation. If you are considering database modifications or
customizations, do not proceed without consulting Kofax; otherwise, the results are unpredictable and
the software may become inoperable.
You can use Microsoft SQL Server with integrated Windows Authentication as a logging (logdb) database
only in the following cases:
Important Microsoft SQL Server with integrated Windows Authentication cannot be used as a logging
(logdb) database when you run Management Console and RoboServer in embedded mode.
Also, make sure that SQL Server Authentication of the Microsoft SQL Server is disabled.
Both Management Console and RoboServer must run only on a Windows platform.
Management Console must be installed on a Tomcat server.
The JDBC driver, including DLLs, must be manually installed into both Management Console and all
RoboServer installations without using the JDBC distribution mechanism in the Management Console.
Oracle Connection URL must use ${ServerName}:${Schema}. Using ${ServerName}:
${ServiceName} is not supported.
You can use PostgreSQL database only for storing your data. PostgreSQL cannot be used as a
Management Console system, logging, or audit database.
12
Kofax RPA Installation Guide
Be aware that loss of data may occur when storing data in Oracle, Sybase or MySQL. On Oracle, an
empty string is converted to null. On Sybase, an empty string is converted to " " (a single space). On
MySQL, millisecond precision is lost when storing dates. For details, see the ObjectKey Caveats section
in the Storing Data in Databases topic in the Kofax RPA help.
Note For correct display of data in the Kofax Insight Dashboard, make sure Java correctly sets the
time according to your time zone on RoboServers and computers running Management Consoles. See
the Timezone Data Versions in the JRE Software on the Oracle web site for the latest updates in time
zones. If necessary, use the Timezone Updater Tool to update the time zone information.
Document Transformation prerequisites and limitations
Install all the latest Windows updates before installing and using Kofax RPA Document Transformation.
Prerequisites
The maximum document size for transformation is 100 MB. Kofax RPA imposes a file size limit for a
transformed document to enable protection against the denial-of-service attacks. You can lower the
file size value to protect against such an attack. To change the document size limit, edit the following
parameter in the Web.config file in the Kofax DTS\Transformation Services directory in the
Kofax RPA installation folder.
<httpRuntime targetFramework="4.5.1" maxRequestLength="104857600"/>
The following are other requirements you need to observe.
Do not install Kofax RPA Document Transformation on the computer running Kofax Transformation
or Kofax TotalAgility.
You can re-use existing KTM, KTT, and RTTI projects version 6.2 or earlier.
You cannot re-use KTA projects, because KTA does not provide a way to export a KTA Extraction/
Classification group to a complete .fpr file.
Limitations
The following Kofax Transformation features are not supported.
Rich client user modules (Doc Review, Validation, Verification, Correction)
ThinClient user modules other than validation (Verification and Correction)
Multiple steps of Validation
Configuration Sets for migration between systems
A2iA engines
Reporting settings
Desktop Automation requirements and prerequisites
The following sections list components that must be installed and configured on the automation devices
(remote computers you want to automate) before you can use the Desktop Automation feature in Kofax
RPA.
Java Access Bridge
To automate Java programs or Java applets on remote devices with Kofax RPA, install Java 32-bit on
your device (JRE or JDK) and enable the Java Access Bridge in the Java Runtime Environment used
by the application. We recommend using the latest available Java version.
For JRE 7 or Later
To enable Java Access Bridge for Java version 7 or later, navigate to the bin directory in the Java
installation directory and run the following command.
13
Kofax RPA Installation Guide
jabswitch -enable
For JRE6
Follow this procedure to install Java Access Bridge 2.0.2 on a Windows 32-bit system. For older
applications that require Java version 1.6, copy the following files to the specified destination
directories, where %WINDOWSHOME% is the directory where Microsoft Windows is installed (for
example, C:\WINDOWS), and %JAVAHOME% is the directory where your JDK or JRE is installed.
The following are examples of directory names for Java SE 6 Update 24.
JDK: C:\Program Files\Java\jdk1.6.0_24\jre
JRE: C:\Program Files\Java\jre6
The following table lists Java Access Bridge Windows libraries and related files for Windows 32-bit
systems.
Java Access Bridge File Destination Directory
WindowsAccessBridge.dll %WINDOWSHOME%\SYSTEM32
JavaAccessBridge.dll %JAVAHOME%\bin
JAWTAccessBridge.dll %JAVAHOME%\bin
accessibility.properties %JAVAHOME%\lib
access-bridge.jar %JAVAHOME%\lib\ext
14
Kofax RPA Installation Guide
Java Access Bridge File Destination Directory
jaccess.jar %JAVAHOME%\lib\ext
For more information, search the Downloads page on the Oracle web site ( http://www.oracle.com/
technetwork/java/javase/downloads/) to locate and download jab-2-0-2. For installation
instructions, see "installing-jab-32-bit" on the http://docs.oracle.com website.
Perform the following to test that you have installed Java Access Bridge properly.
1. Run the SwingSet2 application and then run the JavaMonkey.exe application.
2. Select File > Refresh Tree in the Java Monkey application and the SwingSet2 application
should appear.
Alternatively, you can use the JavaFerret.exe application.
WebDAV Redirector
When using the Robot File System on a computer where the Desktop Automation Service is installed,
to be able to connect to the service, you require the WebDAV Redirector. Some operating systems do
not include WebDAV by default, so you need to manually install it.
For example, to install it on a Windows Server 2008, 2008 R2, 2012, or 2012 R2, in the Windows
Server Manager -> Features, check the Desktop Experience option. For a Windows Server 2016,
check the WebDAV Redirector option.
.
Requirements for Linux-based platforms
To use Desktop Automation, install the libxslt1.1 package.
To use the built-in browser in Desktop Automation on Ubuntu-based distributions, install the following
packages:
gconf-service
libasound2
libatk1.0-0
libc6
libcairo2
libcups2
libdbus-1-3
libexpat1
libfontconfig1
libgcc1
libgconf-2-4
libgdk-pixbuf2.0-0
libglib2.0-0
libgtk2.0-0
libnspr4
libnss3
libpango-1.0-0
libpangocairo-1.0-0
15
Kofax RPA Installation Guide
libx11-xcb1
libxcb1
libxcomposite1
libxcursor1
libxdamage1
libxfixes3
libxi6
libxrandr2
libxrender1
libxss1
libxtst6
Xvfb
To use the built-in browser in Desktop Automation on Red Hat and CentOS-based distributions, install
the packages containing the following libraries:
atk.x86_64
gtk2.x86_64
epel-release
GConf2
qt5-qtwebkit
qt5-qtwebkit-devel
qtwebkit-devel
libX11.so.6
libGL.so.1
libXext.so.6
libxslt
libXtst.x86_64
libXScrnSaver
libX11-xcb.so.1
libfontconfig.so.1
libpango-1.0.so.0
libpangocairo-1.0.so.0
libcairo.so.2
libXcomposite.so.1
libXcursor.so.1
libXdamage.so.1
libXfixes.so.3
libXi.so.6
libXrender.so.1
libXtst.so.6
libXrandr.so.2
16
Kofax RPA Installation Guide
libXss.so.1
libgconf-2.so.4
libgio-2.0.so.0
libasound.so.2
libcups.so.2
libdbus-1.so.3
libatk-1.0.so.0
libgtk-x11-2.0.so.0
libgdk-x11-2.0.so.0
libgdk_pixbuf-2.0.so.0
libnspr4.so
libnss3.so
libnssutil3.so
libsmime3.so
libexpat.so.1
libxcb.so.1
xorg-x11-server-Xvfb
To use the "Open" step action, which allows an application to open on an automated device with an
RDP connection, install the packages containing the following libraries:
libc.so.6
libxcb.so.1
libXext.so.6
libdl.so.2
libpthread.so.0
libm.so.6
libssl.so.1.1
libcrypto.so.1.1.0
libXau.so.6
libXdmcp.so.6
For more information on this action, see "Open" in the Kofax RPA help.
Prerequisites for Internet Explorer
To automate Internet Explorer for use with the Desktop Automation feature, check the following
requirements.
In Internet Explorer 7 and higher on Windows 7, set the same value (either On or Off) in the
Protected Mode settings for each zone. To open the Protected Mode settings in Internet Explorer,
select Tools > Internet options and click the Security tab. For each zone, select the Enable
Protected Mode option and select the same security level.
For IE 10 and higher, disable the Enhanced Protected Mode in the Security settings on the
Advanced tab of the Internet Options window.
For IE 11 only, check that a FEATURE_BFCACHE subkey with a DWORD value named
iexplore.exe is present in the registry on the target computer. This subkey enables the driver
17
Kofax RPA Installation Guide
to maintain a connection to the instance of Internet Explorer it creates. For 32-bit Windows,
examine the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Internet Explorer\Main
\FeatureControl\FEATURE_BFCACHE key in the registry editor. For 64-bit Windows, examine
the HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Internet Explorer
\Main\FeatureControl\FEATURE_BFCACHE key. If the FEATURE_BFCACHE subkey is not
present, create it and create a DWORD value named iexplore.exe with the value "0" in the key.
Set the browser zoom level to 100% to align the native mouse events with the correct coordinates.
Note In some cases, out-of-browser Silverlight applications can interfere with Desktop Automation.
The cause of the problem is the Internet Explorer subdriver. To disable the subdriver, clear the
"Extended Internet Explorer Support" option on the Windows tab of the Desktop Automation
Service configuration window.
SAP prerequisites
To automate an SAP application for use with the Desktop Automation feature, enable scripting on both
the server and the client sides.
On the client, go to SAP GUI Options and enable scripting. Also, turn off notifications, because
they interrupt the automation process.
To enable scripting on the SAP server, perform the following steps. Note that you must have
administrative privileges to change the sapgui/user_scripting parameter.
1. Log in to your SAP server.
2. Run transaction RZ11. Specify the parameter name sapgui/user_scripting and click
Display. If Parameter name is unknown appears in the status bar, it indicates that you
are missing the current support package. Check your installed packages.
3. Change the value to TRUE.
4. Click Save.
Note that some elements, such as scroll bars, are only available if you run the SAP client on a
machine with a Windows Classic desktop theme.
18
Chapter 2
Install Kofax RPA
This chapter describes how to install Kofax RPA on a single computer in a developer environment. See
the Administrators Guide for installation and deployment in a production environment.
The complete installer is delivered as a .zip file. For the Windows platform, Kofax RPA has five installers
that install different components of the software:
Kofax RPA Design Studio installer: Installs Design Studio, but does not install RoboServer,
Management Console or API. Use this installer if you have a central Management Console/License
Server and need a separate copy of Design Studio.
Kofax RPA RoboServer installer: Installs RoboServer only and does not install Management Console or
Design Studio. This installer is useful, if you need to set up dedicated RoboServer machines.
Configurable full Kofax RPA installer: Installs all of the core components, including Git Synchronizer, or
selected components that you specify.
Kofax RPA Desktop Automation installer: Installs the Desktop Automation Agent to automate remote
devices.
Kofax RPA DTS (Document Transformation Service) installer: Installs the Kofax RPA Document
Transformation components.
This installer contains the following components required to run:
Document Transformation Project Builder
Kofax Licensing Server
Document Transformation Services
Document Transformation Thin Client Server
Document Transformation Standard Projects
Document Transformation Service Scheduler
Prerequisite: Prior to unzipping the software archive file, right-click the .zip file and unblock it to prevent
issues during installation. Disregard this step if the Unblock option is not displayed.
Silent Installation
19
Kofax RPA Installation Guide
As another option, you can perform a silent installation. If you run a silent installation of the full installer,
you get the "Typical" install. See Silent Installation on Windows for details.
For Linux, Kofax RPA provides a full installer as well as rpm and deb packages for installing RoboServer
as a service. See Install on Linux for details.
Upgrade from Earlier Versions
In the interest of stability, different versions of Kofax RPA may be installed side by side on the same
computer without interfering with each other (except that they must be configured to use different port
numbers for the Management Console if run simultaneously). This means that you can install a newer
version and get acquainted with it while still doing your daily work with the older version.
You can copy important data such as uploaded robots, execution schedules and so on from one version of
Management Console to another by making a backup of the old installation and "restoring" it into the new
one. Making a backup varies in different versions of Kofax RPA, so check help or User's Guide to learn
how to create a backup.
For more information about upgrade procedures, see the Kofax RPA Upgrade Guide.
Note Effective since Kofax RPA version 10.3, any admin user can restore a backup created by any other
admin user.
Install on Windows
The complete Kofax RPA installer provides the following installation options. Optional items are listed with
an asterisk.
Design Studio: Installs Design Studio and its required components
RoboServer: Installs RoboServer
Embedded Management Console: Installs components needed to run an embedded Management
Console on the RoboServer
Management Console: Creates the WAR file for manual installation of the Management Console
SQL scripts for database tables
API*: Installs necessary API components
The following files install separate Kofax RPA components.
If you are installing Design Studio only, download and save
the Kofax_RPA_DesignStudio_11.1.0.0_x32.msi or
Kofax_RPA_DesignStudio_11.1.0.0_x64.msi file to your hard disk. After the download is
completed, run the file to start the installation and follow the installer prompts.
To install a RoboServer, download and save the Kofax_RPA_RoboServer_11.1.0.0_x32.msi
or Kofax_RPA_RoboServer_11.1.0.0_x64.msi file to your hard disk. After the download is
completed, run the file to start the installation and follow the installer prompts.
To install the Desktop Automation Service, download and save the
Kofax_RPA_DesktopAutomation_11.1.0.0_x32.msi. After the download is completed, run the
file on the computer you want to automate and follow the installer prompts. For more information, see
Install Desktop Automation Service.
20
  • 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

Kofax RPA 11.1.0 Installation guide

Category
Network management software
Type
Installation guide

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

Finding information in a document is now easier with AI