monkey/debian.md at bc1f583e20d58083057b1b22e3623e5a1dffa3f7

2.7 KiB

Raw Blame History

title

date

draft

pre

weight

disableToc

Supported Distros

This Debian package has been tested on Ubuntu Bionic 18.04 LTS and Ubuntu Focal 20.04 LTS.

Deployment

Update your package list by running:
```
sudo apt update
```

If you are using Ubuntu Focal 20.04, run the following commands to install Python 3.7:

sudo apt install software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt install python3.7 python3.7-dev

Extract the tarball by running:
```
tar -xvzf monkey-island-debian.tgz
```

Install the Monkey Island Debian package:

sudo dpkg -i monkey_island_deb.deb  # this might print errors

If, at this point, you receive dpkg 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. That's 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 you're 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.

2.7 KiB Raw Blame History