|
|
This section describes how to install the Eiconcard Services and Eiconcard Connections for Linux drivers in the kernel, and configure their communications protocol software.
The eiconcfg program is used to install the Eiconcard Services and Eiconcard Connections for Linux drivers in the kernel and configure their communications protocol software. The eiconcfg program contains a number of different configuration screens that allow adjustment of parameters in the following areas:
The eiconcfg program can be used to configure more than one Eicon Networks product. Only those options available for Eiconcard Connections for Linux are presented here.
Since Eiconcard Connections for Linux can interact with a wide variety of types of equipment, switches, and networks, you may not know which parameters need to be changed. To simplify the configuration process, default values have been set for each parameter, and in most cases it is not necessary to change them.
For complete instructions on how to install Eiconcard Connections for Linux, see the Eiconcard Connections for Linux Release Notes.
Note: You need to configure only the subpackages that you install in the kernel.
The following is an overview of the Eiconcard Connections for Linux configuration procedure:
| 1. | Enter /usr/lib/eicon/eiconcfg at the command line. |
| 2. | Configure the Eiconcard Services driver. For more information, see Eiconcard Services Driver Configuration. |
| 3. | Configure the Eiconcard Services protocols. For more information, see Eiconcard Services Protocol Configuration. |
| 4. | Configure the Eicon Host PAD driver. For more information, see Eicon Host PAD Driver Configuration. |
| 5. | Configure the Eicon Terminal PAD driver. For more information, see Eicon Terminal PAD Driver Configuration. |
| 6. | Configure the Eicon Routing Services driver. For more information, see Eicon Routing Services Driver Configuration. |
Note: If you are running the eiconcfg program for the first time, the Eiconcard Services Driver must be configured before any of the other options.
The Eiconcard Services driver is installed in the Linux kernel and provides the interface between user-space applications, other Eicon drivers, and the Eiconcards.
To configure the Eiconcard Services driver, run eiconcfg and select the Eiconcard Services Driver Configuration option from the configuration menu. The menu options are discussed in the following sections.
Note: The first time you run eiconcfg, an Eiconcard must be installed and you are initially prompted to add an Eiconcard. See Add an Eiconcard below.
When you select option 1, Configure an Eiconcard, you can add, remove, or modify existing Eiconcard configurations as required. These options are described in the sections that follow.
Add an Eiconcard
To add an Eiconcard, follow these steps:
| 1. | Select option 1, Add an Eiconcard. |
| 2. | Enter the type of Eiconcard you are adding. A suggested configuration for the Eiconcard is displayed. |
| 3. | Select option 1, Accept this configuration and continue with step 6 below. Alternatively, select option 2, Manually configure the Eiconcard and continue with the following step. |
| 4. | Enter the Eiconcard parameters as prompted, or press Enter to accept the default values. If you enter h, help information will be displayed for the related parameter. |
| 5. | Press Enter. |
| If you are using an Eiconcard S5x, make sure that the DIP switches on your Eiconcard (for I/O ports) are set correctly. | |
| 6. | If you are adding another Eiconcard now, repeat steps 2-5. Otherwise, enter q to quit. |
Modify an Eiconcard Configuration
To modify an Eiconcard configuration, run eiconcfg, select the Eiconcard Services Driver Configuration option, and follow these steps:
| 1. | Select option 1, Configure an Eiconcard. |
| 2. | Select option 3, Modify an Eiconcard Configuration. |
| 3. | Select the number of the Eiconcard you are modifying. |
| 4. | Enter the Eiconcard parameters as prompted, or press Enter to accept the default values. If you enter h, help information will be displayed for the related parameter. |
| 5. | After you specify a value for the last parameter, the new configuration values are displayed and you are returned to the main Eiconcard configuration screen. |
| 6. | Enter q to quit the Eiconcard Configuration. You are returned to the main Eiconcard Services Driver Configuration screen. |
Remove an Eiconcard
To remove an Eiconcard from the system, run eiconcfg, select the Eiconcard Services Driver Configuration option, and follow these steps:
| 1. | Select option 1, Configure an Eiconcard. |
| 2. | Select option 2, Remove an Eiconcard. |
| 3. | Enter the number of the Eiconcard that you want to remove. |
Note: If there is only one Eiconcard configured, it cannot be deleted; however the Eiconcard driver can be removed from the kernel to render the Eiconcard inoperable.
The default parameters for the Advanced Driver Options should be suitable for most user systems. However, you may want to increase these values if your system includes multiple applications written with the Eicon X.25 Development Kit. For more information on configuring the Advanced Driver Options, see Advanced Eiconcard Services Configuration.
Install/Remove Eiconcard Services Driver
The Eiconcard Services driver must be installed in the kernel before using the Eiconcard Connections for Linux product.
To install or remove the Eiconcard Services driver, follow these steps:
| 1. | Run eiconcfg, and select the Eiconcard Services Driver Configuration option. |
| 2. | Select option 3, Install/Remove the Eiconcard Services driver, depending on whether the driver is already installed. |
| If you select to remove the Eiconcard Services driver, and other Eicon Networks drivers are installed on your system, you are prompted to remove these drivers. If you are reinstalling the Eiconcard Services driver immediately, do not remove these drivers and do not relink the kernel until after you have reinstalled the Eiconcard Services driver. Otherwise, you must use the required menu options to remove these drivers. | |
| 3. | Enter q to quit the Eiconcard Services Driver Configuration screen. |
| 4. | Enter q to quit eiconcfg. |
| Note: If you wish to configure the Eiconcard Services communications protocols or any of the Eiconcard Connections for Linux drivers, do not quit eiconcfg now. Instead, proceed to the relevant configuration section outlined in this chapter. | |
| 5. | Reboot your system. |
The Eiconcard Services Protocol Configuration option is used to configure the communications protocol software. It contains configuration screens that allow adjustment of parameters in the following areas:
 | Line Protocols |
