Install Guide for GRAPE-6 library and test programs (C) May 19 2001 Jun Makino All rights reserved Version 0.1 September 24 2001 Jun Makino Version 0.2 Jan 4 2002 Jun Makino 0. Overview In this document, I'll describe how to install library files for GRAPE-6, and how to run test programs. At present, Alpha (DU 4.0x and Linux kernel 2.2.x) and x86 (Linux kernel 2.2.x and 2.4.x) are supported. 1) Installing library First, download the newest version from http://grape.astron.s.u-tokyo.ac.jp/pub/people/makino/softwares/GRAPE6/ (select "Current Library") You will get g6libs.tar.gz. untar it by > tar xvzf g6libs.tar.gz at the directory where you want to place the source files. The following subdirectories will be created: g6hib/ g6hibddx86/ grape6-x86/ phibdd/ simple-grape/ g6hib-x86/ grape6/ grape6board/ pit/ In newest versions, there may be some more... Goto g6hib by > cd g6hib 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 applications. 3. Installing the device driver (need to be a superuser) 4. Testing the basic device driver functions and the PCI card. 5. Testing the libraries and sample applications enter menu number (1-5, or 0 to exit): Select items 1-5 in turn, and follow instructions. Note that you need to be a superuser to execute step 3. In step 3, you are asked, beside others, two rather obscure questions: Which clocking scheme do you use?(0,1) 0: board EPROM before DEC 2001 1: board EPROM after DEC 2001 Which PCI card version do you use?(0,1) 0: card EPROM before DEC 2001 1: card EPROM after DEC 2001 This is to configure the software to match the version of EPROMs on processor board and PCI interface card. If you got your GRAPE-6 after Feb 2002, you are likely to have the new EPROMs. If not, Hamamatsu metrix will be sending (or should have sent) the DEC 2001 version to you with instructions for replacement. If you have installed it, please answer 1. If not, 0 should be supplied. 2) Test programs Basic tests are performed in step 5 of the install script. Problem with these tests are that depending on the vesion of the gcc, the result could be different from what is assumed, in particular for long tests. If you need more detailed diagnostics, you can use g6cbtest or g6ptest located (you might need to make them) in directory g6hib(-x86) g6cbtest is the most basic test program to check the PCI interface card. To use this program, you need to connect the IP port and FO port of the PCI card (see hardware installation guide, g6hib/g6hard.tex [Maybe not ready yet. You should also consult the document provided by HAMAMATSU METRIX] for details) using straight cable. After you did so, you can simply type g6cbtest with no additional argument. g6ptest calculates the force between two particles and compare the result with that of software GRAPE-6 simulator. 3) User Guide User Guide is g6hib/g6user.tex Good luck!