This README-all file is intended to provide general purpose instruction 
about GM, applicable to all supported architectures.

For questions about installing GM, see the README-<arch> file for each
architecture, and see the file README.

If these files do not answer your questions, send e-mail
to help@myri.com. Please include the architecture, and OS you 
are running on, as well as the GM version that you are running.
It is recommended that you run on a recent version of GM.


1. Step-by-step instructions to install and test the switch and network.

If the drivers have already been installed and the cabling is correct
there will be a green LED lit up on the switch for each connection that is
active. 

At this point, you can run 'gm_board_info' (in the binary/bin directory) 
from a command prompt to get information about the network. gm_board_info 
displays information about the Myrinet adapter as well as a list of nodes 
on the network.

*** No routes found *** is an indication that there is no active mapper on
the network. You will have to run the mapper before proceeding. (See README and
README-<arch>).

When gm_board_info successfully reports a list of nodes, you can then
run gm_allsize and gm_nway to test the network.

gm_allsize can be used to measure latency and bandwith. gm_allsize without
any parameters will measure latency. 'gm_allsize -bw --geometric' will measure
bandwith. One-way tests can be performed by running in slave mode on one
machine and master on the node to be tested. This is done by adding
'--slave' on the command line of the slave machine and '-h host' on the
command line of the master where host is the name of the machine running
in slave mode. The name of each node can be found by running gm_board_info
on each machine. 'gm_allsize --help' will provide a list of additional
parameters that can be used.

gm_nway can be used to send and receive messages from multiple
machines. For example, given machines named myr1, myri2, and myri3, you
can execute 'gm_nway myri1 myri2 myri3' from a command line from each of
the machines. This will cause all three nodes to send and receive messages
between each other. 'gm_nway --help' will provide a summary of
parameters. It can be used on any subset of the network.

More information about these tests can also be found at /binary/bin/tests.README
