Back to Connection Configuration Index Forward to Test

Link Configuration

The Administration Guide supplies detailed information on link configuration. This section contains a brief overview of the steps to take in configuring WAN links that will help you get started quickly.

Link Configuration Parameters

Wanware comes with a set of link configuration defaults, and it uses those parameters whenever you run "wanware start", the script that builds the protocol stacks. The configuration files used for the stacks are located in the directory:

/usr/lib/x25/config (for X.25 and LAPB)
/usr/lib/frel/config (for Frame Relay)
/usr/lib/tsg/config (for raw synchronous links)

The name of the link configuration file is identified in /etc/packetnets. Look for lines in this file of the form:

CONFIG link0

By default, Wanware uses file names link0, link1, link2, etc.

We recommend that you use the utility tsgconfig to make changes to the link configuration.

Configuration Keywords

You can also choose to review or modify the link configuration files directly. Link configuration is keyword driven. Each configuration file is an ASCII file, which contains a list of keywords and parameter values.

Default Configuration

The "linkx" file does not need to contain any keyword/parameter pairs. All necessary parameters have default values, which are built in during the compile process. For reference purposes only, the default configuration settings are listed in readable form in the file:

/usr/lib/x25/net.default (for X.25 and LAPB)
/usr/lib/frel/config/link.defaults (for Frame Relay)
/usr/lib/tsg/config/net.default (for raw synchronous)

Modifying the default file doesn't do anything to the default values used.

Change X.25 Link Configuration

The sections below describe the parameters which you will likely need to change to make X.25 useful for your specific network connection. You should review the service you are paying for with your network provider and use tsgconfig to set those parameters that are different from the default values.

Number of Logical Channels: bwc_num

bwc_num represents the number of X.25 Switched Virtual Circuits (SVCs) that you're running on the link. Strictly speaking, there are three classes of SVCs allowed - incoming only, outgoing only, and both-way. bwc_num is the number of both-way SVCs. Usually, bwc_num is the only non-zero number, because the number of logical channels in other classes are only used in special applications. The default value is 8. It should be set to the actual number of SVCs being provided by the network.

Packet Window Size Negotiation: window_neg

If set to YES, allows Call Setup packets to contain the "packet window size" negotiation facility. Wanware clears call requests/incoming calls which contain this facility if window_neg is NO. The clear will contain cause 3 and diagnostic 65 (41 hex).

Packet Size Negotiation: pktsize_neg

If set to YES, allows Call Setup packets to contain the "packet size" negotiation facility. Wanware clears all call requests/incoming calls which contain this facility if pktsize_neg is NO. The clear will contain cause 3 and diagnostic 65 (41 hex).

Throughput Class Negotiation: class_neg

If set to YES, allows Call Setup packets to contain the "throughput class" negotiation facility. Wanware clears all call requests/incoming calls which contain this facility if class_neg is NO. The clear will contain cause 3 and diagnostic 65 (41 hex).

Change Frame Relay Link Configuration

There is one link configuration item that will likely have to be set for each Frame Relay node: lmitype. Again, we recommend that you set this and other parameters using tsgconfig.

lmitype stands for Link Management Interface TYPE. In frame relay, there are several standards for communicating with the network's switch to determine which DLCIs are active and available for sending data. If this parameter is set incorrectly, you will see no response to Wanware's status enquiry messages sent to the network when you run tsgtrace. This, in turn, means that Wanware will not have the network's permission to send any user data. lmitype can be set to one of:

0 - No LMI protocol
1 - Frame Relay Consortium LMI
2 - ANSI ANNEX D
3 - CCITT ANNEX A

Change LAPB Configuration

The configuration for the LAPB links is held in files in the directory /usr/lib/x25/config. The parameters for the links can usually be left at their default values. The file net.default lists and describes the parameters that can be changed. Ignore the section of the default file that describes the packet layer parameters, since LAPB links can be described as X.25 links without the packet layer.

Change Raw Synchronous Configuration

There is a "defaults" file that lists and describes the link parameters. In this case the list is very short. Normally, only the frame size needs to be adjusted to be as large as or larger than that expected on the link.