Stallion Technologiessupport
Product documentation
online documentation
 
Documetation image, 8K

EasyConnection Installing with UNIX

EasyConnection

EasyIO

EasyServer II

If your installation is non standard, you can use the additional installation procedures outlined in the Reference and Utilities section. 

easyadm ensures trouble-free board configuration because the selected configuration is validated, so the UNIX rebuild works the first time. The board setup procedure is also simplified. The correct switch settings are displayed for EasyConnection boards with switches. 

Supported hardware 

ATA version 5.4 onwards supports all Stallion EasyIO and EasyConnection board and module types including the XP. This panel is capable of baud rates up to 230,400 and 460,800 and will not work with previous driver revisions. 

You are required to select the correct board type during the installation of new boards. The board type is displayed on the packaging. If the packaging is not available, refer to the table in the Hardware Installation Reference. 

Contents 

This Section details the complete procedure for installing EasyConnection in a SCO UNIX, SCO XENIX, UnixWare, SVR4, Solaris and Interactive UNIX environment. The process has four steps: 

Step 1  Install EasyConnection software 

Step 2  Board Configuration

Step 3  Hardware Installation 

Step 4  Port Configuration


Step 1: Installing EasyConnection Software 

The Software is composed of two parts: 

  • The Drivers 
  • The Configuration Manager (easyadm

Install the EasyConnection software using the package installation facility included with your operating system. 

Follow these steps to install the software:  

1.  Log in as 'root', in Single User Mode. (Multi User Mode is recommended for 
     SVR4 systems.) 

2.  Run the package installation facility for your UNIX system, i.e.: 
 
    SCO UNIX or XENIX ...........custom 
    Interactive UNIX ............. ......sysadm 
    UnixWare, SVR4.X .................sysadm or pkgadd -d diskette [1,2] 
    Solaris ................................if Volume Manager is running, type vol check 
    EasyConnection is installed using the pkgadd command: 

  pkgadd -d /dev/diskette0

Then reply Y to any queries about already installed files or superuser shellscripts. During installation, on some systems the pkgadd utility will prompt for change of attribute on /tmp. This is quite harmless. 

You must remove any previous version of the ATA driver before installing this one. 

3.  Install as a new product/package using the diskette supplied. 

4.  Easyadm runs automatically during installation. 

The following notes indicate operating system specific installation instructions. 

Note: Under SVR4 systems (including Unixware and Solaris) STREAMS must be installed for the driver to operate successfully. 

UnixWare 2.0 Installation. EasyConnection is installed as described in the previous section. On EISA systems, both EISA and ISA boards must be installed in the EISA configuration utility. 



Step 2: Board configuration 

EasyConnection provides two board configuration methods: 

This section outlines the First Time method. Instructions for the alternative diskette installation method are described in Autosetup in the Reference and Utilities [PDF - 279KB] section. 

Note: Before proceeding with the configuration process, ensure the system has a vacant slot for each EasyConnection board being installed. Do not install the board into the system until it has been configured and the system shut down and powered off. On most systems, Single User Mode is recommended for the board configuration process. Multi User Mode is recommended for SVR4. 

First Time Configuration 

For each new EasyConnection board being installed, easyadm selects a configuration which does not conflict with any hardware already installed. This configuration is provided as the default configuration for that board. During the configuration process <Enter> accepts the default values. <F3> displays a list of acceptable alternative values, and <F1> provides on-line help relating to the current field. 

Note: The installation of EasyConnection boards into EISA/MCA machines requires the generation of a Configuration Diskette. This diskette is created automatically as part of the installation process in EISA/MCA bus machines only. Follow steps 3 to 7 of `EISA/MCA Configuration Diskette Generation' in this Section when the diskette information is requested. 

To create a new board configuration for your UNIX system: 

1.  Highlight Select on the Main Menu. 

2.  Highlight New boards and <Enter>. 

3.  Highlight Install and <Enter>. 

4.  The Board Installation Table displays.   

After generating the configuration diskette (either automatically in the board installation procedure or manually as detailed in the section entitled `EISA/MCA Configuration Diskette Generation' in this Section) consult your Hardware Vendor's manuals for details on setting up your system's EISA/MCA configuration. 

EISA bus. For boards in an EISA bus machine not sharing interrupts, an edge triggered interrupt is used. Multiple boards sharing interrupts use level triggered interrupts. Check the correct interrupt type is set in the system's configuration.   


Step 3: Hardware installation 

Installing the EasyConnection 

Note: To avoid static damage, avoid excessive board handling. 

Complete installation detail is given in Part D, Section 1 [PDF - 237KB]. The following is a summary: 

1.  Power down the machine. If necessary, consult the computer system installation manual for the correct cover removal procedures. 

2.  Install host adapter board. For each board to be installed, locate an 
     available slot. Push the board firmly into the slot, making sure it is fully 
     inserted. 

3.  Retaining screw. Securely tighten the retaining screw. 

4.  Module assembly. If attaching modules, assemble according to the 
     instructions given in the EasyConnection User Documentation [PDF - 17KB]. 

5.  Connect module to host adapter. Carefully connect the module assembly to 
     the host adapter using the supplied cable. 

Note: When installing ISA boards in an EISA machine we recommend that you configure the ISA boards using the system's EISA Configuration Utility. Hardware conflicts can then be detected and resolved easily. 

6.  Power up the machine. 
     You can now proceed with Port Configuration.   

EISA Configuration Diskette Generation 

To generate an EISA Configuration Diskette: 

1.  Highlight Customize on the Main Menu. 

2.  Highlight "Generate EISA/MCA Config". 

3.  Highlight the diskette drive required. 

4.  Highlight the diskette size required. 

5.  Insert your Stallion Technologies Easy Utilities diskette (or any other DOS 
     formatted diskette) into the required drive. 

6.  Answer "y" to the prompt, "Update configuration using the setup above?". 

7.  The configuration diskette file !STL0200.CFG is updated. 

When installing a PCI host adapter under Unix, set both IRQ and IO address to "Auto". This allows the driver to autodetect the board each time the system is booted, allowing for dynamic allocation of resources by the PCI BIOS. 

Use the default board settings in easyadm, then Exit and rebuild the kernel. Reboot the system to single user and run board diagnostics to ensure correct operation of the new EC8/64-PCI.  

In some early PCI machines, the BIOS may be non-compliant, and may not assign system resources such as IRQ and IO address. In these cases, it may be necessary to specify the actual IRQ and IO address in the driver instead of 'auto'.   


Step 4: Port Configuration using easyadm 


Overview 

Port Configuration involves setting various communications parameters for the port, configuring serial devices and confirming the port wiring. 

Communications parameters define the way I/O ports communicate with any connected devices. The communications parameters for each port are: 

  • Baud Rate 
  • Number of Bits per Character 
  • Number of Stop Bits 
  • Parity 
  • Flow Control Mechanism 

The port configuration must match that of the device connected to the port. 

Login as root and run easyadm. 

Port Configuration options are accessed from the Panel Configuration Menu. 

To display the Panel Configuration Menu:  

1.  Highlight Select on the Main Menu. 

2.  Highlight the EasyConnection panel to be configured and press <Enter>. 

Note: Select the EasyConnection panel by moving cursor with arrow keys, or enter the EasyConnection panel label (depending on the information displayed in the box). 

3.  The Panel Configuration Menu and the panel diagram is displayed. 
     Five options are available at this level: Select, View, Utilities, Analyse, and 
     Panel. 

Configuring a Device 

Following Board Configuration and Hardware Installation, the devices can be configured to the ports on the EasyConnection panel. 

The types of devices you can attach to a port are: 

  • Terminals 
  • Printers 
  • Modems 
  • UUCP Communications Links 
  • Sessions (multiple login sessions on one port) 
  • Attached Printers (printer attached to terminal auxiliary port) 
  • Other 

Standard installations use the default settings for each device attachment. If you require different settings, enter these instead of the defaults. Use the <F3> window to view and select different options or type them into the fields. 
 
Note: Only one Terminal, Printer, UUCP Link or Modem can be attached to a port at any time. Extra Sessions can be attached to a Modem or Terminal port. The Attached Printer option provides the facility for a terminal to support a local printer plugged on to the back of that terminal. Additional information about the options for each type of device are outlined in Device Types in this section. 

Attaching Devices to Ports.  
The following steps outline how to attach a device to a port on the EasyConnection panel: 

1.  From the Panel Configuration Menu, highlight `Select', highlight the Port and 
     press <Enter>. 

2.  Highlight `Configure' and press <Enter>. 

3.  Highlight the device to be attached and press <Enter>. 

4.  Complete the device setup parameters as required: 

- Either press <Enter> after a field to accept the default setting, or 
- Enter a different setting and press <Enter>, or 
- Select a different option from the <F3> window and press <Enter>. 
- Enable the Device. 
- Use <F1> Help on each field for help specific to that field. 

5.  Press <Enter> after last field to complete the device attachment. 

6.  You can copy a Port Configuration from one port to single or multiple port 
     destinations if the setup is to be identical. See Copy Port Configuration in this 
     section.

Wiring 

You can display wiring diagrams to verify the wiring for a particular port configuration: 

1. Highlight the port for wiring verification. 

2. Highlight Wiring on the Port Configuration Menu and press <Enter>. 

3. Highlight the wiring applicable to the port and press <Enter>. 

4. The wiring diagram is displayed. 

5. Check that your cabling matches this diagram. 

6. Press <Enter> or <ESC> to exit from the display.   

Device Types 

When you are attaching a device to a port, some entry fields are common to all devices, except raw printers and other devices. They are shown here with their SCO UNIX default settings: 

Port Status Enabled Disabled 

Baud Rate 9600 
Data Bits 8 
Stop Bits 1 
Parity None 
Handshaking Software 
Other fields are unique to each device type and in some cases questions have to be answered. 

The information in this section will help you enter the correct settings for each device in your installation.  

Terminal 

Follow the steps for Configuring a Device in this Section. 

  • What Terminal Type is it? Choose the terminal type best suited to the terminal connected to this port. The terminal type Easyterm allows UNIX sessions to be run through a DOS PC. See Part E, Section 11 - Easyterm - for more information. 
  • Optionally, enter a label for the terminal. Labels are not mandatory, but do provide an efficient reference of devices attached to a port. 
  • Set to Enabled or Disabled. 
  • Do you need Stable or Cycling Baud Rates? Setting the Baud Rate to 'Cycling' lets you change the Baud Rate for the terminal device using the <Break> key. Each time you press <Break> the next Baud Rate in the cycle is set. Continuously pressing <Break> causes the Baud Rate to 'cycle' around the range of settings. 
  • Choose Login Management method. (SVR4 only) This additional field is only offered on selected devices. The default setting is ttymon, which enables a port device on a port monitor. The getty option is also available. 

Printer 

Follow the steps for Configuring a Device in this Section. 

  • Is the printer a UNIX system printer? UNIX system printers can be used by all users on the system and are accessed using the 'lp' command. 
  • Optionally, enter a label for the printer. If it is a Raw-device, no further configuration is required. 
  • What is the printer name? Activate the <F3> window to view the names given to existing printers. You cannot select from this window, you must type a unique name for this new printer into the field. 
  • Which type of printer interface will it use? The printer interface is used by the system to control a particular type of printer. Activate the <F3> window to view a list of available printer interfaces. Some printer interfaces set up their own communications parameters. If you select this type of interface for a printer port, the port communication parameters will be automatically reconfigured to suit the interface. The software displays a warning if this happens. 

    Note: If you use an interface script other than standard, you may need to edit the script manually to include stty settings to match the port configuration parameters. Most scripts indicate where port parameters can be modified by a stty command. 

  • Will it be the default system printer? The default system printer receives all print jobs queued with no specific destination. The 'lp' command directs printing to the default printer. For example, to print a file named 'costfile': 

    lp costfile To print the same file to a printer named 'accounts', the '-d' option is included to signify the destination printer: 
    lp -d accounts costfile 

  • Enable the Printer. 

Modem 

Follow the steps for Configuring a Device in this Section. 

  • Select the Link Type - Dialin, Dialout or Dialin/out. 
  • Optionally, enter a label for the modem. If it is a Dialout, no further configuration is required. 
  • Enter the Terminal type for the terminal using the modem. 
  • Select either Enabled or Disabled. 
  • Do you need Stable or Cycling (<Break> key selectable) Baud Rates? 
  • Choose Login Management Method. (SVR4 only)   

UUCP Communications Links 

A UUCP Link is a cost-effective networking solution enabling UNIX systems to communicate with each other by either a direct connection, modems over a dedicated line or modems using a dial-up network. 

Functions provided by a UUCP network include file transfer, mail and remote command execution. 

Follow the steps for Configuring a Device in this Section. 

  • Select the Link Type - Dialin, Dialout or Dialin/out. 
  • Optionally, enter a Label for the UUCP Link. 
  • Select the Connection Type - Modem or Direct. If it is a Dialout, no further configuration is required. 
  • Select either Enabled or Disabled. Do you need Cycling Baud Rates? 

Note: Refer to your system manuals for information about setting up UUCP files, System, Devices etc. 

Multiple Session Support (MSS) 

Sessions allow you to switch screens with a special 'Hotkey' sequence. Each screen has a separate login. 

Sessions operate as independent devices and can be used transparently by standard applications software without modification. 

You must set up a terminal on the port before any multiple sessions can be attached to the port. 

Follow the steps for Configuring a Device in this Section. 

  • Enable the Port. 
  • Enter Hotkey for Session 0. 
  • If first session, enter Hot Key for the Main Port. See the EasyConnection Reference [PDF - 279KB]:  Customize - Syntax for Entering Escape Sequences for information about entering Hotkeys. 

Note: The number of virtual devices (sessions, attached printers) that can be configured per panel has a limit, depending on the size of the panel. The value of this limit is twice the number of ports on that panel (ie. 16 virtual devices on an 8 port panel). Sessions are not recommended on terminals that are used for PC-term mode applications, such as Microsoft Word. 
 

Attached Printers 

Attached Printers provide the facility for terminals attached to EasyConnection Ports to support a local printer on the terminal's auxiliary port. Setup is similar to that of a standard printer. 

Follow the steps for Configuring a Device in this Section. 

  • Is the printer a UNIX System Printer? If it is a Raw-device, no further configuration is required. 
  • Enter a Name for the Printer - select one different from the list in <F3> Window. 
  • What Printer Interface will it use? 
  • Is the Printer a Default Printer? 
  • Enable the Printer. 

Other 

This option provides the facility to attach a general UNIX device (for PABX's, milling machines, traffic controllers etc). It is the application's responsibility to set up the Other port's communications parameters. 

Multiple Session Support (MSS) 

You can copy an existing port configuration, including its attached devices, to another port or to a number of other ports. 

Note: When a printer's port configurations are copied to other ports, the UNIX printer name assigned is identical to the 'copied from' port's printer name, except that a digit [0-9] is appended to make the new printer name unique. 

A Port Configuration cannot be copied to a port which already supports a device. Use combinations of Remove and Copy if you need to reorganize the port configurations on an EasyConnection panel. Color screens display selections in 'inverse'. Monochrome (one color) screens display selections as 'flashing'. 

To copy a port configuration: 

1. Highlight Utilities on the Panel Configuration Menu and press <Enter>. 

2. Highlight Copy and press <Enter>. 

3. Highlight the port to be copied and press <Enter>. 

4. Highlight the destination port and <Space> to select. 

5. Repeat step (4) until the required number of destination ports have been selected. 

6. Press <Enter> to execute the port configuration copy. 

7. Answer 'y' to 'Copy to all the highlighted ports (y/n):' question. 

Working `/' appears at the top right corner of your screen. You can actually observe the result of the multiple copy as each destination port receives the setup. 
 
 

Removing Port Configurations 

You can delete port configurations when required. 

Note: To remove a port configuration, the devices on that port must be currently inactive (ie. for a port configured as a terminal, all users must be logged out of the terminal sessions). To kill processes running on a port, via easyadm, reset the device in the Single Port Monitoring Display. 
See Reset Device in Section 2 of the EasyConnection Reference [PDF - 279KB]. 

To remove a port configuration: 

1. Highlight Utilities on the Panel Configuration Menu and press <Enter>. 

2. Highlight Remove and press <Enter>. 

3. Highlight the first port and <Space> to select. 

4. Repeat step (3) until you have selected all the ports you want to remove. 

5. Press <Enter> to remove the port configurations. 

6. Answer 'y' to 'Remove the highlighted ports (y/n) ?' question. 

Working `/' appears in the top right corner of your screen. You can actually observe each port configuration being deleted. 
 
 

 Go to Top of Page
Go to Top

Copyright © 2007 Lantronix. All rights reserved