최초 설정
배포를 마치면 MAC이 실행되지만, 모든 설정은 아직 출고 기본값 상태입니다. 이 페이지는 설치 직후 챙겨야 할 항목을 안내합니다 — 관리자 비밀번호 변경, 운영자 계정 생성, 스위치 연결, 그리고 (선택) LLMBoost 클러스터 연동.
기본 로그인
http://<master-ip>:23000을 열고 다음으로 로그인합니다.
- 사용자명:
admin - 비밀번호:
admin
운영 환경에서는 기본 비밀번호를 즉시 변경하세요. 최초 기동 전에 아래와 같이 미리 원하는 비밀번호를 지정할 수도 있습니다.
~$ mac env set MAC_ADMIN_PASSWORD=<strong-password>
~$ mac start master
역할과 사용자 관리
MAC에는 세 가지 기본 역할이 정의되어 있습니다.
| 역할 | 권한 |
|---|---|
admin | 모든 권한 — 사용자 관리, 전원 제어, 전체 설정 변경 |
operator | 읽기 + 쓰기 (컨테이너 제어, 소프트웨어 설치, 스위치 설정) |
viewer | 모든 모니터링 데이터에 대한 읽기 전용 접근 |
추가 사용자는 웹 UI의 Cluster → Users에서 생성합니다.
인증 비활성화 (랩 전용)
망 분리된 랩 환경이라면 인증 자체를 건너뛸 수 있습니다. 값이 ~/.mac/env에 기록되어
재시작 시 api-server 컨테이너로 전달되도록, 셸 prefix가 아니라 반드시
mac env set으로 설정하세요.
~$ mac env set MAC_AUTH_ENABLED=false
~$ mac restart master
랩 외부에서 접근 가능한 망에서는 절대 이렇게 설정하지 마세요.
스위치 접속 설정
SONiC 또는 Dell OS10 스위치를 MAC에서 관리하려면, 마스터에 SSH 자격 증명을 한 번 등록합니다.
~$ mac env set SWITCH_USER=admin
~$ mac env set SWITCH_PASSWD_LIST=admin,YourSecondPassword
~$ mac restart master
SWITCH_PASSWD_LIST는 쉼표로 구분한 목록입니다. 스위치에 처음 연결할 때 MAC이 목록에
나온 비밀번호를 순서대로 시도하고, 성공한 비밀번호를 캐시해 둡니다. 벤더 기본
비밀번호가 섞여 있는 플릿 (예: OS10의 admin, SONiC의 123455)을 관리할 때
편리합니다.
스위치는 별도로 추가할 필요가 없습니다. 등록된 에이전트가 보고하는 LLDP 데이터로 자동 탐색되어 Network Topology 페이지에 나타납니다.
LLMBoost 자동 탐색 (선택)
등록된 에이전트 중 하나라도 LLMBoost 쿠버네티스 클러스터의 노드라면, Services → LLMBoost 페이지가 자동으로 활성화됩니다. 모델뿐 아니라 디플로이먼트와 파드 배치까지 확인하려면, 읽기 전용 K8s 서비스 어카운트 토큰을 발급해 두어야 합니다.
# K8s 컨트롤 플레인 노드에서:
~$ kubectl create serviceaccount mac-reader -n llmboost
~$ kubectl create clusterrolebinding mac-reader \
--clusterrole=view \
--serviceaccount=llmboost:mac-reader
~$ kubectl create token mac-reader -n llmboost --duration=8760h
그 다음, MAC 마스터에서 다음과 같이 설정합니다.
~$ mac env set LLMBOOST_K8S_TOKEN=<paste-token-here>
~$ mac restart master
K8s 노드와 에이전트가 서로 다른 서브넷에 있다면, 엔드포인트를 명시적으로 지정합니다.
~$ mac env set LLMBOOST_API_ENDPOINT=http://<k8s-ip>:30080/api
~$ mac env set LLMBOOST_K8S_API_URL=https://<k8s-ip>:6443
~$ mac env set LLMBOOST_DASHBOARD_URL=http://<k8s-ip>:30080/manage/
준비 완료
이제 **사용 가이드**로 넘어가, 대시보드의 모든 페이지를 차례대로 살펴봅니다.