root/branches/nondb/INSTALL @ 453

Revision 453, 4.6 KB (checked in by arthur, 6 years ago)

Update INSTALL for Centos based cdrom

  • Property svn:keywords set to Id
Line 
1INSTALLYING HONEYSNAP
2=====================
3
4This document explains step by step how to install
5Honeysnap, including all dependencies.  Suggestions
6for this document, or Honeysnap in general should be
7sent to <honeysnap@honeynet.org>.  This document is
8broken down into the following parts.
9
101: Dependencies
112: Installation on a Linux/Unix/OS X Workstation
123: Installation on Windows
134: Installation on a Honeywall
145: Running Honeysnap
15
16
171. DEPENDENCIES
18================
19
20General Dependencies
21 Python 2.4 or greater      http://www.python.org
22 libpcap                    http://sourceforge.net/projects/libpcap/
23 pypcap 1.1 or greater      http://code.google.com/p/pypcap/
24
25Pure python modules:
26 irclib 0.4.6 or greater    http://python-irclib.sourceforge.net/
27 dpkt                       http://code.google.com/p/dpkt/
28 magic                      http://www.demonseed.net/~jp/code/magic.py
29
30This latter set should be installed automatically and are listed
31here for completeness.
32     
332: INSTALLATION ON UNIX
34========================
35
36First, you will need to install python 2.4 or 2.5 and its header file.  Most
37distributions most likely already have this installed.  Then you will
38need libpcap.  For most UNIX-like systems, it should be in your package
39management system (apt-get, yum, DarwinPorts etc.).  You will need libcap
40and also libpcap-devel if that is listed separately.  For example, on
41Debian/Ubuntu with python2.4:
42
43  $ sudo apt-get install python2.4-dev
44  $ sudo apt-get install libpcap0.8 libpcap0.8-dev
45
46Get pypcap from http://www.honeynet.org/tools/honeysnap/pypcap-1.1.tar.gz
47
48This version is the same as the one from Dug Song's site, but with the
49installer altered to install cleanly on linux and on python 2.5.
50                             
51$ wget http://www.honeynet.org/tools/honeysnap/pypcap-1.1.tar.gz
52$ tar xvzf pypcap-1.1.tar.gz
53$ cd pcap-1.1
54$ sudo python setup.py install
55
56You should then be able to install Honeysnap and all its remaining
57dependencies (provided you have a network connection).
58E.g. for version 1.0.6:
59
60  $ tar xvzf honeysnap-1.0.6
61  $ cd honeysnap-1.0.6
62  $ sudo python setup.py install
63
64If you already have easy_install installed, you can simplify the
65installation process further by simply executing the following.
66
67  $ sudo easy_install http://www.honeynet.org/tools/honeysnap/pypcap-1.1.tar.gz
68  $ sudo easy_install honeysnap-1.0.6.tar.gz
69
70This is exactly the same as untar'ing the distribution and
71running 'sudo python setup.py install'
72
73Please note that this will install the honeysnap script into your
74PATH, usually in /usr/bin. If this isn't what you want, specify
75--script-dir. e.g
76
77$ sudo easy_install --script-dir /usr/local/bin honeysnap-1.0.6.tar.gz
78
793: INSTALLATION ON WINDOWS
80==========================
81
82Download  and install the following, in order.
83
84  * Python 2.4 (from http://www.python.org/download). You can install
85  from the Windows MSI installer linked from that page.
86
87  * winpcap from
88  http://www.winpcap.org/install/default.htm 
89       
90  * pypcap from http://code.google.com/p/pypcap/downloads/list
91  You need to download and run the Windows installer for your
92  version of Python (2.4 in our example)
93
94To make Python easily available on the command line, right click
95on "My Computer" and select Properties. Then go to Advanced and
96choose Environment Variables. Add to the end of the PATH variable
97
98 ;C:\Python24;C:\Python24\Scripts
99
100(assuming you installed Python to the default location). If you
101don't already have setuptools installed, you'll need to download
102ez_setup.py from
103
104  http://peak.telecommunity.com/dist/ez_setup.py
105
106and run it. This will install easy_setup. Finally run
107
108  easy_install honeysnap-1.0.6.zip
109                                                   
110This should download and install honeysnap and all its
111dependencies.
112                 
1134: INSTALLATION ON A HONEYWALL
114==============================
115
116Note: These instructions apply to version 1.3 of the Honeywall
117and later only.
118                 
119i) yum install pcap
120
121ii) Install honeysnap (e.g. version 1.0.6):
122
123$ wget http://www.honeynet.org/tools/honeysnap/honeysnap-1.0.6.tar.gz
124$ tar xvzf honeysnap-1.0.6
125$ cd honeysnap-1.0.6
126$ sudo python setup.py install
127
128ii) Test!
129
130$ honeysnap --version
131
132
1335: Running honeysnap
134====================
135Try to execute 'honeysnap':
136
137  $ honeysnap
138
139You should see:
140                               
141usage: honeysnap [options]
142
143options:
144  --version             show program's version number and exit
145  -h, --help            show this help message and exit
146  [.... more options snipped....]
147
148  Please see the accompanying documentation for instructions on
149  configuration.
150
151       
Note: See TracBrowser for help on using the browser.