Install Guide for GRAPE-6A library and test programs

Version 1.1 Nov 30 2004
Toshiyuki Fukushige (fukushig@provence.c.u-tokyo.ac.jp) 

0. Overview

In this document, I'll describe how to install library files for
GRAPE-6A, and how to run test programs.

At present, x86 (Linux kernel 2.4.x) and x86_64 (Linux kernel 2.6.5)
are supported.

1) Installing library

First, download the newest version from

http://grape.c.u-tokyo.ac.jp/~fukushig/g6a
(select current library)

You will get g6apkg.tar.gz.  Untar it by

> tar xvzf g6apkg.tar.gz

at the directory where you want to place the source files.
The directories: 

g6apkg/

and several subdirectories will be created. 

Goto g6apkg by

> cd g6apkg

and start the install script by

> csh -f install.csh

You will see the menu:

********** Main Menu ***********
1. Compiling the device driver
2. Compiling libraries and sample program
3. Installing the device driver '(need to be a superuser)'
4. Configuring the internal FPGAs
0. Exit
enter menu number '(1-4, or 0)':

Select items 1-4 in turn, and follow instructions.

You need to be a superuser to execute step 3.  And, you need to
execute step 3 and 4 every time after rebooting your computer.

After the instruction (step 2) the software library are created in

g6apkg/lib/libg6a.a 
g6apkg/lib/libg65.a 

and the header files are in 

g6apkg/include/grape6.h
g6apkg/include/gp5util.h

respectively.

2) Test programs

Goto g6apkg/test and start the test script by

> csh -f test.csh

In this script, a test using the sample program "s8", where the N-body
system is integrated with individual (blocked) timestep algorithm, is
executed. The sample output for Redhat 9.0 (gcc 3.22 + kernel
2.4.20-8) is g6apkg/test/log.rh90.sample.  The sample output for
Fedora Core 2 (x86_64, gcc 3.33 + kernel 2.6.5-1) is
g6apkg/test/log.fc2.sample.  If all operate normally, the test script
should output exactly the same log except for timing result.

There is also long version of the test script.
Goto g6apkg/test and start the test script by

> csh -f test_long.csh

In this script, tests using the sample program "s8", "s9", where the
N-body system is integrated with shared timestep algorithm, with
different number of particle and with checking neighbor list ("s9nb")
are executed.  The test script will output g6apkg/test/log.{s8.1k,
s8.64k, s9.1k, s9.64k, s9nb}.sample. The sample output for Redhat
9.0(gcc 3.22 + kernel 2.4.20-8) and Fedora Core 2 (x86_64, gcc 3.33 +
kernel 2.6.5-1) are also in g6apkg/test .

3) Software Guide

Software Guide is g6apkg/doc/g6auser.{tex,pdf}





