System TCP Keepalive Settings

You can configure the Oracle® Enterprise Session Border Controller to control TCP connections by setting:

• The amount of time the TCP connection is idle before the Oracle® Enterprise Session Border Controller starts sending keepalive messages to the remote peer
• The number of keepalive packets the Oracle® Enterprise Session Border Controller sends before terminating the TCP connection

If TCP keepalive fails, then the Oracle® Enterprise Session Border Controller will drop the call associated with that TCP connection.

In the ALCI, a configured set of network parameters appears as follows:

network-parameters
        tcp-keepinit-timer             75
        tcp-keepalive-count            4
        tcp-keepalive-idle-timer       400
        tcp-keepalive-interval-timer   75
        tcp-keepalive-mode             0

Then you apply these on a per-interface basis. For example, the H.323 interface (stack) configuration allows you to enable or disabled use of the network parameters settings.

System TCP Keepalive Configuration

TCP setting are global, and then enabled or disabled on a per-interface basis.

To configure TCP keepalive parameters on your Oracle® Enterprise Session Border Controller:

Note:

If you want to use the default values for TCP keepalive, you do not need to take Steps 1 through 4. You can simply set the TCP keepalive function in the H.323 stack configuration, and the defaults for network parameters will be applied.

1. In Superuser mode, type configure terminal and press Enter.

   ORACLE# configure terminal

2. Type system and press Enter to access the system-related configurations.

   ORACLE(configure)# system

3. Type network-parameters and press Enter. The system prompt changes to let you know that you can begin configuring individual parameters.

   ORACLE(system)# network-parameters
   ORACLE(network-parameters)#

4. tcp-keepinit-timer—If a TCP connection cannot be established within some amount of time, TCP will time out the connect attempt. It can be used to set the initial timeout period for a given socket, and specifies the number of seconds to wait before the connect attempt is timed out. For passive connections, this value is inherited from the listening socket. The default is 75. The valid range is:

   • Minimum—0

   • Maximum—999999999.

5. tcp-keepalive-count—Enter the number of packets the Oracle® Enterprise Session Border Controller sends to the remote peer before it terminates the TCP connection. The default is 8. The valid range is:

   • Minimum—0

   • Maximum—223-1

6. tcp-keepalive-idle-timer—Enter the number of seconds of idle time before TCP keepalive messages are sent to the remote peer if the SO-KEEPALIVE option is set. This option is set via the h323-stack configuration element. The default is 7200. The valid range is:

   • Minimum—30

   • Maximum—7200

7. tcp-keepalive-interval-timer—When the SO_KEEPALIVE option is enabled, TCP probes a connection that has been idle for some amount of time. If the remote system does not respond to a keepalive probe, TCP retransmits the probe after a set amount of time. This parameter specifies the number of seconds to wait before retransmitting a keepalive probe. The default value is 75 seconds. The valid range is:

   • Minimum—15

   • Maximum—75

8. tcp-keepalive-mode—Set the TCP keepalive response sequence number. The default is 0. The valid values are:

   • 0—The sequence number is sent un-incremented

   • 1—The number is incremented

   • 2—No packets are sent