Management Console User's Guide
209
The cluster settings
When modifying the cluster settings, any changes settings are indicated with a bold font so that one has
an overview of the changes made before confirming by clicking the 'OK' button.
In order for the settings to be sent to the RoboServers, they must first be applied. Applying settings is done
by settings the cluster into maintenance mode (see the section on cluster modes for more information). If,
when confirming a number of settings changes by closing the cluster settings dialog with a click on the
'OK' button, a cluster is already in maintenance mode, the settings are applied right away. If the cluster is
not in maintenance mode, the following dialog appears:
Applying cluster settings
In the apply settings dialog, one selects how the cluster should transition into maintenance mode in order
to apply settings. When the settings have been applied, the cluster will return to normal mode.
The following sections describe each part of the cluster settings in more detail.
Add links in pdf - insert, remove PDF links in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Free C# example code is offered for users to edit PDF document hyperlink (url), like inserting and deleting
add links to pdf in acrobat; accessible links in pdf
Add links in pdf - VB.NET PDF url edit library: insert, remove PDF links in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
Help to Insert a Hyperlink to Specified PDF Document Page
c# read pdf from url; add url to pdf
Management Console User's Guide
210
Databases
The databases that are defined on a cluster are those that are available to robots running on the cluster
RoboServers. This means that for a robot to access a cluster database, it must use the name that the
databases is given in the cluster settings. A database uses a database type. Database types are defined in
the Management Console settings.
If a cluster has been selected as providing Design Studio with Shared Databases, the databases that are
defined on the cluster are also sent to Design Studio.
For users upgrading from pre 9.2.0 versions, it is possible to import databases from the legacy db.properties
files in which databases were previously defined. This is done by selecting the 'Databases' node in the tree,
and clicking the 'Import Databases From File' button. This will open a window in which the contents of
the file can be pasted.
The properties of the databases are the same as those described here.
To add a new database, you either select the database category, and click the 'Add Database' button, or
you right-click the database category and click the add button. You can import databases from legacy
properties files. This is done by selecting the database category and clicking the 'Import Databases From
File' button. This will open a window in which you can paste the contents of the file you wish to import.
Proxy Servers
This section allows you to configure a list of proxy servers that will be used on the RoboServers. If only
a single proxy server is defined, that one will be used. If a list of proxy servers is defined, for the first
connection a random proxy server is selected. The following connections then use the proxy servers in
round-robin order.
The properties of the proxy servers are the same as those described here.
To add a new proxy server, you either select the proxy server category, and click the 'Add Proxy Server'
button, or you right-click the proxy server category and click the add button. You can import proxy servers
from legacy properties files. This is done by selecting the proxy servers category and clicking the 'Import
Proxy Servers From File' button. This will open a window in which you can paste the contents of the file
you wish to import. The file must have the format described at the bottom of this section.
Logging
In this sections logging is enabled or disabled for the cluster RoboServers, and how to log is defined. There
are three types of logging possible, these are described below.
Database Logging
If database logging is enabled, the RoboServers will log to the RoboServer Log
Database which is defined in the Design Studio settings. If 'Log Robot Input
To Database' is selected, the input that robots are given will be logged to the
database. NOTE:  a RoboServer log database MUST be configured and enabled
for database logging to work. If no database has been configured, the cluster
settings will be invalid (you will be informed of this, so you can correct the
problem).
Log4J
Using log4j to log you can control where the log goes using an ordinary
log4j.properties  file.  The  log4j.properties  file  is  found  in
the  Configuration  folder  in  the  application  data  folder.  The  default
log4j.properties file logs all robot run information, robot messages and
server messages into a file. The logs are placed in the Logs folder in the
application data folder. More advanced setups include storing in the Windows
event log, rotating files, and the syslog. See the log4j manual for details.
C# PDF Convert to HTML SDK: Convert PDF to html files in C#.net
HTML converter toolkit SDK, preserves all the original anchors, links, bookmarks and to Use C#.NET Demo Code to Convert PDF Document to Add necessary references
add hyperlink to pdf online; add hyperlinks to pdf online
.NET PDF Document Viewing, Annotation, Conversion & Processing
PDF Write. Insert text, text box into PDF. Edit, delete text from PDF. Insert images into PDF. Edit, remove images from PDF. Add, edit, delete links. Form Process
adding hyperlinks to a pdf; clickable pdf links
Management Console User's Guide
211
When enabling this log, RoboServer will log using three different loggers.
Table 29. Log4J Loggers
Logger
Description
log4j.logger.kapow.servermessagelog
This logger is used for server logging that is not tied
to a particular robot run.
log4j.logger.kapow.robotrunlog
To  this  logger  information  about  starting  and
stopping robots. It includes execution time of the
robot.
log4j.logger.kapow.robotmessagelog
Messages logged by robots e.g. as part of handling
errors  in  steps.  This  also  includes  profiling  if
profiling is setup to output into the log.
E-mail Logging
This will send an e-mail whenever a robot logs an error message or the server
has a error message.
Table 30. E-mail configuration
Property
Description
To Address
Who should  receive the e-mail. You  can add multiple
addresses separated by ",".
From Address
The from address to be used on the e-mails.
Profiling
If you enable profiling of robots you can see the execution time for the individual steps and the entire
robot. This is very useful if you have a slow running robot and want to improve performance.
Profiling is configured using the following properties:
Table 31. Profiling Properties
Property
Description
Output Type
If  you  choose  Summary,  only  one  statement  summarizing  the
execution is written to the profiling log for each robot execution. If
you choose Detailed, a detailed statement is written to the profiling
log for every step executed in a robot provided the execution time of
the step is above the threshold defined by the Threshold property.
Output Target
This controls where the profiling information is send. The possibilities
are to send it to the console, to a file or in the log.
Threshold
This  threshold  defines  the smallest  execution time for a  step  (in
milliseconds) for which to include profiling information for that step.
Log page URL in wait messages If checked, the page URL is printed before page load wait time.
Robot Execution
On this section, properties of the RoboServer robot execution can be defined. It is possible to specify how
many robots that can run concurrently on the (individual) RoboServers, and how many can be queued.
Please refer to this section for help on tweaking the numbers.
VB.NET PDF Convert to HTML SDK: Convert PDF to html files in vb.
Turn PDF images to HTML images in VB.NET. Embed PDF hyperlinks to HTML links in VB.NET. Convert PDF to HTML in VB.NET Demo Code. Add necessary references:
adding links to pdf document; add hyperlinks pdf file
C# PDF Convert to Word SDK: Convert PDF to Word library in C#.net
the original text style (including font, size, color, links and boldness). C#.NET DLLs and Demo Code: Convert PDF to Word Document in C# Add necessary references
add a link to a pdf file; adding a link to a pdf in preview
Management Console User's Guide
212
Table 32. Robot Execution Properties
Property
Description
Max concurrent robots
How  many  robots  are  allowed  to  execute  concurrently  on  each
RoboServer.
Max queued robots
How  many  robots  are  allowed  to  reside  in  the  queue  on  each
RoboServer.
Projects
In this section of the Admin tab, you may configure which projects are available in the Management
Console.
Projects are a way to segment robots, types, snippets, resources and schedules. Robots only have access to
the type, snippets and resources contained in the project they belong to. Names of robots, types etc. also
need only be distinct within a project.
Note that if you delete a project, all of the robots, types, snippets, resources and schedules associated with
it will be deleted as well.
By default, the Management Console contains a single project.
When deploying the Enterprise edition on a standalone web container, you can also configure project
permissions  for  users  based  on  their  group  membership  (for  instance  LDAP  groups),  see  Project
Permissions for details.
The project name is used as a foreign key in the log tables. This is needed to determine who has permission
to view the log files in the Enterprise version. This means that when you rename a project, all existing Robot
Runs and Robot Messages belonging to this project must be updated to reflect the new name. Otherwise
they will not show up when the logs are filtered by project. If the Management Console is connected to
the logging database when you rename a project, the Management Console will automatically rename the
Robot Run/Message entries in the log database. However if it is not connected, or the connection is lost
during this update, the administrator must manually run the following SQL to update the log tables.
UPDATE ROBOT_RUN SET projectName = '<newName>' where projectName = '<oldName>';
UPDATE ROBOT_MESSAGE SET projectName = '<newName>' where projectName = '<oldName>';
Where <oldName> is the old project name, and <newName> is the new project name.
Rest Services and Kapplets
Robots can be exposed as Rest services and/or Kapplets. If you open the Edit Project dialog then on the
Services tab you can configure the runtime for these services.
How to C#: Basic SDK Concept of XDoc.PDF for .NET
You may add PDF document protection functionality into your C# program. to edit hyperlink of PDF document, including editing PDF url links and quick
add links to pdf online; add links to pdf in preview
C# Create PDF Library SDK to convert PDF from other file formats
PDF with a blank page, bookmarks, links, signatures, etc. PDF document in C#.NET using this PDF document creating toolkit, if you need to add some text
add hyperlink pdf document; add links pdf document
Management Console User's Guide
213
Projects - service tab
By default Rest services are protected by basic authentication. When invoking Rest services directly from
a browser (using XMLHttpRequest), you have to disable the authentication, as you would otherwise be
exposing login credentials in the JavaScript source files. When calling Rest services from a programming
language like Java, Ruby, C# etc, it is a good idea to have the services protected by authentication
(assuming that you can keep the credentials stored in a secure manner).
There are certain restrictions when calling a Rest service from a browser, unless the service is located on
the same web server as the web page from which it is invoked. When calling a Rest service from another
domain (referred to as CORS Cross-Origin Resource Sharing), you have to include certain headers for
the client to be allowed to process a resource from another domain. The Access-Control-Allow Origin
is one such header. If you call a Rest service in a cross domain fashion, you must specify the domain,
from which the page that generated the request was loaded. If a page on http://example.com contains a
page with JavaScript that generates a request to a service located on http://kapowsoftware.com, then the
service response from http://kapowsoftware.com must contain the header Access-Control-Allow-Origin:
http://example.com or built in security mechanisms in the browser will prevent it from processing the
cross-origin response. As you can see in the above screen shot, you may use * as a wildcard, which means
that any domain can invoke your Rest service in a cross domain fashion.
VB.NET PDF: Basic SDK Concept of XDoc.PDF
You may add PDF document protection functionality into your VB.NET program. to edit hyperlink of PDF document, including editing PDF url links and quick
change link in pdf file; add url pdf
C# Image: Tutorial for Document Management Using C#.NET Imaging
more detailed C# tutorials on each part by following the links respectively are dedicated to provide powerful & profession imaging controls, PDF document, image
convert excel to pdf with hyperlinks; add link to pdf acrobat
Management Console User's Guide
214
Projects - Kapplets tab
In the Kapplets tab, you can specify if the robots of the project should be exposed as Kapplets.
Users
On the users tab it is possible to view data on users that have logged in. It is also possible to delete any
configuration stored by the user, by pressing the Delete button in the user row in the table.
Settings
This tab enables you to configure the Management Console. You have to click the save button for the
changes to take effect. Additional options, which affect how you connect to the Management Console
(such as port numbers and security settings) are configured in the Settings application as described in
Configuring the Embedded Management Console.
Management Console User's Guide
215
Schedule Logs Cleanup
Here you configure the thresholds for the schedule logs cleanup.
Every 10 minutes the Management Console looks at the number of schedule runs and messages. If there
are more records than the thresholds defined here, cleanup will occur and records will be deleted until the
numbers of records are below the listed threshold.
If you have many schedules, or your schedules execute often, you may want to increase the thresholds,
otherwise the information available on the Logs Tab may not be sufficient.
Table 33. RoboServer Log Database Cleanup
Property
Description
Max schedule runs
The maximum number of schedule runs recorded in the database
before cleanup triggers.
Max schedule messages
The maximum number of individual schedule messages recorded in
the database before cleanup triggers.
RoboServer Authentication
In this section, you configure the credentials (user name and password) that the Management Console
will use when running robots on the RoboServers belonging to the configured clusters. The Management
Console will use the same set of credentials for all RoboServers. These credentials must match the
configuration done as described in Requiring Authentication for all the configured RoboServers.
RoboServer Log Database
This is the logging database used by all RoboServers belonging to clusters where database logging has
been enabled in the cluster settings. The database is configured in the same way as the cluster databases.
Cleanup thresholds can be configured for the RoboServer log database in the same way as for the Schedule
Log.
Table 34. RoboServer Log Database Cleanup
Property
Description
Robot message count threshold
The log will automatically clean up the database when the number of
robot messages in the database exceeds this threshold. The cleanup
will delete the oldest robot runs and the messages for the deleted runs.
If you experience performance problems with the log database you can
lower this threshold. If you wish to store more historic messages you
can increase this threshold.
Robot run count threshold
The log will automatically clean up the database when the number of
robot runs in the database exceeds this threshold. The cleanup will
delete the oldest robot runs and the messages for the deleted runs. If
you experience performance problems with the log database you can
lower this threshold. If you wish to store more historic messages you
can increase this threshold.
Server message count threshold The log will automatically clean up the database when the number of
server messages in the database exceeds this threshold. The cleanup
will delete the oldest server messages. If you experience performance
Management Console User's Guide
216
Property
Description
problems with the log database you can lower this threshold. If you
wish to store more historic messages you can increase this threshold.
In order to use a database for logging, you must prepare your database server by either creating a new
database (schema), or simply making sure an existing database is available. You must obtain a username
and password with rights to create tables, drop tables, create indexes, drop indexes, select, insert, update,
and delete in the database.
Both the Management Console and RoboServer will create the log tables automatically when they are
started (if the tables do not already exist). However you may also create them using the following scripts
Table 35. SQL scripts for log tables (right click and chose save as)
Database
Create Tables
Drop Tables
IBM DB2
create 
[sql/logging/
db2_create.sql]
drop [sql/logging/db2_drop.sql]
Derby
create 
[sql/logging/
derby_create.sql]
drop [sql/logging/derby_drop.sql]
MySQL
create 
[sql/logging/
mysql_create.sql]
drop [sql/logging/mysql_drop.sql]
Oracle
create 
[sql/logging/
oracle_create.sql]
drop [sql/logging/oracle_drop.sql]
Microsoft SQL
Server
create 
[sql/logging/
sqlserver_create.sql]
drop [sql/logging/sqlserver_drop.sql]
Sybase
create 
[sql/logging/
sybase_create.sql]
drop [sql/logging/sybase_drop.sql]
If you are upgrading from version 7.2, and want to use the logging tables already created, you will have
to modify the ROBOT_RUN table, since a new column has been added. You must add a column named
PROJECTNAME of type VARCHAR(255) to the ROBOT_RUN table (NVARCHAR2 on Oracle, NVARCHAR
on Sybase and Microsoft SQL server).
If you are upgrading from version 8.1 or earlier, and want to use the logging tables already created, you
will have to modify the ROBOT_MESSAGE table, since a new column has been added. You must a a
column named PROJECTNAME of type VARCHAR(255) to the ROBOT_MESSAGE table (NVARCHAR2
on Oracle, NVARCHAR on Sybase and Microsoft SQL server).
SMTP Server
This section allows you to configure a mail server that will be used for sending notifications to Kapplet
users (if notification is selected when starting the Kapplet), and for sending e-mail log messages if e-mail
logging has been enabled in the cluster settings. NOTE: for Kapplet notification e-mails to work, a from
address must also be specified under Kapplet results.
The SMTP server is configured using the following properties.
Table 36. SMTP server
Property
Description
Host
The SMTP server host name
Management Console User's Guide
217
Property
Description
Port
The SMTP server port.
User
If the SMTP server requires authentication then enter the user name
here.
Password
If the SMTP server requires authentication then enter the password
here.
Encryption
• NONE: Credentials and email are sent in clear text.
• TLS: TLS encryption is used. This only works if the SMTP server
has a trusted certificate (if the server has a self-signed certificate
it must be exported and imported into the JVM's truststore using the
keytool utility). Uses the STARTTLS SMTP extension.
• SMTPS: SMTP over SSL. A secure channel of communication
is established, over which the Credentials a email is sent. This is
rarely supported by SMTP servers , but will work even if the
server uses a self-signed certificate.
Base URL
This is the application base URL. It is used when generating results links in Kapplets, so that the e-mails
can contain links to the results residing on the Management Console server. Normally, the base URL is
configured automatically, and it is not necessary to change it.
Shared Databases
Shared databases are databases which are sent to all Design Studio clients being activated by (getting
license from) the Management Console. To simplify the user interface, these databases are configured on
a cluster. So in order for the databases available in a certain cluster to also be available to Design Studio
clients, simply select the cluster here. If one desires to have a special set of databases available for Design
Studio (for instance, maybe one is not interested in having production databases sent to Design Studio) a
special Design Studio cluster can be created on which the shared databases are defined. The default cluster
for shared databases is the default, and automatically created, Production cluster.
Kapplet Results
In this section Kapplet results settings are configured.
Table 37. Kapplet Results
Property
Description
Delete results after (hours)
How many hours that Kapplet results are residing in storage before
they are automatically cleaned up (deleted).
From address (on result e-mails) A from address used when sending results e-mails. Note that results
e-mails also require a properly configured SMTP server.
Database Types
A database type defines a given type of database, e.g. MySQL. A database type consists of the following
properties.
Management Console User's Guide
218
Table 38. Database Type Properties
Property
Description
Name
The name identifying the database type.
JDBC driver
The JDBC driver class of the driver (the driver must be uploaded under
Database Drivers).
Connection URL template
A template string defining how connection URLs for databases of the
given type look. Possible variables to use in the template string are the
following:
${ServerName}
Defines the server name (host) of the database
server.
${Schema}
Defines  the  schema  (or  database/catalog
depending on database vendor) of the database.
An  example  of  a  connection  string  template  is  the  following
'jdbc:mysql://${ServerName}/${Schema}'.  This  string
defines  the  connection  string  for  a  MySQL database  running  on
the  default  port  (no  port  is  specified),  on  the  server  given  by
${ServerName} and using the schema given by ${Schema}. The
variables are given values when databases of the given type are created
(see the cluster databases section.
Validation query
The validation query for a database is the query to use when validating
connections to the given database. Such queries varies greatly between
different types of databases.
The database types are also sent to Design Studio clients.
To add a new database type, you either select the database type category, and click the 'Add Database
Type' button, or you right-click the database type category and click the add button. NOTE: adding a
new database type should be considered an advanced and in some cases experimental feature, meaning
that the default database types are those that are supported, and there is no guarantee that a whole new
type of database will work as expected throughout the product. However, modifying the database types
in order to, for instance, add a type that defines a MySQL server running on a non-standard port would
be a normal use-case.
Database Drivers
The Database Drivers section of the settings contains uploaded database JDBC drivers. These drivers are
required by the various databases types. As with database types, uploaded database drivers are also sent to
Design Studio clients. Note that if you run your Management Console on, for instance, a MySQL database,
you need to provide Tomcat with the MySQL driver. This means that MySQL databases will work when
used in the Management Console (on the log tab or when testing the connection). However, for the MySQL
databases to also work on all RoboServers, it is necessary to upload the MySQL driver here so that it can
be sent to the RoboServers (and Design Studio).
HINT: on certain database types, you may need to tweak parameters or settings to be able to store files
larger than a certain size. For instance, on MySQL databases, you may have to increase the value of the
'max_allowed_packet' variable which in many installations are set to 1 MB meaning that database
drivers larger than 1 MB cannot be stored. Please consult the documentation for your database if you
encounter problems when uploading drivers. To help identify any problems, you will receive an error
message, and the Management Console log will contain further details.
Documents you may be interested
Documents you may be interested