Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 874

News	FAQ
Search	Home

Getting Started

The first step to installing the AIPS++ external developer's release is to install the required software upon which AIPS++ depends. This includes CVSup, RPFITS, CFITSIO, and PGPLOT. AIPS++ distributes RPMs RPMs built upon various releases of RedHat Linux which greatly simplify the installation of these packages for Linux systems which use RPM. The RPMs are built for specific RedHat releases and must be installed as root. If you're using RPM, you need to install:

• cvsup-16.1e-2ds.i386.rpm
• rpfits-2.4-1ds.i386.rpm
• cfitsio-2.401-1ds.i386.rpm
• pgplot-5.2.0-9ds.i386.rpm
• pgplot-devel-5.2.0-9ds.i386.rpm
• pgplot-motif-5.2.0-9ds.i386.rpm

In addition to these, you need to ensure that a few packages which are normally part of a Linux installation are installed:

• GNU make
• either Open MOTIF or LessTif (or just about any other Motif you might have installed)
• LAPACK and BLAS
• all of the standard header files, e.g. glibc-devel
• all of the X11 header files, e.g. XFree86-devel
• tcl and tk
• bison and flex

A good way to check is to do something like:

    rpm -qa | egrep '^openmotif|^lesstif|^make|^glibc|^XFree|^lapack|^blas|^tcl|^tk|^bison|^flex'

If the output of this seems to list all requirements, then you are in good shape.

Finally, you need to have the gcc 2.95 variety of GNU gcc compiler installed. This is necessary because we have found precision problems with g77 in the 2.96 release, and we do not yet support the 3.1 release. To simplify this, RPMs for gcc-2.95.3 are also available from the AIPS++ ftp site. You need:

• gcc+2-2.95.3-52ds.i386.rpm
• gpp+2-2.95.3-52ds.i386.rpm
• libgpp+2-2.95.3-52ds.i386.rpm
• gppshare+2-2.95.3-52ds.i386.rpm
• g77+2-2.95.3-52ds.i386.rpm

These RPMs install into /usr/gcc/2.95.3, e.g. /usr/gcc/2.95.3/bin/gcc, and currently they are not relocatable. Otherwise, you can get gcc 2.95 from the GNU ftp site and install it by hand.

The next step is to select a directory where you would like your AIPS++ installation to reside. For the examples in this section, /usr/local/aips++ will be used; if you choose a differnt location, just substitute your path for /usr/local/aips++. So first create the directory for the initial CVSup bootstrap file, for example:

    bash$ mkdir -p /usr/local/aips++/sup/files

With an editor, create a file in this directory named for the architecture being installed, e.g. /usr/local/aips++/sup/files/linux. In this file, put:

    bootstrap release=linux host=aips2.nrao.edu base=/usr/local/aips++

If you chose a root directory other than /usr/local/aips++ for your installation, you should substitute your directory in the line above. This file specifies which set of bootstrap files should be fetched.

The next step is to use the bootstrap specification file you just created to fetch the bootstrap files:

    bash$ cd /usr/local/aips++
    bash$ cvsup sup/files/linux &

A GUI should pop up, when it does you should only need to press the go button, i.e. the button with the little green triangle beside the exit button. This will fetch all of the AIPS++ bootstrap files for the given architecture..

The next step is to run the bootstrap setup script. This script not only takes care of configuration details, but it also fetches the AIPS++ source code:

    bash$ cd /usr/local/aips++
    bash$ linux/setup

This script will first verify the AIPS++ root directory, and then it will commence with downloading the source code. This may take some time, so patience, as well as bandwidth, is required. After the initial installation of the source code, however, subsequent updates should only download source code modifications, not all of the source code.

Lastly, all you need to do is build AIPS++:

    bash$ cd /usr/local/aips++/code
    bash$ gmake allsys