PREREQUISITES

The following are the minimum requirements for running SARA:

1.  UNIX/Linux Platform with perl 5.0.3 (or greater), cc (or gcc)
2.  A Web Browser (e.g., Netscape, Lynx, Mosaic)
3.  Normal utilities, such a gunzip, make, etc.

The following is highly recommended if you are scanning MS Windows
platforms:

1. samba-tng (from samba-tng.org).  See README.SMB for details

GETTING THE LATEST VERSION

The latest version can always be found by referring to 
http://www-arc.com/sara.  We suggest that you join the
sara-l list server while you are at it.

UNPACKING AND BUILDING

The SARA distribution is provided in a compressed tar format.
The distribution file is in the format sara-x.x.x.tgz where
x.x.x is the version number.  Unpack the distribution with the 
following commands.  Note that the SARA distribution will be
installed in the sara-x.x.x directory which will normally be 
a subdirectory to the directory where the *tar.gz file was loaded.


        gunzip sara-x.x.x.tgz
        tar xvf sara-x.x.x.tar

As of SARA 3.5.6, we added the GNU autoconf configure method for
building SARA.  This method is initiated by typing:

        ./configure
        make

Note, there is no make install.  The SARA distribution is installed
in the directory below where the  tarball was installed.

If you have problems with this method, the fallback method of building
is:
        make -f Makefile.fallback <ostype>

In this case, the SARA build process may assume that the compiler is 
named 'cc'.  If your environment uses gcc AND there is no link for cc, 
perform the following (assumes sh, bash, or ksh shell):

        CC=gcc
	export CC

Next, build the program by typing make OSTYPE where OSTYPE may be:

        aix osf bsd bsdi dgux irix4 irix freebsd
        hpux9 hpux linux linux-nansi sunos4 sunos5 
        trusted-sunos5 sysv4

For instance, if you are building the program in a Solaris 7 
(SunOS 5.5.1) environment, type:

        make sunos5 


This command may protest if it cannot find all of the OS' system utilities.
The programs nmblookup and smbclient are optional but SMB file/print
sharing tests will not be possible. Other 'protests' indicate that certain
SARA core tests will not be possible (e.g., showmount missing will limit
SARA's ability to detect open exports).

SARA does not find the WWW browser that you want to use, edit the
config/paths.pl file and change the line

       $MOSAIC="program_name";


RUNNING SARA

SARA supports three different operational modes:

1.  Local interactive execution:

    The mode is initiated by merely typing './sara'.  It will summons
    your Web browser on the SARA hosted machine (under normal 
    installations, this would be Netscape Communicator).  The operational
    functions can be initiated by clicking on the blue ball to the left
    of the command.  Refer to the 'Documentation' function for details
    on how to operate SARA in this mode.

    If you are using an older version of Netscape (e.g., 4.5.x or less),
    you may encounter problems when initiating many of the functions.
    Specifically, SARA may present a Open dialog box rather than the
    expected Web page.  For proper operation, Netscape must be configured
    to interpret SARA screens (often ending in .pl extensions) as html
    documents.  The Documentation (FAQ) provides the steps to properly
    configure Netscape for proper SARA operation.


2.  Command line execution:

    SARA can be directed to perform scans through the UNIX/Linux command
    line.  Refer to the Documentation or the SARA manual page (sara.8)
    for all of the command line options.


3.  Remote interactive execution:

    SARA can be controlled from a remote UNIX/Linux workstation.  This
    should be configured by an experienced UNIX/Linux administrator. 
    Details on this mode are available on the initial SARA page when you
    initiate SARA in interactive mode.

PROBLEMS

If you experience problems, please subscribe (http://www-arc.com/sara) to
the sara-l list server and post your problem. We continually monitor
this site.
     
