NRAO
 
 

Astronomical Image Processing System
Running the CD setup and install wizards CDSETUP and install.pl

[AIPS]

Table of Contents


Preliminaries

AIPS is available in both a development (see latest) version and a frozen version. The latter, being unchanging, is made available on CDrom for some operating systems, currently Linux, Solaris, and Mac OS/X. This document will assume that you have:

  • Downloaded the latest version of the Install Wizard (install.pl). You may also use the one on the CDrom.
  • Downloaded the latest version of the CD set-up procedure (CDSETUP). You may also use the one on the CDrom.
  • Placed the downloaded install.pl and CDSETUP in what will be your AIPS_ROOT area and made both files executable (chmod +x). Then cd to that area.
  • Moved any old $HOME/.AIPSRC to a new name for reference. An old file may confuse the new installation.
  • Alternatively, you may edit the old $HOME/.AIPSRC for use by the new installation. Delete the lines showing DOWNLOADED and UNPACKED and correct the CCOMOPT line to refer to the new version rather than the old one.

You should also make sure you have perl installed (it is, in /usr/bin on Linux systems) as that is a pre-requisite of running the wizards. Be sure that perl is in your path.

[Top of Page]


Running the CDSETUP script

CDSETUP is a Bourne-shell script that introduces itself, asks some questions, and then creates an AIPS installation on your computer. It creates the AIPS directory structure on your computer's hard drive and then loads some or all of AIPS onto that disk. If you chose the "some" option, it creates links from the hard drive to the CDrom device rather than copying the files. After these steps, CDSETUP invokes portions of the Installation wizard to configure your particular AIPS installation. See the A Guide to the Install Wizard instructions on its use.

To run the installation scripts, change directory (cd) to the directory that you want to use as AIPS_ROOT. Then type:

bash$ ./CDSETUP

[Top of Page]


Introduction

Before it does anything, the script describes itself and asks a crucial question:

                         AIPS CD-rom Setup
                         =================

This script will get you started in your installation of AIPS
from CDrom (or other read-only random access media) to hard disk.
There are three operations supported:

  1.  Run from CDrom; this leaves the binaries on the CDrom, and
      only installs a minimal footprint on your hard disk.  This
      may incur a penalty in speed, and you need the CD mounted
      to run AIPS.

  2.  Full install; this copies more or less everything to your
      hard disk.  You may need 500 or more Megabytes of free space
      but will not have the speed penalty and do not need the CD
      mounted in order to run AIPS.

  3.  Alter an existing system from partial to full.

  4.  Alter an existing system from full to partial.

Which option do you want? (999 to quit)

It will continue to prompt you and repeat the question until you enter one of 1, 2, 3, 4, or 999. As described above, option 1 is for a new installation (of this version of AIPS) in which the text and executables will be kept as much as possible on the CDrom itself. This has the advantage of using a minimum amount of space on your hard drive, but will be slower in execution. Option 2 is also for a new installation, but it will copy all of the text and executables to your hard drive. This will occupy about 0.5 Gbytes of disk and will run rather faster than the first option. Option 3 is to convert an existing AIPS installation done with option 1 into one done with option 2. Option 4 is to convert an existing AIPS installation done with option 2 to one done with option 1.

[Top of Page]


More questions: locating things

The script now needs to locate the CDrom device and AIPS_ROOT. It asks:

Where is the AIPS CDrom mounted? (/mnt/cdrom):

A local (write-enabled) AIPS_ROOT is needed; this is where your
AIPS installation will be placed.  You need about 500 Megabytes
free for a full install of a SINGLE architecture (add 350 for each
additional), and about 10 Megabytes if running from CDrom.

Where do you want AIPS? (some_dir_name):

The first question asks for the location of the CDrom and gives a default value. The script sets the CDrom location and determines which version of AIPS is to be found there. It dies if it does not find one. The next question asks where you want to put the AIPS tree (or for an installation upgrade, where you put the pre-existing installation) with a default shown in parentheses. If the current directory is the CDrom, then there is no default. If the specified AIPS_ROOT directory does not exist, the script will ask you if you want to create it. An answer to this question, other than Y or y, will cause the script to quit.

[Top of Page]


Disk space

The script then worries about disk space and attempts to determine how much will be needed. Typical messages for a type 2 installation could be:

This CDrom has binaries for the following architectures:

LINUX: uses 222580 Kbytes for binaries and libraries
The FITS area on the CDrom takes up 65968 Kbytes
The TEXT area on the CDrom takes up 75268 Kbytes
Total space used on CDrom: 447680 Kbytes
Base space (no binaries): 84764 Kbytes

(Add the base space to whatever binaries you plan on installing
to get the amount of space you need)

Space free on your hard drive: 7601332 Kbytes

There appears to be enough space free under the 
$AIPS_ROOT.

If there appears to be more limited space, the script may ask for permission to proceed with some worrying messages. Tell it to continue unless you have so little disk that you should not be doing this at all. (Remember, AIPS data typically uses way more disk than is needed for AIPS itself.)

[Top of Page]


Doing the work

If you are doing or moving to a full installation, you should see messages like:

Copying TEXT area from CDrom (75268 Kbytes)...
Done

Creating temp symlink to BIN area on CDrom...
Creating symlink in DA00 to LINUX area on CDrom...
Copying SYSTEM/UNIX files...
...done.
Copying 31DEC04/AIPS/...
... done.
Copying 31DEC04/APL/...
... done.
Copying 31DEC04/DOC/...
... done.
Copying 31DEC04/HELP/...
... done.
Copying 31DEC04/HIST/...
... done.
Copying 31DEC04/INC/...
... done.
Copying 31DEC04/Q/...
... done.
Copying 31DEC04/QY/...
... done.
Copying 31DEC04/RUN/...
... done.
Copying 31DEC04/UPDATE/...
... done.
Copying 31DEC04/Y/...
... done.

If you are doing or moving to a minimal installation, you should see messages like:

Creating symlink to TEXT area on CDrom...
Creating temp symlink to BIN area on CDrom...
Creating symlink in DA00 to LINUX area on CDrom...
Copying SYSTEM/UNIX files...
...done.
Making symbolic links to areas that are rarely needed, and
unnecessary for running AIPS.  These include:

   31DEC04/DOC  31DEC04/AIPS  31DEC04/APL  31DEC04/HIST
   31DEC04/Q    31DEC04/QY    31DEC04/UPDATE

These will now only be accessible when the CDrom is mounted.

Then you will be asked about architectures. If you are doing or moving to a full installation, you should see messages like:

Now to copy the LOAD and other areas to your hard disk.
Install binaries for LINUX? (y) 
Installing LIBR area for LINUX...
Installing LOAD area for LINUX...(this will take a while)
Done with architecture LINUX

If you are doing or moving to a minimal installation, you should see messages like:

Now to make symlinks to the LOAD and other areas, and copy
essential files only.
Install pointers to binaries on CDrom for LINUX? (y) 

Finally, it is time to invoke install.pl, the instructions for which may be found in A Guide to the Install Wizard.

You may choose to run the install wizard at this time.
You can either use the CD version of the wizard,
or you can check our web: http://www.aips.nrao.edu/
to see if we have any fixes to install.pl.
Enter YES if you want to stop now and check for fixes,
Or enter NO to use the CD version (or local disk copy in AIPS_ROOT)
Stop now (y)? 

There is already an install.pl in AIPS_ROOT, using it.
About to run perl on install.pl; this will clear the
screen and start the menu-based wizard.  Press ENTER: 

[Top of Page]


Modified on $Date: 2007/10/29 20:39:52 $
[Eric W. Greisen]