monkey/monkey/monkey_island

Monkey island dev. env. setup guide

To easily setup development environment for Monkey Island and the Monkey look into deployment scripts folder. If you want to setup dev. env. for Island manually, refer to the instructions below.

How to set up the Monkey Island server

On Windows

1. Exclude the folder you are planning to install the Monkey in from your AV software, as it might block or delete files from the installation.

2. Create folder "bin" under monkey\monkey_island

3. Place portable version of Python 3.7.4

   • Download and install from: https://www.python.org/ftp/python/3.7.4/

4. Install Island's requirements

   • python -m pip install -r monkey\monkey_island\requirements.txt

5. Setup mongodb (Use one of the following two options):

   • Place portable version of mongodb
     1. Download from: https://fastdl.mongodb.org/win32/mongodb-win32-x86_64-2012plus-4.2.1.zip
     2. Extract contents of bin folder to \monkey\monkey_island\bin\mongodb.
     3. Create monkey_island\db folder.

   OR

   • Use already running instance of mongodb
     1. Run 'set MONKEY_MONGO_URL="mongodb://:27017/monkeyisland"'. Replace '' with address of mongo server

6. Place portable version of OpenSSL

   • Download from: https://indy.fulgan.com/SSL/Archive/openssl-1.0.2p-i386-win32.zip
   • Extract contents to monkey_island\bin\openssl

7. Download and install Microsoft Visual C++ redistributable for Visual Studio 2017

   • Download and install from: https://go.microsoft.com/fwlink/?LinkId=746572

8. Generate SSL Certificate

   • run ./windows/create_certificate.bat when your current working directory is monkey_island

9. Put Infection Monkey binaries inside monkey_island/cc/binaries (binaries can be found in releases on github or build from source) monkey-linux-64 - monkey binary for linux 64bit monkey-linux-32 - monkey binary for linux 32bit monkey-windows-32.exe - monkey binary for windows 32bit monkey-windows-64.exe - monkey binary for windows 64bit

10. Install npm

    • Download and install from: https://www.npmjs.com/get-npm

11. Build Monkey Island frontend

    • cd to 'monkey_island\cc\ui'
    • run 'npm update'
    • run 'npm run dist'

How to run

1. When your current working directory is monkey_island, run monkey_island\windows\run_server_py.bat

On Linux

1. Get python 3.7 and pip if your linux distribution doesn't have it built in (following steps are for Ubuntu 16):

   • sudo add-apt-repository ppa:deadsnakes/ppa
   • sudo apt-get update
   • sudo apt install python3.7 python3-pip python3.7-dev
   • python3.7 -m pip install pip

2. Install required packages:

   • sudo apt-get install libffi-dev upx libssl-dev libc++1 openssl

3. Create the following directories in monkey island folder (execute from ./monkey):

   • mkdir -p ./monkey_island/bin/mongodb
   • mkdir -p ./monkey_island/db
   • mkdir -p ./monkey_island/cc/binaries

4. Install the packages from monkey_island/requirements.txt:

   • sudo python3.7 -m pip install -r ./monkey_island/requirements.txt

5. Put monkey binaries in /monkey_island/cc/binaries (binaries can be found in releases on github).

   monkey-linux-64 - monkey binary for linux 64bit

   monkey-linux-32 - monkey binary for linux 32bit

   monkey-windows-32.exe - monkey binary for windows 32bit

   monkey-windows-64.exe - monkey binary for windows 64bit

   Also, if you're going to run monkeys on local machine execute:

   • chmod 755 ./monkey_island/cc/binaries/monkey-linux-64
   • chmod 755 ./monkey_island/cc/binaries/monkey-linux-32

6. Setup MongoDB (Use one of the two following options):

   • Download MongoDB and extract it to monkey/monkey_island/bin/mongodb:
     1. Run ./monkey_island/linux/install_mongo.sh ./monkey_island/bin/mongodb. This will download and extract the relevant mongoDB for your OS.

   OR

   • Use already running instance of mongodb
     1. Run set MONKEY_MONGO_URL="mongodb://<SERVER ADDR>:27017/monkeyisland". Replace '' with address of mongo server

7. Generate SSL Certificate:

   • cd ./monkey_island
   • chmod 755 ./linux/create_certificate.sh
   • ./linux/create_certificate.sh

8. Install npm and node by running:

   • sudo apt-get install curl
   • curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -
   • sudo apt-get install -y nodejs

9. Build Monkey Island frontend

   • cd to 'monkey_island/cc/ui'
   • npm install sass-loader node-sass webpack --save-dev
   • npm update
   • npm run dist

How to run

1. When your current working directory is monkey, run chmod 755 ./monkey_island/linux/run.sh followed by ./monkey_island/linux/run.sh (located under /linux)