Activating the CONNX JDBC Router

If either of the following is true in your environment, you need to deploy the CONNX JDBC Router.

  • You want your client machines to be able to execute applets that use JDBC on a non-Windows server.

  • Your Internet and intranet clients cannot connect to port 7500 on the machine running the CONNX JDBC server because of firewall issues. 

If either of the above statements is true, the CONNX JDBC Router must be deployed. The CONNX JDBC Router is a Java executable that acts as if it were the CONNX JDBC Server. Clients connect to the IP address of the machine on which the router is located (instead of the CONNX JDBC Server). The router then accepts client requests, but instead of processing the requests, dispatches the packet to the CONNX JDBC Server. The router then receives a reply from the CONNX JDBC Server, and sends it back to the client. This dispatcher function enables clients to function with firewalls or preexisting applet security.

If both of the statements are not true, this step is unnecessary. Proceed to Connecting to the CONNX JDBC Server to continue.

For more information on the CONNX JDBC Router, see CONNX JDBC Router in the CONNX User Reference Guide, available either online, on the CONNX CD-ROM, or within the CONNX product.

 

To activate the CONNX JDBC Router

  1. Install the content of the router on a non-Windows Web server. It will be necessary to have Classpath defined to point to the correct JDK. The Classpath should include the connxrouter.jar file.

Example:

export CLASSPATH=<unix installation directory>/java/ftp/connxrouter.jar;:$CLASSPATH
 

For more information about setting the Classpath, refer to CONNX JDBC Driver, in the CONNX User Reference Guide, either online, on your CONNX CD-ROM, or within the CONNX product. For more information about transferring the .jar file, see Moving a Client to a Non-Windows Platform by Transferring the .jar File.

  1. Invoke the Router by typing the following command on the command line of your native machine.

java com.Connx.Router.TCRouter <ip address or name of CONNX JDBC Server> <Server Port Number> <Router Port Number>

The following table contains a description of the above syntax:

 

Router syntax

Syntax

Description

IP Address

IP address of your machine or host name of your machine.

Server Port Name

Port number from 0 to 99. Default is 7500.

Router Port Number

Port number created by user that does not conflict with exiting Port number.

 

Related Topics

image\CHICLET.gif Moving a Client to a Non-Windows Platform by Transferring the .jar File