INSTALL_NOTES 3.26 KB
Newer Older
hrchilds's avatar
hrchilds committed
1 2


miller86's avatar
miller86 committed
3
                       Installation instructions for VisIt
hrchilds's avatar
hrchilds committed
4 5 6 7 8 9
                      =====================================

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

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

hrchilds's avatar
hrchilds committed
22 23
        "platform" will be one of the following:  aix, aix64-xlc, darwin,
        irix6, linux-altix, linux-ia64, linux-x86_64, linux_chaos, linux_rhel3,
hrchilds's avatar
hrchilds committed
24 25
        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
26 27 28 29 30 31

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

    For example

32
        visit-install 1.12.0 linux_rhel3 /usr/local/visit
hrchilds's avatar
hrchilds committed
33

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

40
        visit-install 1.12.0 darwin /usr/local/visit
hrchilds's avatar
hrchilds committed
41

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

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
60 61
    card, we recommend using the NVidia 4363 driver or newer.  Below are
    notes on the various NVidia Linux drivers.
hrchilds's avatar
hrchilds committed
62 63 64

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

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

hrchilds's avatar
hrchilds committed
67
      3123 - Does support stereo rendering, but it may not render large
hrchilds's avatar
hrchilds committed
68 69 70 71 72 73 74
             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
75 76
      4363 - Recommended.  There are no known critical bugs with this or
             newer drivers.
hrchilds's avatar
hrchilds committed
77 78 79

Windows:

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

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

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