Using the Server Logical Mapper

Server provides a logical mapper, named tcpd, which must run on each machine that runs a server or a named component (for example, if you give a name to a component using the -ilsn command line option).

This logical mapper stores associations between named servers and the TCP ports they are using. The component connects to the server as follows:

  1. The component connects to the logical mapper running on the server machine and asks on which port the server is listening for incoming connections.

  2. The component connects to the server using this port.

By default the Server logical mapper is designed to listen on the TCP port 8000, but you can change this default value by setting the environment variable ILS_TCPD_LISTEN_PORT on the machine running the daemon and on the client machine. You can also use the command line option

-port <port number>

to specify a listen port.

Example

Run the following command to start a logical mapper on the TCP port 8001:

tcpd -port 8001

On Windows® platforms, you can run this logical mapper as a Windows Service. To install the logical mapper as an NT service, use the following options:

tcpdsvc.exe -install

or

tcpdsvc.exe -installauto

To remove the previously installed services, use:

tcpdsvc.exe -remove

Use the Services section of the Control Panel to start and stop the service. You can use the Startup Parameter text box in the Control Panel to specify -port <portnumber> option before starting the service. An icon is installed on the task bar; it allows you to close the logical mapper, reinitialize it, or display the current mapping.