Support

Umit
Want to learn more about Umit?

• F.A.Q.
• Download
• Screenshots
• Documentation
• Installation

Linux

1. Dependencies
2. Available installation packages
3. Install from source package
4. Install from subversion repository

Windows

1. Dependencies
2. Available installation packages
3. Install from source package
4. Install from subversion repository
5. Install from binary installer
6. Install from binary installer (Full version)

---

Linux

1. Dependencies

Before install Umit in your Linux box, check if the following dependencies are met:

• Nmap 3.95 or greater (latter versions may work, but they are not recommended)
• Python 2.4 or greater
• GTK 2.6 or greater
• PyGTK 2.6 or greater
• PySQLite 2 or greater
• Psyco 1.5 or greater (plus)

If you're not sure that you have everything installed, run this script to check it.
To run this script, download it and follow these steps:

1. Open a terminal (xterm or gnome-terminal, for example)
2. Go to the directory where you downloaded the script, using the cd command
3. Change the file permissions with the following command: chmod a+x linux_check.sh
4. Execute the script: ./linux_check.sh
5. The first block shows the versions of the dependencies already installed in your system. If everything ran ok, a second block will be shown with a list of required versions to run Umit. Compare the first block versions with the second one. If the first block meets the requirements, you're ok to run Umit.
6. If the second block didn't appear, it means that a dependency check has failed and you can't run Umit yet. Install the failed dependencies, and run the script again to verify if everything is ok.

If you find that something is missing, you can follow the steps above, accordingly to your Linux distribution:

Debian based distros (Debian, Ubuntu, etc.)

1. Open a terminal with root user
2. Update your apt-get database:
   apt-get update
3. Install the needed packages:
   apt-get install nmap python2.4 python2.4-gtk2 python2.4-pysqlite2 python2.4-psyco

Red Hat based distros and others (Red Hat Enterprise, Fedora, Mandrake, SuSE, etc.)

As there is no default automatic installer for every distros, try one or more of the instructions bellow:

• Check if your distro have a yum repository. If it does, try to install the dependencies using it
• Try to find the dependencies packages at http://www.rpmfind.net
• Try to find the dependencies packages at each project web sites
• Try to install the dependencies using source packages provided by projects web sites, using the projects web site list that follows

Projects web sites

• Nmap: http://www.insecure.org/nmap
• Python: http://www.python.org
• GTK: http://www.gtk.org
• PyGTK: http://www.pygtk.org
• PySQLite 2: http://initd.org/tracker/pysqlite
• Psyco: http://psyco.sourceforge.net

2. Available installation packages

Currently, there's no special package for Linux (no deb nor rpm packages). To install Umit in a Linux box, download the source package and follow the installation instructions.

3. Install from source package

The source package is available compressed in the following formats:

• zip
• tar gz
• tar bz2

Pick your preferred one, and follow the steps bellow:

1. Check if your system meets the installation dependencies
2. Extract the source package inside your home directory, following the instructions bellow according to the downloaded package format:
   
   
   • Zip: unzip umit-0.7.1.zip
   • Tar GZ: tar -xzbf umit-0.7.1.tar.gz
   • Tar BZ2: tar -xjvf umit-0.7.1.tar.gz
   
   By extracting the source package, you'll get a directory named umit inside the current working directory.
3. With root user go inside the recently created directory named umit using the cd command: "cd umit" and execute: "python setup.py install"
4. No installation errors means that Umit was sucessfully installed. Run it by typing umit.pyw

4. Install from subversion repository

The Umit repository has anonynous read access permission. If you wish to get the lastest revision and install it for testing purposes, follow the steps bellow:

1. Check if your system meets the installation dependencies
2. Check if you have subversion installed, by trying to run the svn help command.
3. Export the latest Umit repository revision: svn export https://svn.sourceforge.net/svnroot/umit
4. The command above creates a directory named umit in the current working directory with the exported umit source code.
5. With root user go inside the recently created directory named umit using the cd command: "cd umit" and execute: "python setup.py install"
6. An error message here means two things: an installation error occourried (like failed dependencies) or the exported revision is not working.

PS: Exporting the latest revision is recomended for testing purposes only. If you do so, you will certainly find bugs or won't be able to run Umit properly, because you're going to get an unstable development version.

