IThis website contains all relevant code, documentation and tips to get started with PeerfactSim.KOM, a wonderful tool to evaluate large-scale peer-to-peer systems.

Quick Start Guide

This guide gives information on how to download, setup, run and practically use the simulator.

The corresponding howto – video and further documentations and guides can be found on the documentation page.

 Download and Setup

Preparation steps

  • Install Java JDK 1.8
  • (Install Eclipse)

Download the simulator

Unzip and place the files

  • Unzip all files
  • Copy the simulator folder in your Eclipse workspace

Create and compile the simulator project

  • Open Eclipse
  • File – New Project – Java – Java Project
  • Type in the name of the simulator folder
  • Clicking “Next” / “Finish” creates the project
  • Right click on the new project – Build project
  • Once the code is built, the simulator is ready to use

If you have questions

Running a simulation

Run the simulator with GUI

  • In the simulators main folder: runGUI.bat or
  • Pick a simulation config file – Start

Run the simulator within Eclipse

  • Open Run Configurations – New Java Application
    • Name: <as you wish>
    • Project: <the PeerfactSim.KOM project>
    • Main class: org.peerfact.GUIRunner
  • Select a configuration in the GUI – Start
    • (e.g. /config/visualization/chord.xml)

Run the simulator from the console

  • Under Windows: run.bat config\visualization\chord.xml
  • Under Linux/Mac: config/visualization/chord.xml

Further running modes (including a batch mode for comparative evaluations) are available, please see the detail introduction in the guide.

Observing the simulation results

Using the visualization environment

  • Start the visualization with the Play-button and adjust the visualization speed with the buttons at the top
  • Turn metrics and information on an off at the left side of the screen
  • Use the simulation time slider at the bottom to jump back an forth

Obtaining figures for papers using gnuplot

  • All simulated and monitored layers log their results in the “/outputs”-folder of the simulator
  • These files are typically comma separated value (csv) fields, easily plotable with gnuplot
  • Fitting gnuplot-scripts come together with the results, run them on the csv-files, obtain pdf figures for your papers


For more information on how to use PeerfactSim.KOM – have a look at the documentation corner.

Comments are closed.