PRISM SaaS 설치 가이드

PRISM SaaS 서비스를 이용하기 위한 고객사 인프라 설치 가이드입니다. SaaS 모델에서는 데이터 수집기와 데이터 전송 서비스만 고객사 서버에 설치하며, PRISM 서버와 대시보드는 기가플롭스 클라우드에서 호스팅됩니다.

대상 독자

본 문서는 고객사 시스템 관리자 및 인프라 담당자를 대상으로 합니다.

변경될 수 있음

본 문서의 버전, 사양, 도메인 등은 초기 기준이며, 설치 패키지 및 배포 구성에 따라 달라질 수 있습니다.

사전 요구사항

아래 항목은 설치 전 준비가 필요한 기본 조건입니다.

네트워크 요구사항

외부 통신 (관리 서버 → PRISM 클라우드):

대상	용도
`prism.giga-flops.com:443`	API, 서버 등록
`prism-data.giga-flops.com:443`	메트릭 데이터 전송

브라우저에서 https://prism.giga-flops.com과 https://prism-data.giga-flops.com에 접속이 되는지 확인하세요.

기술 담당자용 확인 명령

bash

curl -v https://prism.giga-flops.com
curl -v https://prism-data.giga-flops.com

주의

외부 HTTPS 통신(443 포트)만 열면 됩니다 (인바운드 개방 불필요)
기업 프록시 사용 시 HTTPS 통신 허용 필요
보안 검사(SSL Inspection)가 활성화된 경우 위 도메인을 예외 처리해주세요

내부 네트워크 (관리 서버 ↔ 모니터링 대상 서버):

관리 서버에서 각 모니터링 대상 서버로의 내부 통신이 가능해야 합니다. 각 서버의 수집기가 모은 데이터를 관리 서버가 주기적으로 취합합니다.

사전 확인 체크리스트

[ ] 마스터 노드에서 prism.giga-flops.com:443, prism-data.giga-flops.com:443 연결 가능
[ ] 마스터 노드에서 모든 컴퓨트 노드로 SSH 접속 가능
[ ] sudo 권한 보유

계정 및 라이선스 확인

계정 등록

브라우저에서 https://prism.giga-flops.com에 접속합니다.
로그인 화면 하단의 회원가입 링크를 클릭합니다.

회원가입 폼을 작성합니다.

단계	입력 항목
1단계	아이디 (중복 확인), 비밀번호, 비밀번호 확인
2단계	담당자 성함, 연락처, 이메일(선택), 이용약관 동의
3단계	가입 완료 안내

기가플롭스 관리자가 승인하면 로그인이 가능합니다.

INFO

회원가입 완료 시 "관리자 승인 후 로그인이 가능합니다" 메시지가 표시됩니다. 승인 완료 시 등록한 이메일로 안내가 발송됩니다.

라이선스 키

Installer 실행 시 라이선스 키가 필요합니다. 라이선스 키는 계정 승인 후 PRISM 포털에서 확인하거나, 기가플롭스 담당자를 통해 전달받습니다.

라이선스 관련 안내

라이선스 관리 기능(갱신, 서버 수 확장 등)은 준비 중입니다. 라이선스 관련 문의는 기가플롭스 담당자에게 연락해주세요.

주의

라이선스 키는 보안 정보입니다. 외부에 공유하지 마세요.

인스톨러 다운로드

다운로드 방법

브라우저에서 https://downloads.giga-flops.com에 접속합니다.
PRISM 계정으로 로그인합니다 (조직코드, 아이디, 비밀번호).

다운로드 센터 로그인

INSTALLER 카테고리에서 GigaFlops Installer의 다운로드 버튼을 클릭합니다.
CLI 환경에서는 링크 복사 버튼을 클릭하여 wget 명령을 복사한 후 서버에서 실행합니다.

다운로드 센터

설치 모드

Installer는 대화형 실행과 옵션 기반 실행을 모두 지원합니다. 초기 설치는 대화형 실행을 권장하며, 대규모 설치나 자동화 환경에서는 옵션 기반 실행을 사용할 수 있습니다.

설치 모드	대상	설치 구성 요소
Master Install (Mode D)	마스터 노드	데이터 수집·전송 서비스
Exporter All (Mode A)	마스터 · 컴퓨트 노드	서버 에이전트, GPU 에이전트(GPU 시), BMC 에이전트(BMC 시)

권장 설치 순서

1단계: 마스터 노드에서 Master Install 실행 → 데이터 수집·전송 서비스 설치
2단계: 마스터 노드와 모든 컴퓨트 노드에서 Exporter All 실행 → 모니터링 에이전트 설치

기타 모드

Exporter Select (Mode B): 설치할 에이전트를 개별 선택합니다.

파일 정보

파일명: GigaFlopsInstaller.jar
GPU 자동 감지: Installer가 NVIDIA 드라이버 설치 여부를 자동으로 확인합니다. GPU가 없으면 GPU 에이전트 설치를 자동으로 건너뜁니다.

Installer 실행 화면

대화형으로 실행하면 라이선스 검증 후 설치 모드를 선택합니다. Exporter All을 선택하면 서버 환경을 자동 감지하여 필요한 에이전트를 설치합니다.

