What is Peach
Installing
Tutorials
Methodology
Introduction
FAQ
Peach 3
Peach Pits
 General Conf
 Data Modeling
 State Modeling
 Agents
  Monitors
 Test
  Publishers
  Loggers
Running
Minset
Peach 2.3
License

Installing Peach 2

For Peach 3 installation instruction click here.

The following sections list the steps needed to install Peach on different operating systems. Peach is written in Python and should run on any system that has a Python v2.5 run time. For Window users there is a pure binary release.

Windows

Binary Version of Peach

  1. Install Debugging Tools for Windows (download).

  2. Run the Peach installer (x86 download, x64 download)

If you would like to enable network captures when fuzzing network protocols then also install Wireshark or Winpcap.

Latest Source Version of Peach

  1. Install ActiveState Python v2.7 (32bit or 64bit)

  2. Install Debugging Tools for Windows (download or just installer).

  3. Install SVN client such as TortoiseSVN.

  4. Checkout source code from http://peachfuzz.svn.sf.net/svnroot/peachfuzz/branches/Peach2.3

  5. Install dependencies from "peach\dependencies\py2.7-???" (32bit or 64bit as needed)

  6. Verify install is working by:

  7. Run "peach samples\HelloWorld.xml" and verify no errors.

  8. Run "peach samples\DebuggerWindows.xml". You may need to provide the WinDbg path to the two monitors.

If you would like to enable network captures when fuzzing network protocols then also install Wireshark or Winpcap.

Known Issues

In the x64 version of Peach, the Peach Validator tool does not work. This is a known issue that will hopefully be resolved in the future.

OS X

Peach has excellent support for fuzzing on OS X with the exception of the Peach Validator GUI program which can be hard to get working.

  1. Install XCode from your OS X install DVD

  2. Download and compile Crash Wrangler from Apple. NOTE: If you move Crash Wrangler to another Apple, you will need to recompile.

  3. Download Peach source from here

  4. Install all required dependencies. The minimum set of dependencies is: 4Suite, cDeepCopy, cPeach, Zope, and Twisted. The source to them is provided in the dependencies/src folder.

  5. Change your Crash Reporter preferences to "Server." This will stop those annoying crash dialogs from popping up. There is a preferences utility included with XCode.

There are two choices for detecting faults on OS X. The preferred method is using Crash Wrangler, the other option is Crash Reporter.

Linux/Unix

  1. Install Python 2.5 (2.6 is OK)

  2. Download Peach source from here

  3. Install all required dependencies. The source to them is provided in the dependencies/src folder. For wxPython I recommend you install the OS X package available from the development site.

The UnixDebugger required vdb or vdebug module included with the dependencies. There is now a BETA Crash Reporter monitor for OS X. You will need to change the Crash Reporter settings to "Server" mode to avoid those pop-ups.

GUI Applications

Peach has a GUI application Peach Validator that uses wxWidgets and wxpython. I have had some issues getting these running well under OS X. YMMV. Peach will still run in console mode w/o these GUI’s.