lmco / laikaboss

Laika BOSS: Object Scanning System
Apache License 2.0
732 stars 155 forks source link

Complete overhaul of README and integration into Wiki #61

Open askkemp opened 7 years ago

askkemp commented 7 years ago

Using a minimal install of CentOS 7.3, I updated the installation instructions in the Readme for the CentOS section.

marnao commented 7 years ago

@Langhorne thanks for this!

Before I merge, have you tried using pip to install pefile?

askkemp commented 7 years ago

@marnao I went back and tested the manually installed pefile module (pefile-2016.3.28-py2.7). I tested it against PuTTY.exe Found out that META_PE had an exception.

I then removed it pip uninstall pefile==2016.3.28 (which seems to have worked) and then pip installed it which gave me pefile-2016.3.28-py2.7. A rescan of the EXE had NO errors.

So it appears that pip install pefile is the best option.

marnao commented 7 years ago

nice! can you update the instructions to reflect that please?

askkemp commented 7 years ago

I used the web gui so I think I made the change correctly.

marnao commented 7 years ago

It looks like you added this to yum install instead of pip install

askkemp commented 7 years ago

I'm redoing it all again and I don't think the below are needed:

yum install autoconf automake libtool swig

Thoughts?

Here is what I have now:

Installing on CentOS

Based on installation from a CentOS 7.3 minimun installation

  1. Install framework dependencies:

    sudo yum install -y epel-release
    sudo yum install -y python-pip python-zmq python-devel gcc
    sudo pip install gevent interruptingcow yara-python 

    If you want to use the Suricata integration prototype, then also 'pip install redis'

  2. Install Laika BOSS scanning module dependencies

    sudo yum install openssl-devel ssdeep-devel libffi-devel
    sudo pip install cffi six IPy fluent-logger javatools m2crypto olefile pylzma pyclamd py-unrar2 pexpect pefile ssdeep
    1. Install pyexif

pyexif is a Python library to communicate with the ExifTool command-line application. Install ExifTool application following instructions at http://www.sno.phy.queensu.ca/~phil/exiftool/install.html#Unix.

```shell
Install Exiftool application (see above sentence)
sudo yum install perl-devel
wget https://github.com/smarnach/pyexiftool/archive/master.zip
unzip master.zip
sudo python setup.py build
sudo python setup.py install
```

You may need to set the LD_LIBRARY_PATH variable to include /usr/local/lib when running Laika.

askkemp commented 7 years ago

I overhauled the README and connected parts to the wiki.