PRISMTRINITY
온프레미스, 최신

TRINITY PRISM 설치

받아서 풀고 한 줄 명령이면 끝.
인터넷 없는 폐쇄망(에어갭) 환경에서도 그대로 동작합니다.

Docker · Podman Ubuntu 22.04+ · RHEL 8/9 폐쇄망(에어갭) 지원

CPU, 메모리, 디스크 최소/권장 사양은 아래 표를 참고하세요.

다운로드

처음 설치라면 왼쪽, 이미 쓰고 계시면 오른쪽 - 둘 중 하나만 받으면 됩니다.

처음 설치/재설치

설치 패키지

아직 PRISM이 깔려 있지 않은 서버에 받는 통합 설치본입니다.
받아서 풀고 ./install.sh 한 줄이면 끝납니다.

통합 설치본, 올인원
최신 설치본 불러오는 중…
엔진, 인프라, 설정, 스킬, 설치 스크립트를 하나로 묶은 단일 아카이브입니다. 에어갭, 폐쇄망에서도 그대로 설치됩니다.
약 5.7 GB·설치 시 무결성 자동 검증
다운로드
AI 모델(LLM) 별도 이 설치본에 AI 모델(LLM)은 포함되지 않습니다. 기존 LLM 추론 서버(vLLM)를 연동하며, 없을 경우에 한해 BIMATRIX가 설치를 지원합니다. 연결은 설치 후 관리자 화면에서 한 번만 지정하면 됩니다.
이미 운영 중, 최신으로

업데이트 패키지

이미 PRISM을 쓰고 있는 환경을 최신으로 올리는 패치 번들입니다.
관리자 화면 시스템 업데이트에 끌어다 놓으면 무중단으로 자동 적용됩니다.

업데이트 번들, 기존 설치용
최신 업데이트 불러오는 중…
운영 중인 환경을 멈추지 않고 최신 코드로 올립니다. 관리자 화면 시스템 업데이트 에 올리면 자동으로 적용, 검증됩니다.
약 38 MB·업데이트 시 무결성 자동 검증
다운로드
되돌리기 안전장치 업데이트는 적용 직전 스냅샷을 떠두기 때문에 문제가 생기면 직전 버전으로 롤백됩니다 - 실패 시 자동, 직접 되돌리려면 시스템 업데이트 이력에서 [롤백]. 적용 후 화면이 정상인지만 확인하면 됩니다. 막히면 설치 후 정상동작 확인 - 문제 해결을 참고하세요.
버전별 변경 내용 - 릴리즈 노트

시스템 사양

최소 사양으로도 동작하지만, 권장 사양에서 최상의 AI 분석 성능을 경험할 수 있습니다.
권장 사양 단일 서버에서 동시 20명까지 실측했으며, 응답 여유를 둔 권장 운영 인원은 10명입니다.

최소 사양
OSUbuntu 22.04+
RHEL 8, 9
엔진Docker 24.0+ · Compose v2.20+
또는 Podman 4.9+ / 5.4
CPU12 vCPU
RAM32 GB
Disk300 GB SSD
Network폐쇄망(에어갭) 지원
개발, PoC, 소규모 팀
권장 사양
OSUbuntu 22.04 LTS / RHEL 9
엔진Docker 24.0+ · Compose v2.20+
또는 Podman 4.9+ / 5.4
CPU16 vCPU
RAM64 GB
Disk500 GB NVMe
Network폐쇄망(에어갭) 지원
프로덕션, 대용량 분석, 멀티테넌트
설치 전 최소 (부팅 게이트) 위 권장 사양과 별개로, 설치기는 시작 전 CPU 4 vCPU, 메모리 28 GB, 엔진 저장소 여유 50 GB 를 검사합니다(저장소는 엔진에 따라 도커 /var/lib/docker, 파드맨 ~/.local/share/containers). 이 값 미만이면 사전 점검(preflight)이 설치를 자동 중단합니다. CPU가 8 vCPU 미만이면 경고만 표시하고 진행합니다.

설치 가이드 - 4단계

받아서 풀고 → sudo ./install.sh --llm-url=http://<LLM>:<포트>/v1 → http://서버:8200 접속. 끝.

