INSTALL_NOTES 3.16 KB
Newer Older
hrchilds's avatar
hrchilds committed
1 2 3 4 5 6 7 8 9


                       Installation instructions for VisIt
                      =====================================

This document contains instructions for installing VisIt on both Unix and
Windows systems.  The Unix installation instructions are first followed
by the Windows installation instructions.

hrchilds's avatar
hrchilds committed
10
Unix and Mac OS X:
hrchilds's avatar
hrchilds committed
11 12 13 14 15 16 17 18 19

1.  Run the visit-install script to install visit.  Note that it can
    create a new distribution directory or update an existing
    distribution.  This is handled automatically.

        visit-install "version" "platform" "directory"

    where

hrchilds's avatar
hrchilds committed
20
        "version" will be 1.5.1 for the current distribution.
hrchilds's avatar
hrchilds committed
21

hrchilds's avatar
hrchilds committed
22 23 24
        "platform" will be one of the following:  aix, darwin, irix6, linux,
        osf1, or sunos5 depending on the machine.  The one you use should
        match the name of the accompanying distribution file.
hrchilds's avatar
hrchilds committed
25 26 27 28 29 30

        "directory" is the directory you wish to install visit into.
        If the directory doesn't exist the script will create it.

    For example

hrchilds's avatar
hrchilds committed
31
        visit-install 1.5.1 irix6 /usr/local/visit
hrchilds's avatar
hrchilds committed
32

hrchilds's avatar
hrchilds committed
33
    will install the irix6, 1.5.1 version of visit in the directory
hrchilds's avatar
hrchilds committed
34
    "/usr/local/visit".  Note that you will need to have the file
hrchilds's avatar
hrchilds committed
35
    "visit1_5_1.irix6.tar.gz" present in the current directory for this
hrchilds's avatar
hrchilds committed
36 37 38
    to function properly.  You can install multiple binaries into the
    same directory.  For example, you could then execute

hrchilds's avatar
hrchilds committed
39
        visit-install 1.5.1 linux /usr/local/visit
hrchilds's avatar
hrchilds committed
40

hrchilds's avatar
hrchilds committed
41
    to add a linux, 1.5.1 version of visit to the same directory.
hrchilds's avatar
hrchilds committed
42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58

2.  Add the bin directory below the installation directory
    (/usr/local/visit/bin in our example) to each user's search path.
    The best way to do this is to add it to the user's .cshrc file.
    The bin directory contains the visit script which starts VisIt.
    It can be run on many machines.  The script determines the type of
    machine it is running on and starts the appropriate executable.
    If visit were installed in the directory "/usr/local/visit",
    then the following commands would set your search path
    appropriately.

        cd
        echo "set path = ($path /usr/local/visit/bin)" >> .cshrc

    This completes the installation process for VisIt.

3.  If you are installing VisIt on a Linux system with an NVidia graphics
hrchilds's avatar
hrchilds committed
59 60
    card, we recommend using the NVidia 4363 driver or newer.  Below are
    notes on the various NVidia Linux drivers.
hrchilds's avatar
hrchilds committed
61 62 63

      2802 - Not recommended.  It has a triangle shading bug.

hrchilds's avatar
hrchilds committed
64
      2960 - Doesn't support stereo rendering, but no critical bugs.
hrchilds's avatar
hrchilds committed
65

hrchilds's avatar
hrchilds committed
66
      3123 - Does support stereo rendering, but it may not render large
hrchilds's avatar
hrchilds committed
67 68 69 70 71 72 73
             numbers of polygons when using display lists.  You can turn
             off display lists by bringing up the "Rendering options"
             window and deselecting the "Use display lists" toggle button.

      4191 - Not recommended.  VisIt either crashes your X server or puts
             up a visualization window that never gets refreshed.

hrchilds's avatar
hrchilds committed
74 75
      4363 - Recommended.  There are no known critical bugs with this or
             newer drivers.
hrchilds's avatar
hrchilds committed
76 77 78

Windows:

hrchilds's avatar
hrchilds committed
79
1.  Copy the file visit1.5.1.exe to your desktop.
hrchilds's avatar
hrchilds committed
80

hrchilds's avatar
hrchilds committed
81
2.  Double click on the visit1.5.1.exe icon to run the installer.
hrchilds's avatar
hrchilds committed
82

hrchilds's avatar
hrchilds committed
83
3.  Follow the directions provided by the installer.