TCP/IP Transport

The TCP/IP transport must be used when the database server and client are on different computers. For connections on the same computer, the fast Hybrid Pipe Shared Memory (HPSM) transport is recommended, although TCP/IP or the JadeLocal transport can be used. See also "RPC, Database, and Node Configuration", later in this chapter.

The following JADE initialization file parameters are required to use the TCP/IP transport.

[JadeServer]
NetworkSpecification<n>=transport-type,enabled|disabled,
                        listener-port[,interface]

[JadeClient]
ServerNodeSpecifications=transport-type,remote-host,remote-port
                         [,local-interface[,local-port]]

Alternatively, use the server argument in a command line to specify the server Universal Resource Identifier (URI) target database and the client-server transport, instead of the server and path arguments in a command line and the ServerNodeSpecifications parameter in the [JadeClient] section of the JADE initialization file. For details, see "Format of the Server URI String", later in this chapter.

The values (which are case-insensitive) for the transport-type variable in the NetworkSpecification parameter are:

• TcpIP, which is a synonym for TcpIPV4.

• TcpIPv4, which provides IP version 4 connections only.

• TcpIPv6, which provides IP version 6 connections only.

If you want the server to support both network protocols, you must define a network specification for each protocol.

You can specify the interface value as a host name or an IP address. If you use an IP address, the address must be in an appropriate format for the specified transport-type value. Specify the local interface name or IP address if you want to select a specific network adapter in a database server node that has more than one network adapter installed; for example, to enable an administrator to ensure connections from clients connect on the fastest interface or to allow easier security when used in conjunction with a firewall or router access list. (JADE defaults to all network adapters in the node.)

The values for the transport-type variable in the ServerNodeSpecifications parameter are:

• TcpIP, which is a synonym for TcpIPAny.

• TcpIPAny, which connects using IP version 4 or 6.

• TcpIPv4, which connects using IP version 4.

• TcpIPv6, which connects using IP version 6.

You can specify the remote-host and local-interface values as a host name or an IP address. If you use an IP address, the address must be in an appropriate format for the specified transport type value. If you specify a host name, all DNS-provided addresses will be attempted.

For the TcpIPAny transport type, the client will first attempt to connect via IP version 6 and then IP version 4 protocol on the provided IP addresses. Each connection failure will be logged, and the next available combination tried.