GigaFlops Installer 실행 화면

마스터 노드 설치

마스터 노드에 데이터 수집·전송 서비스를 설치합니다.

설치 절차

Installer 파일이 있는 디렉터리로 이동합니다.
Master Install로 설치를 실행합니다.

bash

# 대화형 실행 (권장)
sudo java -jar GigaFlopsInstaller.jar

# 옵션 기반 실행
sudo java -jar GigaFlopsInstaller.jar --master

대화형 실행 시 Installer가 라이선스 키를 입력받고 Mode D를 선택하면 데이터 수집·전송 서비스를 설치합니다. --master 옵션을 사용하면 모드 선택을 건너뜁니다.

MASTER 모드 설치 시작

설치 과정에서 수행되는 작업

Installer가 다음 단계를 자동으로 진행합니다.

라이선스 검증
데이터 수집 서비스 설치 (바이너리 설치, systemd 서비스 등록)
데이터 전송 서비스 설치 (Docker 컨테이너 배포, 클라우드 연결 확인)
설치 완료 요약 출력

클라우드 연결 확인

설치 완료 후 데이터 전송 서비스가 기가플롭스 클라우드와 정상 통신하는지 확인합니다.

bash

# 전송 서비스 로그 확인
docker logs gigaflops-bridge --tail 20

"Data forwarded successfully" 류의 메시지가 보이면 정상입니다.

MASTER 모드 설치 완료

주의

sudo 권한으로 실행해야 합니다 (systemd 서비스 등록 필요).
이미 설치된 환경에서 재실행하면 기존 설정을 덮어씁니다. 업그레이드 시에도 동일 명령을 사용하세요.

컴퓨트 노드 설치

각 컴퓨트 노드에 모니터링 에이전트를 설치합니다.

설치 절차

각 컴퓨트 노드에 Installer 파일을 복사합니다.
Installer를 실행하여 에이전트를 설치합니다.
모든 컴퓨트 노드에서 반복합니다.

bash

# 1. 각 컴퓨트 노드에 Installer 파일 복사
scp GigaFlopsInstaller.jar user@<컴퓨트노드IP>:/tmp/

# 2. 각 컴퓨트 노드에서 대화형 실행 (권장)
ssh user@<컴퓨트노드IP>
sudo java -jar /tmp/GigaFlopsInstaller.jar

# 또는 옵션 기반 실행 (자동화 시)
sudo java -jar /tmp/GigaFlopsInstaller.jar \
  --api https://prism.giga-flops.com \
  --license <라이선스키>

EXPORTER 모드 자동 감지 결과

설치 과정에서 수행되는 작업

Installer가 서버 환경을 자동 감지하여 다음 단계를 진행합니다.

서버 에이전트 설치 (필수 — 모든 노드)
GPU 감지 → NVIDIA 드라이버가 있으면 GPU 에이전트 설치, 없으면 건너뜀
BMC 감지 → BMC 기능이 있으면 BMC 에이전트 설치, 없으면 건너뜀
PRISM 서버에 자동 등록

설치 확인 (각 노드에서)

bash

# 서버 에이전트 확인
systemctl status node_exporter

# GPU 에이전트 확인 (GPU 노드만)
docker ps | grep dcgm

# BMC 에이전트 확인 (해당 노드만)
systemctl status ipmi_exporter

대규모 설치 팁

여러 노드에 한번에 설치하는 예시입니다.

bash

NODES="node1 node2 node3 node4 node5"
LICENSE="<라이선스키>"

for NODE in $NODES; do
  echo "=== Installing on $NODE ==="
  scp GigaFlopsInstaller.jar $NODE:/tmp/
  ssh $NODE "sudo java -jar /tmp/GigaFlopsInstaller.jar \
    --api https://prism.giga-flops.com --license $LICENSE --yes"
done

보안 참고

라이선스 키를 명령행 인자로 입력하면 쉘 히스토리에 남을 수 있습니다. 보안 정책상 문제가 있는 환경에서는 대화형 실행을 사용하세요.

팁

GPU 에이전트는 Docker로 실행되므로, GPU 노드에도 Docker 설치가 필요합니다.
NVIDIA Container Toolkit이 사전 설치되어 있어야 GPU 에이전트가 GPU에 접근할 수 있습니다.
100대 이상 대규모 클러스터는 Ansible/pdsh 등 자동화 도구 활용을 권장합니다.

설치 결과 확인

서비스 상태 확인

마스터 노드:

bash

# 데이터 수집 서비스 상태
systemctl status prometheus
# Active: active (running) 이어야 합니다.

# 데이터 전송 서비스 상태
docker ps | grep bridge
# STATUS가 "Up" 이어야 합니다.

컴퓨트 노드:

bash

# 서버 에이전트
systemctl status node_exporter

# GPU 에이전트 (GPU 노드)
docker ps | grep dcgm

# BMC 에이전트 (해당 노드)
systemctl status ipmi_exporter

종합 확인

