SOCKET_FAMILY

The SOCKET_FAMILY element specifies whether domain sockets or TCP sockets are to be used on Linux®/UNIX™ systems.

Syntax

<SOCKET_FAMILY> type </SOCKET_FAMILY>

type specifies the type of socket to use, TCP or UNIX.

Child elements

There are no child elements.

Usage

You use this element to specify whether domain sockets or TCP sockets are to be used on Linux/UNIX systems. By default, the Genero Application Server uses Linux/UNIX domain sockets to communicate between the dispatcher and the proxies on Linux/UNIX systems. On Windows® the GAS uses TCP sockets to communicate between the dispatcher and proxies .

To use TCP sockets on Linux/UNIX, change the SOCKET_FAMILY element value to TCP.

Warning: Forcing TCP sockets on UNIX should only be done for debugging purposes, at the request of support.

On Windows, the SOCKET_FAMILY element is configured to TCP, but it is not used. It must exist, however, as it is required by the schema validating the file.

Usage example

<RESOURCE_LIST>
  <WNT>
    <RESOURCE Id="res.dispatcher.socket.family" Source="INTERNAL">TCP</RESOURCE>
    <RESOURCE Id="res.dispatcher.socket.path" Source="INTERNAL">C:\temp</RESOURCE>
  </WNT>
  <UNX>
    <RESOURCE Id="res.dispatcher.socket.family" Source="INTERNAL">UNIX</RESOURCE>
    <RESOURCE Id="res.dispatcher.socket.path" Source="INTERNAL">/tmp</RESOURCE>
  </UNX>
...
<INTERFACE_TO_CONNECTOR>
  <TCP_BASE_PORT>$(res.ic.base.port)</TCP_BASE_PORT>
  <TCP_PORT_OFFSET>$(res.ic.port.offset)</TCP_PORT_OFFSET>
  <DOCUMENT_ROOT>$(res.path.docroot)</DOCUMENT_ROOT>
  <TEMPORARY_DIRECTORY>$(res.path.tmp)</TEMPORARY_DIRECTORY>
  <SOCKET_FAMILY>$(res.dispatcher.socket.family)</SOCKET_FAMILY>
  <SOCKET_PATH>$(res.dispatcher.socket.path)</SOCKET_PATH>
</INTERFACE_TO_CONNECTOR>

Parent elements

This element is a child of the INTERFACE_TO_CONNECTOR element.