Installation

Choose and initialize the storage system:

Local storage can be used in conjunction with NFS mounts to store backups off nodes. The backup directory must be accessible from all nodes in the cluster and mounted appropriately. If the backup folder is not shared, the nodes will only see their own backups.
Google Cloud Storage setup
AWS S3 setup
Ceph Object Gateway S3 API
Azure Blob Storage setup
IBM Cloud Object Storage setup
MinIO/S3 compatible Storage setup

Install Medusa on each Cassandra node using one of the following methods.

Using pip

if the storage backend is a locally accessible shared storage, run sudo pip3 install cassandra-medusa
if your backups are to be stored in AWS S3 or S3 compatible backends (IBM, OVHCloud, MinIO, ...), run sudo pip3 install cassandra-medusa[S3]
if your backups are to be stored in Google Cloud Storage, run sudo pip3 install cassandra-medusa
if your backups are to be stored in Azure Blob Storage, run sudo pip3 install cassandra-medusa[AZURE]

Running the installation using sudo is necessary to have the /usr/local/bin/medusa script created properly.

If your Cassandra servers do not have internet access:

on a machine with the same target OS and Python version, clone the cassandra-medusa repo and cd into the root directory
run POETRY_VIRTUALENVS_IN_PROJECT=true poetry install to install Medusa's dependencies
run poetry run pip freeze | grep -v cassandra-medusa > requirements.txt to identify the dependencies
run mkdir -p medusa_dependencies && pip download -r requirements.txt -d medusa_dependencies to download the dependencies into a sub directory
run tar --exclude=".venv" -zcf medusa.tar.gz . to compress Medusa together with its dependencies but without Poetry's venv
upload the archive to all Cassandra nodes and decompress it (mkdir -p cassandra-medusa && tar xf medusa.tar.gz -C cassandra-medusa)
install Medusa's dependencies using pip install --no-index --find-links medusa_dependencies -r requirements.txt
install medusa itself using a command similar to poetry build && pip install dist/cassandra_medusa-<version>-py3-none-any.whl
test if the installation was successful by running medusa

install RPM pre-requisites sudo yum install -y python3-pip python3-devel
install pipenv sudo pip3 install pipenv
unpack your archive built using the procedure from previous section
create your python env in the directory previously created cd cassandra-medusa && pipenv --python 3
install python dependencies of medusa pipenv run pip3 install -r requirements.txt --no-index --find-links medusa_dependencies/
prepare an installation directory with appropriate privileges sudo mkdir /opt/cassandra-medusa ; sudo chmod go+rwX /opt/cassandra-medusa
build Medusa using pipenv run pip3 install poetry && poetry build
install medusa as non-root user pipenv run pip3 install dist/cassandra_medusa-0.20.0.dev0-py3-none-any.whl --no-index --find-links medusa_dependencies
test if the installation was successful by running pipenv run medusa

1/ Using the command line, run the following:

curl -1sLf \
  'https://dl.cloudsmith.io/public/thelastpickle/medusa/setup.deb.sh' \
  | sudo -E bash

In case of problem, read the full instructions on the cloudsmith.io documentation

Note: since Medusa 0.9 we publish releases for Ubuntu bionic and focal only.

2/ Install Medusa :

sudo apt-get update
sudo apt-get install cassandra-medusa

4/ (optional) Install the storage dependencies

if your backups are to be stored in Azure Blob Storage, run sudo apt-get install azure-cli
if your backups are to be stored in Google Cloud Storage, follow this quickstart guide from Google.