Configuring E/ISA Boards Using Interactive Mode

You might need to run eisa_config interactively for the following reasons:

You need to add, remove, or move an ISA board, which do not have readable ID registers and thus are not automatically recognized by eisa_config.
eisa_config exited from automatic mode with an error message requiring you to change the choice for a function. See “Changing Choices for Board Functions” shortly.
You want to change the choice that eisa_config automatically selected for a function.
eisa_config exited from automatic mode with an error message requiring you to add a board interactively.
You might want to view your E/ISA configuration for planning purposes.




	NOTE: Always run `eisa_config` interactively before physically changing the configuration.

Sample Interactive Session to Add an E/ISA Card

Starting eisa_config

Invoke eisa_config, which begins by displaying the current board configuration.

/sbin/eisa_config
 
HP-UX E/ISA CONFIGURATION UTILITY
 
    Type q or quit to leave eisa_config.
    Type ? or help for help on eisa_config commands.
 
 
 Slot      CFG File      Contents
 
 0         !HWPC010      HP Series 700 EISA System Board
 1         !XYZ1401      XYZ SCSI Controller
 2                       ** EMPTY **
 3         !XYZ1702      XYZ Centronics Interface
 4                       ** EMPTY **

On-Line Help

Note that eisa_config has self-explanatory on-line help. Type ? or help at an EISA prompt and read the entries to acquaint yourself with the program.

Displaying CFG Files

Type the cfgfiles command to display the CFG files currently in the /sbin/lib/eisa directory. The cfgtypes command lists and explains each board type. For example, NET is a network board.

EISA: cfgfiles
 
 Filename    Board Type   Board Name
 
 !HWPC010      SYS        HP Series 700 EISA System Board
 !XYZ1401      MSD        XYZ SCSI Controller
 !XYZ1702      PAR        XYZ Centronics Interface
 !XYZ1802      NET        XYZ Networking Board
 !XYZ2276      VID        XYZ Video Board

Adding a Board

Make sure the CFG file is present in the /sbin/lib/eisa directory. If it is absent, check the documentation supplied with the card. (CFG files are required for EISA cards, but advisory only for ISA cards.)

Type a show slot command to see in which slots the !XYZ1802 board can be installed. Then type the add command to add the board to slot 2. eisa_config displays the new configuration.

EISA: show slot !XYZ1802
 
    Valid slots for this board: 2  4
 
EISA: add !XYZ1802 2
 
 Added board:  XYZ Networking Board
 Comments:     The XYZ Networking board is an IEEE 802.3 local area networking
               board for use with twisted-pair cabling.
 
 
 Slot      CFG File      Contents
 
 0         !HWPC010      HP Series 700 EISA System Board
 1         !XYZ1401      XYZ SCSI Controller
 2         !XYZ1802      XYZ Networking Board
 3         !XYZ1702      XYZ Centronics Interface
 4                       ** EMPTY **

You can use the comment command to display help or comments provided by the manufacturer about the board and its switches, the interface functions and choices.

Correcting a Mistake While Using eisa_config

If you have made changes in the configuration that you want to undo, you can return to the current session's initial configuration by using the init command.

Type the following command:

[init [system.sci ]]

If you specify system.sci, eisa_config retrieves the configuration from that file; otherwise, it retrieves it from non-volatile memory (NVM).

Displaying Board Information

Type a show command to ask for information on the board in slot 2. eisa_config displays the board's basic attributes and indicates the currently selected choice for each function.

