Context Navigation

GIPSY
Installation

GIPSY

GIPSY is an acronym of Groningen Image Processing SYstem. It is a highly interactive software system for the reduction and display of astronomical data. Information can be found here

Installation

created a user gipsy/gipsy:
gipsy@metis:~$ tar xzvf gipsy_src.taz

cdelacruz@metis:/usr/local/gipsy$ gip_root=$PWD
cdelacruz@metis:/usr/local/gipsy$ export gip_root

cdelacruz@metis:/usr/local/gipsy/sys$ ./mkclient.csh 103 (used 79 on this test setup)
Creating /usr/local/gipsy/loc

cdelacruz@metis:/usr/local/gipsy/sys$ .$gip_sys/gipenv.sh
cdelacruz@metis:/usr/local/gipsy/sys$ mv clients.new $gip_root/loc/clients

cdelacruz@metis:/usr/local/gipsy/sys$csh 
metis:~/sys> source gipenv.csh

Compiler setup:

metis:~/sys> cd $gip_loc
metis:~/sys> cp $gip_sys/setup.mgr setup

Edited the setup file (/home/gipsy/loc/setup);
deleted all the lines except for:

#
#
# OS: 2.6.9-1.648_ELsmp (Distribution Red Hat Enterprise, x86_64)
# CC: gcc 3.4.2
#
#