확인 항목	명령	기대 결과
데이터 수집 서비스	`systemctl is-active prometheus`	active
데이터 전송 서비스	`docker ps \| grep bridge`	Up
서버 에이전트	`systemctl is-active node_exporter`	active
GPU 에이전트	`docker ps \| grep dcgm`	Up
클라우드 연결	`curl https://prism.giga-flops.com`	응답 수신

팁

서비스가 inactive/failed인 경우: journalctl -u <서비스명> --no-pager -n 50으로 로그를 확인하세요.

포털 접속

접속 절차

웹 브라우저에서 https://prism.giga-flops.com에 접속합니다.
회원가입 시 등록한 계정으로 로그인합니다.
- 기업 코드 (Organization Code)
- 아이디
- 비밀번호
로그인 성공 후 대시보드 메인 화면으로 진입합니다.

대시보드 확인 사항

확인 항목	기대 결과	문제 시
서버 카드 표시	등록된 모든 서버가 카드로 표시	에이전트 설치 상태 확인
서버 상태	ONLINE (녹색)	에이전트/네트워크 확인
CPU/메모리 수치	0%~100% 실시간 갱신	데이터 지연 시 전송 서비스 로그 확인
GPU 정보 (해당 시)	GPU 온도, 사용률 표시	GPU 에이전트 확인

데이터 표시 대기 시간

에이전트 설치 후 데이터가 수집·전송되어 대시보드에 표시되기까지 약 1~3분 소요됩니다. 설치 직후 대시보드가 비어 있을 수 있습니다. 2~3분 후 새로고침하세요.

서버가 보이지 않는 경우

다음 순서로 확인합니다.

컴퓨트 노드에서 서버 에이전트가 실행 중인지 확인
bash
```
systemctl status node_exporter
```
마스터 노드의 데이터 수집 서비스 상태 확인
bash
```
systemctl status prometheus
```
데이터 전송 서비스가 정상 동작하는지 확인
bash
```
docker logs gigaflops-bridge --tail 20
```
클라우드 연결 상태 확인
bash
```
curl https://prism.giga-flops.com
```

브라우저 호환성

최신 브라우저를 권장합니다 (Chrome, Edge, Firefox, Safari).
Internet Explorer는 지원하지 않습니다.

트러블슈팅

일반 문제

#	증상	원인	해결 방향
1	클라우드 연결 실패	방화벽 443 차단, 프록시 미설정, 컨테이너 중지	아웃바운드 443 허용 확인, 전송 서비스 컨테이너 재시작
2	에이전트 미수신	에이전트 미설치/중지, 내부 네트워크 차단	대상 노드에서 에이전트 서비스 상태 확인
3	데이터 지연	네트워크 지연, 전송 서비스 지연	전송 서비스 로그에서 전달 상태 확인
4	포털 접속 불가	DNS 미해석, 기업 프록시/방화벽 차단	기업 IT팀에 도메인 허용 요청
5	라이선스 만료	계약 기간 종료	기가플롭스 고객지원 (연락처 준비 중)로 라이선스 갱신
6	Installer 실행 오류	Java 미설치, 권한 부족	Java 버전 확인, sudo 실행
7	GPU 메트릭만 없음	GPU 에이전트 미설치, GPU 드라이버 오류	GPU 드라이버 상태 확인, 기가플롭스 고객지원 문의

문제가 해결되지 않는 경우 기가플롭스 고객지원 (연락처 준비 중)으로 문의해주세요.

PRISM SaaS 설치 가이드 ​

사전 요구사항 ​

네트워크 요구사항 ​

사전 확인 체크리스트 ​

계정 및 라이선스 확인 ​

계정 등록 ​

라이선스 키 ​

인스톨러 다운로드 ​

다운로드 방법 ​

설치 모드 ​

파일 정보 ​

Installer 실행 화면 ​

마스터 노드 설치 ​

설치 절차 ​

설치 과정에서 수행되는 작업 ​

클라우드 연결 확인 ​

컴퓨트 노드 설치 ​

설치 절차 ​

설치 과정에서 수행되는 작업 ​

설치 확인 (각 노드에서) ​

대규모 설치 팁 ​

설치 결과 확인 ​

서비스 상태 확인 ​

종합 확인 ​

포털 접속 ​

접속 절차 ​

대시보드 확인 사항 ​

서버가 보이지 않는 경우 ​

브라우저 호환성 ​

트러블슈팅 ​

일반 문제 ​

PRISM SaaS 설치 가이드

사전 요구사항

네트워크 요구사항

사전 확인 체크리스트

계정 및 라이선스 확인

계정 등록

라이선스 키

인스톨러 다운로드

다운로드 방법

설치 모드

파일 정보

Installer 실행 화면

마스터 노드 설치

설치 절차

설치 과정에서 수행되는 작업

클라우드 연결 확인

컴퓨트 노드 설치

설치 절차

설치 과정에서 수행되는 작업

설치 확인 (각 노드에서)

대규모 설치 팁

설치 결과 확인

서비스 상태 확인

종합 확인

포털 접속

접속 절차

대시보드 확인 사항

서버가 보이지 않는 경우

브라우저 호환성

트러블슈팅

일반 문제