1
받기
위 설치 패키지에서 통합 설치본을 받습니다. 폐쇄망은 USB로 옮긴 뒤 2번부터.
2
풀기
$ tar -xzf TRINITY-PRISM-3.0.0.20260918-111_Installer.tar.gz
$ cd TRINITY-PRISM-*_Installer
3
설치 - AI 서버(LLM) 주소만 넣으면 끝
Docker 설치는 root 권한이 필요합니다 - sudo 로 실행하세요. RHEL 등 Podman 환경은 sudo 없이 일반 계정으로 설치됩니다(설치기가 엔진을 자동 판별 - 아래 Docker · Podman 설치 방법 참고). LLM 주소를 생략하면 설치 중 한 번 입력 프롬프트가 뜹니다. LLM 서버가 아직 없어도 설치 자체는 완료되며, AI 기능은 설치 후 LLM 연결 시 켜집니다. AI 서버 주소는 OpenAI 호환(vLLM 등) 기준이라 끝에 /v1까지 포함합니다.
$ sudo ./install.sh --llm-url=http://<LLM서버IP>:<포트>/v1
4
접속
http://<서버IP>:8200
Docker · Podman 설치 방법 설치기가 서버에 있는 엔진을 자동으로 판별합니다. RHEL 계열은 기본 탑재된 Podman 으로, 그 외는 Docker 로 설치됩니다. Podman 은 실행 권한에 따라 두 가지로 나뉘며, sudo 없이 일반 계정으로 실행하면 rootless, sudo 로 실행하면 rootful 입니다. 설치 위치는 rootless 가 ~/prism-cosmos, rootful 은 Docker 와 동일한 /opt/prism-cosmos 입니다. 재부팅 후 자동 기동에 필요한 준비는 두 방식 모두 설치기가 처리합니다.
# Docker - root 권한(기존과 동일)
$ sudo ./install.sh --llm-url=http://<LLM서버IP>:<포트>/v1

# Podman rootless(RHEL 등) - sudo 없이 일반 계정으로 그대로 실행
$ ./install.sh --llm-url=http://<LLM서버IP>:<포트>/v1

# Podman rootful - root 권한으로 운영할 때
$ sudo ./install.sh --llm-url=http://<LLM서버IP>:<포트>/v1

