=============================================================================== README - Interphase IRIX 5.3 SIGD/LANE Driver Installation UGRMF41-000,REVA -- driver: sx00205.a00 -- signald: B05 =============================================================================== Files: README # this README file lane # driver installation csh script sys/ia.o # hardware driver object sys/ia.smx # hardware driver system file sys/ia.mfx # hardware driver master file sys/li.o # LANE driver object sys/li.smx # LANE driver system file sys/li.mfx # LANE driver master file bin/signald # SIGD application (UNI 3.0/3.1 signaling) bin/sigdbg # SIGD debug application bin/sigstat # SIGD statistics application bin/sigd_start # SIGD start/restart script bin/sigd_stop # SIGD shutdown script bin/lec # LANE Client configuration utility bin/lecs # LANE configuration utility bin/ledbg # LANE Client debug utility bin/les # LANE Server configuration utility bin/lesdbg # LANE Server debug utility bin/iadump # driver diagnostic/dump utility bin/ipburn # V5215 firmware burn utility (SX00205 only) config/atmlane # IS_ON configuration file config/signald # IS_ON configuration file config/lec # IS_ON configuration file config/atmconf.0 # LANE/SIGD configuration file config/lecconf.0 # LANE Client 0 configuration file man/signald.z # packed man page man/sigdbg.z # packed man page man/sigstat.z # packed man page man/lec.z # packed man page man/lecs.z # packed man page man/ledbg.z # packed man page man/les.z # packed man page man/lesdbg.z # packed man page man/atmconf.z # packed man page man/lecconf.z # packed man page =============================================================================== Architecture: This driver consists of three basic parts: the signaling application, the LAN Emulation (LANE) driver, and the hardware driver. Also provided are support/debug utilities and man pages. 1) Signaling - signald This is run as an application and provides either the UNI 3.0 or 3.1 signaling software. This must be invoked after both the LANE and hardware drivers are operational. Support/debug utilities: sigd_start, sigd_stop, sigdbg, sigstat Configuration file: atmconf.0 2) LANE driver - li.o This is a kernel level driver, and provides the interface for the signaling application and the IFNET network driver. This is setup to be loaded by the kernel at boot time. System files: li.smx, li.mfx Support/debug utilities: lec, lecs, les, ledbg, lesdbg Configuration files: atmconf.0, li.mfx 3) Hardware driver - ia.o This is a kernel level driver and provides the interface between signaling, LANE, and the specific hardware platform. This is setup to be loaded by the kernel at boot time. System files: ia.smx, ia.mfx Support/debug utility: iadump, ipburn =============================================================================== Pre-installation: Prior to installation the following needs to be known/determined: 1. root password 2. A unique IP address and name. 3. A unique Major Device number for the LANE driver. 4. A unique Major Device number for the Hardware driver. 5. A unique Short IO address for the Interphase controller(s). 6. If not installing from CDROM, the tarfile is around 2.0MB in size, and when extracted, requires an additional 2.0MB. 7. It is recommended that the IRIX network configurations are performed prior to running the drivers' install script. =============================================================================== Install Script: usage: lane [option(s)] options: [-i num] major device number for ia driver (default: 60) [-l num] major device number for li driver (default: 61) [-a addr] adapter's short io address (default: 0x6000) [-b path] directory for binaries (default: /usr/sbin) [-c path] directory for config files (default: /etc/config) [-m path] directory for man pages (defualt: /usr/share/catman/a_man/cat1) [-u usr] install 'user' (default: root) [-g grp] install 'group' (default: sys) notes: 1. The install script creates the following files by editing the respective distribution file, using command line options or installation defaults: created file from command option ------------------------ ---------- -------------- /var/sysgen/system/ia.sm sys/ia.smx -a /var/sysgen/system/li.sm sys/li.smx -a /var/sysgen/master.d/ia sys/ia.mfx -i /var/sysgen/master.d/li sys/li.mfx -l =============================================================================== Network Configuration: It is assumed that whoever is installing this driver is somewhat familiar with the administration of IRIX networking. The following instructions are pretty generic in nature, and your specific setup may vary slightly. 1. Add the interface to the kernel by editing the file: /etc/config/netif.options Follow the directions provided in the file and note which ifname/ ifaddr you use. This network's ifname is: li0. if_X_name=li0 if_X_addr=NAME where: _X_ is the next available interface number NAME is the IP name to be specified in /etc/hosts 2. Create the ifconfig file (where _X_ is the same as in step 1): /etc/config/ifconfig-_X_.options specifing the options your network requires, ie: broadcast 123.456.789.0 netmask 0xffffff00 up 3. Add the IP NAME (where NAME is the same as in step 1) and address to the file: /etc/hosts ie: 123.456.789.321 NAME =============================================================================== Automating Bootup & Shutdown: The UNI signalling application must be started after the hardware device drivers have been loaded by the kernel. This may be done manually by the system administrator after bootup, or may be automated using the startup script provided with the driver package. Both startup and shutdown commands may be added to the file /etc/init.d/network 1. LANE client(s) startup - at the end of the case 'start', add the following: # ATM/LEC startup if $IS_ON lec && test -x /usr/sbin/lec; then /usr/sbin/lec -u0 -f /etc/config/lecconf.0 fi The "lane" install script creates the file: /etc/config/lec with the contents: on which is used by the $IS_ON test above. To disable configuring the LANE clients at boot time, change the contents of this file to "off". This will mandate that the system administrator configure each client manually after every boot/reboot. 2. Signald startup - at the end of the case 'start', add the following: # ATM/SIGD startup if $IS_ON signald && test -x /usr/sbin/sigd_start; then /usr/sbin/sigd_start fi The "lane" install script creates the file: /etc/config/signald with the contents: on which is used by the $IS_ON test above. To disable starting the signaling application at boot time, change the contents of this file to "off". This will mandate that the system administrator manually start the signald application after every boot/reboot. 3. Most systems DO NOT provide a hardware reset during a reboot, and if not, the board remains active, and the kernel will PANIC upon receipt of the first receive packet. Software can provide this much needed reset by adding the shutdown command at the end of the case statement 'stop': # ATM/LANE shutdown if $IS_ON atmlane; then $IFCONFIG li0 down 2> /dev/null if test -x /usr/sbin/iadump; then /usr/sbin/iadump shutdown fi fi The "lane" install script creates the file: /etc/config/atmlane with the contents: on which is used by the $IS_ON test above. To disable this reset during shutdown, change the contents of this file to "off". This will mandate that the system administrator manually reset the hardware prior to a reboot (or requires a power cycle before booting). NOTE: the paths to lec, sigd_start, and iadump above must match whatever is specified during the driver installation (the -b command line option). The path to lec, signald, and iadump, if changed from the install script's default (/usr/sbin/), must be changed in the above examples, and also in the scripts: sigd_start, sigd_stop =============================================================================== Installation steps: 1. Login as root 2. If installing from the tarfile, create a temporary directory (ie, /usr/lane), copy the tarfile into the directory, and extract the contents with the command: tar xvf sx* If installing from CDROM, change to the base directory: cd /CDROM 3. Check the following installation parameters, and if your environment requires changes, use the appropiate command line option(s) to alter: -a SHIO = short I/O address -i IAMAJ = major device number for the hardware driver -l LIMAJ = major device number for the LANE driver -b BINDIR = directory to install executable binaries -c CFGDIR = directory to install configuration files -m MANDIR = directory to install man pages Any changes may be made by editing the script or with command line arguments. 4. See the man pages for altering the parameters used in the configuration files: atmconf.0 lecconf.0 5. Run the lane script. This will install all binaries, system files, and man pages. After installation, the kernel is reconfigured and the system rebooted with the new kernel. 6. If the installation was succesful, the drivers will be loaded and the network interface configured at bootup. 7. If signalling and LANE configuration were not setup to auto-start at bootup, they will need to be manually started after every boot/reboot. sigd_start -script to start/restart the signaling application (uses parameters in file: atmconf.0) lec -LANE configuration application (uses parameters in file: lecconf.0) =============================================================================== Interphase (i) Corp 13800 Senlac Dr Dallas Tx 75234 214-654-5000 http://www.iphase.com/ email: intouch@iphase.com