Home

Oneclick is supporting tool used to automate some of the workload when using EACirc Framework. Usually EACirc have to be executed in many different configurations and each configuration multiple times. After execution, the results from each workunit have to be processed into bigger picture. Doing this process by hand is time consuming and prone to errors. In answer to this, Oneclick was developed. Aim of this project is to do most of the mind-numbing work instead of researchers so that they can spend their time with researching things, not Bash scripts.

Currently Oneclick allows user to:

• Generate multiple different configuration files for EACirc based on simple rules.
• Generate scripts used for running of EACirc on remote server as well as scripts for download of results.
• Post-process output of multiple EACirc runs, detect errors or inconsistencies and give final result of whole run.

Oneclick User documentation

• Building Oneclick
  Build instructions for project under Windows and Linux systems.
• Prerequisites
  You will need to be able to run Perl scripts for upload and download of remote workunits.
• Running Oneclick
  Notes for running application from configuration files generation to result processing.
  • Configuration files and scripts generation
    How to generate configuration files and where to find them.
    • Configuration file options
      Setting up file for workunit generation, example configuration included and described.
  • Creating workunits on BOINC
    Using and modifying upload script, possible errors reviewed.
  • Downloading results from BOINC
    Description of download script, PHP script and assimilator.
  • Results processing
    How to process results and interpret them, described post-processors.

Oneclick developer notes

• Output files and logs
  Described output files and their location and how to change default directories.
• Adding Oneclick components
  How to add or modify Oneclick code.
• Oneclick@Centaur
  Result processing directly at server. No need for downloading.
• Additional libraries and dependencies
  Third party libraries used in project, dependency on EACirc project.

Authors and licence

The framework is developed at the Centre for Research on Cryptography and Security, Masaryk University, Brno, Czech Republic. It's licensed under MIT licence, see the file in the repository root. The project uses some third party code, licence details for these parts can be found in the LicenceReadMe file in the repository root.

• Petr Švenda
  2014-now (Project lead)
• Ľubomír Obrátil
  2014-now (Development)

For the contributors to EACirc Framework see here.