Myrinet GM-2 Software
for AIX

To download Myrinet software, you need a login and password.
If you don't already have these, please request them.

The AIX GM software is only distributed in binary form, and supports AIX 5.2 and 5.3 in 32-bit or 64-bit mode.

Recommended-version GM Binary Downloads for AIX
NIC
Operating System / Architecture PCIXE
(Two port,
Lanai 2XP)		 PCIXF
(One port,
Lanai 2XP)
and
PCIXD
(One port,
Lanai XP)
AIX 5.2 and 5.3 for Power4,
Power5, PowerPC-970		 GM-2.1.21 GM-2.0.21

Note: These GM binaries assume the use of PCIX-series Myrinet NICs. PCI64-series and PCI32-series Myrinet NICs are not supported.

Abbreviated Binary Installation Instructions

Please be sure to read the README files ( README-aix-gm2.0 or README-aix-gm2.1) for detailed installation instructions and architecture-specific troubleshooting. Unresolved questions could also be answered in the FAQ.

These abbreviated instructions presume that you are installing GM 2.0.

Current cautions and common problems:

  1. Running 64-bit GM applications on a 32-bit kernel is NOT supported. Attempting to run 64-bit GM applications on a 32-bit kernel will produce undefined results.

GM installation is performed in a few easy steps:

1. Unpacking the GM driver. 

        gunzip gm-2.0.21_AIX.tar.gz
        tar xvf gm-2.0.21_AIX.tar

2. Installing the GM driver.

The GM driver and associated software is shipped as an AIX Licensed Program Product (LPP). To install the GM LPP and start the mappers on an AIX system where GM is not currently installed: 

        su root     
	cd gm-2.0.21_AIX
        installp -a -d devices.pci.c1144380 all
        cfgmgr      
        /opt/gm/sbin/gm_start

After installation, all of the GM software will be contained under the directory /opt/gm except for the driver itself and its config and unconfig methods.

If there is already a version of the GM LPP installed, the old version should be uninstalled before installing the new version. To uninstall the GM driver, issue the following command: 

        su root
        /opt/gm/sbin/gm_stop
	installp -u devices.pci.c1144380.rte

This command stops the mappers and the IP over Myrinet device and then unloads the GM driver.

Once the GM LPP is installed, subsequent reboots will automatically load the gm driver and start the mappers.

2. Enabling IP over Myrinet (Ethernet emulation) (OPTIONAL)

If you would like to run IP over Myrinet (ethernet emulation), you must initially configure an IP and Netmask for the Ethernet emulation device. This can be done with the commands: 

        su
        smit tcpip
                --> Minimum Configuration & Startup

Assuming that AIX has assigned the name ent2 to the Myrinet device, IP over Myrinet is enabled as follows: 

        ifconfig en2 <ipaddr> up

The following command terminates and detaches IP over Myrinet: 

   
        ifconfig en2 detach

3. Testing the GM Installation.

Once the GM software has been properly installed on all of the hosts in your cluster, you are ready to validate your Myrinet installation by performing the following sequence of tests.

Each of these steps is detailed in the Troubleshooting section of the FAQ.

The test scripts (gm_board_info, gm_debug, gm_allsize, gm_stress) are available in <install_path>/bin in your GM installation. A README describing each of these tests can be found in <install_path>/bin/README.

Congratulations! You have successfully installed GM.

Refer to the Software and Documentation Page for details of GM-based software (MPICH-GM, PVM-GM). If you encountered difficulties during any phase of this installation process, we recommend that you first consult the README-aix and FAQ, and if you still have unresolved questions, please feel free to contact technical support at help@myri.com.


Last updated: 16 May 2006