Installation.

This chapter describes how the MNMR package is installed on the system. The first part describes how to load the tape and compile the programs, and the second part describes how to set up the individual users.

Requirements.

In order to use the MNMR system, you'll need to have access to the following systems on the machine (probably named differently on the different machines):

X11 Development Tools, C compiler, and a FORTRAN compiler. On the Stardent 1500 machine, obtaining the vectorized, machine-coded FFT package from the Contributed Library greatly improves the performance of the system. On Silicon Graphics, install the complib package to obtain a library with fast FFT code.

Reading the tape.

Before reading the tape into the system, a directory for MNMR should be created. This could be done as follows:

mkdir /usr/people/xyz/mnmr
cd /usr/people/xyz/mnmr

The tape can then be read in as follows:

tar xvof /dev/tape

Note, on some machines it might be necessary to use the noswap device name for the tape drive, e.g. /dev/tapens, or pipe the data from the tape through the dd command, e.g.

dd conv=swab </dev/tape | tar xvof -

If you have the MNMR distribution as a gzip'ed tar file, you can do the following instead:

gzip -cd mnmr.tar.gz | tar xvof -

You should then add the following lines to your .cshrc file:

setenv MNMR_DIR /usr/people/xyz/mnmr
setenv MNMR_HOST iris

The word iris should be chosen according to the machine on which you want to run the system:

A directory to hold the compiled programs should be created, and made available for all users for read and execute access. This could be done as follows:

mkdir /usr/people/Inmrprog
chmod a+rx /usr/people/Inmrprog

The directory: $MNMR_DIR/MakeUtil contains setup files for the different platforms, all in two versions: SetUpI sets up some variables for compiling a debug version for the SGI IRIX 4.x machines, and SetUpIO sets the variables for compiling an optimized version, used for production. You'll need to modify these files and change the line reading:

MAKE_PROG_DIR="/<something>/carlsberg/Inmrprog/"

into:

MAKE_PROG_DIR="/usr/people/Inmrprog/"

or into whatever directory name you have chosen for the programs. If you run the system on a network with different machines connected to it (e.g. both SGI machines and IBM R6000 machines), you can create a different directory for the different platforms, e.g. /usr/people/Inmrprog for the SGI machines, and /usr/people/IBMnmrprog for the IBM machines. The MAKE_PROG_DIR would then have to be set up differently in the SetUpIBM/SetUpIBMO and the SetUpI/SetUpIO files.

2Creating the Xw Widget library.

The directory: $MNMR_DIR/Xw contains the source code for the HP Widgets. They are used for the MVIEW program. If your X11 development kit already has this library, you don't need this directory, and the MAKE_XWLIB environment variable in the SetUp files must be changed accordingly. You might need to change the Makefile file in the Xw directory to make a version for your system.

Creating the CPLOT library.

The $MNMR_DIR/cplot directory contains the Carlsberg plotting system, cplot. It consists of a library containing a main routine, and some drivers for the different devices supported. If you want to add new drivers, use one of the files as a template, add the name to the cplot.c file and to the Makefile. If you add new drivers that need to be linked with specific system libraries, these should be added to the MAKE_XLIB environment variable in the SetUp files. Normally, both a debug and an optimized version is created.

Setting up the Users.

The only thing that needs to be done for the users that want to use the MNMR system is to add the program directory (in this case: /usr/people/Inmrprog) to their path statement.

Setting up a System Printer.

The directory: $MNMR_DIR/printer contains some script files for setting up printers. Use them as a guideline for setting up a printer on your machine.