엔진을 직접 지정하려면 --engine=docker 또는 --engine=podman 을 붙이세요. 한 서버에 Docker 와 Podman 이 모두 설치된 경우에는 설치기가 임의로 선택하지 않고 중단하므로, 이 옵션을 반드시 지정해야 합니다. 어느 엔진이든 설치 절차와 접속 방법(http://서버:8200)은 동일합니다. 아래 옵션 예시의 명령은 Docker 기준(sudo)이며, Podman(RHEL 등) 환경은 앞의 sudo 만 빼고 일반 계정으로 그대로 실행하면 됩니다 - 붙이는 옵션(HTTPS, 포트, 하위 경로, 외부 인프라, 데이터 경로)은 엔진과 무관하게 동일합니다.

설치할 때 붙이는 옵션HTTPS, 포트, 하위 경로, 데이터를 다른 디스크에 저장
HTTPS/SSL HTTPS(SSL)로 운영하려면 설치 명령에 --ssl + 도메인 + 인증서 경로만 추가하면 됩니다.
$ sudo ./install.sh --llm-url=http://<LLM서버IP>:<포트>/v1 \
       --ssl --domain=회사도메인.co.kr --cert-path=/인증서폴더

도메인 연결(DNS), 리버스 프록시 환경, 이미 http로 설치된 걸 나중에 HTTPS로 바꾸기는 네트워크, 도메인, HTTPS 설정에 정리했습니다.

포트 변경 기본 포트(8200)를 바꾸려면 설치 명령에 --port 만 추가합니다.
$ sudo ./install.sh --llm-url=http://<LLM서버IP>:<포트>/v1 --port=8300
하위 경로에 설치 도메인 아래 특정 경로(예: /prism)에 설치하려면 설치 명령에 --base-path 를 추가합니다. 접속 주소가 도메인/prism 이 됩니다(한 도메인을 다른 서비스와 경로로 나눠 쓸 때). 옵션 없이 설치하면 기존처럼 루트에 설치됩니다.
$ sudo ./install.sh --llm-url=http://<LLM서버IP>:<포트>/v1 --base-path=/<하위경로>
데이터를 다른 디스크에 저장 - 용량 부족 대응 엔진 기본 저장소의 용량이 부족하면 --volume-root 로 데이터를 지정한 디스크에 저장할 수 있습니다. 비워 두면 기존 방식 그대로이고, 지정하면 설치기가 디렉토리 생성과 소유권까지 맞춰 줍니다.
$ sudo ./install.sh --llm-url=... --volume-root=/mnt/bigdisk/prism

Podman rootless 에서 별도 디스크를 쓸 때는 서버 관리자가 대상 디렉토리를 설치 계정 소유로 미리 만들어 줘야 합니다(rootless 는 사용자 번호 매핑이 달라 설치 계정이 소유권을 바꿀 수 없습니다). Docker · Podman rootful 은 필요 없습니다.

운영 데이터베이스를 따로 쓰기이미 갖춘 PostgreSQL, 검색엔진, Redis 연결. 오라클과 티베로로 설치. 설치한 뒤 갈아끼우기
외부 DB · 검색엔진 · Redis 연결 - 이미 갖춘 인프라 활용 이미 운영 중인 PostgreSQL · Elasticsearch(또는 OpenSearch) · Redis 가 있으면 그대로 연결해 쓸 수 있습니다. 설치 중 화면에서 항목별로 내장/외부를 선택하며(기본은 전부 내장이라 그냥 Enter), 외부를 고르면 그 자리에서 접속을 점검합니다. 무인 설치라면 옵션으로 지정합니다.
$ sudo ./install.sh --llm-url=... \
       --db-dsn=<외부 DB 접속정보> \
       --search-engine=external-es --search-url=http://<ES주소> \
       --redis-url=redis://<Redis주소>

외부 PostgreSQL 을 쓸 때는 스키마(테이블 구조)가 미리 준비돼 있어야 합니다 - 설치기가 외부 PostgreSQL 에는 테이블을 만들지 않습니다. 오라클과 티베로는 설치기가 표를 직접 만들어 줍니다(아래 운영 데이터베이스를 오라클, 티베로로 설치 참고). 질문 없이 전부 내장으로 설치하려면 --bundled 를 쓰세요(무인 설치, 자동화용).

운영 데이터베이스를 오라클, 티베로로 설치 제품이 쓰는 운영 데이터베이스(레포지토리)를 사내 표준에 맞춰 오라클이나 티베로로 두고 설치할 수 있습니다. 접속 주소만 주면 설치기가 종류를 알아서 가리고, 필요한 표와 초기 데이터를 직접 만들어 줍니다. 내장 PostgreSQL 컨테이너는 뜨지 않습니다.
# 오라클
$ sudo ./install.sh --llm-url=http://<LLM서버IP>:<포트>/v1 \
       --db-dsn='oracle://계정:비밀번호@<오라클서버>:1521/<서비스명>'

# 티베로
$ sudo ./install.sh --llm-url=http://<LLM서버IP>:<포트>/v1 \
       --db-dsn='tibero://계정:비밀번호@<티베로서버>:8629/<DB이름>'

비밀번호에 특수문자가 들어갈 수 있으니 주소는 작은따옴표로 감싸세요. 서비스명이 아니라 SID 만 쓰는 옛 오라클 서버는 주소 끝에 ?sid=1 을 붙입니다. --db-dsn 을 생략하면 설치 중 외부 DB 를 고른 뒤 종류(PostgreSQL / 오라클 / 티베로)를 선택하는 화면이 나오므로, 주소만 입력해도 됩니다.

설치 전에 준비할 것 세 가지

1. 연결용 자바 파일(JDBC 드라이버) - 오라클과 티베로는 제조사 라이선스 때문에 설치본에 넣어 배포할 수 없습니다. 쓰시는 데이터베이스 버전에 맞는 파일을 받아 설치본을 푼 폴더의 drivers 폴더에 넣고 설치를 시작하세요. 파일 이름은 받은 그대로 두면 됩니다. 오라클은 ojdbc11.jar(자바 21 기준 권장) 또는 ojdbc8.jar, 티베로는 tbjdbc.jar 입니다. 파일이 없으면 데이터베이스 준비 단계에서 설치가 멈춥니다.

이 폴더에는 파일을 하나만 넣으세요. 제품은 drivers 폴더에 있는 파일을 전부 등록하기 때문에, 자바 버전별로 나뉜 파일(예: 티베로 배포본의 -8, -11, -17)을 한꺼번에 넣으면 어느 것이 쓰일지 정해지지 않습니다. 제품 컨테이너의 자바는 21 이므로 자바 17 이상용 파일을 쓰시고, 구분이 없는 배포본이면 받은 파일 하나만 넣으면 됩니다.

2. 데이터베이스 버전 - 오라클은 19 이상, 티베로는 7 이상이 필요합니다. 설치기가 표를 만들기 전에 서버 버전을 확인하고, 낮으면 아무것도 바꾸지 않고 멈춥니다. 제품이 설정과 대화를 저장할 때 쓰는 문법이 오라클 19 부터 들어왔기 때문입니다.

3. 계정과 권한 - 제품 전용으로 비어 있는 계정을 하나 준비하시고, 표와 색인을 만들 수 있는 권한과 임시 테이블스페이스를 주세요.

이미 쓰고 계신 계정에 얹는 것은 권하지 않습니다. 오라클과 티베로는 계정이 곧 스키마라, 제품이 그 계정 안에 표 126개와 색인, 번호생성기를 함께 만듭니다. 그중 conversations, audit_event, system_settings 처럼 어느 회사 데이터베이스에나 있을 법한 이름이 37개 있습니다. 설치할 때는 이름이 겹치는지 확인하고 겹치면 멈추지만, 나중에 그 이름으로 표를 새로 만드시려 할 때 막힐 수 있습니다. 부득이 기존 계정을 쓰셔야 하면 기술지원으로 문의해 주세요 - 겹칠 수 있는 이름 목록을 드립니다.

설치가 끝나면

설치할 때 주신 운영 데이터베이스가 데이터 원본 목록에 자동으로 등록됩니다(이름 운영 데이터베이스). 접속 정보를 화면에서 다시 입력하지 않아도 바로 테이블 추가부터 시작할 수 있습니다. 내장 PostgreSQL 로 설치할 때와 같은 동작입니다.

이 항목에는 운영 데이터베이스 계정의 비밀번호가 함께 저장되므로, 데이터 원본 화면을 볼 수 있는 관리자에게 그 계정이 보입니다. 원치 않으시면 이 데이터 원본만 지우시면 됩니다. 제품 동작에는 영향이 없습니다.

오라클, 티베로에서는 다음 화면이 열리지 않습니다 - 지식 그래프, 관계 지도, 온톨로지 관리, 이상 판정 노드의 계보 메타 목록. 이 기능들은 PostgreSQL 전용 확장 위에 만들어져 있어서, 해당 화면은 오류 대신 지원하지 않는다는 안내를 보여 줍니다. 나머지 기능은 모두 동일하게 동작합니다.

설치한 뒤에 운영 데이터베이스만 바꾸기 - 재설치 없이 이미 운영 중인 서버의 운영 데이터베이스(레포지토리)만 다른 데이터베이스로 갈아끼웁니다. 설치 폴더에 함께 들어 있는 switch_repo.sh 를 쓰며, HTTPS 설정과 접속 비밀키는 그대로 유지됩니다.

지금 데이터는 새 데이터베이스로 넘어가지 않습니다. 새 데이터베이스에 표를 새로 깔고 갈아끼우는 방식이라, 사용자 계정, 메타 정보, 대시보드, 질의 이력이 모두 처음 상태로 돌아갑니다(관리자 계정도 초기 비밀번호로). 자료를 지키면서 옮겨야 한다면 이 방법이 아니라 별도 이관이 필요하니 기술지원으로 문의해 주세요.

설치한 지 오래된 서버라면 시작 전에 두 가지를 먼저 하세요.

1. 이미지 패치를 먼저 적용합니다. 새 데이터베이스에 표를 만들 때 쓰는 기준 파일이 제품 이미지 안에만 있고, 파일 교체 패치로는 갱신되지 않습니다. 이미지가 낡은 채로 시작하면 표를 넣는 도중에 멈추는데, 그때는 이미 지금 자료를 버린 뒤라 되돌릴 수 없습니다.

2. 전환 스크립트를 최신본으로 바꿉니다. 이 파일도 패치로 갱신되지 않아 설치 당시 판 그대로입니다. 최신본은 시작 전에 이미지가 낡았는지 확인하고, 낡았으면 아무것도 바꾸지 않고 멈춥니다. 이미지 패치를 적용하면 최신본이 제품 이미지 안에 들어오니 아래처럼 꺼내 쓰세요.

# Docker · Podman rootful - 설치 폴더가 /opt/prism-cosmos
$ sudo docker cp trinity-prism-core:/app/ops/switch_repo.sh /opt/prism-cosmos/switch_repo.sh
$ sudo chmod +x /opt/prism-cosmos/switch_repo.sh

# Podman rootless - 설치 폴더가 홈 아래 ~/prism-cosmos, sudo 없이 그대로
$ podman cp trinity-prism-core:/app/ops/switch_repo.sh ~/prism-cosmos/switch_repo.sh
$ chmod +x ~/prism-cosmos/switch_repo.sh

설치 폴더로 바로 꺼냅니다. 아래 실행 단계가 설치 폴더 안에서 ./switch_repo.sh 를 부르기 때문입니다. 다른 곳에 꺼내 두면 그 자리에 파일이 없어 실패합니다.

컨테이너 이름은 설치 시점에 정해집니다. 예전에 설치한 서버는 cosmos-core 일 수 있으니 docker ps(Podman 이면 podman ps) 로 실제 이름을 확인하고 바꿔 쓰세요.

# (1) 설치 폴더로 이동
$ cd /opt/prism-cosmos

# (2) 새 접속 주소를 파일에 적습니다 (명령줄에 직접 쓰면 비밀번호가 다른 사용자에게 보입니다)
$ printf '%s' 'oracle://계정:비밀번호@<오라클서버>:1521/<서비스명>' > ./dsn.txt
$ chmod 600 ./dsn.txt

# (3) 바꾸지 않고 점검만 - 먼저 확인
$ sudo ./switch_repo.sh --to-file=./dsn.txt --dry-run

# (4) 실제 전환
$ sudo ./switch_repo.sh --to-file=./dsn.txt

# (5) 다 쓴 주소 파일은 지웁니다
$ rm -f ./dsn.txt

파일을 만들기 번거로우면 아래처럼 한 줄로 넘겨도 됩니다. 파일이 생기지 않으니 지울 것도 없습니다. --to= 뒤에 주소를 그대로 쓰는 방법은 비밀번호가 들어 있으면 거절합니다. 전환이 도는 몇 분 동안 같은 서버에 로그인한 누구나 실행 중인 명령을 볼 수 있기 때문입니다.

$ printf '%s' 'tibero://계정:비밀번호@<티베로서버>:8629/<DB이름>' | sudo ./switch_repo.sh --to=- -y

내장 PostgreSQL 로 되돌리려면 아래처럼 실행합니다. 되돌릴 때는 남아 있는 내장 데이터 폴더를 비워야 해서 --reset-internal-db 가 함께 필요합니다. 이 옵션은 내장 PostgreSQL 에 남아 있던 자료를 지웁니다. 되돌릴 수 없습니다. 옮기기 전에 쓰던 자료가 거기 있다면 먼저 백업하세요.

$ sudo ./switch_repo.sh --to=internal-pg --reset-internal-db

준비물은 위 오라클, 티베로로 설치와 같습니다 - 연결용 자바 파일은 설치 폴더의 drivers 폴더에 넣고, 버전 조건(오라클 19 이상, 티베로 7 이상)을 만족해야 합니다. 전환 도중 문제가 생기면 설정을 바꾸기 전으로 되돌리고 멈춥니다. 다만 새 데이터베이스에 절반쯤 만들어진 표는 그대로 남습니다. 다시 시도하기 전에 그 계정을 비워 주세요.

전환한 뒤에 uninstall.sh 를 쓰면 옮기기 전에 쓰던 내장 PostgreSQL 자료가 없어집니다. 옮긴 것을 되돌릴 마지막 수단이 그 자료입니다. 반대로 새로 연결한 데이터베이스의 표는 이 스크립트가 지우지 않으니, 그쪽은 필요하면 직접 정리하세요.

Podman rootless 로 설치한 서버는 설치 폴더가 ~/prism-cosmos 이고, 앞의 sudo 없이 일반 계정으로 그대로 실행합니다.

다시 설치하기, 문제가 생기면완전 초기화 후 재설치, 설치 중 막혔을 때 점검
다시 깨끗하게 설치 - 완전 초기화 후 재설치 이미 설치된 걸 완전히 지우고 새로 설치하려면, 남아 있는 컨테이너, 데이터, 이미지, 설치 폴더를 먼저 모두 지운 뒤 install.sh 를 다시 실행합니다. 기존 설치가 남아 있으면 재설치가 기존 설치 감지로 중단되거나 옛 버전이 그대로 떠서, 새로 깔기 전 초기화가 필요합니다.

컨테이너, 볼륨, 이미지만 지우면 부족합니다. 화면(프론트) 원본은 설치 폴더(/opt/prism-cosmos)에 있어, 이 폴더가 남아 있으면 재설치해도 옛 화면이 그대로 뜹니다. 아래 uninstall.sh 는 이 폴더까지 한 번에 지웁니다(수작업으로 지운다면 sudo rm -rf /opt/prism-cosmos 도 함께 실행하세요).

Podman rootless 로 설치한 서버라면 설치 폴더가 /opt/prism-cosmos 가 아니라 홈 아래 ~/prism-cosmos 입니다. uninstall.sh 와 install.sh 모두 앞의 sudo 를 빼고 일반 계정으로 그대로 실행하세요(엔진은 자동으로 판별되며, Docker 와 Podman 이 공존하는 서버에서는 --engine=podman 처럼 지워야 할 엔진을 지정해야 합니다). 수작업으로 지울 때도 sudo 없이 rm -rf ~/prism-cosmos 입니다. Podman rootful 은 Docker 와 동일하며, 설치 폴더와 실행 방식 모두 위 Docker 설명을 따릅니다. 컨테이너와 데이터만 지우고 이 폴더를 남겨 두면, Docker든 Podman이든 재설치해도 옛 화면이 그대로 뜹니다.

데이터가 영구 삭제됩니다 - DB, 설정, 라이선스까지 모두 지워지며 되돌릴 수 없습니다. 데이터를 지키며 버전만 올리려면 초기화가 아니라 위 업데이트 패키지를 사용하세요.

uninstall.sh 받기 - 완전 초기화 스크립트

# (1) 받은 uninstall.sh 를 설치 서버로 옮깁니다 - 설치본을 푼 폴더에 두면 편합니다
# (2) 무엇이 지워질지 먼저 확인 - 실제 삭제는 하지 않습니다
$ sudo bash uninstall.sh --dry-run
#     Podman rootless 설치라면 sudo 없이:  bash uninstall.sh --dry-run
#     Docker 와 Podman 이 공존하는 서버라면 지울 엔진을 지정합니다
#     예)  bash uninstall.sh --engine=podman --dry-run
# (3) 경고 확인 후 전량 삭제 + 자동 검증
$ sudo bash uninstall.sh
# (4) 다시 설치
$ sudo ./install.sh

2026년 7월 9일 릴리즈 이후 설치본에는 이 스크립트가 기본 포함되며, 그 다음 릴리즈부터는 설치할 때 설치 폴더(/opt/prism-cosmos/uninstall.sh)에도 복사되어 패키지 폴더를 지웠어도 바로 실행할 수 있습니다. 그 이전에 설치한 서버에는 없으니, 여기서 받아 설치 서버 호스트로 옮긴 뒤 실행하세요.

문제가 생기면 화면이 안 뜨거나 설치/패치 중 막히면 호스트에서 직접 명령으로 점검합니다. 웹 화면, 모니터링, 로그에 못 들어가는 상황까지 대비한 명령 모음을 설치 후 정상동작 확인 - 문제 해결에 정리했습니다(컨테이너 상태, 로그, 헬스 체크, 패치 실패 시 대응).

설치가 끝나면 설치 후 정상동작 확인 가이드로 모니터링, AI 모델 연결을 점검하세요.

업데이트 가이드 - 3단계

이미 운영 중이라면 패치 번들 하나로 무중단 갱신합니다.
명령줄 없이 관리자 화면에서 끝납니다.

1
업데이트 패키지 받기
위 업데이트 패키지에서 패치 번들(.tar.zst)을 받습니다. 폐쇄망은 USB로 옮깁니다.
2
시스템 업데이트 화면 열기
관리자로 로그인한 뒤 시스템 설정 › 시스템 업데이트 메뉴를 엽니다.
3
끌어다 놓으면 자동 적용
받은 파일을 화면에 드래그앤드롭하면 무결성 검증 → 무중단 적용까지 자동입니다. 문제가 생기면 직전 버전으로 자동 롤백되고, 진행 상황이 실시간 로그로 표시됩니다.
업데이트 전에 확인할 것버전 표기 맞추기(3.0.0 전환), Podman 설치본 조치 파일 - 해당하실 때만
버전 표기 맞추기 - 업데이트가 막히거나 경고가 뜰 때 제품 버전 표기가 7.0.0 에서 3.0.0 으로 바뀝니다. 숫자가 작아져서 일부 서버가 새 패치를 낮은 버전으로 잘못 읽습니다.

먼저 확인하세요. 2026년 8월 21일 판(7.0.0.20260821) 이상을 받으셨으면 이 작업이 필요 없습니다. 그 판부터는 표기가 바뀐 것을 알아보고 새 패치가 평소처럼 올라갑니다. 지금 버전은 관리자 화면의 시스템 업데이트에서 보실 수 있습니다.

그 판을 건너뛰셨다면 아래 두 경우 중 하나가 납니다.

1. 낮은 버전이라며 업데이트가 막힐 때 - 오래 전에 설치하신 서버에서 납니다. 이 스크립트를 실행하시면 그대로 올라갑니다.

2. 되돌리기 경고가 뜰 때 - 확인을 누르시면 그냥 설치되지만, 이력에 이전 버전으로 남습니다. 경고 없이 넘기고 싶으시면 패치를 올리기 전에 실행하세요. 이번 한 번만이고, 다음 회차부터는 뜨지 않습니다.

설치된 내용은 그대로 둡니다. 표기의 앞자리만 7 에서 3 으로 바꿉니다(예: 7.0.0.20260813 을 3.0.0.20260813 으로). 데이터, 설정, 라이선스는 손대지 않습니다. 실행할 때마다 되돌리기 파일이 같은 폴더에 만들어지니, 원래대로 돌리고 싶으면 그 파일 하나만 실행하면 됩니다.

버전 표기 맞추기 스크립트 받기

# (1) 받은 파일을 제품이 설치된 서버로 옮깁니다
# (2) 무엇이 바뀔지 먼저 확인 - 실제로는 바꾸지 않습니다
$ bash version_rebase_to_3.sh --dry-run
# (3) 실제로 맞추기
$ bash version_rebase_to_3.sh
#     데이터베이스 컨테이너를 여러 개 띄운 서버라면 이름을 지정합니다
#     예)  bash version_rebase_to_3.sh trinity-prism-pg

Docker 와 Podman 을 모두 지원하며, 컨테이너를 멈추거나 다시 띄우지 않습니다. 새로 설치하는 서버는 이 작업이 필요 없습니다 - 처음부터 3.0.0 으로 시작합니다. 예상하지 못한 버전 표기가 있으면 아무것도 바꾸지 않고 멈추고 그 값을 보여 주니, 그대로 기술지원으로 알려 주세요.

Podman 설치본 조치 파일 Podman 으로 설치한 서버에서 업데이트가 적용되지 않을 때 사용합니다. 한 번 실행하면 이후 업데이트는 정상 동작합니다.

두 가지를 함께 처리합니다. 하나는 설치본에 남아 있는 읽기전용 마운트로, 새 파일 쓰기를 막아 업데이트가 적용 도중 되돌아갑니다. 다른 하나는 업데이터에 들어 있는 podman-compose 버전으로, 1.5.0 은 컨테이너 이름을 제대로 만들지 못해 이미지 교체가 매번 실패합니다. 이 파일이 마운트를 걷어내고 podman-compose 를 1.6.0 으로 올립니다.

sha256 aabcb3f3bce76a90244edb3b927908cbd82be060406f36a118e281c5d74a3f6c

Podman 조치 파일 받기 - 87MB

$ unzip prism-updater-hotfix-podman.zip -d ~/hotfix && cd ~/hotfix
# 무엇을 할지 먼저 확인 - 실제 변경은 하지 않습니다
$ bash apply-updater-hotfix.sh --dry-run
$ bash apply-updater-hotfix.sh
#   rootless 설치라 sudo 없이 그대로 실행합니다

패치 중 막히면 설치 후 정상동작 확인 - 문제 해결의 패치 실패 대응을 참고하세요.

필수 소프트웨어

PRISM은 Docker 또는 Podman 에서 동작합니다.
설치기가 서버에 있는 엔진을 자동으로 판별하니, 아래 중 한쪽만 준비되어 있으면 됩니다.

Docker Engine - 24.0 이상

컨테이너 런타임. Ubuntu 기준 공식 설치 스크립트로 한 번에 설치됩니다.

# 공식 설치 스크립트 실행
$ curl -fsSL https://get.docker.com | sudo sh
# 설치 확인 - Docker version 24.0.x 이상
$ docker --version
참고 비 root 사용자로 운영할 경우 sudo usermod -aG docker $USER 실행 후 재로그인하세요.

Docker Compose - v2 내장

멀티 컨테이너 오케스트레이션. Docker 최신 버전에 compose 플러그인이 기본 포함되어 별도 설치가 필요 없습니다.

# 설치 확인 - Docker Compose version v2.x.x
$ docker compose version

Podman - RHEL 대안 · 4.9(RHEL 8) / 5.4(RHEL 9)

RHEL 계열에 기본 포함된 컨테이너 엔진입니다. 관리자(root) 권한 없이 일반 계정으로 운영하는 rootless 와, Docker 와 같이 root 로 운영하는 rootful 을 모두 지원합니다. rootless 는 Docker 설치나 root 권한이 막힌 폐쇄망, 보안 환경에 적합합니다. 컨테이너 조합에는 podman-compose 가 필요하며, 없으면 함께 설치합니다.

# 설치 확인 - Podman 4.9 이상
$ podman --version
$ podman-compose --version
참고 Podman 은 별도 준비 없이 ./install.sh 를 실행하면 됩니다. sudo 없이 실행하면 rootless, sudo 로 실행하면 rootful 입니다. 재부팅 후 자동 기동 설정은 두 방식 모두 설치기가 처리하며, 로그아웃 유지(linger) 는 rootless 에만 해당합니다. 자세한 방법은 위 Docker · Podman 설치 방법을 참고하세요.

제품에 포함된 소프트웨어

아래 소프트웨어는 설치본 안에 모두 들어 있어 따로 준비하실 필요가 없습니다.
보안성 검토나 자산 목록 제출에 쓰실 수 있도록 정식 명칭과 버전을 정리했습니다.

웹, 애플리케이션 계층
웹서버nginx 1.27.5
실행 환경Python 3.11.15
애플리케이션 서버Uvicorn 0.52.0
FastAPI 0.141.1
자바 런타임OpenJDK Temurin 21.0.11
자바는 오라클, 티베로 연결용 드라이버를 돌릴 때만 사용합니다
데이터, 검색 계층
데이터베이스PostgreSQL 16.10
그래프 확장Apache AGE 1.6.0
캐시Redis 7.4.10
검색엔진Elasticsearch 8.13.0
분석 엔진DuckDB 1.5.5
이미 운영 중인 서버가 있으면 그쪽에 연결해 쓸 수 있습니다
어느 버전 기준인가요 위 값은 설치본 3.0.0.20260813 기준입니다. 설치본이 올라가면 끝자리 버전이 달라질 수 있으니, 정확한 값이 필요하시면 릴리즈 노트를 함께 확인하시거나 기술지원으로 문의해 주세요. Tomcat, WebLogic 같은 별도 WAS 제품은 사용하지 않습니다. 웹서버와 애플리케이션 서버가 설치본 안에서 함께 동작합니다.
이미 갖춘 인프라를 쓰실 때 PostgreSQL, Elasticsearch, Redis 는 사내에서 운영 중인 서버에 연결해 쓸 수 있고, 운영 데이터베이스는 오라클이나 티베로로 두실 수도 있습니다. 방법은 위 운영 데이터베이스를 오라클, 티베로로 설치와 외부 DB, 검색엔진, Redis 연결을 참고하세요.

함께 보면 좋은 문서

방화벽, 디스크, 설치 일정까지 현장 준비는 설치 전 준비사항 체크리스트에서, 설치 직후 모니터링, AI 모델 연결 점검은 설치 후 정상동작 확인 가이드에서 확인하세요.