| 1 | Introduction |
|---|
| 2 | |
|---|
| 3 | Umit is a network scanning frontend. |
|---|
| 4 | |
|---|
| 5 | Umit is developed in the Python programming language, and its |
|---|
| 6 | interface is built with the GTK Toolkit. It's also worth to mention |
|---|
| 7 | that the initial development is sponsored by Google's Summer of Code. |
|---|
| 8 | |
|---|
| 9 | The project goal is to develop a network scanning frontend that is really |
|---|
| 10 | useful for advanced users and easy to be used by newbies. With Umit, a |
|---|
| 11 | network admin can create scan profiles for faster and easier network |
|---|
| 12 | scanning and even compare scan results to easily see any changes. New |
|---|
| 13 | users can also construct powerful scans with Umit command creator |
|---|
| 14 | wizard. |
|---|
| 15 | |
|---|
| 16 | Installation |
|---|
| 17 | |
|---|
| 18 | Umit is available for multiple platforms. It has been successfully |
|---|
| 19 | tested on the following platforms/flavors: |
|---|
| 20 | * Ubuntu 5.04 Hoary Hedgeog |
|---|
| 21 | * Red Hat Enterprise Linux 4 |
|---|
| 22 | * OpenBSD 3.7 |
|---|
| 23 | * Microsoft Windows 2000 |
|---|
| 24 | * Microsoft Windows XP |
|---|
| 25 | * Apple MacOS X 10.4 (Tiger) |
|---|
| 26 | |
|---|
| 27 | The installation instructions are somewhat different for each |
|---|
| 28 | platform. |
|---|
| 29 | |
|---|
| 30 | Default (source) Installation |
|---|
| 31 | |
|---|
| 32 | The Umit's source package are provided in such a way that, if you have |
|---|
| 33 | all the required software, it will run 'out-of-the-tarball'. |
|---|
| 34 | |
|---|
| 35 | The list of required software follows: |
|---|
| 36 | * [1]Python 2.4 or higher |
|---|
| 37 | * [2]GTK+ 2.6 or higher |
|---|
| 38 | * [3]PyGTK 2.6 or higher |
|---|
| 39 | * [4]nmap itself and its requirements |
|---|
| 40 | * [5]PySQLite2 |
|---|
| 41 | * [10]Psyco (optional) |
|---|
| 42 | |
|---|
| 43 | After unpacking the source distribution do one of the following: |
|---|
| 44 | * Double click the umit file |
|---|
| 45 | * Call the Python interpreter on the umit file |
|---|
| 46 | |
|---|
| 47 | GNU/Linux Installation |
|---|
| 48 | |
|---|
| 49 | Unpack the source package, and get inside the extracted directory. |
|---|
| 50 | |
|---|
| 51 | # Extracting gziped tarball |
|---|
| 52 | $ tar xvzf umit-0.9.1.tar.gz |
|---|
| 53 | |
|---|
| 54 | # Extracting bziped tarball |
|---|
| 55 | $ tar xvjf umit-0.9.1.tar.bz2 |
|---|
| 56 | |
|---|
| 57 | # Extracting ziped source |
|---|
| 58 | $ unzip umit-0.9.1.zip |
|---|
| 59 | |
|---|
| 60 | |
|---|
| 61 | After extracting the sources, get inside the extracted dir: |
|---|
| 62 | $ cd umit-0.9.1 |
|---|
| 63 | |
|---|
| 64 | And then, run the command bellow as root: |
|---|
| 65 | # python setup.py install |
|---|
| 66 | |
|---|
| 67 | |
|---|
| 68 | This should be enough to get Umit installed. |
|---|
| 69 | To run Umit: |
|---|
| 70 | $ umit |
|---|
| 71 | |
|---|
| 72 | |
|---|
| 73 | If you want to define the path where Umit should be installed, do: |
|---|
| 74 | $ python setup.py install --prefix /path/to/umit_dir |
|---|
| 75 | |
|---|
| 76 | After that, put the /path/to/umit_dir/bin directory created in your PATH: |
|---|
| 77 | $ export PATH=$PATH:/path/to/umit_dir/bin |
|---|
| 78 | |
|---|
| 79 | Or, put line above inside your ~/.bash_profile, ~/.bashrc or ~/.profile |
|---|
| 80 | (depending on your system) and this will get executed everytime you login. |
|---|
| 81 | After putting the bin directory in the PATH, execute Umit: |
|---|
| 82 | $ umit.pyw |
|---|
| 83 | |
|---|
| 84 | |
|---|
| 85 | Microsoft Windows Installation |
|---|
| 86 | |
|---|
| 87 | For the Microsoft Windows platform, ready to run installers are |
|---|
| 88 | available. Download them from the [6]Umit website. |
|---|
| 89 | |
|---|
| 90 | |
|---|
| 91 | Links: |
|---|
| 92 | |
|---|
| 93 | [1] Python official website - http://www.python.org |
|---|
| 94 | [2] GTK official website - http://www.gtk.org |
|---|
| 95 | [3] PyGTK official website - http://www.pygtk.org |
|---|
| 96 | [4] Nmap official website - http://www.insecure.org/nmap |
|---|
| 97 | [5] PySQLite2 official website - http://initd.org/tracker/pysqlite |
|---|
| 98 | [6] Umit website - http://www.umitproject.org |
|---|
| 99 | [9] Umit blog - http://blog.umitproject.org |
|---|
| 100 | [10] Pysco website - http://psyco.sourceforge.net |
|---|
