Installing the Workgroup EISA SGI
Adapter Software

Running the IRIX Install Script

Now you need to invoke the EISA SGI adapter software installation script using the install.fddi command.

The script asks various questions about the type of installation you want to perform, and about your system. Specifically, it asks for the following information:

• If you want to install the EISA SGI driver
  

• The number of FDDI interfaces you want to install
  

• The host name and IP address for each interface
  

• The network interface number for each adapter
  

IRIX EISA SGI Driver Installation

The following steps describe the installation of the IRIX EISA SGI adapter driver software:

Step 1 Change directory to /usr/local/cfddi.

Step 2 To start running the EISA SGI installation script, enter ./install.fddi. The following information appears:

console 6# ./install.fddi



You have invoked the install.fddi script.

Which is used to install software for FDDI EISA Adapters.



1) Install FDDI EISA driver.





Do you wish to install the EISA FDDI driver (y/n) [y] ? y

Step 3 When the FDDI EISA SGI installation prompt appears, enter y. The following information appears:

How many FDDI interfaces are being installed in this machine [1] 
? 1 

Step 4 Enter the number of FDDI interfaces installed on this workstation. The EISA adapter slot number prompt appears.

Enter eisa slot number (1-4) for FDDI interface [1] 1

Step 5 Enter the physical slot number (1 to 4) where the EISA adapter, will be or is, installed. The FDDI interface host name prompt appears:

Enter hostname for FDDI interface fddi0 [console-fddi]: 

Step 6 Enter the new name of this workstation or use the default name assigned (the existing name with the -fddi modification). The IP address prompt appears:

Enter IP address for FDDI interface 1 [198.133.219.99]: 

Step 7 Enter the IP address for this workstation or press Return to enter the default IP address. The following prompt appears:

modifying /etc/hosts



Enter netif number for FDDI interface 1 [ 1 ]: 2

Step 8 Enter the netif (network interface) number for this interface. The follow prompt appears:

Is EISA FDDI Adapter currently installed in the workstation (y/n) 
[y] ? y

Step 9 If the interface card is installed enter y, if not enter n. After some system configuration information is displayed, the kernel rebuild confirmation appears:

configuring kernel...................done



Installation of FDDI EISA driver complete.

You should now halt the system, power down,

and install the FDDI EISA Adapter.



A log of the installation is in ./install.fddi.log

console 7# 

Step 10 Power down the system and install the EISA SGI adapter or if the adapter is already installed, log out and reboot to cause the system to run using the new rebuilt kernel. Refer to the chapter, "Installing the Workgroup EISA SGI Adapter Hardware."

See the section "EISA SGI Driver Installation Script Example" for a complete version of the previous installation script.

Caution If your system is running Network Information Service (NIS), you must also update the NIS databases with the host name and IP address. Refer to the Silicon Graphics, Inc. Personal System Administration Guide for instructions on how to update NIS databases. You must have an NIS server on the newly created FDDI subnet.

EISA SGI Driver Installation Script Example

The following text is an example of the ./install.fddi.log file created using the previous installation procedures:

console 6# ./install.fddi



You have invoked the install.fddi script.

Which is used to install software for FDDI EISA Adapters.



1) Install FDDI EISA driver.





Do you wish to install the EISA FDDI driver (y/n) [y] ? y



How many FDDI interfaces are being installed in this machine [1] ? 1



Enter eisa slot number (1-4) for FDDI interface [1] 1



Enter hostname for FDDI interface 1 [console-fddi]: 



Enter IP address for FDDI interface 1 [198.133.219.99]: 



modifying /etc/hosts



Enter netif number for FDDI interface 1 [ 1 ]: 2





Is EISA FDDI Adapter currently installed in the workstation (y/n) [y] ? y



configuring kernel...................done



Installation of FDDI EISA driver complete.

You should now halt the system, power down,

and install the FDDI EISA Adapter.



A log of the installation is in ./install.fddi.log

console 7# 

Editing the /etc/config/netif.options File

The /etc/config/netif.options files will need to be modified to allow the network connection to the EISA SGI adapter. The modifications will vary depending on the configuration of the EISA SGI adapter in the network. The three basic configurations of the EISA SGI adapter in the network are:

• CDDI/FDDI EISA SGI adapter as the primary network interface with Ethernet as secondary.
  

• CDDI/FDDI EISA SGI adapter as the secondary network interface with Ethernet as primary.
  

• CDDI/FDDI EISA SGI adapter as the only network interface.
  

Note The install.fddi script will create an /etc/config/ifconfig-x.options file for each adapter installed and mount the interface as "up". (For example, the netif-1.options file corresponds to network interface adapter number 1.) If special ifconfig command options are required for the interface, for example, netmask setting, the /etc/config/ifconfig-x.options file will need to be modified.

The following example will modify the /etc/config/netif.options file for the netif number 2 adapter installed in the previous example. This example will configure the EISA SGI adapter as the secondary network interface with the Ethernet as primary. Complete the following steps to edit the netif.options file:

Note To install an adapter with a different netif number or configuration modify the corresponding lines of the netif.options file for that number.

Step 1 Log in as superuser.

Step 2 Open the /etc/config/netif.options file using a text editor such as vi using the following command:

vi /etc/config/netif.options

The following file will appear:

# netif.options:

#

# The network startup script, /etc/init.d/network, computes typical

# primary and gateway interface names and addresses for most systems.

# Netif.options provides a place for site-dependent network interface

# definitions. You need to modify this file only if:

