selectpdf c# example : Adding hyperlinks to a pdf SDK software service wpf winforms .net dnn WATUsageGuide42-part886

Control Center User's Guide
419
Managing Robots
This section explains how to manage robots using the Control Center.
Monitoring Robots
The robots can be monitored by selecting the Robots category in the tree view. The main view will then
show an overview of the robots on all registered RoboServers as shown below:
Monitoring All Robots
If the RoboServers subcategory is selected, the main view shows an overview of the robots on the
individual RoboServers:
Adding hyperlinks to a 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 hyperlink pdf; adding hyperlinks to a pdf
Adding hyperlinks to a 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
add a link to a pdf in preview; add link to pdf acrobat
Control Center User's Guide
420
Monitoring Robots on RoboServers
If you select a single RoboServer in the tree view (or if you double click on the RoboServer in the table),
the main view shows an overview of the robots on this particular RoboServer:
Monitoring Robots on a RoboServer
Control Center User's Guide
421
If you select a robot in the table in the main view, details about this particular robot are shown below
the table:
Monitoring a Robot
Stopping Robots
Robots are stopped by selecting a robot and clicking the  icon. This brings up a dialog asking you to confirm
the stopping of the robot. Note that this should only be done if you do not want the robot to stop by itself.
You can stop more than one robot by selecting the robots in a table in the main view and do as described
above, or by right clicking the selected robot and choosing "Stop Robot...".
You can stop all robots on a particular RoboServer by selecting a RoboServer and clicking the  icon.
You can stop all robots on all RoboServers by selecting the RoboServers category, the Robots category,
or the RoboServers subcategory and clicking the  icon.
Other Control Center Features
This section explains how to use the features of the Control Center that are not directly related to managing
RoboServers and robots.
Exporting and Importing the RoboServer List
Whenever you shut down the Control Center, the list of registered RoboServers is automatically saved,
and when you start the Control Center again, the list is loaded again.
However, you can also export and import the RoboServer list manually. Once a RoboServer list is exported
to a file, it can be imported on other Control Center installations. This allows you to avoid registering your
RoboServers on each installation, and instead easily export and import the settings.
Control Center User's Guide
422
Exporting the RoboServer List
The  current  RoboServer  list  can  be  exported  by  opening  the  File  menu  and  selecting  "Export
RoboServers...".
Importing a RoboServer List
A RoboServer list can be imported by opening the File menu and selecting "Import RoboServers...".
When you import a RoboServer list, you register all RoboServers in the list that are not already registered.
RoboServers that use the same protocol as a RoboServer already registered (but possibly with a different
name) are not registered again.
Editing Settings on a Remote RoboServer
From the Control Center, you can edit the settings of a connected RoboServer by clicking the  icon. This
brings up a dialog similar to the one shown below:
Editing Settings
After changing the settings, you must restart the RoboServer in order for the changes to take effect.
423
Management Console in Tomcat
By default, Management Console is run as an embedded component inside RoboServer, which makes for
easy installation. As an alternative, it can be deployed as a regular web application on a standalone Tomcat
5.5, 6 or 7 web server. The following table lists the differences in feature set.
Table 147. Management Console features and configuration
Feature
Embedded
Standalone J2SE Web Container (Enterprise)
Authentication
Single user defined in Settings
Role based security by project. Roles are obtained
through LDAP or other provider
Management
Console  data
store
Embedded Derby database
Container  managed  Data  Source  (supported
platforms)
Instructions  on  configuring  an  embedded  Management  Console  can  be  found  in  the  RoboServer
Configuration  section.  An  embedded  Management  Console  is  started  as  described  in  Starting  the
Management Console.
Detailed instructions on deploying Management Console in a Tomcat web container are found on the
following pages.
Notes on Upgrading
If you have been running a previous version of Management Console this section will inform you how
to upgrade to 9.2.0
Upgrading involves the following steps
• Create a backup of your data from the previous version of Management Console
• Install Management Console
• Update the Management Console configuration
• Restore the backup
Create a backup
Check  the  online  documentation  of  your  previous  version  of  Management  Console  to  learn
how  to  create  a  backup.  9.1  [http://help.kapowtech.com/9.1/topic/doc/sc/OptionsTab.html]  9.0
[http://help.kapowtech.com/9.0/topic/doc/sc/OptionsTab.html] 8.2 [http://help.kapowtech.com/8.2/topic/
doc/sc/OptionsTab.html]  8.1  [http://help.kapowtech.com/8.1/topic/doc/sc/OptionsTab.html]  8.0 [http:/
/help.kapowtech.com/8.0/topic/doc/sc/OptionsTab.html]  7.2  [http://help.kapowtech.com/7.2/topic/doc/
sc/OptionsTab.html]  7.1  [http://help.kapowtech.com/7.1/topic/doc/sc/OptionsTab.html]  7.0  [http://
help.kapowtech.com/7.0/topic/doc/sc/OptionsTab.html]
Install Management Console
Follow the next steps in this guide to learn how to install the Management Console. If you are upgrading
from 8.1 or later you can reuse your old Configuration.xml, see next section.
Management Console in Tomcat
424
Upgrade Management Console configuration
If you are upgrading from version 8.0 or earlier, you will have to re-configure your new Management
Console from scratch. Prior to version 8.1 some configuration was done in web.xml this is no longer the
case. You may no longer copy or modify the web.xml.
Most configuration is done in Configuration.xml. This file may be copied from previous versions.
Copy the Configuration.xml from the previous version into WEB-INF/ overriding the version
already there. Once you start Management Console it will create a new Configuration.xml based
on your old version, you must then copy the upgraded version into WEB-INF/ overriding your old
configuration. Instruction should display when you access Management Console web interface.
As of version 8.2 , LDAP integration is no longer container managed. If you used LDAP for authentication
in a previous version, you should remove the Realm definition in the ManagementConsole.xml
inside Tomcat's conf/Catalina/localhost/. LDAP integration is now configured in WEB-INF/
login.xml, as described in LDAP Integration
Restore the backup
Check the Management Console user's guide for details on how to restore a backup.
Deploying into Tomcat
We will now detail how to install the Management Console on a stand alone J2SE web container. For this
guide we have chosen Tomcat, the distribution has been tested on Tomcat 5.5, 6.0 and 7.0. Your J2SE web
container must be using the Java 1.6 runtime or newer.
Configuring ManagementConsole.war
The Management Console application comes in the form of a Web Application Archive (a WAR file)
named ManagementConsole.war and is located inside the /WebApps folder in the Kapow Katalyst
installation folder.
The version of ManagementConsole.war that ships with Kapow Katalyst is configured to run embedded
inside RoboServer, before you can deploy it as a standalone application on Tomcat it must be reconfigured
to fit your environment.
A WAR-file is compressed using zip, in order to access the configuration files you will have to explode
(unpack) it. Once the configuration files are updated you re-zip and deploy ManagementConsole.war to
you Tomcat server.
The  table  below  contains  a  list  of  the  configuration  files  relative  to  the  root  of  the  un-zipped
ManagementConsole.war
Table 148. Configuration files
File
Configures
Notes
WEB-INF/
Configuration.xml
Clustering, password encryption, REST-Plugin
If  you  copy  the  version
of  the  file  from  8.1,
it  will  automatically  be
upgraded  once  you  start
the Management Console
Management Console in Tomcat
425
File
Configures
Notes
WEB-INF/
login.xml
Administrators and users, this is where you integrate with LDAP
WEB-INF/
roles.xml
Permissions for various application roles
WEB-INF/
classes/
log4j.properties
application logging
Spring configuration files
Configuration.xml,  login.xml  and  roles.xml  are  all  Spring  configuration  files
(www.springsource.org [http://www.springsource.org/]) and share the same general syntax which we will
outline here.
Spring is configured through a series of beans, each bean has a number of properties which configures a
piece of code inside the application. The general syntax is:
<bean id="id" class="SomeClass">
<property name="myName" value="myValue"/>
</bean>
Table 149. Part
part
Configures
id="id"
The id of the bean is an internal handle, that the application use
to refer to the bean. It is also referred to as the beans name
class="SomeClass"
The  class  identifies  the  code  component  which  the  bean
configures.
<property
name="myName"
value="myValue"/
>
Defines a  property with the name  myName and the value
myValue. This configures a property on the code component
defined by the class attribute
The only part of spring beans that you may need to change is the value attribute of the <property
name="myName" value="myValue"/>, for example if you want to change the admin user defined
in login.xml;
<bean class="com.kapowtech.mc.config.HardCodedUser">
<property name="userName" value="admin"/>
<property name="password" value="admin"/>
<property name="groups" value="ADMINISTRATOR"/>
</bean>
You can change the values of the userName, password, and groups properties to define a user with a
different userName, password, and group association.
Sometimes the property value of a bean is a list of nested beans, like the list of hard coded users in
login.xml, which is defined like this
<bean id="hardCoded" class="com.kapowtech.mc.config.HardCodedLogin" lazy-init="true">
Management Console in Tomcat
426
<property name="users">
<list>
<bean class="com.kapowtech.mc.config.HardCodedUser">
<property name="userName" value="admin"/>
<property name="password" value="admin"/>
<property name="groups" value="ADMINISTRATOR"/>
</bean>
<bean class="com.kapowtech.mc.config.HardCodedUser">
<property name="userName" value="dev"/>
<property name="password" value="dev"/>
<property name="groups" value="DEVELOPER"/>
</bean>
<-- More beans may be here -->
</list>
</property>
</bean>
In case you need more hard coded users, you can add them by copying an existing HardCodedUser bean
in the list and modifying the userName, password and groups property values. Notice that nested beans
often don't have any id. Lists may also contain simple values like the adminGroups bean in login.xml
<bean id="adminGroups" class="com.kapowtech.mc.config.AdminGroups">
<property name="adminGroups">
<list>
<value>ADMINISTRATOR</value>
</list>
</property>
</bean>
This defines a simple list where each value is just a text string.
Troubleshooting
If you have any problems during the installation, you should check the Tomcat log in the /logs folder
in your Tomcat installation. During the configuration process it is often easier to run Tomcat from the
command line, as it will then print error messages directly in the command line window.
Creating a new Database
We strongly recommend that you create a new database for the tables used by the Management Console.
There are two requirements to the database.
• Unicode support
• Case-sensitive comparison
Unicode support is needed because non-ASCII characters, like Danish Æ, German ß or Cyrillic # may be
given as input to robots. This input is stored in the database, and without Unicode support these characters
may be stored incorrectly.
Case-sensitive comparison is needed because it is possible to upload a robot named a.robot and another
named A.robot. Without case-sensitive comparison uploading the latter would override the first.
Management Console in Tomcat
427
Database servers handles Unicode and case-sensitive comparison very differently. The following list
contains recommendations for the supported database systems.
Table 150. Recommendations for Unicode support and case-sensitive comparison
Database
Recommendations
IBM DB2
Create the database using CODESET UTF-8
MySQL 5.x
Create the database with utf8_bin collation:
CREATE DATABASE KAPOW_MC COLLATE utf8_bin
Oracle
We use NVARCHAR2, NCLOB types for Unicode. For case-sensitive comparison ensure
that NLS_COMP is set to BINARY
Microsoft SQL
Server  2005/
2008
We use NVARCAR, NTEXT types for Unicode. For case-sensitive comparison create the
database with a Case-Sensitive collation like SQL_Latin1_General_CP1_CS_AS:
CREATE 
DATABASE 
KAPOW_MC 
COLLATE
SQL_Latin1_General_CP1_CS_AS
Sybase
Adaptive
Server
Enterprise
We use NVARCAR, NTEXT types for Unicode. For case-sensitive comparison ensure that
the sort order is binary (see sp_helpsort).
The  scripts below  use "NVARCHAR(255)  NOT NULL  UNIQUE", due  to  index
limitations this will not work on an ASE with 2K page size, unless you modify the scripts
to use NVARCHAR(200) NOT NULL UNIQUE (or install on a 4/8/16K page server)
The tables used by the Management Console can be grouped into 3 categories: Platform tables, logging
tables, and data view tables. The platform tables hold information exclusive to the Management Console
such as the uploaded robots and their scheduling information, while the logging and data view tables are
shared with RoboServer.
User privileges
When the Management Console starts, it will automatically try to create the required platform tables and
logging tables (if not already created by RoboServer). This means that the user account used to access
the database must have the CREATE TABLE and ALTER TABLE privilege. Oracle users also needs the
CREATE SEQUENCE privilege. If this is not possible you can have your Database administrator create
the tables using the scripts below.
Additionally the user must be allowed to SELECT, INSERT, UPDATE, DELETE for the system to work
properly.
SQL scripts for Management Console tables
Table 151. SQL scripts for Management Console tables (right-click and choose
"Save As")
Database
Script to Create Tables
Script to Drop Tables
IBM DB2
create 
[sql/platform/
db2_create.sql]
drop [sql/platform/db2_drop.sql]
MySQL 5.x
create 
[sql/platform/
mysql_create.sql]
drop 
[sql/platform/
mysql_drop.sql]
Oracle
Management Console in Tomcat
428
Database
Script to Create Tables
Script to Drop Tables
create 
[sql/platform/
oracle_create.sql]
drop 
[sql/platform/
oracle_drop.sql]
Microsoft SQL Server 2005/2008
create 
[sql/platform/
sqlserver_create.sql]
drop 
[sql/platform/
sqlserver_drop.sql]
Sybase Adaptive server
create 
[sql/platform/
sybase_create.sql]
drop 
[sql/platform/
sybase_drop.sql]
The Management Console uses a 3rd party scheduling component called Quartz. Quartz also requires
a number of tables which must reside among the other platform tables. These tables are also created
automatically when the Management Console starts, or may be created manually using the scripts below.
SQL scripts for Quartz tables
Table 152. SQL scripts for Quartz tables (right-click and choose "Save As")
Database
Script to Create Tables
Script to Drop Tables
IBM DB2
create 
[sql/quartz/
quartz_db2_create.sql]
drop 
[sql/quartz/
quartz_db2_drop.sql]
MySQL 5.x
create 
[sql/quartz/
quartz_mysql_create.sql]
drop 
[sql/quartz/
quartz_mysql_drop.sql]
Oracle
create 
[sql/quartz/
quartz_oracle_create.sql]
drop 
[sql/quartz/
quartz_oracle_drop.sql]
Microsoft SQL Server 2005/2008
create 
[sql/quartz/
quartz_sqlserver_create.sql]
drop 
[sql/quartz/
quartz_sqlserver_drop.sql]
Sybase Adaptive server
create 
[sql/quartz/
quartz_sybase_create.sql]
drop 
[sql/quartz/
quartz_sybase_drop.sql]
Creating a Tomcat context file
In an enterprise environment databases are often accessed through a data source. This guide will show you
how to configure your Tomcat with a data source that connects to a local MySQL database server.
In  Tomcat  data  sources are  defined  within the  applications  context. The context may  be  declared
either embedded or external to the application. When the context is embedded it is defined in the file
context.xml, which must be located inside the WAR file inside the META-INF folder. When declared
externally the file must be located in Tomcat's /conf/Catalina/localhost folder and the name
of the file must be ManagementConsole.xml (same name as the deployed WAR file). Although Tomcat
recommends deploying with an embedded context, as it provides a single deployment unit, we will use an
external context definition in this guide, as it makes modifying the file easier. Once you have refined your
configuration, you can embed the context file and deploy the War file to your production environment.
Adding platform data source
Create the file ManagementConsole.xml inside Tomcat's/conf/Catalina/localhost folder
and add the following content:
<Context>
<!-- Default set of monitored resources -->
Documents you may be interested
Documents you may be interested