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
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