next up previous contents index
Next: Optimizing and Example Up: LASPack Reference Manual Previous: Changes in Version

Installation

 

In order to simplify the description of the installation procedure, we assume that you are working on a UNIX system and have already copied the LASPack distribution file laspack-1.12.3.tar.Z.

The complete installation consists of the following five steps:

  1. Move the file laspack-1.12.3.tar.Z to the directory that will become the top-level directory for the source files.
  2. Uncompress and untar the file:
    uncompress laspack-1.12.3.tar.Z
    tar xvf laspack-1.12.3.tar
    This should create the entire distribution tree.
  3. Make sure that you have appropriately set the following variables of your UNIX environment (for compilation of the source files an ANSI C compiler is needed):
        HOME           home directory 
        CC             name of the C compiler 
        CFLAGS         compiler options 
        LDFLAGS        linker options
    

  4. There are two possibilities for installing the package:

    User's installation:
    This should be carried out if you want to install LASPack in your home directory so that it is available only to you.

    At this stage, you could use the environment variable ARCH_EXT in order to install the library and the test programs in different subdirectories depending on computer architecture. If you share your home directory across a heterogeneous computer network, it may be advantageous for the management of several versions of binaries. In this case, set the variable ARCH_EXT to an appropriate value (e.g. /sunos on Sun workstations, /hp-ux on HP workstations, etc.).

    Make sure that the directory $HOME/bin$ARCH_EXT (or $HOME/bin if you don't use ARCH_EXT) is contained in the environment variable PATH and run the installation script:

    ./install
    This will generate the library liblaspack.a (and the library libxc.a which is not a part of LASPack but required by some test programs) and install it in the directory $HOME/lib$ARCH_EXT. Furthermore, it will build the test programs and install them in the directory $HOME/bin$ARCH_EXT.
    Local installation:
    This will install the LASPack library and corresponding header files in the directory /usr/local/lib and the test programs in the directory /usr/local/bin which are usually used for such a kind of software. To do this you need permission to write in these directories. Futhermore you should set the environment vatiable PATH to /usr/local/bin.

    The installation script should be started with an additional parameter:

    ./install local
  5. Finally, running the installation script, the LASPack library created is automatically checked. By means of the program mlstest, all combinations of multilevel solvers, plain iterative procedures, and preconditioners available in LASPack are tested on a two-dimensional Poisson problem. If all goes well, you get the message:
    LASPack tested successfully.
    Therewith the LASPack installation is completed.

    In order to run test programs in a C shell, do not forget to renew the hash tables by the command:

    rehash

LASPack as well as the installation script were successfully tested on several machines: Sun Sparc5, HP 9000/735, IBM RS/6000 550, DEC 3000/800 M, SGI IRIS Indigo and PC 486 (running Linux). Nevertheless, if the installation fails, please contact the author.



next up previous contents index
Next: Optimizing and Example Up: LASPack Reference Manual Previous: Changes in Version



Tomas Skalicky (skalicky@msmfs1.mw.tu-dresden.de)