본문으로 건너뛰기

설치

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

사전 요구 사항​

  • Ubuntu 또는 RHEL 계열 amd64와 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

sudo 없이 mac 실행하기​

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

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

저장소 자격 증명 받기​

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

MAC 패키지 설치​

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로 설치하세요.

RHEL 계열 호스트​

MangoBoost에 배포판에 맞는 RPM을 요청하세요. 릴리스 패키징은 RHEL 9와 10용 RPM을 내부 저장소에 게시합니다. 위의 공개 APT 절차는 YUM 저장소를 설정하지 않습니다. Docker Engine과 Compose v2를 먼저 설치하세요. podman-docker는 MAC의 Compose 절차를 실행할 수 없습니다.

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

업그레이드할 때는 sudo dnf upgrade ./mango-ai-center-<version>.rpm을 사용하세요. RPM을 삭제해도 /etc/mango/mac, 볼륨, 이미지와 node 토큰은 남습니다. 데이터를 지우는 전체 정리는 별도로 실행해야 합니다.

컨테이너 이미지 받기​

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

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

오프라인 설치​

오프라인 번들과 함께 압축 파일 및 MANIFEST 체크섬을 요청하세요. 번들은 Ubuntu 22.04와 24.04에 설치할 수 있습니다. 번들의 bundle.env에 나열되지 않은 호스트에는 Docker와 Compose를 미리 설치해야 합니다. 번들은 AMD GPU 호스트와 GPU가 없는 호스트를 지원합니다. NVIDIA 호스트에는 온라인 설치를 사용하세요. dcgm-exporter는 재배포 대상에서 제외되며, 이미지를 따로 로드해도 오프라인 설치 프로그램은 NVIDIA 호스트에서 실행을 거부합니다.

  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 저장소에 접근할 수 있어야 합니다. 펌웨어 다운로드 URL에 접근할 수 없으면 File upload를 사용하세요.

네트워크 및 방화벽 포트​

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

방향포트
사용자 → masterTCP 23000(대시보드), 28080(API). TLS 사용 시 23443, 28443
master → agentTCP 28000, 29101, 29102, 29103, 29150, 29200, 29300, 29500
agent → masterTCP 28080(로그와 감사 이벤트, TLS 사용 시에도 필요). TLS 사용 시 28443
master → 스위치TCP 22(SSH), 8080(gNMI). UDP 161(SNMP)
master → BMCTCP 443(Redfish)
master → DPU SoCTCP 443, 8443(Redfish)