---

Windows XP/2000/2003

1. Dependencies

Before install Umit in your Windows box, check if the following dependencies are met:

• Nmap 3.95 or greater (latter versions may work, but were not tested)
• Python 2.4 or greater
• GTK 2.6 or greater
• PyGTK 2.6 or greater
• PySQLite 2 or greater
• Psyco 1.5 or greater (plus)

If you don't have some or any of then installed, you can visit the projects web sites and follow each project installation instructions.

Projects web sites

• Nmap: http://www.insecure.org/nmap
• Python: http://www.python.org
• GIMP-WIN (GTK for Windows): http://gimp-win.sourceforge.net
• PyGTK for Windows: http://www.pcpm.ucl.ac.be/~gustin/win32_ports
• PySQLite 2: http://initd.org/tracker/pysqlite
• Psyco: http://psyco.sourceforge.net

Quick list of installers

• Nmap: http://download.insecure.org/nmap/dist/nmap-4.11-setup.exe
• Python: http://www.python.org/ftp/python/2.4.3/python-2.4.3.msi
• GTK: http://prdownloads.sourceforge.net/gimp-win/gtk+-2.8.18-setup-1.zip?download
• PyGTK: http://www.pcpm.ucl.ac.be/~gustin/win32_ports/binaries/pygtk-2.8.6-1.win32-py2.4.exe
• PyCairo: http://www.pcpm.ucl.ac.be/~gustin/win32_ports/binaries/pycairo-1.0.2-1.win32-py2.4.exe
• PySQLite 2: http://initd.org/pub/software/pysqlite/releases/2.3/2.3.2/pysqlite-2.3.2.win32-py2.4.exe
• Psyco: http://sourceforge.net/project/showfiles.php?group_id=41036

2. Available installation packages

There are two installers available for Windows:

• Umit and Higwidgets: Installer ideal for those who already have all dependencies installed
• Umit, Higwidgets and Other dependencies bundled: Installer ideal for those who doesn't have some or any of the required dependencies. It's a larger instaler, but it comes with umit, higwidgets, nmap, python, gtk, pygtk, pysqlite2 and psyco.

Beyond the installers above, you can install umit through a source package or by exporting the svn repository.

3. Install from source package

To proceed with an installation from a source package, you must be sure that you already have installed all required dependencies. Without then, Umit is not going to work.

For Windows boxes, it's recommended to download the source package compressed with ZIP. The others (Tar GZ and BZ2) need special programs to be extracted, and Windows XP/2000/2003 can handle ZIP files without any aditional program.

Here follows the steps for a source installation at Windows:

1. Extract the source package at your home directory (usually called "My Documents")
2. Click on the start menu, and then select Run...
3. Run the following command, and a terminal will be displayed: cmd
4. Go inside the umit directory created at the extraction process inside your home directory
5. Type: python setup.py install

PS: If you got a command not found error, check if python is in your PATH environment variable.
PS2: Installing Umit from source at windows is recommended only for advanced users.

4. Install from subversion repository

First, install a SVN client. I recommend Tortoise SVN.

With a SVN client properly installed, export the latest umit revision from it's repository. If you decided to use Tortoise SVN, follow these steps:

1. Open Windows Explorer
2. Go inside your home directory (usually called "My Documents")
3. Right-click inside the directory, and choose TortoiseSVN->Export. An export dialog will be shown.
4. At URL of repository, put https://svn.sourceforge.net/svnroot/umit
5. Choose Head revision and click Ok
6. Wait until the end of the export process
7. Click on the start menu, and then select Run...
8. Run the following command, and a terminal will be displayed: cmd
9. Go inside the umit directory created by the export process inside your home directory
10. Type: python setup.py install

PS: If you got a command not found error, check if python is in your PATH environment variable.
PS2: Installing Umit from repository at windows is recommended only for advanced users.

5. Install from binary installer (Umit and Higwidgets only)

Be sure that you have installed all required dependencies before running this installer. After checking dependencies, double-click over the installer file, and follow the instructions.

6. Install from binary installer (Full version)

This installer consider that you don't have any dependency installed. Just double-click over the installer file, and follow the instructions.