CLI Reference

mass-ctl is the client-side tool for mounting volumes and managing the local environment. Install it on every client machine that needs to access storage.

Supported Platforms

Packages are published with every release for:

Platform	Package	Install with	Mounting volumes
Ubuntu 22.04 (jammy)	mass-client (.deb)	apt	Yes
Ubuntu 24.04 (noble)	mass-client (.deb)	apt	Yes
Ubuntu 26.04 (resolute)	mass-client (.deb)	apt	Yes
RHEL / Rocky Linux 9	mass-client (.rpm)	dnf	Yes
RHEL / Rocky Linux 10	mass-client (.rpm)	dnf	No — thin client

warning

The Enterprise Linux 10 package is a thin client. It ships the mass-ctl binary and shell completions only, with no bundled storage runtime, so it can talk to the Manager API but cannot mount volumes and cannot build the bundled C examples. To mount volumes from an Enterprise Linux host, use EL9. Every Ubuntu package and the EL9 package are full clients.

warning

Enterprise Linux 8 is no longer supported. The EL8 client package was withdrawn because it could not run correctly on EL8 systems.

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 9 or 10

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

The EL9 package is a full client; the EL10 package is a thin client that cannot mount volumes — see the warning above.

info

Upgrading from an older mass-ctl-client package? The new packages declare Provides: / Replaces: against the legacy names, so the old package is removed in place — no manual purge needed.

Verify the Installation

mass-ctl --version

This prints the build version, Git SHA, and build date.

Shell Completion

Tab completion is installed automatically for bash and zsh, and works in root login and sudo -s shells. mass-ctl completion <bash|zsh|fish|powershell> prints a script for any supported shell.

What Ships With the Client

The full client packages (all Ubuntu .debs and the EL9 .rpm) are self-contained — they need no separate storage-client installation:

Path	Contents
/opt/boostx-sds/daos/example	Ready-to-build C example programs
/opt/boostx-sds/hdf5	HDF5 runtime and connector
/opt/boostx-sds/ior/bin/boostx-ior	The IOR storage benchmark
/opt/boostx-sds/mpifileutils/bin/boostx-dsync	The parallel data mover behind mass-ctl dsync

See Developer Toolkit for how to use them. The EL10 thin client ships none of these.

Next Steps

• Authentication Setup — obtain a certificate before your first mount
• Commands — full command reference
• Troubleshooting