Configuring the Port Service on Client and Server

•If RemoteServiceName has been uncommented, but not RemoteServicePort, then the port service name is substituted only if it has not been overridden already by the -p switch.

•If RemoteServicePort has been uncommented, but not RemoteServiceName, then the port number is substituted only if it has not been overridden already by the -p switch.

•If both RemoteServicePort and RemoteServiceName are uncommented, then the RemoteServiceName takes precedence if it has not already been overridden by a -p argument. If there is already a port service name override, the RemoteServiceName value is ignored and the RemoteServicePort value overrides 3050.

•At this point, if an override of either the port number or the service name has been signaled, both v.1.0 and v.1.5 servers proceed to check the Services file for an entry with the correct combination of service name and port number. If a match is found, all is well. If not, and the port service name is not gds_db, the server will throw an exception and fail to start. If gds_db is the port service name and it cannot be resolved to any other port, it will map to port 3050 automatically.

If the default service name is to be overridden, then you will need to make an entry in the Services file--see the topic below, Configuring the Services File.

Using the -p switch override

Note

Please note that this switch is available in Firebird 1.0.x, too, but was previously undocumented.

Starting the server with the optional -p switch enables you to override either the default port number (3050) or the default port service name (gds_db) that the server uses to listen for connection requests. The switch can override one, but not both.

From Firebird 1.5 onward, you can use the -p switch in combination with a configuration in firebird.conf to enable an override to both the port number and the port service name.

Syntax for TCP/IP

The command-line syntax for starting a server that applications are going to access through TCP/IP is as follows:

server-command <other switches> -p port-number | service-name

For example, to start the Superserver as an application and override the service name gds_db with fb_db:

88