# 1) the computed primary and/or gateway interface names are incorrect, or

# 2) you don't like convention used to define addresses for interfaces, or

# 3) the host has more than 2 interfaces.

#

# /etc/init.d/network uses two variables to configure each interface.

# The script uses "if1name" and "if1addr" for the primary interface,

# "if2name" and "if2addr" for the first gateway interface, etc.

#

# An ifXname variable (where X=1,2,3...) is the interface's device name as

# reported by "/usr/etc/netstat -i". Valid names include ec0, et0, enp0,

# enp1, fxp0, fxp1, ipg0, ipg1, etc., but NOT lo0.

#

# An ifXaddr variable is a hostname containing $HOSTNAME or a hostname

# in /etc/hosts or an IP address in dot notation. ($HOSTNAME is the host's

# name in /etc/sys_id.) By convention, gateway interfaces use the

# "gate-", "gate2-" and "gate3-" prefixes in front of $HOSTNAME.

# If you don't like this convention, change the appropriate ifXaddr 
variables.

# For the system to boot correctly, make sure that names specified in 
ifXaddr

# variables have entries in /etc/hosts.





# The following shell variables have the form "var=value", with no spaces

# before or after the = character (for example: if1name=fxp1).

# Lines with the leading : character are commented out.





# Append the interface name and remove the leading : to override

# the primary interface selection.



: if1name=ec0



# To override the primary interface address, change the value part

# and remove the leading : character.



: if1addr=$HOSTNAME



# To override the name and/or address of the first gateway interface,

# change the value part and remove the leading : character.



: if2name=

: if2addr=gate-$HOSTNAME



# If this host has more than 2 interfaces, you must define values for

# if3name (and if4name if appropriate). Change if3addr (and if4addr) to

# the appropriate names in /etc/hosts if your site has different naming

# conventions.



if3name=

if3addr=gate2-$HOSTNAME



if4name=

if4addr=gate3-$HOSTNAME



# If this host has more than 8 network interfaces, set the number of

# interfaces that the network startup script will configure.



: if_num=8

Step 3 Find the following lines of text that correspond to the network interface number (netif#) entered when you ran the install.fddi script. The following example will install netif number 2:

# To override the name and/or address of the first gateway 
interface,

# change the value part and remove the leading : character.



: if2name=

: if2addr=gate-$HOSTNAME

Step 4 Edit the line and add the following information:

if2name=fddi0

Delete the leading colon and space and add fddi0.

Step 5 Edit the line of text:

: if2addr=gate-$HOSTNAME

Step 6 Edit the line and add the following information:

if2addr=$HOSTNAME-fddi

Delete the leading colon, space, and gate-, and add -fddi to the end.

Step 7 Save and close the file.

Step 8 Proceed to the chapter, "Installing the Workgroup EISA SGI Adapter Hardware" to install the EISA SGI adapter.

/etc/config/netif.options File Modification Example

The following text is an example of the /etc/config/netif.options file modified using the previous procedure:

# netif.options:

#

# The network startup script, /etc/init.d/network, computes typical

# primary and gateway interface names and addresses for most systems.

.

.

(information omitted)

.

.

# Append the interface name and remove the leading : to override

# the primary interface selection.



: if1name=ec0



# To override the primary interface address, change the value part

# and remove the leading : character.



: if1addr=$HOSTNAME



# To override the name and/or address of the first gateway interface,

# change the value part and remove the leading : character.



if2name=fddi0

if2addr=$HOSTNAME-fddi



# If this host has more than 2 interfaces, you must define values for

# if3name (and if4name if appropriate). Change if3addr (and if4addr) to

# the appropriate names in /etc/hosts if your site has different naming

# conventions.



if3name=

if3addr=gate2-$HOSTNAME



if4name=

if4addr=gate3-$HOSTNAME



# If this host has more than 8 network interfaces, set the number of

# interfaces that the network startup script will configure.



: if_num=8

Setting Up Routers for IRIX

When you install an FDDI EISA SGI adapter in a system with an existing Ethernet interface, it automatically becomes a router serving both the FDDI and Ethernet networks. The router is known to the Ethernet network by its Ethernet IP address and host name, and to the FDDI network by its FDDI IP address and host name.

Stations on an internetwork can be reached via multiple routes. When a standard IRIX system is booted, the route daemon (routed) sends out packets over both the Ethernet and the FDDI networks. The route daemon determines the optimal route between stations by relative hop count, not by the speed of the interface. Therefore, in cases where the hop counts are equal, the use of FDDI is not guaranteed. You can guarantee the use of FDDI for network commands by specifying the FDDI host name or IP address of the destination machine.

In Figure 3-1, two commands will each resolve the same physical file on the workstation called Aria.

Figure 3-1 : Setting Up a Router

If a user on Fredo mounts files on Delbert, then NFS traffic goes over the Ethernet to either Samson or Aria and from there over an FDDI network to Delbert. However, if a user on Samson mounts files on Aria, the NFS traffic can go over either the FDDI or Ethernet. The user can specify which interface to use by including Aria's FDDI or Ethernet host name in the mount command as follows:

fredo@samson => mount aria:/usr/etc/install/usr/etc/install
fredo@samson => mount aria-FDDI:/usr/etc/install/usr/etc/install

Both these commands mount to the same physical files on Aria. However, the first results in NFS traffic being routed over the Ethernet networks while the second results in NFS traffic being routed over the FDDI network.

Copyright 1988-1996 © Cisco Systems Inc.