EDR-3317 (SGI GIO HIPPI Interface controller card drivers and utilities).



RELEASE 1.1.2



IMPORTANT NOTE:  The driver/utility software is presently specific 

for Indigo2 R4K machines running IRIX 6.2. 



INSTRUCTIONS FOR USE:



- Installation and Configuration of software driver for the SGI GIO HIPPI card.



INSTALLATION OF DRIVER



The following operations are performed as 'root' on the target system.



The kit is distributed in a tar file.  See the customer letter for location

of software kit. 



1.  Copy the distribution file H_IP22R4K_6.2_1.1.2.tar to the /usr/dist (or 

any working directory) directory.



        # su

        # cd /usr/dist (or any working directory you want)

        # cp <location of kit> H_IP22R4K_6.2_1.1.2.tar



2.  Extract the archive



          # tar xvf H_IP22R4K_6.2_1.1.2.tar



After you have installed the Essential GIO-HIPPI NIC into your Indigo2, 

follow these steps (you must have root privileges), to setup the driver: 



NOTE: [ Make sure that if you have an Essential GIO driver already installed 

you use the Software Manager to remove the driver before installing a new one. ]



3.  Launch the Software Manager (swmgr).



4.  Enter <working_directory> (e.g. /usr/dist ) in the Available Software

text box.



Click the Lookup button or press the Return key on your keyboard. The

Software Manager will look for a distribution package in the working

directory, and the Start button will be highlighted.



5.  Select "Default Installation." If you choose "Customize Installation", 

the "GIO-HIPPI for Indigo2 v. x.xx" installation package should appear in 

the main window. Select the GIO-HIPPI installation package under the Install 

heading; a check will appear in the checkbox.



6.  Begin the installation by clicking the Start button.



When the Software Manager has completed the driver software installation, 

choose the Quit command from the File menu to close the Software Manager.



7.  Reboot the system:

        reboot

You have now completed installation of the Essential HIPPI driver software.



- CONFIGURATION OF DRIVER



You should make sure that /etc/init.d/Essnic.pre and Essnic.post files contain

the below information.



1. Modify /etc/init.d/Essnic.pre file to include:



        You will need an essarp -l statement with the information about 

the Logical Switch address of the machine you are installing on.



Example:

        /etc/essarp -l 00e



If there is a statement "/etc/essgidle 1" then you need to change it to 

"/etc/essgidle 10" for performance improvements. If there is no essgidle 

statement then add one.



2. Modify /etc/init.d/Essnic.post file to include:



        You will need to set the Universal Lan Address (ULA) and logical 

address of the other machines on the HIPPI network as well as the machine 

you are on.



Example:

        essarp -s george-h 00:b1:46:00:14:C6 00e ess0

        essarp -s bill-h 00:b1:46:00:14:D7 102 ess0



3. Make sure an IP address and hostname has been assigned for this Network 

Interface Card (NIC), and the /etc/hosts file, NIS and/or DNS tables are 

updated, where applicable. If you are not sure abut the IP address and/or 

hostname for this NIC, please contact your system/network administrator.



4. Modify network config files in /etc/config.



    a) Modify the /etc/config/netif.options file and add the next two lines

corresponding with how many network devices that are already present:



Example:

        if2name=ess0

        if2addr=george-h



    b) Create the file /etc/config/ifconfig-x.options, where x corresponds 

with the ifxname=ess0 (see above example) entry in the 

/etc/config/netif.options file. Add the following line, where the netmask 

is optional, but the up is required for TCP/IP functionality upon reboot.



Example:

        For the above example, the file would be called ifconfig-2.options, 

and it would contain the following: 



        netmask 0xffffff00 up



5. Install new firmware and setup tuning parameters.



You need to install new firmware and load correct tuning parameters into NIC

EEPROM by using the following script, as root:



/usr/Essential/hippi/scripts/esssetup.sh



6. Reboot the machine.



-----------------------------------------------------------------------------



Release Information



1) Several bugs in the previous release of the driver have been fixed,

   including sluggish performance.



2) ARP agent and IP broadcast agents are not supported. Direct connected

   systems process each other's ARP properly. Network connected NICs

   discover ARP properly if arp is manually configured using essarp -s



