
If you have problems on any architectures, please
send the output from
/var/adm/messages
to <help@myri.com>.

The IP device is accessed via
	ifconfig myri0 <address> netmask <netmask> broadcast <bcast> up


Never run GM_INSTALL twice on any machine.
To simply update the driver binary 
(e.g. after you have run GM_INSTALL once at some point in time 
in the distant past for a previous GM release),
	./GM_copy_driver
	sync
	/sbin/reboot

run
./GM_INSTALL 
to install/configure the driver.

You need to run the mapper at least once after loading the driver
on all nodes in your network.
cd sbin
mapper active.args

You might want to run
	gm_setname -h `hostname` 
to write a "useful" name into the card/driver. Otherwise, the
gm_name of the machine will be an ASCII-ized version of
its 48-bit ID.


COMPILING from SOURCE
By default, the configure will use cc and c++.
To compile from source you'll need to have a /usr/sys/HOSTNAME
or a /usr/sys/MYRI directory. We put both of those on the "-I" include
path list for building kernel code.

To compile from source using the Tru64 C and C++ compilers
 
#DIGITAL C++ V6.1-027
setenv CC /usr/ccs/bin/cc
setenv CFLAGS "-std -msg_disable extrasemi "
setenv CXX /usr/bin/cxx
setenv CXXFLAGS "-O2 -inline speed -x cxx -using_std -w2 -msg_disable extrasemi -tune generic"
rm -f config.cache
./configure


#Compaq C++ V6.2-024 
setenv CC /usr/ccs/bin/cc
setenv CFLAGS "-std -msg_disable extrasemi "
setenv CXX /usr/bin/cxx
setenv CXXFLAGS "-O2 -inline speed -x cxx -nocxxstd -using_std -w2 -msg_disable extrasemi -tune generic"
rm -f config.cache
./configure



*************************************************************************
The driver is theoretically unloadable, but we have not found an
"if_detach" function, so reloading the driver will result in multiple
myri0 interfaces showing up in the system. Most likely, any ifconfig or
IP traffic will cause a system panic.

The driver developer docs at
http://www.unix.digital.com/faqs/publications/dev_doc/usr/examples/ddk/lan/README

say this about unloading a network driver.

NOTES:
------

o LAN drivers can only be loaded.  There is currently no method for unloading
  LAN drivers.  We are planning on fixing this for a future release.
*************************************************************************


****************************************************************
WARNING - it appears that some HW/OS combinations do NOT
correctly create the
	/dev/gm*
devices. This should happen automatically when the driver loads.
If you've run GM_INSTALL, then type

	ls -l /dev/gm*

If you have no GM entries, then look in /var/log/messages
for a line like this
Jul 16 16:33:01 sx vmunix: gm: major device number assigned = 75

grep "major device number assigned" /var/adm/messages

Then run (as root)
gm_makedev <major_num>

e.g. gm_makedev 75

This should let you use GM while we try to find the root problem.
****************************************************************


****************************************************************
If you have problems running the mapper and see something
like this
./mapper: /sbin/loader: Fatal Error: cannot map libstdc++.so.2.8.0


then set up a symbolic link from libstdc++.so.2.8.1 to libstdc++.so.2.8.0
assuming you can find libstdc++.so.2.8.0 in /usr/local/lib.

If not, a copy is at
ftp.myri.com
cd /pub/GM
<use the normal user and passwd you use for myrinet software>

www% ls -l lib*
-rw-r--r--  1 web        399700 Jul 16 16:57 libstdc++.so.2.8.0.gz
-rw-r--r--  1 web        399613 Aug 16 17:45 libstdc++.so.2.8.1.gz


This should let you use the mapper until we release a statically
linked version.

We're now compiling with libstdc++.so.2.8.1 so both are
available on our web site.

****************************************************************

To unload the driver you need to do the following
/sbin/sysconfigdb -d gm
/sbin/reboot

The system will boot with the gm driver not loaded.
You can then
	./GM_INSTALL
to re-load it.

****************************************************************

If you see errors of this form -

gm: LANAI: gm_sdma.h: call handle_send_error(0x0x4f698,18) destid=0
gm: LANAI: handle_send_error: subport 4 handling send error 18
gm: LANAI: handle_send_error: disabling subport 4

Then you will need to apply this patch that can be found here -
http://ftp.support.compaq.com/patches/.new/unix.html

t64v50as0001-19991025.README, T64V50AS0001-19991025 Tru64 UNIX V5.0 Aggregate
                         ECO Summary
                         10-Nov-1999 

use 
uname -a 
to check your Tru64 version

and 
sys_check -config -nohtml > output_file

to check what patches you have currently installed (look
in the output_file for "Installed patch kit versions")

******************************************************************
