설치 후 정상동작 확인

모니터링 화면에서 서비스 확인

관리자 계정으로 로그인한 뒤, 아래 경로로 모니터링 화면을 엽니다. 핵심 서비스가 한 화면에 모두 표시됩니다.

좌측 하단 관리자 › 시스템 설정 › 시스템 & 모니터링 › 모니터링

모니터링 화면 - 상단 ‘서비스 상태 6/6’ 와 ‘서비스 / 실시간’ 6개 카드.

가운데 서비스 / 실시간 영역에 6개 카드가 있습니다. 각 카드가 정상이면 그 서비스는 살아있는 것입니다.

6개가 모두 정상이면 설치 완료입니다. 데이터베이스, AI 모델, 분석, 검색, 캐시, 임베딩까지 모두 살아있다는 뜻입니다.

상단 ‘서비스 상태’ 배지가 6 / 6 이면 동일한 의미이고, 그 옆 CPU, 메모리, 디스크, PG 풀로 서버 자원 여유도 함께 봅니다. 모든 값은 실시간 실측 - 각 서비스에 실제로 연결을 확인(ping)해 받아온 결과입니다.

AI 모델(LLM) 연결

지금 받은 것은 PRISM 단독 설치 파일입니다. AI 모델은 포함되지 않고, 설치 시 모델 목록(연결 정보)만 등록됩니다. 따라서 gpt-oss-120b 를 쓰려면 사내에 LLM 모델 서버(vLLM)가 먼저 떠 있어야 하며, 설치 직후 어느 서버에 연결할지 한 번 지정해야 AI 분석 기능이 켜집니다.

좌측 하단 관리자 › 시스템 설정 › AI & 모델 › LLM 모델

LLM 모델 화면 - 설치 시 기본 등록된 모델 4종, 각 카드에 [연결 확인], [수정].

설치하면 모델 4종이 등록되어 있습니다. 상태는 활성(지금 쓰는 모델), 대기, 키 필요 로 표시됩니다.

하단 ‘새 모델’ 버튼으로 다른 모델을 추가할 수도 있습니다 (OpenAI, OpenAI 호환, Anthropic, 사용자 정의). 온프레미스 Qwen(3.8 권장, 3.6 이상), Gemma(사내 vLLM)나 외부 Gemini 등도 이렇게 추가하며, 표의 시드 모델은 키만 넣으면 바로 쓸 수 있습니다.

환경에 맞는 한쪽으로 설정합니다.

AI 모델이 아직 연결 안 됐으면 로그인 시 안내 창이 떠서 이 화면으로 안내합니다. 연결 후 1단계 모니터링의 LLM API 카드가 정상으로 바뀌면 완료입니다.

화면이 안 뜨거나 빨강일 때

모니터링 화면 자체가 안 열리거나 특정 카드가 빨강일 때만 서버 터미널에서 아래를 확인합니다. 정상이면 건너뛰어도 됩니다.

bash <설치경로>/prism-ctl.sh status      # 컨테이너 상태 + 서비스 헬스 (Docker·Podman 공통)

A. 로그인 화면조차 안 뜰 때 - 컨테이너 기동 확인

PRISM은 9개 컨테이너로 동작합니다. 외부 입구는 gateway(8200) 하나뿐이고 나머지는 내부 통신입니다.

cd /opt/prism-cosmos/ops/docker      # 설치 루트(기본 /opt/prism-cosmos)
docker compose -f docker-compose.yml ps

9개가 모두 Up (healthy) 인지 봅니다. 웹 입구 응답도 함께 확인합니다.

curl http://<서버주소>:8200/health
# 정상: {"status":"ok","service":"prism-cosmos-tap"}

B. LLM API 카드가 빨강일 때 - 모델 서버 도달 확인

설정(2단계)은 맞는데도 빨강이면, 모델 서버 자체가 떠 있는지 확인합니다. 아래는 우리 120B 기본 주소 예시입니다.

curl http://<모델 서버 주소>:<포트>/v1/models
# 응답이 없으면 모델 서버가 안 떠 있거나 사내망에서 안 닿는 것

C. 증상별 대응

전체 로그 보기

cd /opt/prism-cosmos/ops/docker      # 설치 루트(기본 /opt/prism-cosmos)
docker compose -f docker-compose.yml logs -f          # 전체
docker compose -f docker-compose.yml logs -f tap      # 특정 서비스

D. 설치/패치 중 막혔을 때

관리자 화면의 시스템 업데이트 로 패치하다 멈추거나 설치가 중간에 끊겼을 때, 웹 화면에 못 들어가도 서버 터미널에서 직접 확인합니다.

설치가 중간에 실패했을 때는 화면 캡처 대신 설치 로그 파일 하나만 기술연구소에 보내면 됩니다. 위치는 설치 패키지를 푼 폴더 안 install_log/prism-install-<날짜>-<시각>.log 입니다. 비밀번호 등 민감 정보는 자동으로 가려집니다.

패치 실행(RUN) 시 바로 500 이 뜰 때는 아래 복구 도구를 호스트에서 한 번 실행한 뒤 화면에서 다시 패치하세요. 데이터는 바뀌지 않고(컬럼 하나만 보강), 여러 번 실행해도 안전합니다.

