CLI 레퍼런스
mass-ctl은 볼륨을 마운트하고 로컬 환경을 관리하는 클라이언트 측 도구입니다. 스토리지에 접근해야 하는
모든 클라이언트 머신에 설치합니다.
지원 플랫폼
릴리스마다 다음 플랫폼용 패키지가 게시됩니다:
| 플랫폼 | 패키지 | 설치 도구 | 볼륨 마운트 |
|---|---|---|---|
| Ubuntu 22.04 (jammy) | mass-client (.deb) | apt | 가능 |
| Ubuntu 24.04 (noble) | mass-client (.deb) | apt | 가능 |
| Ubuntu 26.04 (resolute) | mass-client (.deb) | apt | 가능 |
| RHEL / Rocky Linux 9 | mass-client (.rpm) | dnf | 가능 |
| RHEL / Rocky Linux 10 | mass-client (.rpm) | dnf | 불가 — thin 클라이언트 |
Enterprise Linux 10 패키지는 thin 클라이언트입니다. mass-ctl 바이너리와 셸 자동완성만
포함하며 스토리지 런타임이 번들되지 않으므로, Manager API 통신은 가능하지만 볼륨을 마운트할 수
없고 번들 C 예제도 빌드할 수 없습니다. Enterprise Linux 호스트에서 볼륨을 마운트해야 하면 EL9를
사용하십시오. Ubuntu 패키지 전체와 EL9 패키지는 완전한 클라이언트입니다.
Enterprise Linux 8은 더 이상 지원되지 않습니다. EL8 시스템에서 정상 동작할 수 없어 EL8 클라이언트 패키지 제공이 중단되었습니다.
설치
mass-client는 MangoBoost 패키지 저장소(repo.mangoboost.io)를 통해 배포됩니다.
설치 전에 클라이언트 머신에 저장소를 먼저 등록해야 합니다.
MangoBoost에서 발급한 저장소 자격 증명(사용자 이름과 비밀번호)이 필요합니다. 자격 증명이 없다면 MangoBoost 담당자에게 문의하십시오.
Ubuntu / Debian에 설치
1. MangoBoost APT 저장소 등록
sudo su -
apt update
apt install -y curl gpg lsb-release
# MangoBoost 서명 키 가져오기
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
# 아래 두 값을 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
# APT 소스에 저장소 추가
echo "deb https://repo.mangoboost.io/artifactory/public-debian $(lsb_release -cs) boostx-sds" \
| tee /etc/apt/sources.list.d/mango.list
2. 패키지 설치
apt update
apt install -y mass-client
RHEL / Rocky Linux 9 또는 10에 설치
1. MangoBoost DNF 저장소 등록
sudo su -
# 아래 두 값을 MangoBoost에서 제공받은 자격 증명으로 교체하세요
export MANGO_GUEST_NAME=<your-mangoboost-username>
export MANGO_GUEST_PASSWORD=<your-mangoboost-password>
# RHEL 메이저 버전 감지 (예: rhel9)
. /etc/os-release && RHEL_VER="rhel${VERSION_ID%%.*}"
# DNF 소스에 저장소 추가
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. 패키지 설치
dnf install -y mass-client
EL9 패키지는 완전한 클라이언트이고, EL10 패키지는 볼륨을 마운트할 수 없는 thin 클라이언트입니다 — 위 경고를 참조하십시오.
기존 mass-ctl-client 패키지에서 업그레이드하는 경우, 새 패키지가 기존 이름에 대해 Provides: /
Replaces:를 선언하므로 별도의 purge 없이 그대로 교체됩니다.
설치 확인
mass-ctl --version
빌드 버전, Git SHA, 빌드 날짜가 출력됩니다.
셸 자동완성
bash와 zsh 자동완성이 자동으로 설치되며, root 로그인 셸과 sudo -s 셸에서도 동작합니다.
mass-ctl completion <bash|zsh|fish|powershell>로 지원되는 셸의 스크립트를 출력할 수 있습니다.
클라이언트에 포함된 구성 요소
완전한 클라이언트 패키지(모든 Ubuntu .deb과 EL9 .rpm)는 자체 완결형이며, 별도의 스토리지
클라이언트 설치가 필요하지 않습니다:
| 경로 | 내용 |
|---|---|
/opt/boostx-sds/daos/example | 바로 빌드할 수 있는 C 예제 프로그램 |
/opt/boostx-sds/hdf5 | HDF5 런타임 및 커넥터 |
/opt/boostx-sds/ior/bin/boostx-ior | IOR 스토리지 벤치마크 |
/opt/boostx-sds/mpifileutils/bin/boostx-dsync | mass-ctl dsync가 사용하는 병렬 데이터 무버 |
사용 방법은 개발자 툴킷을 참조하세요. EL10 thin 클라이언트에는 이들이 포함되지 않습니다.