monkey/docs/content/setup/debian.md

2.3 KiB
Raw Blame History

title date draft pre weight disableToc tags
Debian 2020-05-26T20:57:19+03:00 false <i class="fab fa-linux"></i> 1 false
setup
debian
linux

Deployment

To extract the tar.gz file, run tar -xvzf monkey-island-debian.tar.gz.

Once you've extracted the package, deploy it using run the following commands:

sudo apt update
sudo dpkg -i monkey_island.deb  # this might print errors

If, at this point, you receive dpkg printed errors that look like this:

dpkg: error processing package gc-monkey-island (--install):
    dependency problems - leaving unconfigured
Errors were encountered while processing:
    gc-monkey-island

It just means that not all dependencies were pre-installed on your system. Thats no problem! Just run the following command, which will install all dependencies, and then install the Monkey Island:

sudo apt install -f

Troubleshooting

Trying to install on Ubuntu <16.04

If youre trying to install the Monkey Island on Ubuntu 16.04 or older, you need to install the dependencies yourself, since Python 3.7 is only installable from the deadsnakes PPA. To install the Monkey Island on Ubuntu 16.04, follow these steps:

sudo apt update
sudo apt-get install libcurl4-openssl-dev
sudo apt-get install software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt-get update
sudo apt-get install python3.7-dev python3.7-venv python3-venv build-essential
sudo dpkg -i monkey_island.deb  # this might print errors
sudo apt install -f

The Monkey Island interface isn't accessible after installation

To check the status of the Monkey Island after the installation, run the following command: sudo service monkey-island status.

Upgrading

Currently, there's no "upgrade-in-place" option when a new version is released. To get the updated version, download the new .deb file and install it. You should see a message like Unpacking monkey-island (1.8.2) over (1.8.0). After which, the installation should complete successfully.

If you'd like to keep your existing configuration, you can export it to a file using the Export config button and then import it to the new Monkey Island.

Export configuration