|
|
||
|
|
||
Table of Contents
PreliminariesWe assume that you have followed the instructions and retrieved the Latest version of AIPS (or the frozen, released version). This means you have:
You should also make sure you have perl installed (it is, in
Running the
|
Screen 0: INTRODUCTION
----------------------
Welcome to the AIPS Install Wizard (AipsWiz)!
It will do the following:
1. Look for (and/or download) the 'tarball' for 31DEC22
(skipped if installing from CD or network)
2. Unpack it wherever you specify (skipped if CD or network)
3. Ask you for various settings through a set of menus
4. Review your settings, and
5. Do the installation with no further input needed.
Things can go wrong (!) so this procedure is not perfect,
but it saves state in a file .AIPSRC in your home area.
So you can easily restart an interrupted install attempt,
without re-entering all your settings. You can also go
back a screen by typing 'B' to most prompts, or you
can Quit at any menu by entering 'Q'.
[You may also type B for back, or Q to Quit]
AipsWiz: ===> Press <ENTER> or <RETURN> to get started:
|
There's not much to do here besides make sure that you're in the right
directory, and you have the 31DEC22.tar.gz tarball (only
if doing a text installation) right here too. If you don't have the
tarball, the script will offer to get it for you; that's handled on
the next screen.
If you have run the wizard before from this account, and have let it unpack the tarball, you will get a different menu:
Screen 0: Re-Introduction
-------------------------
Welcome back to the AIPS Install Wizard (AipsWiz).
It would appear you've been here before.
If you REALLY want to start over, you may want to remove
the .AIPSRC file in this account's home directory.
Otherwise, you can skip forward to a specific screen by
entering its number at the prompt. The default action
is to simply start at screen 1. Screens are:
1. Optionally download 31DEC22 tarball (skipped if CD or network)
2. Confirm that tarball is correct (skipped if CD or network)
3. Choose AIPS_ROOT, optionally unpack tarball (skipped if CD or network)
4. Group ownership, group write enable/disable
5. Site name, Architecture
6. Additional hosts
7. Data area definition
8. Printer setup
9. Tape drives
10. Advanced settings
11. Final check before doing the install
[You may also type B for back, or Q to Quit]
AipsWiz: ===> Press |
So if you interrupted a previous install attempt at, say, the adding additional hosts step, you can go directly to that screen and continue as if nothing had happened.
Screen 1: DOWNLOAD
------------------
Found a 'tarball' /opt/aips/31DEC22.tar.gz
..................Dated 2022.01.24:05:22.42 (UT)
......... downloaded on 2022.01.24:18:34.24 (UT)
....... current time is 2022.01.24:18:49.26 (UT)
You can:
(G) Get a newer copy from NRAO's ftp site,
(the file is generated nightly)
(S) Skip the download and use the existing tarball, or
(Q) Quit now.
NOTE: if by some chance the automatic ftp fetch fails, you
may want to fetch it yourself by hand, from
ftp.aoc.nrao.edu/pub/software/aips/31DEC22/31DEC22.tar.gz
[You may also type B for back, or Q to Quit]
AipsWiz: ===> What do you want to do? [default S]
|
What goes on behind the scenes here is some exploration: looking for
the "tarball", and checking the .AIPSRC file for when it
thinks this was downloaded (note: if the wizard finds the tarball but does
not download it itself, it applies the "now" date to the "downloaded"
time).
Most of the time you will simply want to use the
Skip option; it's usually only worth getting
a new tarball if the one you have is more than a month or two out of
date. Let's assume that you've skipped ahead.
Screen 2: Confirmation
----------------------
Proceeding with 31DEC22 install/upgrade. Please check:
-rw-r--r-- 1 aipsmgr aipspgmr 134719348 Jan 24 00:22 /opt/aips/31DEC22.tar.gz
that this is the file you want (should be >175 Mbytes)
[You may also type B for back, or Q to Quit]
AipsWiz: ===> Proceed [Y/N, default Y]
|
As you can see, this is just a confirmation step that gives you yet another chance to bail out if necessary. Let's assume you proceed.
Screen 3: Where to unpack
-------------------------
Please tell me where to unpack the 31DEC22 version of AIPS
No blanks are allowed in the path name
(This is the so-called AIPS_ROOT area).
The default is /home/aips/AIPS
[You may also type B for back, or Q to Quit]
AipsWiz: ===> AIPS Root area: /opt/aips
|
NOTE WELL: This screen will set where you want the
AIPS_ROOT area to be. It defaults to the current
directory. The example above shows the user entering (in red) the desired area.
You may want to remove any existing TEXT area in the
specified directory before proceeding. Once you enter the
AIPS_ROOT value, the wizard proceeds to unpack the tarball
with this dialog:
AipsWiz: Unpacking the 'tarball' /home/myname/tmp/31DEC22.tar.gz
AipsWiz: in the /opt/aips directory
AipsWiz: This may generate some errors if you are overwriting, but
AipsWiz: these ('Cannot unlink: directory not empty') are benign.
AipsWiz: (printing a dot every 100 files for your amusement...
..........................................................
AipsWiz: Unpacking apparently worked (total of 5769 files)
AipsWiz: ==> Press |
The "dot printing" will not be at a uniform speed, as of course the
size of each chunk of 100 files will vary. It will be slow near the end
as the TEXT area has some very large files therein. If you
have an existing TEXT area, you'll likely get the "Cannot unlink"
error mentioned in the menu. On Macs, the test for successful unpacking
tends to fail. Exit install.pl and start it up again and all should be
good.
Screen 4: Group Ownership
-------------------------
If more than one account is going to be using AIPS, you should
select a 'Unix group' for these accounts. This can,
but need not be, their primary group.
[You may also type B for back, or Q to Quit]
AipsWiz: ===> What group should be used for AIPS? [aipspgmr]
|
It's important that you set your AIPS site up so that everyone who needs access to it can use it. As read/write privilege is required on some (but not all) of the system files, you need to decide now which mode of operation you are going to use:
Here "you" refers to the account you're using to install AIPS. So the
first thing to decide is whether you want to allow others to run your AIPS
installation, and if so, you should have your systems administrator set up
a Unix group for them. Here at NRAO we call this group
aipsuser, but you can call it anything you want. Whatever
name you choose, you should enter here. If you do not plan on allowing
others access to your AIPS environment, just press
<ENTER>.
This menu is halfway smart: if you enter "foobar", it will
check if "foobar" is one of the groups that you are in (Unix
users have one primary group and can be in many secondary groups as
specified in /etc/group or the NIS or LDAP group map). If
you enter a bad group, it will show you a list of valid groups, pause for
a few seconds, then repaint the menu and ask again for a group name.
Note that the default shown ([aipspgmr]) is the primary group of the
account installing AIPS.
Once you enter a valid group, a second menu appears:
Screen 4b: Group Write
----------------------
If more than one account will use AIPS, and you are using
a group (aipsuser) to permit filesharing, you should also allow
this group write access to certain AIPS files.
[You may also type B for back, or Q to Quit]
AipsWiz: ===> Allow aipsuser to have write access? [YES]
|
Don't panic if you get here and realize you meant to specify a
different group. The wizard does nothing (other than unpack the
tarball) with your new AIPS installation until after screen 12, so you can
easily go back, interrupt, restart, etc. until you are happy with
the settings. So if you got the group wrong, just type Back
now and you'll be at Screen 4 again (not 4b).
Othewise, just enter Yes or No, depending on your needs, and proceed.
Screen 5: Site Name
-------------------
Please enter a single word to describe your AIPS site.
This may be used as a directory name. Do NOT use names which contain
NRAO or OARN - these have special meaning. Examples
MYSITE, CFALAPTOP, JOHN, MARY .
[You may also type B for back, or Q to Quit]
AipsWiz: ===> Your site name: [required, no default]
|
The "Site Name" is used by AIPS for several purposes, most of which are associated with allowing multiple computers to run AIPS from the same area on a shared (NFS) disk. All AIPS machines in a given "site" have to be the same endian flavor (byte order), so you can mix and match Intel/Linux, Intel/Solaris, Alpha/Linux, Alpha/OSF1, and Max/Intel systems in a single site as these are all little-endian architecture. Likewise you can mix and match Sparc/Solaris, HP-UX, SGI, IBM RS/6000, and Mac PPC systems in a single site as they are all big endian. But you cannot have both little and big endian systems in the same AIPS site.
It's really an advanced topic beyond the scope of this document, but
you can have different endian systems sharing the same
AIPS_ROOT area. The trick is to assign each group of endian
systems a different SITE name.
Anyway, you should enter a site name like ERICSITE
here. Choose a single word that best describes your installation.
Once you do this, the wizard will now try to figure out your
architecture by looking at various clues in its environment:
Screen 5a: Site type:
------------------------------------
****** READ CAREFULLY - HAS CHANGED ******
If your site consists of a single portable computer, especially
if it may get different names at different times,
it is best to force the name for AIPS to LOCALHOST.
[You may also type B for back, or Q to Quit]
AipsWiz: ===> If you do not want this, enter N or n [Y]
|
AIPS depends on the computer's name since it often runs in
environments with 10's of computers all sharing a single AIPS
installation. The name is used to find the architecture and site name
from HOSTS.LIST, to select the data areas to include from
DADEVS.LIST, and to find the control files for that
computer. Laptop computers often do not have a fixed name. Instead
they are assigned a dynamic name each time they are plugged in to the
local area network. In this case, it is better to have AIPS use a
a fixed name (LOCALHOST) for the computer rather than the changing
name (returned by uname -n). If you are installing AIPS
for use on a single computer which might have its name change, enter Y
or y at this point. The LOGIN.SH and
LOGIN.CSH files will be changed to reflect this choice
and the computer and its data areas will be found under the name
LOCALHOST. Note that recent versions of install.pl make
LOCALHOST the default and you have to type N or n to avoid this.
Screen 5b: Architecture Confirmation
------------------------------------
Your architecture appears to be LINUX
If this is correct, press RETURN or ENTER.
If not, enter the correct architecture (or ? for a list)
[You may also type B for back, or Q to Quit]
AipsWiz: ===> Enter the architecture for this system [LINUX]
|
The script is pretty good about figuring this out, so you'll likely
just have to press <RETURN> here. If by some chance
you enter something silly like SOL for a Linux machine, this
will be stored in the .AIPSRC file and will come back to
haunt you later! The known architectures are: LINUX,
AXLINUX for Alpha Linux, ALPHA for Alpha OSF1
(Tru64) systems,SOL for older Suns, SUL for
Solaris on Sparc Ultras, SOL86 for Solaris on Intel,
HP for older HP systems running HP-UX, HP2 for
newer HP's, SGI for SGI systems running Irix, MACPPC for
MacIntosh computers with the PPC G3, G4, and G5 chips, MACINT for
MacIntosh computers with the Intel chips, and MACARM for MacIntosh
(Apple) computers with ARM chips.
Screen 6: Additional hosts if any
---------------------------------
You may configure your installation so it runs on many systems,
sharing the AIPS ROOT area via NFS. The list of host(s) is now:
ORANGUTAN
Any new hosts will initially be set to arch=LINUX, but you can
change this by editing HOSTS.LIST in /home/aips/tmp
when the install is finished.
[You may also type B for back, or Q to Quit]
AipsWiz: ===> Enter new hosts (no commas!) or ORANGUTAN to reset:
|
This menu is pretty simple. If you are only installing AIPS on a
single system, just press <RETURN> to continue to the
next screen, as there's nothing to do here. If you intend on allowing
several other hosts to your AIPS installation, you can pre-populate the
HOSTS.LIST configuration file (kept in your
AIPS_ROOT area) right here. Note that it may be easier
to edit $AIPS_ROOT/HOSTS.LIST later using your favorite
editor.
AIPS assumes that users will read and write data files stored on
"disks" and managed by "catalog" files. In reality, each "disk" is
simply a directory somewhere in the Unix file system hierarchy. These are
specified in two or maybe three configuration files, all of which are kept
in the $NET0 area (which is $AIPS_ROOT/DA00/).
The purpose of this menu is to provide an easier, faster way of setting
these files up.
Screen 7: User Data Areas
-------------------------
At least one data area needs to be defined for AIPS user data.
Do it here unless there is already a DADEVS.LIST file. It is
important that the host name in caps appear in the data area name.
Currently these area(s) are defined:
(no data areas have been defined yet)
You can add to this list after installing by editing the two files
DADEVS.LIST and NETSP in the /opt/aips/DA00/ directory.
Please enter (additional) data area(s) now as a space-separated list,
NOTE: THIS MEANS NO BLANKS IN THE PATH TO THE DATA AREA
or the word RESET to re-set the list.
(If you want to use symlinks, use the notation
actual_directory_location:symbolic_link_location
instead of a simple directory location.)
The suggested data area is /opt/aips/DATA/ORANGUTAN_1
which will be put in the list if you do not enter any others
[You may also type B for back, or Q to Quit]
AipsWiz: ===> Data Areas:
|
OK, there's a lot to digest here, mainly because the menu tries to be
both concise and flexible at the same time. Suppose you just wanted to
add one area, and you like the suggested value. You can simply press
<RETURN>. That's it; install.pl
will add its suggestion to the list..
When AIPS starts up it reads the DADEVS.LIST file to
decide which disk areas to include. It will include all
required areas and any area which has the current host name
(in capital letters) in the disk area name, e.g. /DATA/ORANGUTAN_1.
Normally, one only wants to include disk data areas local to the
current host. Required areas on another computer will slow everything
down quite remarkably. Note that the data area may be something like
$AIPS_ROOT/DATA/ORANGUTAN_1 on the server computer, so
long as that file is a link file to a real data area on orangutan
itself.
If you want to add more than one area, just enter all the areas on one
line separated by spaces. If you want to wipe out all the disks defined
and start over, just enter the magic string RESET and press
<RETURN>. Poof! The definitions are gone.
Finally, if you want to do something more sophisticated, such as
putting entries in the configuration files that refer to
$AIPS_ROOT/DATA/ and have symbolic links there pointing to
actual directories elsewhere, you can do that. Just enter a series of
areas separated by spaces, with each area actually being in the form
mentioned, with a colon (:) separating the actual location from the
symbolic link's name. This feature is pretty esoteric and probably few
people will want to use it.
AipsWiz: ===> Data Areas: /opt/aips/DATA/MINE_1 /tmp:/opt/aips/DATA/MINE_2 |
This example shows adding two data areas. The first is a simple
directory, while the second is a symbolic link pointing to
/tmp but that will appear to the AIPS user as
/opt/aips/DATA/MINE_2. We don't recommend using
/tmp to store AIPS data other than as a scratch disk; it's
just shown here as a nice concise example.
Remember that you can always edit the text files such as
$AIPS_ROOT/HOSTS.LIST, $NET0/DADEVS.LIST, $NET0/NETSP,
$NET0/PRDEVS.LIST etc. later in order to add more computers
running AIPS, more disk areas and printers, etc. You may find the old
Postscript installation guide of use in this
regard. In particular, it devotes some space to SYSETUP and other
tools used to install additional computers, disks, and the like.
One of the things you'll surely do in AIPS is generate printout. AIPS will allow you to define many printers, and the users refer to them by number. The available printers will be presented to the user as a menu when they start AIPS itself up, and it's up to you, the intrepid AIPS installer, to configure sensible AIPS names for these printers. This is fairly easy so don't panic.
This screen will do two things: first, get the printers and their types; and second, figure what size paper you'll be using.
Screen 8: Printers
------------------
You may define several printers for use with AIPS.
These will appear on startup as numbered choices to the user
At least one printer must be defined. Currently defined:
(no printers are defined yet)
You can modify printer definitions after the install by
editing the file /home/aips/tmp/DA00/PRDEVS.LIST .
Please indicate whether you want to
- add (N)ew printers
- (D)iscover your system's printers (may not work),
- (A)ccept the current settings as is, or
- (R)eset to clear the list.
(Paper format - A or A4 - will come next)
[You may also type B for back, or Q to Quit]
AipsWiz: ===> Your choice (default: Accept):
|
The "(D)iscovery" option is one you'll probably want to try. It's
actually pretty good about trying things, including looking at
printcap and lpstat information. It will balk
somewhat, however, if it finds more than 15 printers and revert to the
"(N)ew" mode instead.
Suppose we find that there are 34 printers available, and we only want to add three of them to the AIPS printer configuration. Here's what that session might look like:
AipsWiz: Configuring 3 printers. For each, you will be asked if you
AipsWiz: want to configure AIPS to use it, its type, options, and a
AipsWiz: description. AIPS printer types are:
AipsWiz: PS Black-and-white PostScript printer
AipsWiz: COLOR (or COLOUR) Color/Colour PostScript printer
AipsWiz: TEXT Plain text printers (including line printers)
AipsWiz: QMS QUIC format (QMS [not QMS PS!], Talaris) printers
AipsWiz: PREVIEW Screen Previewers, e.g. gv, ghostview, pageview
AipsWiz: And the valid AIPS printer options are:
AipsWiz: NONE (default), nothing special.
AipsWiz: DUP Printer will print on both sides of the paper
AipsWiz: DEF This will be the default AIPS printer
AipsWiz: BIG=nnn Force use of this printer for jobs > nnn lines
AipsWiz: If you want to specify multiple options for a printer,
AipsWiz: separate them with commas (NO SPACES!)
AipsWiz: ==> --Name ('xxx' in 'lpr -Pxxx') for printer 1: ps1
AipsWiz: ==> Printer type for ps1 (N to skip) [PS]:
AipsWiz: ==> Printer options for ps1 (N to skip) [NONE]: DUP
AipsWiz: ==> Description for ps1 (N to skip): Main printer (duplex)
AipsWiz: ==> --Name ('xxx' in 'lpr -Pxxx') for printer 2: ps2
AipsWiz: ==> Printer type for ps2 (N to skip) [PS]:
AipsWiz: ==> Printer options for ps2 (N to skip) [NONE]: DUP,DEF
AipsWiz: ==> Description for ps2(N to skip): 2nd floor printer
AipsWiz: ==> --Name ('xxx' in 'lpr -Pxxx') for printer 3: pscolor
AipsWiz: ==> Printer type for pscolor (N to skip) [PS]: COLOR
AipsWiz: ==> Printer options for pscolor (N to skip) [NONE]:
AipsWiz: ==> Description for pscolor (N to skip): Color printer
|
Right after entering your printer information, you will be asked:
AipsWiz: ==> Do your printer(s) use A or A4 paper? [A]: |
For reference, US "A" standard size paper is 8.5 by 11 inches, and the European and Australian standard "A4" size is about 8.25 x 11.75 inches.
If you use AIPS, you may still want it to read and write data to/from at least one type of tape drive. This is where you specify the details of the drives and set the device names (AIPS users refer to tapes by AIPS tape number). Note that most modern systems no longer support magnetic tape drives of any sort.
Screen 9: Tape Drives
---------------------
If your network has any tape drives you would like to use for AIPS,
you can specify those now. You need to configure each tape drive
machine to run AIPS (or a subset of it). Current definitions:
(no tape drives are defined yet)
You can add to this list after the install by editing TPDEVS.LIST
in the /home/aips/tmp/DA00 area.
Please indicate whether you want to
add (N)ew tape drive(s)
(D)iscover tape drives on ORANGUTAN (may not work)
(A)ccept the current settings as is, or
(R)eset to clear the list.
[You may also type B for back, or Q to Quit]
AipsWiz: ===> Your choice (default: Accept):
|
The "(D)iscovery" option is limited and for the most part will "sniff"
out SCSI tape drives on various platforms. On some (e.g., Linux)
it will find files in /dev/ if they have been configured,
even if you don't have any physical drive attached (or even a SCSI card).
For each one it finds, it asks you for a description of it, or you press
"N" to skip and not include it. Here's a typical dialog:
AipsWiz: ===> Your choice (default: Accept):D AipsWiz: Found SCSI tape drive /dev/nst0 AipsWiz: Found SCSI tape drive /dev/nst1 AipsWiz: Found SCSI tape drive /dev/nst2 AipsWiz: Found SCSI tape drive /dev/nst3 AipsWiz: Found SCSI tape drive /dev/nst4 AipsWiz: Found SCSI tape drive /dev/nst5 AipsWiz: Found SCSI tape drive /dev/nst6 AipsWiz: Found SCSI tape drive /dev/nst7 AipsWiz: Found 8 possible tape drives on this host AipsWiz: ==> Description for nst0 (or N to skip): 4mm DDS-4 DAT AipsWiz: ==> Description for nst1 (or N to skip): N AipsWiz: ==> Description for nst2 (or N to skip): N AipsWiz: ==> Description for nst3 (or N to skip): N AipsWiz: ==> Description for nst4 (or N to skip): N AipsWiz: ==> Description for nst5 (or N to skip): N AipsWiz: ==> Description for nst6 (or N to skip): N AipsWiz: ==> Description for nst7 (or N to skip): N |
(Note: the text above has been shortened here for readability and
clarity; the wizard actually spells out, e.g., Description
for ORANGUTAN tape drive /dev/nst0).
After this comes an important section. It's long, and the screen occupies almost 40 lines, but you need to read and understand it. It affects who can access your AIPS resources over the network. Here is the screen:
Screen 9B: Tape Hosts
---------------------
THIS IS IMPORTANT: READ ME!
The TPMON daemons that are automatically started or restarted
with each AIPS session are servers that give remote systems
access to your local tape drives (TPMON2,3,...) and FITS
disk area (TPMON1). There is a mechanism to restrict connections
to a set of hosts and/or IP addresses. You need to indicate what
remote system(s) if any are allowed to use your tapes
and FITS disk area. The default configuration is to allow ONLY
your local host (127.0.0.1). The list of hosts and/or IP addresses
is currently set to:
-----------------------------------------------------------------
127.0.0.1
-----------------------------------------------------------------
You can modify this list after the install by editing file TPHOSTS
in the /home/aips/tmp/DA00 area. Each line in the file can be
- an IP address, e.g. 192.33.115.11
- a fully qualified domain name, e.g. orangutan.cv.nrao.edu,
- a limited IP address wildcard, e.g. 192.33.115.*, or
- a limited domain name wildcard, e.g. *.cv.nrao.edu.
Please indicate whether you want to
add (N)ew entries
(A)ccept the current settings as is, or
(R)eset to the default.
[You may also type B for back, or Q to Quit]
AipsWiz: ===> Your choice (default: Accept):
|
The default setting is the most secure, as it limits remote access to the local host. If you are in any doubt at all, use our default. The danger is in opening up your systems and networks too widely. System Administrators should refer to the next section for a brief discussion about TCP ports used by AIPS for additional security measures.
AIPS uses "sockets" so the main AIPS engine can talk to the image display (called the "TV"), a lock daemon for the TV, a graphics display, message display, and remote TPMON tape servers. For all except the last, you have the choice of whether to use INET (network based) sockets, or UNIX (file based) sockets. This menu allows you to choose what the default will be; your users can always override this on the command line when they start AIPS itself.
Between screens 9 and 10, install.pl does a quick check on whether
some of the AIPS services are already defined, either in
/etc/services, or in a NIS (YP) services map. It found
they were, so no warning was issued. If you are going to be running
AIPS on a single machine, and not accessing it over a network from
other AIPS machines, then you may want to use UNIX sockets. Doing so
means you don't have to edit the services file or map, and it also
allows AIPS users to have multiple TV's on screen if they want. You
must add tv=local to the aips command line every time you start AIPS.
The default is always Inet sockets.
For sysadmins, the TCP ports used by the TPMON tape/disk servers (daemons) are usually 5010 through 5017. In addition, if INET sockets are chosen in this menu, AIPS will use four ports in the range 5000-5009 as well. If you do not want remote AIPS access to your site, you may want to block these (or permit them to defined systems or networks) at your router or firewall.
To add these to /etc/services, cut/paste from the following table.
sssin 5000/tcp SSSIN # AIPS TV ssslock 5002/tcp SSSLOCK # AIPS TV Lock msgserv 5008/tcp MSGSERV # AIPS Message Server tekserv 5009/tcp TEKSERV # AIPS TekServer aipsmt0 5010/tcp AIPSMT0 aipsmt1 5011/tcp AIPSMT1 aipsmt2 5012/tcp AIPSMT2 aipsmt3 5013/tcp AIPSMT3 aipsmt4 5014/tcp AIPSMT4 aipsmt5 5015/tcp AIPSMT5 aipsmt6 5016/tcp AIPSMT6 aipsmt7 5017/tcp AIPSMT7 |
This screen is skipped in binary installations. In most cases, you
will simply want to scan through this screen and accept the defaults.
This is a smorgasbord of options that covers all sorts of AIPS settings,
but they are usually rather esoteric and not of much interest to the
Astronomer who just wants to run the system and analyze their data. The
location of an acceptable compiler (e.g. version 6.3 of gcc and
gfortran) may force you to modify some of the defaults. Note that the
.AIPSRC file retains this information; if you are
installing a later release all will be known. Screen 10 is skipped for
binary installations since you will not be recompiling AIPS.
Screen 10: Advanced Settings
----------------------------
In general, the default settings for these advanced options will be OK.
Please review the settings, and then decide if you want to change them.
Fortran settings are in $SYSLOCAL/FDEFAULT.SH
C settings are in $SYSLOCAL/CCOPTS.SH, and
Link settings are stored in $SYSLOCAL/LDOPTS.SH
Current settings of advanced parameters:
FORTRAN Compiler: /usr/bin/gfortran (default /usr/bin/gfortran)
and options: -c -fno-automatic -fno-globals -Wno-globals \
-malign-double -Wimplicit -Wall
default options: -c -fno-automatic -fno-globals -Wno-globals \
-malign-double -Wimplicit -Wall
Linker: /usr/bin/gfortran (default /usr/bin/gfortran)
C Compiler: /usr/bin/gcc (default /usr/bin/gcc)
and options: -c -O3 -fomit-frame-pointer -funroll-loops \
-I/opt/aips/31DEC22/INC -DHAVE_LINUX_GLIBC
default options: -c -O3 -fomit-frame-pointer -funroll-loops \
-I/opt/aips/31DEC22/INC -DHAVE_LINUX_GLIBC
Readline Library: /usr/lib/libreadline.a
Debug Libs too: NO
[You may also type B for back, or Q to Quit]
AipsWiz: ===> [M]odify or [A]ccept (default Accept):
|
Let's look briefly at some of these settings:
![[AIPS]](aips.gif)
$INC setting in the configuration files;
this is for the most part benign. If you have installed a
compiler such as gfortran 6.3.0 to avoid the defective 4.4.0
compiler, then you must enter the path to this compiler in
FORT, LINK, and CCOM.
libreadline.a in
an obvious place, it will default to the LIBR/GNU/
location and will be built (or used if pre-supplied, e.g.
on CD).
-g) capabilities. Only set this to YES if you need to
use a debugger like dbx or gdb in AIPS
tasks.
If you choose to change any of these, you will get a dialog like this:
AipsWiz: ===> [M]odify or [A]ccept (default Accept):M
AipsWiz: ==> Change item [FORT, FORTOPT, LINK, CCOM, CCOMOPT,
DEBUGLIBS, READLINE, or (default) END]: DEBUG
AipsWiz: ==> Generate debug and opt. libs [Y/N]: Y
AipsWiz: ==> Change item [APSIZE, FORT, FORTOPT, LINK, CCOM, CCOMOPT,
DEBUGLIBS, READLINE, or (default) END]:
|
This shows the installer changing to make debug libraries. After finishing this, you are brought back to screen 11 so you can double-check your changes.
The pseduo array processor memory is now allocated dynamically via local calls and so is not the issue it once was.
Screen 11: FINAL REVIEW before installing!
------------------------------------------
This is your last, best hope for checking the settings before
committing to the install. Please check these settings, and
make sure they are what you want:
AIPS_ROOT (screen 3): /opt/aips
Group (screen 4): aipsuser
Group Write (screen 4): YES
Architecture (screen 5): LINUX
Site name (screen 5): CVTEST
AIPS hosts (screen 6): ORANGUTAN
Data areas (screen 7): /DATA/ORANGUTAN_1
Printers (screen 8): pscolor PS-CMYK NONE Color printer
ps1dup PS DUP Main printer
ps2dup PS DUP,DEF 2nd floor printer
Paper type (screen 8): A
Tape drives (screen 9): host ORANGUTAN, tape drive /dev/nst0: 4mm DDS-4
Tape hosts (screen 9): 127.0.0.1
Advanced (screen 10): (not listed here)
You can skip back to a previous menu by entering its number,
or use the phrase 'start over' to go back to the beginning.
[You may also type B for back, or Q to Quit]
AipsWiz: ===> [A]ccept (default) or menu number:
|
This screen attempts to give a review of the main settings you have
entered, and allows you to back up to any given screen so you can fix
things. The only annoying feature is that once you go back to a screen,
the only way to get back to screen 11 is to advance one screen at a time.
In effect this just means pressing <RETURN> at each
intervening screen.
You will be given one last chance to change your mind after accepting the values in the menu. Then the script proceeds to deploy the decisions you have made by altering various system files, creating directories, and so on. From a non-binary installation, a typical session might look like this:
AipsWiz: ==> Confirm: start the install with these settings [Y]:
AipsWiz: =====> Creating or updating HOSTS.LIST file
AipsWiz: -- Done.
AipsWiz: =====> Configuring your AIPS_ROOT area...
AipsWiz: =====> Running 31DEC22/SYSTEM/UNIX/AIPSROOT.DEFINE \
/home/aips/tmp
AipsWiz: -- Done.
AipsWiz: =====> changing LOGIN.SH to LAPTOP="YES"
AipsWiz: =====> changing LOGIN.CSH to LAPTOP="YES"
AipsWiz: -- Done.
AipsWiz: =====> Setting up LINUX-specific areas and SYSLOCAL...
AipsWiz: -- Done.
AipsWiz: =====> Configuring AIPS for your printers...
AipsWiz: Text printing set up for 'A' size paper
AipsWiz: -- done
AipsWiz: =====> Configure AIPS data areas ...
AipsWiz: -- done
AipsWiz: =====> Configure AIPS Tape drives...
AipsWiz: -- done
AipsWiz: =====> Create DA00/hostname/ directories...
AipsWiz: -- done.
AipsWiz: =====> Deploying your compiler options in script files...
AipsWiz: CCOPTS.SH done (C Compiler and options)
AipsWiz: LDOPTS.SH done (Linker)
AipsWiz: FDEFAULT.SH done (Fortran compiler and options)
WARNING! The structure of /opt/aips/31DEC22/SYSTEM/UNIX/FDEFAULT.SH
is very complex, and while this wizard install
tries VERY hard to change the right section,
it may have failed. Please, PLEASE inspect the
file and compare it to the original (saved as
FDEFAULT.SH.dist in /opt/aips/31DEC22/SYSTEM/UNIX)
to make sure the settings are right. Do this
BEFORE you proceed any further.
THIS IS REQUIRED FOR THE 2.95.3 COMPILER IN LINUX
AipsWiz: ==> Press <ENTER> after you have verified FDEFAULT.SH::
|
(The messages about LOGIN.SH appear only if you ask to
change the host name to LOCALHOST for a single-computer installation.)
Note the pause here, asking for the OK to proceed. If you haven't
changed the settings, don't worry about it. Even if you have, chances are
that it will get the changes made in the right place. However, doing this
sort of change automatically in as complex a file as
FDEFAULT.SH is tricky, so it can't hurt to look at the
architecture-specific section for your system and make sure it's not
totally messed up! In the worst case scenario, you can always restore the
original from the FDEFAULT.SH.dist file.
The process will then continue (after you press
<ENTER>, of course):
AipsWiz: ==> Press <ENTER> after you have verified FDEFAULT.SH::
AipsWiz: =====> Compile Utility Programs in
/opt/aips/31DEC22/LINUX/SYSTEM/CVTEST...
AipsWiz: Compiling F2PS...
AipsWiz: Compiling F2TEXT...
AipsWiz: Compiling NEWEST...
AipsWiz: Compiling PRINTENV...
AipsWiz: Compiling PWD...
AipsWiz: Compiling REVENV...
AipsWiz: - Compiling ZTRLOP.c...
AipsWiz: - that seemed to work.
AipsWiz: =====> Make the XAS TV Server from source...
AipsWiz: About to unpack the XAS.SHR archive.
AipsWiz: Building the UNSHR program for LINUX...
AipsWiz: UNSHR.LINUX built in `pwd`
AipsWiz: About to run XAS.SHR through UNSHR (ignore the prompt)...
Enter the name of the archive:
AipsWiz: Done.
AipsWiz: About to try to make XAS...
|
All of this is reasonably routine and automatic. The messages that
follow have to do with building XAS (note: if your install freezes after
announcing that it's going to make the XAS server, you need a newer
version of install.pl). The make of XAS may
fail due to bad settings in the YYSERV/XAS/Makefile. If
that happens, you can fix it later. Change directory to this area,
edit Makefile, and then enter make clean ; make.
Extra messages reporting intermediate steps are likely to appear. On a binary installation, you will see something like:
AipsWiz: ==> Confirm: start the install with these settings [Y]:
AipsWiz: =====> Creating or updating HOSTS.LIST file
AipsWiz: -- Done.
AipsWiz: =====> Configuring your AIPS_ROOT area...
AipsWiz: =====> Running 31DEC22/SYSTEM/UNIX/AIPSROOT.DEFINE \
/home/aips/tmp
AipsWiz: -- Done.
AipsWiz: =====> changing LOGIN.SH to LAPTOP="YES"
AipsWiz: =====> changing LOGIN.CSH to LAPTOP="YES"
AipsWiz: -- Done.
AipsWiz: =====> Setting up LINUX-specific areas and SYSLOCAL...
AipsWiz: -- Done.
AipsWiz: =====> Configuring AIPS for your printers...
AipsWiz: Text printing set up for 'A' size paper
AipsWiz: -- done
AipsWiz: =====> Configure AIPS data areas ...
AipsWiz: -- done
AipsWiz: =====> Configure AIPS Tape drives...
AipsWiz: -- done
AipsWiz: =====> Create DA00/hostname/ directories...
AipsWiz: -- done.
AipsWiz: =====> and populating area for $THISHOST from rsync server
|
Once the utility programs and XAS are built, the wizard will start preparing for a possible recompile and for the Midnight Job. You do not need to actually run one (though we recommend it if you wish to stay current with the latest bug fixes), but setting up the infrastructure to support a midnight job is now a standard feature of the AIPS install process. Here's what the dialog will tell you on a text installation:
AipsWiz: =====> Preparing for INSTEP2 and INSTEP4 (building AIPS)... AipsWiz: =====> Preparing for the "Midnight Job"... The AIPS Midnight Job is a way to keep your AIPS installation up to date. It is secure, relatively easy, and can be done on demand or in a cron job (i.e. periodically, daily or weekly or whenever). It does require that you have the code versioning system (cvs) installed on your system. This script will set up the infrastructure for you to be *able* to run the Midnight Job (MNJ), but you have the power to make it run or not. Should you choose to run the Midnight Job, the 'begin date' will be set to YYYYMMDD, which is ONE day before the generation time of the 31DEC22.tar.gz file. AipsWiz: ==> If you want a different date, enter it now:: |
This date is used by the midnight job as the zero point for incremental updates, so it should be before the time stamp on the file. Due to possible timezone ambiguities, it's best to accept the one-day-before default the wizard offers.
For binary installations, it is a bit simpler:
AipsWiz: =====> Preparing for the "Midnight Job"... The AIPS Midnight Job is a way to keep your AIPS installation up to date. It is secure, relatively easy, and can be done on demand or in a cron job (i.e. periodically, daily or weekly or whenever). This script will set up the infrastructure for you to be *able* to run the Midnight Job (MNJ), but you have the power to make it run or not. |
At this stage, the wizard hands off control temporarily to the
MAKE.MNJ or MAKE.BMNJ scripts which will
compile some programs, set up some .OLD and
.DAT files, and set up the mailing lists for midnight job
output and error messages. It gives you a chance to examine these
settings and change them by hand before proceeding.
The Midnight Job runs under the code versioning system
(cvs) for text installations and versions older than
31DEC16. Binary installations use rsync (and
only rsync in 31DEC16 and later). You no longer
need to contact us to ask about running a midnight job. The scripts
will attempt to "prime" the cvs setup by accessing our server. When
it asks for a password, simply hit Enter. The process creates a file
.cvspass in your home directory enabling cvs to run
without passwords henceforth. Binary installations try to do this
also, but make little fuss if they fail
The MNJ is of little use with AIPS versions that are completely frozen when you install them and is useful only once after we freeze a particular version. The current development version called TST changes often and, starting with 31DEC22, the NEW version (now 31DEC21) gets updated whenever there is a significant error. Therefore, the MNJ will be of use for NEW as well as TST. Once your version becomes OLD (now 31DEC20 or earlier), then the code does not change. Running a MNJ on such versions should be done once when they become OLD and, thereafter MNJs will only update the TEXT area.
The registration system has fallen into disuse. It required
special database software which the CV Computer Division no longer
maintains. As a consequence, the wizard no longer runs the
REGISTER script. You may run this fairly primitive
script after the installation if you want. It will obtain
registration information from you, and put it in the
REGISTER.INFO file in your home directory. You have the
option of sending this information to NRAO, but we now just file it.
Registration is no longer a requirement to receive help with AIPS.
Usage statistics are now obtained only via monitors of tarball
downloads and cvs accesses.
If you are doing a binary installation (from CD or network), you will not be prompted for this step. Otherwise, the wizard will ask if you want it to start INSTEP2, which compiles all AIPS subroutines, and INSTEP4, which builds all the programs. This can take an hour or more, even on fairly fast hardware. If you choose to defer this, the script gives simple instructions on what to do next. If you go ahead at this point, the script will not only do INSTEP2 and INSTEP4, but also run the programs described below.
If you are installing a frozen version of AIPS, you no longer need to check the patches page for the release before telling INSTEP2 and INSTEP4 to begin. We now apply patches to the NEW version at NRAO and rebuild the binaries and tar ball. As a result, when you download the tar ball or do a binary installation, you get a fully patched version.
If you are installing on architecture MACINT, you will
see the following bit of advice
***************** READ CAREFULLY ************************** If you are running on a modern version of the Mac OS X (10.11 - 10.15 or later), you need to do one more thing NOW to correct for the loss of LIBRARY_PATH functionality. In a 2nd window, start bash, source $AIPS_ROOT/LOGIN.SH Then .$AIPS_ROOT/fix_aips_macos.sh Do not run as root or under sudo and note the dot you will be prompted for your password once. AipsWiz: ===> Hit return in this window when ready. |
If you are not running El Capitan or later releases yet, simply hit Enter, If you are, go to another window (xterm) and follow the above instructions. When you are done, hit Enter in your installation window.
Finally, you may need or want to run these. If building from source,
FILAIP and POPSGN have to be run. This is
done for you, if you opt to run INSTEP2 and INSTEP4 from the
install.pl script. If you are doing a re-installation,
you may be prompted for a password when running
install.pl. The default password is AMANAGER
which can be changed in AIPS, but is usually left as it is shipped.
If installing from CD, FILAIP and POPSGN
should not need to be run. In either case, you may want to examine
system defaults with SETPAR. All of these are run by
defining the AIPS environment and using the RUN shell
script. What follows here is a typical session with the recommended
values, with some text omitted for clarity (the GPL notice, and the
disk selection dialog in RUN):
bash$ . ./LOGIN.SH bash$ $CDTST AIPS_VERSION=/opt/aips/31DEC22 bash$ RUN FILAIP (GNU Copyleft shows up here - also a prompt for a password when re-installing a new version) Password: (default is AMANAGER) # interactive AIPS, # batch queues (2 I) 8 2 FILAI1: Init POPS memory files 1 through 12 with program POPSGN FILAI1: Done! bash$ RUN POPSGN Enter Idebug, Mname, Version (1 I, 2 A's) (NO COMMAS) 0 POPSDAT TST > (press <RETURN> here) POPSG1: Popsgen complete POPSG1: orangutan 31DEC22 TST: Cpu= 0.2 Real= 74 bash$ RUN SETPAR Starting up SETPAR (RELEASE OF 31DEC22) Enter: 1=Start Over, 2=Change parameters, 3=Change DEVTAB, 4=Quit 2 (many options shown, including this:) 35 Computer speed rating (AIPSmarks) 20.00 Enter number to change or 0 = Print, -1 = Return 35 35 Computer speed rating (AIPSmarks) 500.0 30 Enter number to change or 0 = Print, -1 = Return -1 Password: (default is AMANAGER) Enter: 1=Start Over, 2=Change parameters, 3=Change DEVTAB, 4=Quit 4 SETPA1: orangutan 31DEC22 TST: Cpu= 0.0 Real= 106 bash$ |
The above dialog shows an installer running all three utility programs,
so that the system files are created (FILAIP), initialized
(POPSGN), and customized (SETPAR). The
customization shown is to set the "speed" parameter to something close to
the actual expected performance of the machine. This parameter is used to
figure out reasonable delays in task startup, termination and management,
and can make quite a (bad) difference if set too low or too high. Refer
to the AIPS Benchmark page for some tests we've
done and to figure out what value to use for your system. For most newer
(modest) machines, 30 is probably a good starting point.
There are a couple of things that may need to be done to your
operating system controls files in order to run AIPS. You probably
need to be root to do these in LINUX or have
sudo privilege on Macs. The first is to add to
/etc/services the lines
sssin 5000/tcp SSSIN # AIPS TV server ssslock 5002/tcp SSSLOCK # AIPS TV Lock msgserv 5008/tcp MSGSERV # AIPS Message Server tekserv 5009/tcp TEKSERV # AIPS TekServer aipsmt0 5010/tcp AIPSMT0 # AIPS remote FITS disk access aipsmt1 5011/tcp AIPSMT1 # AIPS remote tape 1 aipsmt2 5012/tcp AIPSMT2 # AIPS remote tape 2 aipsmt3 5013/tcp AIPSMT3 aipsmt4 5014/tcp AIPSMT4 aipsmt5 5015/tcp AIPSMT5 aipsmt6 5016/tcp AIPSMT6 aipsmt7 5017/tcp AIPSMT7Comment out the obsolete "radio free ethernet" (5002) service. Your X Windows needs to operate in either 8-bit PseudoColor or 24-bit TrueColor mode. The 16-bit TrueColor mode that is the default on many old systems does not have enough dynamic range for scientific imaging. The file
/etc/X11/XF86Config-4 is used to control this in
OBSOLETE RedHat installations.
The AIPS Manager FAQ may be of help in solving residual installation problems.
That's about all we can cover here. The installation wizard is a vast improvement over the old INSTEP1 way of doing things, and we welcome feedback on it, both for bug reports and suggested improvements.
After a version of AIPS is "frozen", changes will be made to the code for significant errors. When a serious bug is found, a "patch" for the bug will be announced and made available through the patches web page. It will also be applied to the "frozen" version (called NEW) at NRAO. Binary and text installations may use the Midnight Job on the frozen version to update their installation. This is now the only way to patch both text and binary installations.
When a patch is made available, it is usually announced on the "bananas" mail list. This is a closed, moderated mailing list that serves as a conduit for important announcements pertaining to AIPS, as well as an occasional forum for questions and discussion about the software. You can subscribe yourself to this list on-line.
In 2022, we have stopped doing formal patches; we simply update the NEW version occasionally for significant bug fixes. Run the MNJ periodically to get any corrections and TEXT area additions.
Copyright © 2009 Associated Universities, Inc.
The National Radio Astronomy Observatory is a facility of the National
Science Foundation operated under cooperative agreement by Associated
Universities, Inc.