home *** CD-ROM | disk | FTP | other *** search
/ Collection of Hack-Phreak Scene Programs / cleanhpvac.zip / cleanhpvac / SATAN11.ZIP / README < prev    next >
Text File  |  1995-04-11  |  2KB  |  58 lines
  1.  
  2. In order get things up and running,
  3.  
  4. - You need a UNIX system to run SATAN. In order to unpack the SATAN
  5.   archive,
  6.  
  7.     compress -d <satan-X.X.tar.Z | tar xvf -
  8.  
  9. - You will need PERL 5.000 or better (perl5 alpha is NOT good enough),
  10.   and a WWW browser (Netscape, Mosaic, or Lynx). SATAN looks a lot
  11.   better on a color display. The FAQ gives hints for MONO screens.
  12.  
  13. - When you collect or view data about hundreds of hosts you will need a
  14.   machine with enough CPU power (sparc5, indy, or better) and memory
  15.   (32 MB or better).
  16.  
  17. - Run the "reconfig" script. It will patch some scripts with the
  18.   pathnames of your PERL 5 executable, and of your WWW browser.  If
  19.   SATAN does not find the WWW browser that you want to use, edit the
  20.   config/paths.pl file and change the line 
  21.  
  22.     $MOSAIC="program_name";
  23.  
  24.   to whatever browser you prefer (make sure to preserve the quotation
  25.   marks and punctuation of the line.)
  26.  
  27. - Run the "make" command. It will ask you to specify a system type.
  28.   Most mainstream system types are provided. 
  29.  
  30. - When your network lies behind a firewall, you should unset your proxy
  31.   environment variables (such as $http_proxy $file_proxy, $socks_ns,
  32.   etc.) and/or change your browser configuration to not use your SOCKS
  33.   host or HTTP Proxy (see your HTML browser's option section.)
  34.  
  35. - Run the "satan" script. When run without arguments, it will start up
  36.   a WWW browser. The command-line interface is described in the satan.8
  37.   manual page ("nroff -man" format). You must run SATAN as superuser if
  38.   you want to collect data.
  39.  
  40. - You can run multiple SATAN processes in parallel to speed up data
  41.   collection, but each process should be given its own database (via
  42.   the "-d" command-line option). We use one SATAN database per block of
  43.   256 addresses (satan -d x.x.x x.x.x). After data collection you can
  44.   merge SATAN databases in core with the HTML browser (see the
  45.   documentation on scanning and databases for more on this.) Parallel
  46.   code and sharing of databases will come at a later date.
  47.  
  48. - Use your browser's PRINT button to print reports.
  49.  
  50. Most documentation is accessible via your WWW browser. 
  51.  
  52. Last but not least, SATAN was written to improve Internet security.
  53. Don't put our work to shame.
  54.  
  55.     Wietse Venema / Dan Farmer 
  56.         (satan@fish.com)
  57.  
  58.