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
- Download the simulator:
- PeerfactSim.KOM – Community Edition – version used in University of Paderborn / Heinrich-Heine-University of Düsseldorf
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
- Visit the Forum and check for answers:
Running a simulation
Run the simulator with GUI
- In the simulators main folder: runGUI.bat or runGui.sh
- 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: run.sh 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.