Configuring an IP interface

The following table describes the IP configuration commands that must be set in the TDM configuration utility, txconfig:

Command

Description

ifopt

Sets an IP interface option.

ifcreate

Defines an IP interface.

gateway

Defines a gateway route.

mate

Assigns the IP address of the TX board's redundant mate board. Required in a redundant configuration for both SIGTRAN and TDM networks.

ethtrace

Controls Ethernet data tracing.


ifopt command

The ifopt command sets an IP interface option using the following syntax:

ifopt [!]<optName>[ = <optValue>]

where:

Value

Description

optName

optName indicates that the option is enabled.

!optName indicates that the option is disabled.

optValue

Value options are specified as:

optName = optValue


The following table lists the valid option names:

Option name

Type

Description

PINGBLOCK

BIT

Indicates if automatic responses to PING messages are blocked.

MTU

VALUE

Maximum transmission unit (in bytes).

FRAGDROP

SECS

Partial fragment drop timeout.

HOPLIMIT

VALUE

Reserved for future use.

ICMPRATE

VALUE

Reserved for future use.

IPV6

BIT

Reserved for future use.

IPSEC

BIT

Reserved for future use.

NDATTEMPTS

VALUE

Specifies the neighbor discovery attempt (NDA) limit for the specified Ethernet interface.

NDRETRAN

SECS

Neighbor discovery retransmission timeout.

NDREACH

SECS

Reserved for future use.

ARPRETRY

MSECS

Amount of time to wait after issuing an ARP request before re-transmitting the same ARP request.

ARPMAX

VALUE

Maximum number of times to retry an ARP request before terminating retry attempts and considering the remote entity to be unreachable.

ARPREACH

MSECS

Maximum amount of time without receiving any message from the remote IP address before probing to verify connectivity.

ARPUNUSED

MSECS

Amount of time that an unused ARP entry remains in the ARP table. An ARP entry is used each time an outbound IP packet is sent to the remote entity for the given ARP entry.


Examples

Enter the following command to block responses to received PING requests:

ifopt pingblock

 

Enter the following command to drop all fragments if incomplete after 10 seconds:

ifopt fragdrop 10

ifcreate command

The ifcreate command defines an IP interface that uses either:

An interface is created with default options unless options were specifically set using previous ifopt commands.

Using DHCP

The ifcreate command syntax using DHCP is:

ifcreate intfNum DHCP

where:

Value

Description

intfNum

1-based Ethernet interface number.

DHCP

Obtains the IP address, network mask, and default gateway.


The following example shows an interface that uses DHCP:

ifcreate 1 dhcp

 

Not using DHCP

The ifcreate command syntax when not using DHCP is:

ifcreate intfNum IPaddr mask

where:

Value

Description

intfNum

1-based Ethernet interface number.

IPaddr

IP address to assign to the interface.

mask

IP subnet mask.


 

The following example shows an interface with a specific address and mask:

ifcreate 2 10.3.9.15 255.255.255.0

gateway command

The gateway command defines a gateway route using the following syntax:

gateway IPaddress mask gatewayAddress

where:

Value

Description

IPaddress

IPv4 address in dot notation. For example, 1.2.3.4.

mask

Mask associated with IP address, in dot notation.

gatewayAddress

IPv4 address, in dot notation, of routing gateway.


Example

The following example sends all traffic not covered by a more specific route to the gateway at 10.1.0.1:

gateway 0.0.0.0 0.0.0.0 10.1.0.1

mate command

The mate command assigns the IP address of the TX board's redundant mate using the following syntax:

mate IP address | NONE

where:

Value

Description

IP address

IPv4 address in dot notation, for example 1.2.3.4.

NONE

No mate IP address (default).


Example

The following example indicates that the TX board's redundant mate is at address 10.1.1.2:

mate 10.1.1.2

Refer to the Dialogic® TX Series SS7 Boards Health Management Developer's Reference Manual for information about SS7 redundancy.

ethtrace command

The ethtrace command controls Ethernet data tracing using the following syntax:

ethtrace <iface|*> on [<hostchan>]|off

To activate tracing of all Ethernet traffic as part of the TX board boot process, add the following command to the TX configuration file:

ethtrace * ON

This causes the TX board to trace all packets (sent or received over any on-board Ethernet interface) to the default trace channel (47). The ss7trace utility uses Channel 47 to receive all types of SS7 tracing. Refer to the Dialogic® TX Series SS7 Boards TX Utilities Manual for information about ss7trace.

Examples

The following example shows how Ethernet tracing can be activated for specific interfaces:

ethtrace 1 on
ethtrace 2 on

Ethernet tracing can also be directed to channels other than the default channel. The following example causes Ethernet 1 to trace to host channel 101 while Ethernet 2 traces to host channel 102:

ethtrace 1 on 101
ethtrace 2 on 102

To deactivate tracing, run the txconfig utility without a configuration file (interactive mode) and enter the following command:

txconfig> ethtrace * off