$Id: README-solaris,v 1.10 2000/04/23 03:16:24 feldy Exp $

README for solaris distribution

This GM distribution will run under
Solaris 2.5/2.6 on x86 and Ultrasparc platforms.
It will run under solarsi 2.7 in 32-bit mode on ultrasparcs.
It will also run in 64-bit mode on ultrasparcs, but you need
the Sun compiler. See README-solaris7-64bit for more info.

It is not known to work on non-Ultra sparcs.

To compile for an SBus-based machine, use
	./configure --disable-pci

IP support is included. The device is
myriN. It will be myri0 if you only have one
card.

/sbin/ifconfig myri0 plumb	(installs the driver)
/sbin/ifconfig myri0 <ipaddr> up (configures the driver)

To install GM-only
	cd binary
	./GM_INSTALL <install_dir>

To install GM and IP-over-GM
	cd binary
	./GM_INSTALL --ip <install_dir>

WARNING - the install procedure makes links from the install_dir
directory to /kernel/drv/. If your gm_install directory is
on an auto-mounted volume, the links created may get bad paths.
If you type
        ./GM_INSTALL <better_dir>

where <better_dir> is a non auto-mounted volume, it should work.

The advantage of using an NFS_mounted volume is so that you 
can delete the driver from the server if your machine is
panicing due to the Myrinet driver.

Typing
	./GM_INSTALL `pwd` 
will not move the files at all. Note that the script requires
you to type some directory name.


The install script will create a 
	/tmp/S99myrinet
file that is suitable for placement in 
	/etc/rc.d/rc3.d
You'll need to edit it to enable autoloading 
of the IP driver.


To run the mapper

cd binary/sbin
mapper active.args
	[edit the active.args file to uncomment -verbose 
	 to see what the mapper is doing]

The solaris driver does not set the hostname for the GM card, so it uses
the 48-bit ID as a char string. 
To get real hostnames for the GM boards, run
	binary/bin/gm_setname -h `hostname` on each node before running the
mapper.


To build the IP driver from source you need to
	cd gm
	./configure
	make