EISA: show board 2
 
 XYZ Networking Board
 CFG file: !XYZ1802.CFG
 Slot 2
 
   The XYZ Networking board is an IEEE 802.3 local area networking board for
   use with twisted-pair cabling.
 
   Manufacturer ................. XYZ Computer Corp.
   ID ........................... XYZ1802
   Board type ................... NET (Network Board)
   Board slot type .............. ISA 8 Bit
   Readable ID .................. No
   Skirt ........................ No
   Length ....................... 330 millimeters
 
   Function names and possible choices:
     StarLAN 10 PC LAN Adapter
       F1: I/O Base Address
           CH1: 300h [** current **]
           CH2: 340h
           CH3: 240h
       F2: Loopback Mode
           CH1: Normal operation [** current **]
           CH2: Test mode
       F3: Interrupt Channel (IRQ)
           CH1: 3
           CH2: 4
           CH3: 5 [** current **]
           CH4: 7

Changing Choices for Board Functions

If eisa_config cannot automatically generate a new configuration with the choices currently selected, you can use the change command to specify an alternative choice for a particular function on a board. A board must already be part of the configuration before you can use the change command on it.

Use the change command cautiously, because it overrides any choice eisa_config might make, even to resolve a conflict.

To change a choice for a given function, issue the change command, specifying the slot number, function number (F#), and the new choice number (CH#), as shown by the show board slot# command.

EISA: change slot# function# choice#

After making all desired changes within eisa_config, exit the program, as explained in the next section.

Exiting eisa_config

Once you have changed the configuration, eisa_config prompts you to

save the changes and exit,
exit without saving changes, or
abort the exit.

When you save the changes, eisa_config displays a list of subsequent steps.

EISA: quit
 
A description of the configuration was saved in /var/adm/eisa/config.log.
 
If eisa_config was run per the instructions of a specific product
installation manual, refer to that manual for specifics on device file
creation and I/O drivers.
Step 4 may apply if other cards were affected.
 
Otherwise, the following is a list of generally required steps:
 
    (1)  Make any necessary device files.  If you have moved a board you
         may also need to make new device files.
    (2)  Ensure that all appropriate software I/O drivers are present
         in the kernel.
    (3)  Shut down the system with the "/usr/sbin/shutdown -h" command.
    (4)  Once the system is shut down, turn the power off.  Then set any
         physical switches and jumpers correctly.  The switches and jumpers
         that have changed since eisa_config was invoked are listed below.
         The file /var/adm/eisa/config.log contains a summary of the new
         configuration, including required switch and jumper settings.
    (5)  Physically add, move, or remove boards as needed.
    (6)  Turn the power on and boot the system.

Displaying Switch and Jumper Settings

Once you exit, eisa_config displays the switch and jumper settings that have changed since the program was invoked. For example,

 Slot 2
 XYZ Networking Board
 Switch Name:  I/O Base Address
 
 Switches 1 through 3 select the I/O Base Address,
 switch 4 is not applicable.
 NOTE: 'off' in the diagram below corresponds to 'OPEN' on board
 switches.
 
 Default setting
         1   0   0   1
 Required setting
         1   0   0   1
       +-x-+-+-+-x-+on
       |   |   |   |   |
       +-+-x-+-x-+-+off
         1   2   3   4
 
 
 Slot 2
 XYZ Networking Board
 Switch Name:  Loopback Mode
 
     Default         Required    on   off
                                  +-+
        0               0         |   x        4
                                  +-+
        0               0         |   x        3
                                  +-+
        0               0         |   x        2
                                  +-+
        0               0         |   x        1
                                  +-+
 
Exiting eisa_config.
$

Saving the Configuration and Exiting eisa_config

You can save the current configuration without exiting eisa_config by using the save system.sci command.

If the current configuration is not conflict-free, eisa_config notifies you and does not save the configuration.

By default, save records the new configuration in non-volatile memory (NVM). If you use system.sci, save does not record the new configuration in NVM, but instead, records it in the system.sci file. This file can be used to configure subsequent workstations. See “Creating Identical E/ISA Configurations on Other Workstations” later in this chapter.

When you quit eisa_config, it creates the /etc/eisa/config.log file, which contains information on all currently configured boards and their attributes.

Your next task will be to bring down the system, set the physical switches and jumpers to match the new eisa_config specifications, and reboot.

Setting Switches and Jumpers on an E/ISA Interface Board

When you exit eisa_config or use the show switch changed command, you see a graphical representation of the switch and jumper settings that have changed during the eisa_config session. The /etc/eisa/config.log file also contains all required switch and jumper settings for each board in your working configuration. To set the switch and jumper settings,

Print the /etc/eisa/config.log file as a record of all switch and jumper settings that have changed during the eisa_config session.
Warn all users that you will be shutting down the system to configure the E/ISA board. Then shut down the system and turn the power off.
Set the switches and jumpers to their required settings, as determined by eisa_config. If you are installing a new board, add it at this time. If you are installing a peripheral device with this board, connect the device.
Turn on all peripheral devices, then the SPU, and reboot the system.

When the system boots, the E/ISA board settings are written to non-volatile memory (NVM), making the boards fully accessible by HP-UX.

Moving an E/ISA Board

To move a currently configured E/ISA board,

Invoke /sbin/eisa_config and at the EISA: prompt, issue the move command, specifying the board's current and new slot numbers.
EISA: move current_slot# new_slot#
After moving all desired boards within eisa_config, exit the program.
eisa_config will display any switch and jumper settings that may have changed during the session. Refer to the /etc/eisa/config.log file for a record of the new configuration, including the required settings.
Remove the old device file for the board with the rmsf command.
Warn all users that the system will be brought down. Halt the system with the shutdown command and turn off the power.
Set any physical switches and jumpers according to eisa_config requirements. Refer to “Setting Switches and Jumpers on an E/ISA Interface Board”.
Physically move the boards.
Turn the power on and reboot the system. As the system boots, the new configuration is written to NVM and /etc/eisa/system.sci.
If the devices attached to the board use drivers known to insf (for example, SCSI devices), insf creates device special files for them at their new location. If the driver is not known to insf (for example, if you are installing a custom board), use mknod to create any required device special files. Consult the documentation accompanying the board and/or device for guidance.




	NOTE: If you are moving a network board, you need to boot the computer a second time. Use `shutdown -r`.

Removing an E/ISA Board

To remove a currently configured E/ISA board,

Invoke /sbin/eisa_config and at the EISA: prompt, issue the remove command, specifying the slot number from which you are removing a board.
EISA: remove slot#
After removing all boards desired within eisa_config, exit the program.
Remove the old device file for the board with the rmsf command.
Warn all users that the system will be brought down. Halt the system with the shutdown command and turn off the power.
Physically remove the boards.
Turn the power on and reboot the system. As the system boots, the new configuration is recorded in NVM.

Creating Identical E/ISA Configurations on Other Workstations

If you have several workstations with identical E/ISA boards, you can streamline the configuration task as follows:

Invoke /sbin/eisa_config on the first system and configure the E/ISA boards to your satisfaction.
Save the configuration in a system.sci file instead of to NVM.
EISA: save system.sci
Complete the configuration task for the first workstation, by exiting eisa_config, making any necessary physical changes to the boards, and rebooting the system.
When you are ready to configure other workstations, copy the CFG and system.sci files from the first workstation to those systems. (Note, if the workstations share a file system, you might not need to copy the files at all.)
On each of the other workstations, invoke eisa_config using the -n option, which initializes the E/ISA configuration from system.sci.
eisa_config -n system.sci
Save the new E/ISA configuration using the save command.
By default, eisa_config records the configuration in the NVM and to /etc/eisa/system.sci. Optionally, if you specify a file (for example, tmp.sci) as an argument to the save command, eisa_config records the configuration to the specified file.
EISA: save [tmp.sci] Successfully saved configuration in tmp.sci.
You can copy the tmp.sci file to the systems for which you are duplicating the original configuration. Then, from eisa_config on the new system, use the init command to write the configuration to NVM and /etc/eisa/system.sci of the new system.
Complete the configuration task by exiting eisa_config, making any necessary physical changes to the boards, and rebooting the system.