Chapter 3. Install

Table of Contents

1. Installing dependencies
2. Installing from the CVS dev area at NRL
2.1. Installing the libraries
2.2. Installing the IDL procedures
3. Installing tarball packages
3.1. Installing the C++ package
4. Installing form SolarSoft

1. Installing dependencies

The install of the following packages is optionnal for the moment and will not affect the functioning of Raytrace if used through IDL.

Before installing Raytrace user can install the following packages:

  • cfitsio

  • CCFITS

wich can be downloaded at http://heasarc.nasa.gov/fitsio/fitsio.html

2. Installing from the CVS dev area at NRL

2.1. Installing the libraries

  1. Change dir to a working area of your directory tree:

    [me@mycomputer]$ cd myworkdirectory

  2. Checkout Raytrace out of the CVS dev area:

    [me@mycomputer]$ cvs co dev/Raytrace
    [me@mycomputer]$ cd dev/Raytrace

  3. Generate make files, configure and compile:

    [me@mycomputer]$ aclocal
    [me@mycomputer]$ autoconf
    [me@mycomputer]$ automake -a
    [me@mycomputer]$ ./configure
    [me@mycomputer]$ make

  4. Test if compilation was successfull doing:

    [me@mycomputer]$ make check
    ...
    Perfect !
    PASS: raytrace
    ==================
    All 1 tests passed
    ==================
    ...
    [me@mycomputer]$ 
    

  5. Optionally, you can install the software. The default installation path is /usr/local. It can be changed by setting --prefix=PATH when calling ./configure.

    [me@mycomputer]$ make install

[Important]Important

Note that the shared object library libraytrace.so is located in the subdirectory src/.libs and will be installed in --prefix=PATH

2.2. Installing the IDL procedures

  1. Change dir to where you usually put your IDL procedures:

    [me@mycomputer]$ cd myIDLdirectory

  2. Checkout rtidlpro and arnaudutil packages from CVS

    [me@mycomputer]$ cvs co dev/rtwl
    [me@mycomputer]$ cvs co dev/arnaudutil

  3. Go to the lib subdirectory of rtwl.

    [me@mycomputer]$ cd dev/rtwl/lib

  4. Copy the libraytrace.so file or make a symbolic link to it, assuming that PATH2SO in the example is set to the location of libraytrace.so

    [me@mycomputer]$ cp $PATH2SO/libraytrace.so .

    or

    [me@mycomputer]$ ln -s $PATH2SO/libraytrace.so

  5. Run IDL and execute rttest. If the test is successful the installation is done.

    [me@mycomputer]$ idl
    ...
    IDL[mycomputer]> rttest
    ...
    Test looks good !
    IDL[mycomputer]> 

3. Installing tarball packages

3.1. Installing the C++ package

The install follows the classical Unix/Linux install steps: ./configure, make, make install.

  1. Download the tarball package: [CREATE A LINK HERE]

  2. Expand the package and move the the created directory:

    [me@mycomputer]$ tar -xzf scor-0.1.tar.gz
    [me@mycomputer]$ cd scor-0.1

  3. Configure:

    [me@mycomputer]$ ./configure

    Use --help to list the ./configure options. Note that is the some libraries are not located in the standard linux path, you can use the following flags: CPPFLAGS"=-I/non/standard/dir/include -L/non/standard/dir/libs" and LDFLAGS=-L/non/standard/dir/libs

  4. Compile the sources:

    [me@mycomputer]$ make

  5. Optionally check if the compiled programs and libraries work:

    [me@mycomputer]$ make check

  6. Install the package:

    [me@mycomputer]$ make install

4. Installing form SolarSoft

TO BE DONE