Installation

System Requirements and Dependencies

  • A Java Virtual Machine 1.8. Bjoern is written in Java 8 and does not build with Java 7. It has been tested with OpenJDK 8 but should also work with Oracle’s JVM.
  • Radare2 The primitives provided by the radare2 reverse engineering framework are employed to dissect and analyze binary files to obtain graph-based program representations from them.
  • OrientDB 2.1.5 Community Edition. The bjoern-server is based on OrientDB version 2.1.5 and has not been tested with any other version. You can download the correct version here .
  • Bjoern-shell [Optional. ] The bjoern-shell is a convenient tool to query the database contents and develop new query-primitives (so-called steps) that can be re-used in subsequent queries.

Installing radare2

Please follow the instructions here to install radare2, and make sure the programs radare2 and r2 are in the path.

Building bjoern (step-by-step)

git clone https://github.com/fabsx00/bjoern
cd bjoern
gradle deploy

Installing the bjoern-shell

git clone https://github.com/a0x77n/bjoern-shell
cd bjoern-shell
python3 setup.py install
bjosh