Skip to main content
Version: 0.0.6

CLI Reference

mass-ctl is the client-side CLI tool for mounting volumes and managing the local environment. It must be installed on client machines that need to access storage.

Installation​

mass-client is distributed through the MangoBoost package repository at repo.mangoboost.io. Before installing it, register the repository on the client machine.

info

You need repository credentials (username and password) issued by MangoBoost. Contact your MangoBoost representative if you do not have them.

Install on Ubuntu / Debian

1. Register the MangoBoost APT repository

sudo su -
apt update
apt install -y curl gpg lsb-release

# Import the MangoBoost signing key
curl https://repo.mangoboost.io/artifactory/api/security/keypair/mb-gpg/public \
| gpg --dearmor \
| tee /etc/apt/trusted.gpg.d/mango-sdk.gpg > /dev/null

# Replace the two values below with the credentials provided by MangoBoost
export MANGO_GUEST_NAME=<your-mangoboost-username>
export MANGO_GUEST_PASSWORD=<your-mangoboost-password>

install -m 600 -o root -g root /dev/null /etc/apt/auth.conf.d/mango-sdk.conf
{
printf 'machine repo.mangoboost.io\n'
printf 'login %s\n' "$MANGO_GUEST_NAME"
printf 'password %s\n' "$MANGO_GUEST_PASSWORD"
} | tee /etc/apt/auth.conf.d/mango-sdk.conf > /dev/null
chmod 600 /etc/apt/auth.conf.d/mango-sdk.conf

# Add the repository to the APT sources
echo "deb https://repo.mangoboost.io/artifactory/public-debian $(lsb_release -cs) boostx-sds" \
| tee /etc/apt/sources.list.d/mango.list

2. Install the package

apt update
apt install -y mass-client
Install on RHEL / Rocky Linux

1. Register the MangoBoost DNF repository

sudo su -

# Replace the two values below with the credentials provided by MangoBoost
export MANGO_GUEST_NAME=<your-mangoboost-username>
export MANGO_GUEST_PASSWORD=<your-mangoboost-password>

# Detect the RHEL major version (e.g. rhel9)
. /etc/os-release && RHEL_VER="rhel${VERSION_ID%%.*}"

# Add the repository to the DNF sources
tee /etc/yum.repos.d/mango.repo > /dev/null <<EOF
[boostx-sds]
name=MangoBoost BoostX-SDS
baseurl=https://repo.mangoboost.io/artifactory/public-rpm/${RHEL_VER}
username=$MANGO_GUEST_NAME
password=$MANGO_GUEST_PASSWORD
enabled=1
gpgcheck=0
gpgkey=https://repo.mangoboost.io/artifactory/api/security/keypair/mb-gpg/public
EOF
chmod 600 /etc/yum.repos.d/mango.repo

2. Install the package

dnf install -y mass-client