############################################################################### # # Interphase (i) Corp # # IRIX 5.3 RFC-1483 PVC Driver # # Installation Instructions # # UGRMF61-000,REVB # ############################################################################### # # This file describes the contents, files, and procedures for installing the # Interphase ATM adaptors and RFC-1483 PVC drivers into Silicon Graphics # platforms which implement the VMEbus as I/O expansion and run the # IRIX 5.3 operating system. # # These currently include (but not limited to) SGI machine types: # # VME -Challenge L, Challenge XL, Onyx # ############################################################################### # # Contents: # --------- # # This driver evaluation kit is distributed in tar format and, # after extraction, includes the following files: # # readme -this readme file # ixinstall -PVC driver install script # rfc1483 -RFC 1483 reference document # # VME/ixsg.o -IRIX driver object file # VME/ixsg.mf -IRIX driver master file # VME/ixsg.sm -IRIX driver system file # VME/pvcarp -PVC ARP table management utility # VME/ixdump -diagnostic dump utility # VME/ipburn -firmware burn utility # VME/pvcarp.z -pvcarp utility "packed" man page # VME/ixdump.z -ixdump utility "packed" man page # VME/ipburn.z -ipburn utility "packed" man page # # VME/ufiles -list of utilities to install # VME/mfiles -list of man pages to install # ############################################################################### # # Installation Requirements: # -------------------------- # # 1. IRIX 5.3 (or later) operating system # 2. root password # 3. 250KB space in /(root) file system # 4. 500KB space in /usr file system # 5. 1MB temporary space (may be removed after installation) # 6. A unique, legal IP name and address # ############################################################################### ############################################################################### # # Driver/Utility Installation # --------------------------- # # 1. Login as root. # # 2. Select and/or create an installation directory, with at least 1MB # of free space, and extract the evaluation kit into that directory. # For example, to make a directory under /tmp, type: # # cd /tmp ; mkdir ixsg ; cd ixsg # # and to extract the driver from a local CDROM, type: # # tar -xvf /CDROM/sx00200.* # # 3. Verify the evaluation kit contents are present. # # 4. Check the driver defaults (discussed later) to see if they are # appropiate for your environment. If not, make (or note) the necessary # changes prior to invoking the ixinstall utility. # # 5. Perform the Network Configuration procedures. # # 6. To begin the driver, support utility, and documentation installation, # enter the following command: # # ./ixinstall VME # # This script will inquire (using the command uname -srm) the system # as to the operating system name and revision. If any of these are not # supported, the script will inform the user and abort the installation. # # Otherwise it will install the following driver files: # # /var/sysgen/master.d/ixsg # /var/sysgen/system/ixsg.sm # /var/sysgen/boot/ixsg.o # # the following driver support utilities: # # /usr/sbin/pvcarp # /usr/sbin/ixdump # /usr/sbin/ipburn # # the following utility man pages: # # /usr/share/catman/a_man/cat1/pvcarp.z # /usr/share/catman/a_man/cat1/ixdump.z # /usr/share/catman/a_man/cat1/ipburn.z # # and create the following device node: # # /dev/ixc00 # # 7. During reboot, watch the console for messages and/or errors starting # with IXSG. These messages are also copied to the system log file: # # /var/adm/SYSLOG # ############################################################################### ############################################################################### # # Installation Variations # ----------------------- # # This driver and support utilities make a reasonable assumption of three # variables that will work in most environments, but may need to be altered # in some applications. These include (with defaults): # # utility directory - /usr/sbin # man page directory - /usr/share/catman/a_man/cat1 # node major device - 60 # # and for example purposes, we require the following alterations: # # utilitiy dir = /bin # device node = 80 # # The install parameters can be altered in 1 of 2 ways. Either edit # the "script defaults" found in the script itself (ixinstall): # # change- to- # # set UTILDIR = /usr/sbin set UTILDIR = /bin # set MAJDEV = 60 set MAJDEV = 80 # # or via the command line options: # # ixinstall -u /bin -d 80 BUS # ############################################################################### # # The syntax for ixinstall is: # # ixinstall [-c num] [-u udir] [-m mdir] [-d majdev] BUS # # where: # BUS -bus type (VME) # num -number of controllers to install (1 or 2) # udir -directory to install the support utilities # mdir -directory to install the man pages # majdev -character device major number # ############################################################################### ############################################################################### # # Network Interface Configuration # ------------------------------- # # For the ATM network interface to be configured and activated at # bootup, the following steps are required: # # 1. Add the IP name and address to the file # # /etc/hosts # # 2. Edit, following the directions within, the file: # # /etc/config/netif.options # # specifing: # ifXname=ix0 # ifXaddr=NAME # # where: # X is the next available interface # NAME is the IP name specified in /etc/hosts # # 3. Create the file (where X is the same as in step 2) # # /etc/config/ifconfig-X.options # # with the line: # # netmask 0xffffff00 up # # 4. If installing 2 controllers, steps 1,2,3 must be repeated for # the second controller, with step 2's ifXname=ix1. # ############################################################################### ############################################################################### # # Automated Boots & Shutdowns # --------------------------- # # After boot the user must configure the IP to VC conversion table using # the (or a series of) "pvcarp" commands. This is required to establish all # connections to be used by the system. # # For example, to establish connections to 2 systems, named sys1 and sys2 # in the /etc/hosts file, on circuits 101 & 102 respectively, the commands # would be: # pvcarp -s sys1 -c 101 # pvcarp -s sys2 -c 102 # # and to verify the table entries: # # pvcarp -a # # and to gracefully shut down the network: # # pvcarp -z # # To automate the PVC configuration and shutdown, create (maintain as required) # the following startup and shutdown scripts with commands resembling the # following: # # /etc/config/ixsg_up # # echo "ix-ATM PVC configuration" # pvcarp -s sys1 -c 101 # pvcarp -s sys2 -c 102 # pvcarp -a # # /etc/config/ixsg_down # # echo "ix-ATM PVC shutdown" # pvcarp -z # # At boot and shutdown, IRIX 5.3 invokes the following script for configuring # and dismantling the networks: # # /etc/init.d/network # # To have your scripts invoked at appropiate times, edit the initialization # script /etc/init.d/network to contain the following test & execute directives # (generally towards, if not at, the end of the respective case statements). # # case "$1" in # 'start') # # ATM configuration # if test -x /etc/config/ixsg_up; then # /etc/config/ixsg_up # fi # ;; # # 'stop') # # ATM shutdown # if test -x /etc/config/ixsg_down; then # /etc/config/ixsg_down # fi # ;; ###############################################################################