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.2.tar.Z.

The complete installation consists of following five steps:

  1. Move the file laspack-1.12.2.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.2.tar.Z
    tar xvf laspack-1.12.2.tar
    This should create the entire distribution tree.
  3. Make sure that you have appropriate 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. It may be advantageous, if you share your home directory across a heterogeneous computer network, 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.) and make sure that the directory $HOME/bin$ARCH_EXT is contained in your PATH variable.

    Run the installation script:

    ./install
    This will generate the library liblaspack.a (and the library libxc.a which is no 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/lib$ARCH_EXT.
    Local installation:
    This will install 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 kind of software. To do this you need permission to write in these directories.

    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 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 was 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)