본문으로 건너뛰기

설치

각 호스트에 MAC CLI와 컨테이너 이미지를 설치한 뒤 서비스를 시작하세요.

사전 요구 사항​

  • Ubuntu amd64 또는 RHEL 계열 OS와 root 권한
  • Docker 20.10 이상과 Compose v2
  • 모든 node의 NTP 또는 chrony(토큰, 로그와 metric이 같은 시각을 기준으로 함)
  • MangoBoost 이미지 레지스트리 또는 내부 미러에 대한 접근
  • GPU 드라이버와 MangoBoost 드라이버. MAC은 드라이버를 설치하지 않습니다 (Mango SDK 문서).

Docker 설치​

Ubuntu에서는 다음 명령을 실행하세요.

sudo apt update
sudo apt install docker.io docker-compose-v2
sudo systemctl enable --now docker
docker compose version

RHEL 계열 호스트에서는 배포판에 맞는 절차로 Docker Engine과 Compose v2를 설치하세요.

sudo 없이 mac 실행하기​

sudo usermod -aG docker $USER
newgrp docker     # 또는 로그아웃 후 다시 로그인

sudo mac env set --global과, root만 읽을 수 있는 토큰 파일을 사용하는 master의 start/restart에는 계속 sudo가 필요합니다.

저장소 자격 증명 받기​

APT 게스트 자격 증명은 contact@mangoboost.io에 요청하세요. 이미지는 로그인 없이 받을 수 있습니다.

MAC 패키지 설치​

RHEL 계열 호스트는 RPM 설치로 건너뛰세요.

1. APT 인증 파일 생성​

sudo install -d -m 0755 /etc/apt/auth.conf.d
sudo tee /etc/apt/auth.conf.d/mango-sdk.conf >/dev/null <<EOF
machine repo.mangoboost.io
login   <guest-username>
password <guest-password>
EOF
sudo chmod 600 /etc/apt/auth.conf.d/mango-sdk.conf

2. 저장소 서명 키 신뢰​

curl -fsSL \
    https://repo.mangoboost.io/artifactory/api/security/keypair/mb-gpg/public \
    | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/mango-sdk.gpg >/dev/null

3. APT 소스 추가​

echo "deb https://repo.mangoboost.io/artifactory/public-debian jammy universe" \
    | sudo tee /etc/apt/sources.list.d/mango-sdk.list

4. 설치​

sudo apt update
sudo apt install mango-ai-center
mac --help

APT 저장소에 접근할 수 없으면 .deb 패키지를 요청한 뒤 sudo dpkg -i mango-ai-center_<version>_amd64.deb로 설치하세요.

RPM 설치​

배포판에 맞는 RPM을 요청한 뒤 설치하세요.

sudo dnf install ./mango-ai-center-<version>-<release>.<arch>.rpm
mac --help

Software와 DPU 작업에는 RPM을 지원하는 SDK_AGENT_IMAGE가 필요합니다.

컨테이너 이미지 받기​

mac images all
mac pull all                # 또는 mac pull master / mac pull agent

자체 레지스트리는 프라이빗 미러로 전환을 참고하세요.

오프라인 설치​

오프라인 번들과 함께 압축 파일 및 MANIFEST 체크섬을 요청하세요. 번들은 Ubuntu 22.04와 24.04에 설치할 수 있습니다. 번들의 bundle.env에 나열되지 않은 호스트에는 Docker와 Compose를 미리 설치해야 합니다.

  1. 번들을 검증하고 압축을 푸세요.

    sha256sum -c mango-ai-center-offline-<version>-ubuntu-amd64.tar.gz.sha256
    tar xzf mango-ai-center-offline-<version>-ubuntu-amd64.tar.gz
    cd mango-ai-center-offline-<version>-ubuntu-amd64

  2. master를 먼저 설치하세요. 서버 한 대에 모두 설치하려면 --start all을 사용하세요.

    sudo ./install.sh --start master --manifest-sha256 <published-MANIFEST-checksum>

  3. 각 agent에서 master의 node 토큰을 지정해 설치하세요.

    sudo ./install.sh --start agent --master-ip <master-ip> \
        --env MAC_NODE_TOKEN=<master-token> --manifest-sha256 <published-MANIFEST-checksum>

    토큰이 프로세스 인수에 노출되지 않게 하려면 대신 --env-stdin을 사용하세요.

오프라인 클러스터를 업데이트하기 전에 모든 node에서 새 번들을 로드하세요.

mac load /opt/mango-ai-center-offline-<version>-ubuntu-amd64
mac images --check

SDK를 업데이트하려면 APT 또는 DNF 저장소에 접근할 수 있어야 합니다. 오프라인 RPM 호스트에서는 RPM을 설치하고 이미지를 로드한 뒤, node 단위 MAC_OFFLINE=true를 설정하고 서비스를 시작하세요.

네트워크 및 방화벽 포트​

다음 포트를 허용하세요. 포트 설정을 변경했다면 변경한 포트를 허용하세요.

방향포트
사용자 → masterTCP 23000(대시보드), 28080(API). TLS 사용 시 23443, 28443
master → agentTCP 28000, 29101, 29102, 29103, 29150, 29200, 29300, 29500
agent → masterTCP 28080(TLS 사용 시 28443)
master → 스위치TCP 22(SSH), 8080(gNMI). UDP 161(SNMP)
master → BMCTCP 443(Redfish)