| Dialer Selection |
The following sections provide guidelines for selecting options and adjusting parameters during configuration. For detailed configuration procedures, see Configuration Procedure.
Eiconcard Connections for Linux allows you to assign protocols on a per port basis. These protocols are called line protocols, and they handle the actual data transfer. Eiconcard Connections for Linux supports the following line-level protocols:
| X.25 |
| X.25 is an international standard for data communications and is supported in many countries worldwide. Eiconcard Connections for Linux supports CCITT Recommendation 1984 for X.25 operations, over HDLC connections. | |
| HDLC |
| HDLC is a data-link layer protocol used by X.25 to transmit information over a network. Most applications interface at the X.25 level; however, HDLC is provided for custom applications that require it. | |
| Frame Relay |
| Point-to-Point Protocol (PPP), with an option to configure Multilink PPP |
Like other Eicon products, Eiconcard Connections for Linux supports a number of dialer options:
| V.25bis |
| Direct (hardware dialer) |
| Hayes AT (asynchronous dialer) |
| ISDN |
Choose one of these options based on the line type or modem being used.
Each protocol has a number of parameters associated with it. These parameters allow customization of the protocol software for your particular connection. Eiconcard protocols can be configured to suit almost any communications situation. This is done by assigning values to the parameters in the protocol configuration screens.
Note: It is always a good idea to make a backup copy of your Eiconcard configuration file ec.cfg before modifying any parameter values. If problems are encountered with the modified version, the backup copy can be restored. As an aid for detecting communication problems, log any changes you make to the original file.
The Eiconcard contains its own CPU, memory, and real-time operating system. The protocol software runs on the Eiconcard, not on the Linux server. Therefore, the software options you define for Eiconcard Connections for Linux are constrained by the amount of memory available on the Eiconcard. This applies to protocols you define with eiconcfg and to the number of Host PAD and Terminal PAD devices defined on the Linux system.
Using the Configuration Screens
The configuration screens all use specific function keys, which are listed at the bottom of the screen. To move between parameters, use the cursor keys (
) or the Tab key. To change a parameter, type the new value directly. For some parameters, you can press the Spacebar repeatedly to scroll through the permitted parameter values.
The following table describes the function keys displayed on the configuration screens:
| Function Key | Description |
|---|---|
F1 Help |
Provides information about the current screen and its parameters. |
F2 Save |
Saves the parameter values for all screens to the configuration file. |
F3 Prev |
Moves you to the previous configuration screen, if applicable. |
F4 Config |
Moves you to the next configuration screen, if applicable. |
F5 PrvCrd |
Moves you to the configuration screens for the previous card. |
F6 NxtCrd |
Moves you to the configuration screens for the next card. |
F9 Print |
Prints the configuration information to an ASCII file, using a .prt extension for the filename. |
F10 Quit |
Exits the Eiconcard Services Protocol Configuration. |
Most terminals have the function keys defined in /usr/lib/terminfo/terminfo.src. If this is not the case, you should be able to use an alternative function-key mapping. For example, the following function keys are normally available:
| Esc 1 Help |
| Esc 2 Save |
| Esc 3 Previous Screen |
| Esc 4 Config |
| Esc 5 Previous Card |
| Esc 6 Next Card |
| Esc 9 Print |
| Esc 0 Quit |
Note: If you are unable to use either set of function keys, consult the administrator's guide for your Linux operating system for information on keyboard mappings.
You can press the F1 Help key anywhere in the protocol configuration program for screen-sensitive help. To see a description of parameters on a particular screen, move the cursor to that screen and press F1 Help. Detailed information regarding the selected screen will appear. Press the Page Down key to see additional pages of information, or Page Up to see the previous page.
Accessing ISDN switch-specific online help
To access this information, follow these steps:
| 1. | Access the Hardware Configuration screen and select your switch type. For details on this and the other configurable parameters on the Hardware Configuration screen, press F1. |
| 2. | Press F10 to quit the help screen. |
| 3. | Press F4 to access the Protocol Configuration screen. For the first port, Bchannel is automatically selected as the Dialer Selection value. Move to this field and press F4 to access the B-channel Configuration screen. |
| 4. | Specify the Local Directory Number assigned by the telephone company. You cannot access the online help until you have provided a value for this mandatory parameter. |
| Note: For the NI-1 switch type, you must also specify the Service Profile Identifier (SPID) number before you can access the online help. | |
| 5. | Press F1 for information on the available port configurations for your configured switch type, as well as for information on the B-channel parameters specific to your switch type. |
| 6. | Press F10 to quit the help screen. |
| 7. | Press F3 to return to the Protocol Configuration screen and select Bchannel, SIG.+X25, or an HSI dialer type for the remaining port(s) as needed. |
| 8. | With SIG.+X25 selected (if supported by your subscribed switch type), press F4 to access the D-channel Configuration screen. |
| 9. | Specify a value for the Static TEI parameter and press F1 for details on configuring the D-channel to transfer X.25 packet data. |
| Note: For the NI-1 switch type, you must also specify the X.25 DTE address before you can access the online help. |
The eiconcfg program stores most parameter settings in the Eiconcard configuration file. The default name for this file is /usr/lib/eicon/ec.cfg. Many Eiconcard commands refer to the settings in ec.cfg to identify the card configuration.
The following steps outline the configuration process. References are made to several configuration screens. For information on using configuration screens, see Using the Configuration Screens.
| 1. | Create a backup copy of the ec.cfg configuration file in case you need to restore the original version. Whenever you save the ec.cfg file, its previous version is saved to ec.bak. Subsequent saves will overwrite the backup file. |
| 2. | Select the Eiconcard Services Protocol Configuration option from the main eiconcfg menu. |
| 3. | Type the name of the Eiconcard configuration file that you want to modify and press Enter. To see a list of available configuration files, type *.cfg and press Enter. Use the cursor keys to highlight the file that you wish to configure and press F4. |
| Note: When naming Eiconcard configuration files, specify a maximum of 14 characters, as longer filenames cannot be displayed in the configuration listing. | |
| 4. | If you want to save the *.cfg settings to an ASCII text file, select an Eiconcard configuration file in the Files box and press the F9 Print key. The ASCII text filename is *.prt, so if the configuration file was ec.cfg, then the ASCII text file will be saved to ec.prt in the current directory. |
| 5. | Press F4 Config to display the Hardware Configuration screen. |
| 6. | Select appropriate values in the Number of ports and Auto activate ports fields for each Eiconcard in your system. Use the Spacebar to scroll through the available options in each box, and use the cursor keys (
), Tab key, or Enter key to move between boxes. If you are configuring more than one Eiconcard, move to the appropriate column to change the values for each Eiconcard. If an entry you select is invalid, then that entry will flash until you change it (on X-terminals, the incorrect entry is simply highlighted). |
| Note: The Hardware Configuration screen always displays the Eiconcard interface parameter values previously configured. To change any of these values, return to the Eiconcard Services Driver Configuration menu and follow the necessary steps in Configure an Eiconcard. | |
| 7. | Press F4 Config to display the Protocol Configuration screen for the Eiconcard selected. |
| Note: If there is an invalid entry anywhere on the current screen, you cannot continue to the next configuration screen. You can use F10 Quit or the Esc key to cancel the entire configuration operation. | |
| 8. | Move the cursor to the Line Protocol Module box, and press the Spacebar until you see the option you want. Press F4 Config to configure that option. When you are finished, press F3 Prev to return to the main Protocol Configuration screen. |
| 9. | To change the Dialer Selection, move the cursor to the Dialer Selection box, and press the Spacebar until you see the option you want. Press F4 Config to configure that option. |
| 10. | If you have additional Eiconcards to configure, press F6 NxtCrd. The message "Card n" appears in the top right corner of the screen. Configure each Eiconcard as you did the first by modifying the necessary Line-protocol module and Dialer-selection parameters. |
| 11. | Press F2 Save to save all parameter settings for all cards to the Eiconcard configuration file you selected on the Eiconcard Connections for Linux Protocol Configuration screen. |
| 12. | Press F10 Quit to exit the configuration program. |
| 13. | Enter q to quit eiconcfg or, if you want to configure any of the Eiconcard Connections for Linux drivers, do not quit eiconcfg now. Instead, proceed to the relevant configuration section outlined in this chapter. |
| 14. | Reboot your system. |
Note: For any changes you have made in the configuration to take effect, you must stop and reload the Eiconcard using the eccard stop and eccard start commands.
To configure the Eicon Host PAD driver, run eiconcfg and select the Eicon Host PAD Driver Configuration option from the configuration menu. The displayed menu options are discussed in the following sections.
Note: If you do not wish to change the default Eicon Host PAD driver configuration parameters, skip the following section and go to Install/Remove Eicon Host PAD Driver below.
Configure Eicon Host PAD Driver
Follow these steps to configure the Eicon Host PAD driver:
| 1. | Choose option 1, Configure Eicon Host PAD Driver. |
| 2. | Enter the Eicon Host PAD driver parameters as prompted, or press Enter to accept the default values. You can display online descriptions of the driver's parameters by pressing h at each parameter's prompt. |
| After you specify a value for the last parameter, the new configuration values are displayed and you are returned to the main Eicon Host PAD Driver configuration screen. | |
| 3. | Select an option, or enter q to quit the Eicon Host PAD Driver Configuration. |
Install/Remove Eicon Host PAD Driver
The Eicon Host PAD driver must be installed in the kernel before you can use the Eicon Host PAD.
To install or remove the Eicon Host PAD driver, follow these steps:
| 1. | Run eiconcfg, and select the Eicon Host PAD Driver Configuration option. |
| 2. | Select option 2, Install/Remove the Eicon Host PAD Driver, depending on whether the driver is already installed. |
| 3. | Enter q to quit the Eicon Host PAD Driver configuration screen. |
| 4. | Enter q to quit eiconcfg or, if you wish to configure any other Eiconcard Connections for Linux drivers, do not quit eiconcfg now. Instead, proceed to the relevant configuration section outlined in this chapter. |
| 5. | Reboot your system. |
To configure the Eicon Terminal PAD driver, run eiconcfg and select the Eicon Terminal PAD Driver Configuration option from the configuration menu. The displayed menu options are discussed in the following sections.
Note: If you do not wish to change the default Eicon Terminal PAD driver configuration parameters, skip the Configure Eicon Terminal PAD Driver section and go to Install/Remove Eicon Terminal PAD Driver below.
Configure Eicon Terminal PAD Driver
Follow these steps to configure the Eicon Terminal PAD driver:
| 1. | Choose option 1, Configure Eicon Terminal PAD Driver. |
| 2. | Enter the Eicon Terminal PAD driver parameters as prompted, or press Enter to accept the default values. You can display online descriptions of the driver's parameters by pressing h at each parameter's prompt. |
| After you specify a value for the last parameter, the new configuration values are displayed and you are returned to the main Eicon Terminal PAD Driver configuration screen. | |
| 3. | Select an option, or enter q to quit the Eicon Terminal PAD Driver Configuration. |
Install/Remove Eicon Terminal PAD Driver
 |
