INSTALL_NOTES 3.61 KB
Newer Older
hrchilds's avatar
hrchilds committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19


                       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.

Unix:

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.2.5 for the current distribution.
hrchilds's avatar
hrchilds committed
21 22 23 24 25 26 27 28 29 30

        "platform" will be one of the following:  aix, irix6, linux, osf1,
        or sunos5 depending on the machine.  The one you use should match
        the name of the accompanying distribution file.

        "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.2.5 irix6 /usr/local/visit
hrchilds's avatar
hrchilds committed
32

hrchilds's avatar
hrchilds committed
33
    will install the irix6, 1.2.5 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_2_5.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 -a 1.2.5 linux /usr/local/visit
hrchilds's avatar
hrchilds committed
40

hrchilds's avatar
hrchilds committed
41
    to add a linux, 1.2.5 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 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78

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
    card, we recommend using the NVidia 2960 driver unless you will be
    doing stereo rendering.  If you will be doing stereo rendering then you
    must use the 3123 driver, although it has some bugs.  Below are notes
    on the various NVidia Linux drivers.

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

      2960 - Recommended.  Doesn't support stereo rendering.

      3123 - Recommended for stereo rendering.  It may not render large
             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.


Windows:

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

hrchilds's avatar
hrchilds committed
81 82
2.  Right click on the visit1.2.5.exe icon using your mouse and selecting
    "Extract to folder C:\...\Desktop\visit1.2.5" from the popup menu.  A
hrchilds's avatar
hrchilds committed
83
    window will popup as the file is extracted into the directory.  Once
hrchilds's avatar
hrchilds committed
84
    the process is complete a "visit1.2.5" directory icon should appear on
hrchilds's avatar
hrchilds committed
85 86
    your desktop.

hrchilds's avatar
hrchilds committed
87
3.  Double click on the "visit1.2.5" directory icon bringing up a file
hrchilds's avatar
hrchilds committed
88 89 90 91 92 93
    system browsing window.

4.  Double click on the SETUP icon with the computer display icon to run
    InstallShield.

5.  Follow the directions provided by InstallShield.