forked from p34709852/monkey
75 lines
2.3 KiB
Markdown
75 lines
2.3 KiB
Markdown
---
|
|
title: "Debian"
|
|
date: 2020-05-26T20:57:19+03:00
|
|
draft: false
|
|
pre: '<i class="fab fa-linux"></i> '
|
|
weight: 1
|
|
disableToc: false
|
|
tags: ["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:
|
|
|
|
```sh
|
|
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:
|
|
|
|
```sh
|
|
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:
|
|
|
|
```sh
|
|
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:
|
|
|
|
```sh
|
|
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](../../images/setup/export-configuration.png "Export configuration")
|
|
|