Changing the System Configuration

It is sometimes necessary to change the configuration of the protocol software. Perhaps other components in your system have changed or you didn't have all the information during installation, resulting in some incorrect choices. This section describes how to make changes to system configuration without having to reinstall the product.

Note that this section covers driver changes. That is, changes to how the device driver communicates with the card and how applications can communicate with the kernel. If you want to change the link configuration (that is, how the card communicates with the network), see X.25 Link Configuration or Frame Relay Configuration.



Changing /etc/packetnets

The association of a particular network identifier (netid) to a board and link number is found in the /etc/packetnets file. For example, programs written to make calls on the X.25 lines may refer to either a netid or a network name when placing the call.

This file will typically have entries such as:

NETID0  
 NAME link0
 TYPE X25
 CONFIG link0
 BRDTYPE SGP
 NETWORK /dev/x25pkt
 OPEN /dev/sgp
 ATTACH 0
 PUSH x25trc
 SETNID  
 ILINK /dev/x25frm
 ILINK /dev/x25pkt
 SETNID  
 SETCONF  
END   

This indicates that the netid numbered 0 and called link0 is associated with the first (0th) SGP port. Instructions on how the daemon will build the stack and the name of the link configuration file are also indicated.

You may wish to change the network name to Datapac or Sprintnet if that is the name of the network with which the link is connected. This may make an easier-to-remember association in your programs.


Changing Startup Options

The protocol stacks are started or restarted using the script wanware. This script reads two files: /etc/wwconfig/wwconfig and /etc/wwconfig/wwconfig.local.

The file /etc/wwconfig/wwconfig is created by running the script wwconfig. As such, it should not be manually editted as changes will be lost if the script is rerun.

Rather, changes should be made to the file /etc/wwconfig/wwconfig.local. This file will not exist until an administrator creates it for the purposes of customization.

The following items may be specified in this file:
X25DAEMONARGS Command line options to be used for the startup of x25daemon, the X.25 stack building daemon. For example, it is useful to set X25DAEMONARGS to "-n" to allow an application to be the default listener for incoming calls.
X25ACCOUNT Set this variable to true to start the X.25 call acounting daemon, x25account.
X25ACCOUNTOPTS Options to be used for the startup of x25account.
PKTVCNS The total number of X.25 virtual circuits which may be run at the same time. See /etc/wwconfig/wwconfig for the default number of VCs for your installation.
NUMLISTENERS The total number of listeners which may be active at the same time.


Adding Hosts for IP over X.25 and Frame Relay

When you provide information about how your system can reach the remote hosts using the wwconfig utility, it adds them to /etc/hosts and /etc/x25hosts (for X.25) or /etc/frelhosts (for Frame Relay). TCP/IP utilities like telnet and ftp use /etc/hosts for obtaining the IP addresses of hosts (mapping an IP host name to an IP number). x25route uses /etc/x25hosts and froute uses /etc/frelhosts to determine what hosts they need to add to the equivalence tables when it invoked from the TCP startup script.

Note: The wwconfig utility added configuration information to these files between these two flags ("WWCONFIG START" and "WWCONFIG END"). If you wish to add configuration information directly to these file it must be added outside these flags. Anything inside these flags will be overwritten by wwconfig.

For Frame Relay, subscription time options such as Committed Information Rate (CIR), Burst Size (Bc), Excess Burst Size (Be) can be specified separately for each host in /etc/frelhosts. Add the name of the subscription time parameter to each hosts line using the format CIR:xxx, BC:xxx, BE:xxx respectively. At least CIR and BC must be specified and non-zero, otherwise the line is considered invalid.

To add or delete remote hosts from your internets, add/remove them from /etc/hosts and /etc/x25hosts or /etc/frelhosts.

Note: The maximum number of remote Frame Relay hosts is 30. The maximum number of remote X.25 hosts is 20.


Revision 6.3.0 (April 2004)

Copyright © 1997-2004 The Software Group Limited. All Rights Reserved.
® Netcom is a registered trademark of The Software Group Limited.