VMBICAL-AIR Installation Instructions

The AIR version of the VMBICAL software package is now under CVS version control. The current installation of VMBICAL is to be run on a Solaris operating system. This software installation assumes that Perl, psplot and the MONGO plotting package are installed on the machine that it is being run on. A version for the Linux operating system is currently being worked on.

To install the latest version of VMBICAL-AIR on a system, the CVSROOT will first need to be added to the .cshrc file located in the user's home directory. To add the CVSROOT open the .cshrc file in an editor and insert the following:

Two directory structures need to be created for VMBICAL_AIR to run successfully vmbical_air and vmbical_iraf.

  1. To get the latest AIR version of the VMBICAL_AIR software from the CVS repository, at the terminal prompt:
      > cvs checkout -rr2-1 vmbical_air

    This creates the vmbical_air directory wherever the command is invoked.

    NOTE: r2-1 is the version or release of the the VMBICAL-AIR software that is to be checked out from the CVS repository. Currently r2-1 is the most current version. If you are unsure of which one is the current version please ask.

  2. An IRAF directory especially for VMBICAL-AIR is necessary for processing. It is best to create this new directory called vmbical_iraf in the same location as the vmbical_air directory, but not inside of the vmbical_air directory:
      > mkdir vmbical_iraf
      > cd vmbical_iraf
      > mkiraf

    The mkiraf command creates a login.cl file and it is not necessary to edit this file to process data through VMBICAL-AIR.

  3. It is necessary to have a loginuser.cl file in the vmbical_iraf directory where paths to executables can be managed. A sample loginuser.cl file can be copied from the vmbical_air/templates/Startup directory into the vmbical_iraf directory to be edited for the user.
    • edit home to the path of the vmbical_iraf directory
    • edit userid to the operator's username
    • edit node to the machine name that VMBICAL-AIR will be run on
    • edit reset vmbical to the path of the iraf_cl directory
    • printer may be edited to the user's preference in printers
    • cd to control directory may be edited and used if the user would prefer not to have to cd to the main working area once IRAF has been started.

  4. It is also necessary to have a run_iraf script located inside of the vmbical_iraf directory. A sample run_iraf script can be copied from the vmbical_air/templates/Startup directory into the vmbical_iraf directory. It is not necessary to edit this script.

CVS does not retain executables in its repository, only the source code and makefiles to create those executables. Once the vmbical_air directory has been created all executables must be compiled and installed into the necessary directories for VMBICAL-AIR to run properly. VMBICAL-AIR has two main source directories that need to be compiled src_air and src_c.

  1. To compile the source code in src_c change directories to the vmbical_air/src_c directory and run the make commands:
      > cd vmbical_air/src_c
      > make clean
      > make
      > make install

    It is always a good idea to run a clean in the src_c directory before compiling the executables. This will remove any old files that may be lingering around from the last time the executables were made.

  2. To compile the source code in src_air open an IRAF session and change directories to the vmbical_air/src_air directory:
      > cd vmbical_iraf
      > cl
      cl> cd ../vmbical_air/src_air
      cl> cl <run_make.cl

    The run_make.cl script will compile and install all of the AIR executables into their proper directories. If there is a need to compile, install or clean the AIR executables individually click here for more instructions.

Installation is now complete. Operator instructions for VMBICAL-AIR can be found on the VMBICAL-AIR documentation page.

Revision: $Id$