io:/opt/gipsy/4.0/sys> ./install.csh
INSTALL  Version 3.6
Checking for essential utilities ...
/opt/gipsy/4.0/exe/linux created!
/opt/gipsy/4.0/lib/linux created!
/opt/gipsy/4.0/tmp/linux created!
...
ln -s /opt/gipsy/4.0/dat /opt/gipsy/4.0/htm/dat
ln -s /opt/gipsy/4.0/doc /opt/gipsy/4.0/htm/doc
ln -s /opt/gipsy/4.0/exe /opt/gipsy/4.0/htm/exe
ln -s /opt/gipsy/4.0/htm /opt/gipsy/4.0/htm/htm
ln -s /opt/gipsy/4.0/inc /opt/gipsy/4.0/htm/inc
ln -s /opt/gipsy/4.0/lib /opt/gipsy/4.0/htm/lib
ln -s /opt/gipsy/4.0/loc /opt/gipsy/4.0/htm/loc
ln -s /opt/gipsy/4.0/mis /opt/gipsy/4.0/htm/mis
ln -s /opt/gipsy/4.0/old /opt/gipsy/4.0/htm/old
ln -s /opt/gipsy/4.0/sub /opt/gipsy/4.0/htm/sub
ln -s /opt/gipsy/4.0/sys /opt/gipsy/4.0/htm/sys
ln -s /opt/gipsy/4.0/tmp /opt/gipsy/4.0/htm/tmp
ln -s /opt/gipsy/4.0/tsk /opt/gipsy/4.0/htm/tsk
--  Using local setup  --
cd /opt/gipsy/4.0/tmp/linux
Installing compile ...
cp /opt/gipsy/4.0/tsk/compile.c .
g77 -D_BSD_SOURCE -Dntohl=ntohl -D__g77__=2 -I. -I/opt/gipsy/4.0/inc -I- -I/usr/include -ansi -pedantic -m32 -w -o compile compile.c /opt/gipsy/4.0/sub/xclib.c /opt/gipsy/4.0/sub/gip_lock.c -m32 -lm
cp compile /opt/gipsy/4.0/exe/linux/compile
Installing f2cvv ...
cp /opt/gipsy/4.0/tsk/f2cvv.c .
g77 -D_BSD_SOURCE -Dntohl=ntohl -D__g77__=2 -I. -I/opt/gipsy/4.0/inc -I- -I/usr/include -ansi -pedantic -m32 -w -o f2cvv f2cvv.c /opt/gipsy/4.0/sub/xclib.c -m32 -lm
f2cvv f2cvvdefs.h
f2cvv: Command not found.
cp f2cvvdefs.h /opt/gipsy/4.0/inc/f2cvvdefs.h
cp: cannot stat `f2cvvdefs.h': No such file or directory
cp f2cvv /opt/gipsy/4.0/exe/linux/f2cvv
Installing xfile ...
cp /opt/gipsy/4.0/tsk/xfile.c .
g77 -D_BSD_SOURCE -Dntohl=ntohl -D__g77__=2 -I. -I/opt/gipsy/4.0/inc -I- -I/usr/include -ansi -pedantic -m32 -w -o xfile xfile.c /opt/gipsy/4.0/sub/xclib.c -m32 -lm
cp xfile /opt/gipsy/4.0/exe/linux/xfile
Installing lckserver ...
cp /opt/gipsy/4.0/tsk/lckserver.c .
g77 -D_BSD_SOURCE -Dntohl=ntohl -D__g77__=2 -I. -I/opt/gipsy/4.0/inc -I- -I/usr/include -ansi -pedantic -m32 -w -o lckserver lckserver.c /opt/gipsy/4.0/sub/xclib.c -m32 -lm
cp lckserver /opt/gipsy/4.0/exe/linux/lckserver
Installing gftp ...
cp /opt/gipsy/4.0/tsk/gftp.c .
g77 -D_BSD_SOURCE -Dntohl=ntohl -D__g77__=2 -I. -I/opt/gipsy/4.0/inc -I- -I/usr/include -ansi -pedantic -m32 -w -o gftp gftp.c /opt/gipsy/4.0/sub/xclib.c -m32 -lm
cp gftp /opt/gipsy/4.0/exe/linux/gftp
gftp: io registered as GIPSY client #125
Installing sheltran ...
cp /opt/gipsy/4.0/sub/xflib.c .
/opt/gipsy/4.0/exe/linux/f2cvv xflib.c
exitf.h
iandf.h
iorf.h
g77 -c -D_BSD_SOURCE -Dntohl=ntohl -D__g77__=2 -I. -I/opt/gipsy/4.0/inc -I- -I/usr/include -ansi -pedantic -m32 -w xflib.c xflib_ftoc.c
cp /opt/gipsy/4.0/tsk/sheltran.src .
/opt/gipsy/4.0/exe/linux/xfile sheltran.src
sheltran.doc
sheltran.tex
sheltran.f
g77 -o sheltran sheltran.f xflib.o xflib_ftoc.o -ansi -fno-backslash -fno-f2c -m32 -w -lm
f771: warning: command line option "-ansi" is valid for C/C++/ObjC/ObjC++ but not for F77
cp sheltran /opt/gipsy/4.0/exe/linux/sheltran
Installing pgplot fonts ...
cp /opt/gipsy/4.0/sys/pgpack.f .
cp /opt/gipsy/4.0/sys/grfont.txt .
g77 -o pgpack pgpack.f -ansi -fno-backslash -fno-f2c -m32 -w -lm
f771: warning: command line option "-ansi" is valid for C/C++/ObjC/ObjC++ but not for F77
pgpack
 Characters defined:   996
 Array cells used:   26732
cp grfont.dat /opt/gipsy/4.0/lib/linux/grfont.dat
Checking for X11 compiler options ...
... will use for X11 compiler options : -I/usr/X11R6/include -I/usr/X11R6/include/X11
Checking for X11 linker options ...
... will use for X11 linker options   : -L/usr/lib -lpthread -L/usr/X11R6/lib/ -lX11
Checking the X-Toolkit linker options ...
... will use for X-Toolkit options    : -L/usr/X11R6/lib -lXaw -lXmu -lXt -lXext -lSM -lICE -lX11 -lpthread
INSTALL finished!


Building the sources (GIPSY library and the GIPSY applications):

metis:~/sys> ./mkbookkeeper.csh
bookkeeper.new created
metis:~/sys> mv bookkeeper.new bookkeeper

metis:~/sys> p -update > & p.log &
[1] 25726

metis:~/sys> tail p.log
compile -- running in Master Mode!
compile -- Waiting for lock to be removed by gipsy!

Note that when you kill 'p' there might be some lock 
files which will not allow 'p' to be restarted. 
To remove the lock files type:

metis:~/sys> rm -f $gip_sys/.*lock $gip_sys/*.lock $gip_tmp/update.lock

metis:~/sys> tail p.log
rm /home/gipsy/tmp/linux/irzc_intsky.o
rm /home/gipsy/tmp/linux/irzc_intsky.f
rm /home/gipsy/tmp/linux/irzc_detmodel.o
rm /home/gipsy/tmp/linux/irzc_detmodel.f
rm /home/gipsy/tmp/linux/irzc_data.o
rm /home/gipsy/tmp/linux/irzc_data.f
rm /home/gipsy/tmp/linux/irzc_subzem.o
rm /home/gipsy/tmp/linux/irzc_subzem.f
rm /home/gipsy/tmp/linux/zodycal.src
compile -- Ready with zodycal.src!

A look into the installation p.log file reveals
no installation errors:

io:/opt/gipsy/4.0/sys> grep -i error p.log
cp /opt/gipsy/4.0/sub/errorf.c /opt/gipsy/4.0/tmp/linux/errorf.c
/opt/gipsy/4.0/exe/linux/f2cvv errorf.c > f2cvv.out
/opt/gipsy/4.0/exe/linux/xfile errorf.c > xfile.out
g77 -c -D_BSD_SOURCE -Dntohl=ntohl -D__g77__=2 -I. -I$gip_inc -I- -I/usr/include -ansi -pedantic -m32 -w errorf.c
nm errorf.o > nm.dum
ar cq giplib.a errorf.o
rm /opt/gipsy/4.0/tmp/linux/errorf.dc2
rm /opt/gipsy/4.0/tmp/linux/errorf.o
rm /opt/gipsy/4.0/tmp/linux/errorf.c
rm /opt/gipsy/4.0/tmp/linux/gdi_error.h
rm /opt/gipsy/4.0/tmp/linux/gdi_error.dc2
cp /opt/gipsy/4.0/sub/gds___error.c /opt/gipsy/4.0/tmp/linux/gds___error.c
/opt/gipsy/4.0/exe/linux/f2cvv gds___error.c > f2cvv.out
/opt/gipsy/4.0/exe/linux/xfile gds___error.c > xfile.out
g77 -c -D_BSD_SOURCE -Dntohl=ntohl -D__g77__=2 -I. -I$gip_inc -I- -I/usr/include -ansi -pedantic -m32 -w gds___error_ftoc.c
mv -f gds___error_ftoc.o ar1148397828.o
g77 -c -D_BSD_SOURCE -Dntohl=ntohl -D__g77__=2 -I. -I$gip_inc -I- -I/usr/include -ansi -pedantic -m32 -w gds___error.c
nm gds___error.o > nm.dum
ar cq giplib.a gds___error.o
rm /opt/gipsy/4.0/tmp/linux/gds___error_ftoc.c
rm /opt/gipsy/4.0/tmp/linux/gds___error.h
rm /opt/gipsy/4.0/tmp/linux/gds___error.dc3
rm /opt/gipsy/4.0/tmp/linux/gds___error.o
rm /opt/gipsy/4.0/tmp/linux/gds___error.c
rm /opt/gipsy/4.0/tmp/linux/error.h
rm /opt/gipsy/4.0/tmp/linux/error.dc2
io:/opt/gipsy/4.0/sys>

Initialize the environment:

Each user who wants to use gipsy has to put the following 
lines into his or her .cshrc file:

        setenv gip_root <PATH_TO_GIPSY_ROOT_DIRECTORY>
        source $gip_root/sys/gipenv.csh

Also inspect cshrc.csh to find out whether your system needs some special setings. 
If so, incorporate them into your .cshrc.

For bash users:

       ### Gipsy Environment ###
       gip_root=/usr/local/gipsy
       export gip_root
       . $gip_root/sys/gipenv.sh

Optional) Post Installation: GIPSY's Python binding
GIPSY's Python binding enables you to run tasks written in the Python language.
This software is a work in progress which has only been tested on Red Hat Linux versions 7.2, 9.0
and Enterprise. Currently the Xaw3d widget library must be available; the standard Xaw
library is not sufficient. To install the software, perform the following steps:

1. Obtain pygipsy-0.3.tar with your browser or use anonymous ftp:

cd $gip_root
ftp ftp.astro.rug.nl
Name: anonymous
Password: your e-mail address
ftp> cd gipsy
ftp> binary
ftp> get pygipsy-0.3.tar
ftp> quit

2. Unpack the archive:

tar xvf pygipsy-0.3.tar

3. Go to the installation directory and check the README file:

cd pygipsy-0.3
less README

4. Run the installation script:

./install.csh

5. When everything is OK, the installation directory contents and pygipsy-0.3.tar can be deleted:

cd ..
rm -rf pygipsy-0.3
rm pygipsy-0.3.tar

(Optional) Post Installation: GIPSY html documentation
GIPSY documentation is found on the home page of the
Groningen Image Processing SYstem. This documentation can also be installed on
your local system. The file GIPSY_HTML.tar.gz contains GIPSY's html documentation.
To install it on your system, do the following:

1. Check whether $gip_htm is defined. If not, (e.g. you want to install the
documentation on an older, existing, GIPSY installation), your GIPSY version is
too old and you should get an update.
2. Check whether the directory $gip_root/htm exists. If not, change directory
to $gip_sys and run the install script:

cd $gip_sys
./install.csh

This should create the directory. Then (for the second time) type:

./install.csh

This creates some necessary links.
3. Obtain GIPSY_HTML.tar.gz with your browser or use anonymous ftp:

cd $gip_root
ftp ftp.astro.rug.nl
Name: anonymous
Password: your e-mail address
ftp> cd gipsy
ftp> binary
ftp> get GIPSY_HTML.tar.gz
ftp> quit

4. Unpack the html documentation archive in directory $gip_htm:

cd $gip_root/htm
gunzip < ../GIPSY_HTML.tar.gz | tar xvf -

Now GIPSY should be able to access the local html documentation.
The message "... Access via Internet" when starting a Web browser from Hermes
(ESC-X) should not appear anymore.
5. When everyting is OK, GIPSY_HTML.tar.gz can be deleted:

rm $gip_root/GIPSY_HTML.tar.gz

The html documentation is not yet automatically updated. To get the latest version,
repeat steps 3 through 5. The file GIPSY_HTML.tar.gz on our server is currently refreshed daily.

Post installation: Regular updates
If you want regular updates of modifications to GIPSY sources or new GIPSY applications,
and you can compile GIPSY sources, you must do the following:

Turn on the gftp bit in the $gip_loc/clients file. (Just add 128 to the number supplied
to mkclient.csh. E.g. 71 becomes 199 and 103 becomes 231.)

With $gip_sys/atqueue.csh you can queue the update job to run at a specified time and
update the gipsy sources. Preferably this is done once a week. You can also use cron for
regular updates. A cron command which updates every tuesday would look like:

0 22 * * 2 /bin/csh /zia/u/gipsy/gipsy/sys/update.csh

Post Installation: Troubleshooting
You may run into problems installing, running or compiling GIPSY. Here are some things
to check first before contacting the GIPSY group in Groningen.

1. Check whether you have the correct version of the operating system and the
compilers mentioned above. You may have to make small modifications to $gip_loc/setup
to enable correct compiling.
2. Check whether you have initialized the gipsy environment in your .cshrc file.
Each user must have the following statement in his/her .cshrc file:

setenv gip_root
source $gip_root/sys/gipenv.csh

Also inspect $gip_sys/cshrc.csh for any other system specific settings.
3. Then check whether you have made the necessary modifications to the setup files.
4. Check whether you have the lock daemon running on your system. If not,
ask your system manager to start it.
5. Check whether you can start a remote shell on all the machines you want to run
GIPSY (also if you have only one machine). If the remote shell does not want to run,
check your .rhosts file in your home directory.
6. When you are running olwm, you might have to modify the .Xdefaults file in
your HOME directory to enable keyboard focus on the GIDS window. Add the following
line: OpenWindows.FocusLenience: True
7. If you still have problems, you can contact the GIPSY manager at
Groningen: gipsy@astro.rug.nl.

Last modified 20 years ago Last modified on 05/23/06 17:07:18

Note: See TracWiki for help on using the wiki.

Download in other formats:

Plain Text