Reference | Help | Introduction | Slide Show | Class Hierarchy | InterClient | ||
PREV | NEXT | FRAMES | NO FRAMES |
InterServer as a Gateway
You may setup a single InterServer to act as a gateway to
any number of remote InterBase servers
across heterogenous architectures.
The database URL to pass through an InterServer
gateway named pongo
would be:
jdbc:interbase://pongo/interbase-remote-database-file-specificationWhere
interbase-remote-database-file-specification
follows
the syntax dictated by InterBase for remote database access.
For example, for InterBase server perdy
, a database URL
to the example employee database on perdy
might be:
jdbc:interbase://pongo/perdy:/InterBase/examples/employee.gdbHere, an InterServer gateway is installed on
pongo
,
and an InterBase server is installed on perdy
.
The InterServer host must have the InterBase client software installed.
This includes gds32.dll
for Windows, libgds.so
for Solaris, etc....
TCP/IP services will be configured automatically on port 3050 for an InterBase install,
and port 3060 for an InterServer install.
URL Syntax
A database URL is used by a JDBC driver to establish a connection to a database. The general form of an InterBase database URL is
jdbc:interbase://interserverHostName:interserverPort/databaseFileSpecificationBy default, the InterServer service listens on port 3060. So normally, the :interserverPort is not given and the form of the database URL is
jdbc:interbase://interserverHostName/databaseFileSpecificationOn Unix file systems, the databaseFileSpecification starts from a root "/", so a typical database URL on a Unix host may be
jdbc:interbase://pongo//databases/employee.gdbOn Windows file systems, the databaseFileSpecification may start with a driver letter, such as "d:", or it may start from a root "/" using the default drive. So a typical database URL on a Windows host may be
jdbc:interbase://pongo/c:/databases/employee.gdb
InterServer has the ability to reside on a middle tier and proxy service to a remote InterBase server. In this case, the databaseFileSpecification must be recognizable as a remote database by the InterBase client library. So, if InterServer resides on host "pongo", and the InterBase server resides on host "perdy", then a typical database URL may be
jdbc:interbase://pongo/perdy:/databases/employee.gdbOr more generally
jdbc:interbase://interserverHostName/interbaseHostName:databaseFilefor a TCP/IP connection from InterServer to InterBase. Refer to the InterBase documentation for more information about valid databaseFileSpecifications for remote servers.
Reference | Help | Introduction | Slide Show | Class Hierarchy | InterClient | ||
PREV | NEXT | FRAMES | NO FRAMES |