Important: The Eicon Terminal PAD driver must be installed before you can use the Eicon Terminal PAD. |
To install or remove the Eicon Terminal PAD driver, follow these steps:
| 1. | Run eiconcfg, and select the Eicon Terminal PAD Driver Configuration option. |
| 2. | Select option 2, Install/Remove the Eicon Terminal PAD Driver, depending on whether the driver is already installed. |
| 3. | Enter q to quit the Eicon Terminal PAD Driver configuration screen. |
| 4. | Enter q to quit eiconcfg or, if you wish to configure any other Eiconcard Connections for Linux drivers, do not quit eiconcfg now. Instead, proceed to the relevant configuration section outlined in this chapter. |
| 5. | Reboot your system. |
Before installing the Routing Services driver, make sure that you have installed any required LAN cards or TCP/IP software as outlined in the following sections.
If you plan to use Routing Services together with your Linux server as a LAN router, install and configure the server's LAN card before you install Routing Services. Consult the hardware documentation for your Linux system for directions.
TCP/IP must be installed before you install Routing Services. Consult your Linux system's TCP/IP documentation for directions.
If you attempt to install Routing Services when TCP/IP is not installed, the initialization script fails and the system returns to the installation menu. Install TCP/IP and relink the kernel. You are prompted to use the TCP/IP configuration utility. Once you have completed the TCP/IP installation and configuration, run eiconcfg to install the Routing Services driver.
To configure the Routing Services driver, run eiconcfg and select the Eicon Routing Services for Linux Driver Configuration option from the configuration menu. The displayed menu options are discussed in the following sections.
Note: If you do not wish to change the default Routing Services driver configuration parameters, skip the Configure Eicon Routing Services for Linux Driver section and go to Install/Remove Eicon Routing Services for Linux Driver below.
Configure Eicon Routing Services for Linux Driver
Follow these steps to configure the Eicon Routing Services for Linux driver:
| 1. | Choose option 1, Configure Eicon Routing Services for Linux Driver. |
| 2. | Enter the Eicon Routing Services for Linux driver parameters as prompted, or press Enter to accept the default values. You can display online descriptions of its driver's parameters by pressing h at each parameter's prompt. |
| After you specify a value for the last parameter, the new configuration values are displayed and you are returned to the main Eicon Routing Services for Linux Driver configuration screen. | |
| 3. | Select an option or enter q to quit the Eicon Routing Services for Linux Driver Configuration. |
Install/Remove Eicon Routing Services for Linux Driver
|
Important: The Eicon Routing Services for Linux driver must be installed before you can use the Eicon Routing Services for Linux product. |
To install or remove the Eicon Routing Services for Linux driver, follow these steps:
| 1. | Run eiconcfg, and select the Eicon Routing Services for Linux Driver Configuration option. |
| 2. | Select option 2, Install/Remove the Eicon Routing Services for Linux driver, depending on whether the driver is already installed. |
| 3. | Enter q to quit the Eicon Routing Services for Linux Driver Configuration screen. |
| 4. | Enter q to quit eiconcfg or, if you wish to configure any other Eicon drivers, do not quit eiconcfg now. Instead, proceed to the relevant configuration section in eiconcfg. |
| 5. | Reboot your system. |
When the system is rebooted, messages relating to the drivers installed in the kernel are displayed.
If you need to modify the configuration for the installed drivers or communications protocols, run eiconcfg again and follow the steps in the relevant section in this chapter.
Routing Services is now ready for setup and operation. See Using Eicon Routing Services for more information.
|
|
Copyright (c) 2001 Eicon Networks