RUN 500 복구 스크립트 받기

bash recover_run500.sh        # 호스트에서 실행 → 끝나면 화면에서 다시 패치

E. 재부팅 후 서비스가 안 올라올 때

새로 설치한 서버는 재부팅해도 자동으로 다시 켜지도록 설치기가 맞춰 둡니다. 다만 이 기능이 들어가기 전에 설치한 Podman 서버는 재부팅 후 서비스가 안 올라올 수 있습니다. 이때만 아래를 한 번 실행한 뒤 다시 기동하면 됩니다. (Docker 는 해당 없음)

systemctl --user enable podman-restart.service   # root 계정으로 설치했다면 --user 없이
bash <설치경로>/prism-ctl.sh up                    # 그 다음 수동으로 한 번 기동

샘플 데이터로 분석까지 확인

설치 파일에는 확인용 샘플 데이터(매출 10건)와 그 데이터 원본 연결(‘데모 매출 DB’)이 기본으로 들어 있습니다. 메타만 직접 한 번 만들면(②) 질문/분석까지 한 바퀴 돌려, 화면이 뜨는 것뿐 아니라 실제 데이터 분석까지 잘 되는지 확인할 수 있습니다.

① 데이터 원본 확인 (자동 등록됨)

좌측 하단 관리자 › 시스템 설정 › 데이터 › 데이터 원본

설치하면 샘플 데이터베이스 연결 ‘데모 매출 DB’가 자동으로 등록됩니다. 데이터 원본 화면에 데모 매출 DB(PostgreSQL, 호스트 pg)가 보이는지 확인만 하면 됩니다. 따로 추가할 필요 없습니다.

② 메타 만들기 (메타 디자이너)

시스템 설정 › 데이터 › 메타 디자이너 (새 창으로 열림)

메타는 자동으로 만들어지지 않습니다. 아래 순서로 직접 한 번 만들면 됩니다.

1. 상단 [파일] › [새 메타] - 빈 메타 탭이 생깁니다
2. 오른쪽 속성 패널의 [데이터 원본 선택] 에서 데모 매출 DB 선택
3. 가운데 [테이블 추가] 클릭 → 신규 메타라 ‘새 메타 저장’ 창이 먼저 뜹니다. 메타 이름을 넣고 카테고리를 ‘기본’으로 골라 [저장] (카테고리를 골라야 대화 화면 목록에 보입니다)
4. 다시 [테이블 추가] → 테이블 선택에서 스키마 demo 의 demo_sales → 모드는 자동 주행 → [메타 생성] → 완료 (유의어, 예상질문도 이때 같이 만들어집니다)
5. [실행] 탭에서 데이터 10건이 보이면 연결/조회 정상
6. 왼쪽 메타 목록에서 만든 메타를 오른쪽 클릭 → [발행] (발행해야 대화 화면에서 쓸 수 있습니다)

③ 질문해서 답 확인

메인 대화 화면으로 가서, 방금 만든 메타가 들어 있는 업무 카테고리와 메타를 선택한 뒤 아래처럼 질문합니다.

설치 완료 확인

1단계(모니터링 6/6 정상)와 2단계(AI 모델 연결)가 모두 정상이면 설치가 완료된 것입니다.

설치 후 운영 - 백업과 정리

평소 운영에 필요한 것은 정기 백업과 보관 위치 정도입니다. 아래는 호스트에서 한 번씩 확인, 실행하는 명령입니다.

정기 백업

데이터베이스와 설정을 주기적으로 백업해 두면 장애나 서버 이전 시 그대로 복구할 수 있습니다. 운영 중에도 안전하게 실행됩니다.

# 데이터베이스 백업 (Docker)
docker exec trinity-prism-pg pg_dump -U cosmos cosmos | gzip > /backup/prism-$(date +%F).sql.gz
# Podman 은 docker 를 podman 으로: podman exec trinity-prism-pg pg_dump -U cosmos cosmos | gzip > ...

# 설정, 데이터 디렉터리 백업 (Docker)
tar -czf /backup/prism-config-$(date +%F).tar.gz /opt/prism-cosmos /var/lib/prism
# Podman 은 설치 폴더만: tar -czf /backup/prism-config-$(date +%F).tar.gz ~/prism-cosmos (데이터는 위 pg_dump 로 대체)

설치 위치, 중지 / 재시작

완전 제거 (필요 시)

sudo bash uninstall.sh --dry-run      # 무엇이 지워질지 먼저 확인
sudo bash uninstall.sh                # 확인 후 전량 삭제 (Podman 은 sudo 없이)

스크립트 없이 수동으로 지울 때는 아래처럼 합니다. Docker 기준이며, Podman 환경이면 docker 를 podman 으로 바꾸고 경로도 /opt/prism-cosmos 대신 ~/prism-cosmos 입니다(데이터는 ~/.local/share/containers).

docker compose -p prism-cosmos-prod -f /opt/prism-cosmos/ops/docker/docker-compose.yml down
docker volume rm $(docker volume ls -q | grep cosmos_prod_)   # 데이터 삭제 (복구 불가)
rm -rf /opt/prism-cosmos /var/lib/prism