Configuration Files Overview

If you need to configure a machine that does not have a windowing system such as OpenWindows or Motif, you can configure Solstice X.25 by directly editing the configuration files.

Solstice X.25 9.2 automatically converts the configuration files of Solstice X.25 9.x as part of the installation process. Older versions of X.25 are not supported.

Whenever possible, configure X.25 links and applications using the x25tool. Directly editing the files makes it more likely that errors will accidentally be added to the configuration files.

Editing the Configuration Files

Chapter 7, Parameter Reference specifies the keyword and valid arguments for each parameter used in the configuration files. For additional information, consult the man pages (make certain your path includes /opt/SUNWconn/man).

The following configuration files are contained in the /etc/opt/SUNWconn/x25/config directory:

link_config_0000.cfg,link_config_0001.cfg

Contains the link configuration templates. See "Using the Link Configuration Files" for more information. To see the man page description, type man x25_config.

The following configuration files are contained in the /etc/opt/SUNWconn/x25 directory:

ipconf

Contains the IP interface configuration information.

ixemapconf

Contains information about the mapping between the Internet addresses of the network hosts and underlying X.25 addresses.

nuimapconf

Contains information of mapping between the Network User Identifiers and associated facilities.

paddconf

Contains the set of called addresses from which the PAD daemon will accept connect indications.

padmapconf, x29profile, xhosts

Contain the X.25 hosts information that the PAD host database needs.

xtpmapconf

Contains PAD printer parameters definitions.

pvcmapconf

Contains the PVC packet and window size information.

routes

Contains routing configuration information.

x25secuconf, x25secupid

Together contain the authorized incoming calls information needed for call filtering.

Using the Link Configuration Files

File link_config_0000.cfg configures link 0. In the default configuration, this is a WAN link. File link_config_0001.cfg configures link 1. In the default configuration, this is a LAN link.

There is a separate configuration file for each link. The filename format is link_config_nnnn.cfg, where nnnn is a four digit link number. These are the files that will be read when the Solstice X.25 is next started. Editing them is equivalent to modifying the configuration using x25tool while in static mode. Use a different naming convention if you want to save changes without using them on the next restart.

You cannot make changes to an active link by editing the configuration files. If you need to make changes to an active link, use x25tool to modify the configuration while in dynamic mode.

To create a new WAN link use file link_config_0000.cfg as a template. Copy it, giving the new file the correct name for the link you want it to apply to. For example, to configure link 3 as a WAN link, call the file link_config_0003.cfg.

To create a new LAN link, copy and rename the file link_config_0001.cfg. Then edit the new file to use the values you want.

The configuration file consists of a series of keywords and values, divided into sections according to function. The example below shows the IDENTIFICATION and LINK sections of a file:

IDENTIFICATION
    PRODUCT_NAME      Solstice X.25
    PRODUCT_VERSION   9.2
    FILE_TYPE         config
    MODIFIED_BY       agbell
    FILE_DATE         Fri Sept 29 11:41:13 1999


 SECTION LINK
       device         /dev/zsh0
       local_address  0011
       type           WAN
       version        1988
       mode           DTE
       protocol       LAPB
       description    Link to switch

The IDENTIFICATION section is the top section of every file. Updating the MODIFIED_BY field every time you make changes helps you keep track of who has made changes. The FILE_DATE field is updated automatically when you save the file, showing when the last changes were made.

Template Configuration Files

You can also use one of the sample templates instead of the default configuration files. These files are also contained in the /etc/opt/SUNWconn/x25/config directory. The template filename format is def_name_config.cfg.

To use a template file, select the template that most closely matches your configuration needs (for example, def_transpac_config) and copy it. You can then edit the copy as you would any other link configuration file. See "Using the Link Configuration Files" for more information.