Installing the Connection Agent

 Previous  Home topic  Next  Print this topic Send Feedback

Jump to a Section

Installation on Tomcat 6 Web Server

Installation on WebSphere Application Server (Windows/Linux)

 

 

The PerfectForms™ connection agent installation package contains the PerfectForms™ connection agent application and additional required libraries. These additional libraries are open source JAR libraries that contain drivers for PerfectForms™ connection agent connectivity with different types of database servers and other utilities libraries.

 

mysql-connector-java-5.1.6-bin.jar

JDBC driver for connecting to MySQL database servers

 

jdbcLdap.jar

JDBC driver for connecting to LDAP servers

 

ojdbc14.jar

JDBC driver for connecting to Oracle database servers

 

jtds-1.2.jar

JDBC driver for connecting to SQL Server and Sybase database servers

 

dom4j-1.6.1.jar

Utility library

 

jaxen-1.1-beta-6.jar

Utility library

 

ldap.jar

Utility library

 

 

Note: If you already have some of these libraries installed on your Web server, verify that they are the correct versions for the connection agent to work correctly.

 

 

Installation on Tomcat 6 Web Server

 

Document Icon
1.Copy the PerfectFormsAgent Web project archive (PerfectFormsAgent.war) into Tomcat’s Web applications folder (tomcat_install_dir/webapps/).
2.Copy crossdomain.xml file into Tomcat’s ROOT application folder (tomcat_install_dir/webapps/ROOT/).
3.Start Tomcat Server or restart if it’s already running.
4.Check if PerfectFormsAgent has started by opening a new browser window and going to link: http://tomcat_url:port/PerfectFormsAgent.

Note: For the link noted in Step 4, the archive name comes after the "/". For example, http://tomcat_url:port/PerfectFormsAgent becomes http://localhost:8080/ConnectionAgent11807/ if the name of the archive is ConnectionAgent11807.war.

 

Installation on WebSphere Application Server (Windows/Linux)

Preinstall Requirements: WebSphere Application Server 7 and JDK 6

 

In order for the connection agent to accept requests from the PerfectForms application, the WebSphere application server needs to have a crossdomain.xml policy file installed in the root directory of the Web server according to the procedure described below. If there is already an application running at the root directory level, this application must be uninstalled before deploying the crossdomain.war file.

 

Document Icon
1.Log in to the WebSphere Application Server admin console.

WebSphere Admin Console Login

2.Stop the default application in Applications > Enterprise Applications.
3.Uninstall the default application in Applications > Enterprise Applications.
4.Save to the master configuration.
5.Select Applications > Install New Application.
6.Select the crossdomain.war file to deploy with a Context Root = '/'.
7.Click Next, then continue with the default values.
8.At Step 2, Map Modules to Server, check the box in front of crossdomain.
9.Click Next.
10. At Step 3, Map Virtual Hosts ..., check the box in front of crossdomain.
11. Click Next.
12. Click Finish.
13. Save to the master configuration.
14. Start the crossdomain application by selecting Applications > Enterprise Applications.
15. Test the following URL in a browser (http://[WAS_name]:[http_port]/crossdomain.xml).

 

Open the WebSphere application server admin console, log in and navigate to Applications > Application Types > WebSphere Enterprise Applications, then follow the steps below.

 

1.Click Install.

WAS Installation - Step 1

2.Provide location of the ConnectionAgent.ear file then click Next.

WAS Installation - Step 2

3. Click Next.

WAS Installation - Step 3

4. Fill in the name of the PerfectForms directory on which you want to install the application and enter the application name.

WAS Installation - Step 4

5. Click Next.

WAS Installation - Step 5

6. Check the box in front of the connection agent module name then click Next.

WAS Installation - Step 6

7. Check the box in front of the connection agent Web module name then click Next. Click Finish.
WAS Installation - Step 7
8. Save to the master configuration.

WAS Installation - Step 8

9. Start the connection agent application.

WAS Installation - Step 9

10. Test the connection agent URL in a browser (http://[WAS_name_or_IP]:[http_port]/ConnectionAgent)

WAS Installation - Step 10

Updated: 06/12/2011  Page url: http://www.perfectforms.com/Documentation/manual/html/?installaing_the_lookup_agent.htm
PerfectForms™ -- forms software, workflow software, and business process management