RAY Unified Installer — CS 엔지니어 매뉴얼

대상 독자: CS 엔지니어(설치·운영) — 핵심: 본사 CS, 부가: 해외법인/딜러 CS · 대상 버전: v1.2.0 이상 · 최종 갱신: 2026-10-02

위 탭에서 필요한 항목으로 바로 이동하세요: 개요·배경(배경지식·참조), Server(Server Agent 구축·운영), Client(Client Agent·진료 PC 이슈), 5DI(5D 특수 환경).

개요 · 배경

이 제품이 왜 필요한가

기존에는 병원 내 각 PC가 개별적으로 클라우드에 접속해 SW를 업데이트했습니다. 이 방식은 PC마다 버전 불일치, SW 간 호환성 문제, 다수 PC 동시 설치 시 시간·트래픽 낭비를 낳았습니다.

RAY Unified Installer는 병원 내 Application Server 1대가 SW 설치 파일을 중앙 관리하고, 나머지 Application Client PC들이 이 Server로부터 받아 설치·업데이트하도록 하여 이 문제를 해결합니다.

사용 주체는 CS 엔지니어입니다 — 병원 사용자가 직접 조작하는 도구가 아닙니다. Agent는 백그라운드 서비스로 상주하고, CS 엔지니어는 브라우저로 접속해 관리(CS Console)합니다.

핵심 정책 — 설계의 대전제

이 값들은 제품 설계의 불변 전제입니다. 현장 요구가 이와 충돌하면 임의로 바꾸지 말고 본사(플랫폼개발팀)에 문의하세요.

정책	내용	비고
OS 범위	Windows 10 이상, 32/64bit 모두	macOS/Linux 미지원
관리자 권한 상주	Agent는 Windows 서비스로 관리자 권한 상주	최초 설치 시 UAC 승격을 CS가 승인
클라우드는 별개	Agent는 국가 Code 전달 + 응답 파싱만 하며 클라우드 카탈로그를 만들지 않음	카탈로그에 SW가 없으면 Agent 버그가 아니라 클라우드 등록 문제일 수 있음
UI = CS Console(Web)	브라우저로 localhost 접속	별도 설치형 GUI 없음
보안	원내 network 한정 / SW는 SHA-256 / 콘솔은 고정 Password	Server↔Client 상호 인증 없음
서버 수동 교체	자동 Failover 없음	Server 장애 시 CS가 수동 교체 + Client 재지정
공존	기존 SW 자동 업데이트와 공존	—
Agent 자체 업데이트	Server/Client 모두 자동	Server는 인터넷, Client는 Server 경유

아키텍처 한눈에

[클라우드]  ←(인터넷, Server만)
      │
[Application Server + Server Agent]   ← CS가 CS Console로 관리
      │ (원내 Local network only)
      ├─[Client PC + Client Agent] ─ 진료 SW 설치
      ├─[Client PC + Client Agent]
      └─ ...

Server Agent: 원내 대표 PC 1대. 카탈로그·패키지 중앙 관리, Client 배포 오케스트레이션.
Client Agent: 각 진료 PC. Server를 30초 주기로 폴링, 지시받은 SW를 Silent 설치.
Application Server ↔ Data Server: 논리적 구분이며, 물리 PC가 같을 수도 다를 수도 있습니다.

관리 대상 SW

관리 대상 SW는 제품이 정한 목록이고, 각 SW의 버전·설치 파일은 클라우드(RDC — RAYTeams Developer Center)에서 SW별로 개별 조회합니다. 즉 "무엇을 관리할지"는 본사 결정, "그 SW의 최신 버전이 무엇인지"는 클라우드가 정합니다. 따라서 목록에 SW를 추가·제외하는 것은 현장에서 할 수 없고, 반대로 목록에 있는 SW라도 클라우드에 게시된 버전이 없으면 버전이 비어 보일 수 있습니다.

현재 관리 대상 SW(2026-08 기준 — 변동 가능):

SW	비고
RAYTeams	필수 설치 — 모든 PC 공통 기반. 목록 최상단에 표시되며 제외할 수 없음
SMARTDent	SMARTDent 3D는 SMARTDent 설치본에 포함되어 별도 항목 없음
RAYBridge
RAYFace	RAYFace Smile Design / Ortho Simulator의 선행 설치 대상
RAYFace Smile Design	RAYFace 종속 — 선택 시 RAYFace 자동 선택
RAYFace Ortho Simulator	RAYFace 종속 — 선택 시 RAYFace 자동 선택
RAYFusion
RAYDENT Studio
RAYDENT Splint
RAYDENT Converter

RAYServer · RAYScan 시리즈는 현재 관리 대상이 아닙니다(본사 결정). RAYScan 설치 시 함께 설치되는 항목이며, 이 제품의 카탈로그·환경 구성·배포 목록에 나타나지 않습니다.

선택 규칙: RAYTeams는 목록에 표시되며 항상 포함됩니다(체크 해제·"설치 안 함" 선택 불가). 종속 관계가 있는 SW는 선행 SW가 자동 선택됩니다.

카탈로그 vs 사이트 환경 구성 — 카탈로그는 클라우드에 있는 설치 가능한 전체 SW 목록이고, 사이트 환경 구성은 그 중 이 병원에서 실제로 쓸 SW·버전입니다. 이후 모든 Client 배포는 사이트 환경 구성이 기준입니다.

구성 요소와 표준 값

항목	값
표준 설치 경로	`C:\Ray\RAYSWInstaller\` (하위 `packages\`, `logs\`, `data\`)
CS Console 접속	`http://127.0.0.1:8096/cs/` (health: `http://127.0.0.1:8096/health`)
Windows 서비스명	`ray-server-agent` / `ray-client-agent`
설치 실행 파일	`ray-server-agent.exe` / `ray-client-agent.exe`
배포용 Setup	`RAY-Unified-Installer-server-setup.exe` / `RAY-Unified-Installer-client-setup.exe` (더블클릭 → 표준 경로 자동 설치)
받은 설치 파일 (Server)	`C:\Ray\RAYSWInstaller\packages\` — 하위 폴더 없이 원본 파일명 그대로 보관
받은 설치 파일 (Client)	`C:\Ray\RAYSWInstaller\data\client-cache\binaries\<SW>\<버전>\`
진행 상황 파일	`C:\Ray\RAYSWInstaller\jobs.json` (내려받는 중인 SW와 진행량)

위 경로는 Agent 실행 파일이 있는 위치를 기준으로 잡습니다. 표준 경로가 아닌 곳에 설치했다면 그 폴더 아래에 같은 구조로 생깁니다.

Agent 자체 업데이트 (자동)

주기: 서비스 시작 직후 약 5초 + 이후 1시간마다. 배포 버전 > 현재 버전이면 자동 다운로드→교체→재시작.
경로: Server는 인터넷 경유, Client는 Server 경유.
실패 시: 이전 버전 유지 + 다음 주기 재시도. 서비스 중단 없음.

권장 설정 (Best Practices)

Server는 유선·상시전원 PC 1대로 고정 — 단일 장애점.
국가 Code를 셋업 때 명시적으로 설정 — 자동 추정에 의존하지 말 것.
고정 Password는 사이트별로 다르게, 안전 보관.
배포는 진료 외 시간에 — 강제 종료·재부팅 동반 가능.

로그

위치: C:\Ray\RAYSWInstaller\logs\agent-YYYY-MM-DD.log (일자별, retention 설정).
어떤 exe를 어떤 인자·작업디렉토리·실행 컨텍스트로 실행했고 결과가 무엇인지가 남습니다. 트러블슈팅의 1순위 증거입니다.

보안 정책

항목	정책
네트워크	원내 Local network only. WAN은 Server↔클라우드만
Server↔Client 인증	없음
SW 무결성	SHA-256(제공 시 필수) + 정식 릴리스 코드 서명
콘솔 접근	고정 Password(해시 저장), localhost 한정
로그	민감정보 평문 로그 금지

네트워크·방화벽·백신 사전 준비

병원 IT 환경에 따라 방화벽·백신 정책이 다릅니다. 현장 방문 전에 아래를 확인하면 설치 실패의 상당수를 예방할 수 있습니다.

포트

대상	방향	포트	설명
Server (대표 PC)	들어오는 연결	TCP 8096	진료 PC들이 접속. 설치 시 방화벽 규칙이 자동 등록되며, 실패하면 수동 허용 필요
Server (대표 PC)	나가는 연결	TCP 443 (HTTPS)	클라우드에서 SW 목록·설치 파일 다운로드
Client (진료 PC)	들어오는 연결	Agent는 불필요	Agent는 자기 PC 안에서만 열립니다. 설치 대상 SW 자체가 요구하는 예외는 이 표의 범위가 아닙니다(아래 주의)
Client (진료 PC)	나가는 연결	TCP 8096 → Server	Client가 Server에 접속하는 단방향 구조
Client (진료 PC)	인터넷	불필요	Client는 클라우드에 직접 접속하지 않습니다

Server의 나가는 연결에서 허용이 필요한 주소:
api-rsp-application.rayteams.com · api-teams-info.rayteams.com · common.rayplatform.com · r2.rayplatform.com · ray-data.s3.ap-northeast-2.amazonaws.com

⚠️ 이 표의 범위는 Unified Installer(Server·Client Agent) 자신의 통신입니다.
설치 대상 SW 는 각자의 통신 요건이 있어, 그 프로그램에 대한 방화벽 예외가 별도로 필요할 수 있습니다 — 특히 다른 PC 가 접속해 오는 구성으로 설치한 경우입니다. 필요 여부와 형태는 SW·사이트 구성에 따라 달라지므로 해당 SW 의 설치·구성 안내를 함께 확인하세요. 이 표만 보고 "진료 PC 는 들어오는 규칙이 전혀 필요 없다" 로 세팅하면 SW 쪽에서 문제가 될 수 있습니다.
설치 대상 SW 의 방화벽 예외는 각 SW 의 설치 프로그램이 등록합니다 (2026-08-28 결정). Unified Installer 는 자기 통신(Server 인바운드 8096)만 등록합니다. 특정 SW 의 예외가 등록되지 않는다면 그 SW 개발팀에 문의하세요.

5DI 구성을 쓰는 PC는 그 PC 안에서 RAYTeams 로컬 서비스(포트 8008)가 열려 있어야 합니다. PC 내부 통신이라 방화벽 개방은 필요 없습니다.

계정 권한

Agent는 Windows 서비스(관리자 권한)로 상주하므로, 관리자 계정으로 로그인해 있어야만 설치되는 것은 아닙니다.
설치는 로그온한 사용자 화면에서 진행됩니다. 로그온한 사용자가 관리자면 그 화면에서 관리자 권한으로 실행되고(UAC 창 없음), 일반 사용자이거나 아무도 로그온해 있지 않으면 백그라운드(시스템 권한)로 자동 전환해 설치합니다.
다만 일부 SW의 설치 프로그램은 화면이 있어야 정상 동작하므로, 배포 시에는 관리자 계정으로 로그온해 둔 상태를 권장합니다. 병원 IT 업체가 일반 사용자 계정 정책을 쓰더라도 배포 작업 시점에만 로그온하면 됩니다.

백신(Antivirus)

정식 릴리스 Agent는 코드 서명이 되어 있습니다.
대용량 설치 파일의 다운로드·압축 해제·실행이 집중되는 C:\Ray\RAYSWInstaller\ (특히 packages\) 는 실시간 검사 예외 등록을 권장합니다. 실시간 검사가 파일을 붙잡으면 설치가 느려지거나 실패할 수 있습니다.
백신의 '알 수 없는 설치 프로그램 차단' 이나 랜섬웨어 폴더 보호가 C:\Ray\ 및 각 SW 설치 경로를 막지 않는지 확인하세요.

부록

CLI 빠른 참조

ray-server-agent install | uninstall | start | stop | version | setpw | ping
ray-client-agent  install --server=http://<ServerIP>:8096 | uninstall | start | stop | version | ping

국가 Code — ISO 3166-1 alpha-2(예: KR, US). 미설정 시 자동 추정: 저장설정 → IP → Timezone → KR.

용어집

Server Agent / Client Agent: 중앙 관리용 / 각 진료 PC용 상주 서비스.
CS Console: 브라우저로 접속하는 관리 화면(localhost).
사이트 환경 구성: 이 병원이 쓸 SW·버전 확정 목록.
카탈로그: 클라우드 기준 설치 가능한 전체 SW 목록(동적).
5DI: 5D 특수 환경 구성.

FAQ

카탈로그에 SW가 안 보여요 → 애초에 관리 대상 목록에 없는 SW인지 먼저 확인(위 "관리 대상 SW" 표). 목록에 있는데 버전이 비어 보이면 클라우드 등록/게시 상태 문제일 수 있음 — Installer 문제가 아닐 수 있습니다.
Client가 인터넷이 안 되는데요? → 정상. Client는 Server만 있으면 됩니다.
"5DI Config" 메뉴가 안 보여요 → 해당 PC에 RAYTeams가 설치돼 있고 실행 중이어야 합니다. RAYTeams를 한 번 실행한 뒤 CS Console을 새로고침하세요. 5DI 탭 참조.

Server

Server Agent는 원내 대표 PC 1대에서 동작하며, 설정·운영의 중심입니다.

1. Server Agent 설치

대표 PC에서 RAY-Unified-Installer-server-setup.exe 실행(또는 ray-server-agent install) → start.
http://127.0.0.1:8096/health 로 상주 확인.

2. CS Console 초기 셋업

브라우저로 http://127.0.0.1:8096/cs/ 접속.
고정 Password(8자 이상) 설정 — 이후 콘솔 접근 인증에 사용(해시로 저장).
국가 Code 설정 — 국가별 최신 버전 정책의 기준. 미설정 시 자동 추정: 저장설정 → IP → Timezone → KR.

3. 사이트 환경 구성 — 이 단계가 핵심

SW 탭에서 각 SW의 Cloud 버전 / 로컬 버전을 확인.
이 병원에서 쓸 SW와 버전을 선택 → RAYTeams는 목록 최상단에 "필수 설치"로 표시되며 제외할 수 없습니다(미선택 상태로 저장하면 Cloud 최신 버전이 적용됩니다).
저장 → 완료. 선택 결과가 Server에 저장되어 이후 모든 Client 배포의 기준이 됩니다.

'현재 설정 버전' 컬럼 — 이 컬럼은 그 PC에 설치되어 있는 버전이 아니라 사이트 환경 구성에 지정된 버전입니다. 아직 버전을 지정하지 않은 SW는 "미구성"으로 표시됩니다(설치 여부와 무관).

설치는 어떻게 이어지나 — 환경 구성 저장은 "무엇을 쓸지 정하는" 단계일 뿐이고, 실제 설치는 대상 PC에 따라 경로가 다릅니다.

대상	방법
대표 PC(Server) 자신	SW 목록 화면의 각 SW 설치 링크, 또는 Clients 화면의 자기 자신(self) 항목 선택 후 배포
진료 PC(Client)	Clients 화면에서 대상 PC를 선택해 배포

즉 환경 구성에서 버전 선택 → 저장 → (대표 PC는 SW 목록에서 설치 / 진료 PC는 Clients에서 배포) 순서입니다. RAYTeams도 예외가 아니어서, 환경 구성에 포함되어 있어도 배포를 실행해야 실제로 설치됩니다.

4. Client 배포

Clients 탭에서 대상 Client(들)를 선택.
사이트 환경 구성에 담긴 SW를 순차 전송 → Client Agent가 Silent 설치.
설치 전 실행 중인 대상 앱은 강제 종료 경고 후 종료됩니다. Server 자기 자신(self)도 설치 대상에 포함할 수 있습니다.

5. 배포 Job·모니터링

배포 진행 상황은 Jobs 화면에서 추적합니다.

무엇을 볼 수 있나

화면	볼 수 있는 것
Jobs	배포 작업 1건마다 `대상 N대 · 성공 / 실패 / 대기 / 진행` 집계, PC별 개별 상태, Server→Client 전송량(GB)
Clients	PC별 설치된 SW·버전을 색으로 구분(구성과 같음 / 구성과 다름 / 구성에 없음), 연결·오프라인 대수

Jobs 집계 단위는 배포 작업 1건입니다. 사이트 전체(모든 PC × 모든 SW)가 어디까지 올라왔는지는 SW 배포 현황 화면에서 확인하세요 (v1.2.0 추가). PC를 하나씩 열어보지 않아도 도달률을 알 수 있습니다.

SW 배포 현황 — 사이트 전체 도달률

설치 진행률(%)은 표시하지 않습니다. SW 설치 프로그램마다 진행 정보를 알려주는 방식이 달라 신뢰할 수 없는 수치가 나왔기 때문에, 대기 / 진행 / 성공 / 실패 상태로만 표시합니다.

6. SW 설치·업데이트 방식

모든 관리 대상 SW는 항상 Full 패키지를 받아 (재)설치합니다.
.exe/.msi는 그대로 실행, .zip은 압축 해제 후 내부 Setup.exe 실행.
다운로드 무결성은 SHA-256(제공 시 필수)로 검증합니다.

다운로드가 실패하면

이어받기를 지원합니다 (v1.2.0). 전송이 끊겨도 받아 둔 지점부터 이어받으므로, 수 GB SW를 처음부터 다시 받지 않습니다.
짧은 끊김은 자동으로 복구됩니다 (v1.2.0). 진료 PC가 Server에서 받는 구간이 끊기면 10초 간격으로 6회까지 자동 재시도하며, 매 시도가 받아 둔 지점부터 이어갑니다. 담당자가 배포를 다시 실행할 필요가 없습니다.
자동 재시도 한도를 넘으면 그 PC의 배포가 '실패'로 표시됩니다 → 그 PC만 다시 배포하세요. 이때도 받아 둔 분량부터 이어받습니다.
받다 만 임시 파일은 이어받기를 위해 남겨둡니다. 검증을 통과한 파일만 정식 파일명으로 바뀌므로, 불완전한 파일이 설치에 쓰이는 일은 없습니다.
Server가 클라우드에서 받는 구간은 자동으로 3회까지 재시도합니다. 이 구간은 배포 CDN이 이어받기를 지원하지 않아 전체를 다시 받습니다.
전체 소요 시간에는 제한이 없습니다. 느린 회선에서 수 GB를 오래 받아도 중단되지 않습니다. 다만 데이터가 전혀 오지 않으면 멈춘 것으로 보고 연결을 끊습니다 (원내 구간 20초 · 인터넷 구간 3분). 원내 구간은 끊은 뒤 위의 자동 재시도로 넘어갑니다.

낮은 버전으로 되돌리려면 (다운그레이드)

Installer는 버전의 높낮이를 따지지 않고 지정한 버전을 그대로 설치 실행합니다. 다운그레이드를 막지도, 성공을 보장하지도 않습니다.
실제로 낮은 버전이 설치될지는 그 SW의 설치 프로그램 정책에 달려 있습니다. 상위 버전이 이미 설치돼 있으면 설치 프로그램이 아무 작업도 하지 않고 끝내는 경우가 많습니다(설치 창은 떴는데 버전이 그대로).
권장 절차: 기존 버전을 먼저 제거한 뒤 대상 버전을 설치하세요.
설치가 실제로 수행되지 않았는데 '성공'으로 보이던 표시는 v1.2.0에서 정정되었습니다. 다만 설치 프로그램이 조용히 끝나는 경우까지 모두 구분할 수는 없으므로, 다운그레이드 후에는 실제 설치 버전을 확인하시기를 권장합니다.

설치 후 재부팅

Installer가 PC를 자동으로 재부팅하는 일은 없습니다.
설치 프로그램이 재부팅 필요를 표준 방식으로 알려주면 Jobs 화면에 "성공 — 재부팅 필요"로 표시됩니다. 그러나 많은 SW 설치 프로그램은 이 신호를 보내지 않으므로, 표시가 없다고 해서 재부팅이 필요 없다는 뜻은 아닙니다.
여러 SW를 일괄 배포한 뒤에는 대상 PC를 1회 재부팅하는 것을 표준 절차로 권장합니다.

7. 파일 배포 (v1.2.0 추가)

기준 PC의 환경 파일을 서버에 올려 두고, 선택한 PC들에 한 번에 내려보냅니다. PC마다 방문해 파일을 복사하던 작업을 대체합니다.

이 기능은 SW를 알지 못합니다. 지정한 파일을 지정한 위치로 옮길 뿐입니다. 각 SW의 설정 중 무엇이 서버에 동기화되고 무엇이 PC별로 저장되는지는 그 SW의 영역이며, 이 기능이 관여하지 않습니다. 따라서 "설정 백업/복원" 이나 "버전 호환성 보정" 은 하지 않습니다.

절차

CS Console 파일 배포 메뉴에서 원본 폴더를 등록합니다. 폴더 내용이 서버에 보관됩니다.
대상 PC(들)를 선택하고 배포를 실행합니다.
결과는 PC별로 표시됩니다.

파일 배포 화면

알아두실 것

항목	내용
실행 시점	담당자가 실행해야 일어납니다. 자동 동기화는 하지 않습니다
되돌림	대상 PC에서 기존 파일을 보관한 뒤 교체합니다. 실패하면 보관본으로 되돌립니다
결과 구분	설치 결과와 파일 배포 결과를 따로 표시합니다. 설치는 됐는데 파일 배포만 실패한 경우를 구분할 수 있습니다
차단 경로	드라이브 루트(`C:\`), 시스템 폴더(`C:\Windows` 등), Agent 자기 설치 경로는 안전을 위해 차단됩니다
실행 중인 앱	대상 파일을 쓰고 있는 앱이 실행 중이면 해당 PC는 건너뜁니다. 강제 종료는 사전 협의된 SW에만 적용합니다

배포 전에 대상 PC의 앱을 종료해 두시면 건너뛰는 PC 없이 한 번에 끝납니다.

8. PC 별 SW 추가 설치 옵션 (v1.2.0 추가)

같은 SW라도 PC마다 다르게 설치해야 하는 경우(서버 구성, 3D 뷰어 등)를 PC 단위로 지정합니다.

절차

Clients 화면에서 대상 PC를 엽니다.
SW별로 추가 설치 옵션을 선택하고 저장합니다.
다음 설치부터 그 PC에만 해당 옵션이 적용됩니다.

PC 별 SW 추가 설치 옵션

알아두실 것

항목	내용
지속성	한 번 지정하면 다음 설치에도 계속 적용됩니다. 매번 고를 필요가 없습니다
영향 범위	지정이 있는 PC만 영향을 받습니다. 지정하지 않은 PC의 동작은 종전과 같습니다
확인	마지막으로 적용된 결과를 화면에서 확인할 수 있습니다. 설치가 실패하면 적용 기록이 지워져 '대기'로 표시됩니다

옵션 목록이 화면에 안 보인다면 — 옵션 목록은 SW 카탈로그에서 가져옵니다. 해당 SW의 옵션이 카탈로그에 아직 등록되지 않은 것이며, 등록되면 Agent 재설치 없이 자동으로 나타납니다. 본사(플랫폼개발팀)에 문의하세요.

9. 설치 패키지를 미리 넣어두기 (packages 폴더)

인터넷 회선이 느리거나 대용량 SW를 미리 준비해 가고 싶을 때, 설치 파일을 Server의 packages 폴더에 직접 넣어두면 환경 구성 화면의 버전 선택 목록에 로컬 · v버전 옵션으로 나타납니다. 클라우드에서 다시 받지 않고 그 파일로 설치합니다.

절차

대표 PC(Server)의 C:\Ray\RAYSWInstaller\packages\ 폴더를 엽니다.
설치 파일을 폴더 최상위에 그대로 복사합니다.
CS Console의 환경 구성(또는 셋업 마법사) 화면에서 새로고침 버튼을 누릅니다.
해당 SW의 버전 선택 목록에 로컬 · v버전 이 나타나면 그것을 선택하고 저장합니다.

규칙 — 이대로 지켜야 인식됩니다

항목	규칙
위치	`packages\` 최상위만 스캔합니다. 하위 폴더를 만들면 인식되지 않습니다 (하위 폴더는 다운로드 캐시 영역)
확장자	`.exe` · `.msi` · `.zip` 만 인식. `.exe`/`.msi`는 그대로 실행, `.zip`은 압축 해제 후 내부 `Setup.exe` 실행
파일명	파일명에 점으로 구분된 버전이 있어야 그 값을 버전으로 인식합니다 (예: `RAYBridge_2.3.6.6_Setup.exe`, `RAYFace Smile Design v1.2.6.16-FULL.exe`). 버전이 없어도 목록에는 파일명으로 표시되지만, 버전 비교·표시가 되지 않으므로 버전이 들어간 파일명을 권장합니다
이름 매칭	파일명 앞부분이 해당 SW 이름과 일치해야 그 SW의 옵션으로 붙습니다. 클라우드에서 받은 원본 파일명을 바꾸지 않는 것이 가장 안전합니다
배치 위치	Server(대표 PC)에만 넣습니다. 진료 PC에 넣을 필요가 없고, 넣어도 사용되지 않습니다

완전 오프라인 병원은? 위 방식은 설치 파일 다운로드를 없애주는 것이고, SW 목록과 최신 버전 정보 조회에는 Server의 인터넷 연결이 필요합니다. 인터넷이 아예 없는 사이트는 본사(플랫폼개발팀)에 문의하세요. (SW를 통째로 포함한 오프라인 배포 패키지는 현재 제공되지 않습니다.)

10. 기존 환경 (개별 SW가 이미 깔린 병원)

사이트 환경 구성에 포함시킨 SW: 앞으로는 중앙(Installer)이 버전 관리하며, 해당 SW의 개별 자동 업데이트는 중앙 관리에 양보합니다.
환경 구성에 넣지 않은 SW: 기존 방식을 그대로 둡니다.
진료 외 시간에 배포(실행 중 앱 강제 종료). 파일 락/프로세스 경합은 견디도록 설계됐으나 재부팅 후 재시도가 가장 확실.

11. Server 트러블슈팅

Server PC 장애(교체) — 자동 Failover 없음. 새 대표 PC에 Server Agent 설치·환경 구성 복원 → 각 Client를 새 Server IP로 재지정.
CS Console 먹통 / Failed to fetch 다발 — 서버 死가 아니라 브라우저 커넥션 고갈일 수 있음. 다른 탭에서 http://127.0.0.1:8096/health 확인 → 살아있으면 새로고침/탭 정리.

Client

Client Agent는 각 진료 PC에서 동작하며, Server의 지시에 따라 SW를 설치합니다.

1. Client Agent 설치

연결 검증: ray-client-agent ping --server=http://<ServerIP>:8096
설치: ray-client-agent install --server=http://<ServerIP>:8096 → start
이후 Client는 30초 주기로 Server를 폴링합니다.

설치가 끝나면 그 PC의 Client 화면에서 연결된 Server 주소와 연결 상태를 확인할 수 있습니다. Server 주소가 바뀌면 이 화면의 Server IP 변경으로 다시 지정합니다.

Client Agent 화면 — PC 별칭과 연결 상태 — Client Agent 화면 — 연결된 Server와 연결 상태

1-1. PC 별칭 붙이기 (v1.2.0 추가)

PC에 알아볼 수 있는 이름을 붙입니다. DESKTOP-4F8K2A 대신 2진료실처럼 보이므로 배포 대상을 고를 때 헷갈리지 않습니다.

최초 설치 화면에서 입력하거나, 나중에 CS Console에서 지정할 수 있습니다.
양쪽에서 수정 가능하며, 마지막에 변경한 값이 적용됩니다.
별칭을 지정하지 않으면 PC 이름이 그대로 표시됩니다.

2. 받은 설치 파일은 어디에 있나

Client가 Server에서 받은 설치 파일은 그 PC의 아래 위치에 보관됩니다.

C:\Ray\RAYSWInstaller\data\client-cache\binaries\<SW>\<버전>\<원본 설치파일명>

받는 중에는 같은 폴더에 .incoming.bin 이라는 임시 파일로 저장되고, 다 받아 검증을 통과하면 원본 파일명으로 바뀝니다.
받다 실패하면 임시 파일은 자동 삭제됩니다.
내려받는 중인 SW와 진행량은 C:\Ray\RAYSWInstaller\jobs.json 에서 확인할 수 있습니다.
이 폴더는 이미 받은 파일을 다시 쓰기 위한 보관 영역입니다. 디스크 공간 확보가 필요하면 삭제해도 되며, 다음 배포 때 다시 받습니다.

3. 완전 제거

uninstall은 Windows 서비스만 제거합니다. 트레이 헬퍼(자동시작 레지스트리), 방화벽 규칙, data\·packages\·설치 폴더는 남습니다.
완전 제거는 수동(서비스 삭제 → 트레이 종료·레지스트리 정리 → 방화벽 규칙 삭제 → 폴더 삭제). 절차가 필요하면 본사 배포 스크립트를 요청.

5DI (5D 특수 환경)

5D가 처음이라면 — 무엇을 하는 작업인가

5D 환경은 병원 안의 여러 PC와 장비(CT, RAYFace 스캐너)를 하나의 진료 네트워크로 묶어 서로 데이터를 주고받게 만든 구성입니다. 이 묶는 작업을 하지 않으면 각 PC의 SW는 설치만 되어 있을 뿐 서로를 알지 못합니다.

CS 엔지니어가 5D 사이트에서 해야 할 일은 두 가지이고, 순서가 정해져 있습니다.

순서	할 일	어디서
①	각 PC에 SW 설치 (RAYTeams 포함)	이 제품 — Server 탭의 환경 구성 → Clients 배포
②	PC·장비를 네트워크로 묶고 설정·라이선스 적용	5DI Config 화면

①을 건너뛰면 ②를 할 수 없습니다. 5DI Config 화면은 각 PC의 RAYTeams가 제공하는 로컬 서비스와 통신해서 동작하기 때문에, 대상 PC에 RAYTeams가 설치·실행되어 있어야 목록에 나타납니다.

왜 RAYTeams가 필요한가: 5D 구성·라이선스를 실제로 적용하는 주체는 RAYTeams에 내장된 로컬 서비스입니다. CS Console은 그 서비스에 지시를 내리는 조작 화면일 뿐입니다. CS Console(브라우저)이 각 PC의 로컬 서비스를 직접 호출합니다 — 자기 PC는 localhost:8008, 원격은 http://{ip}:8008.

단계별 진행

1단계 — PC 목록 확인

화면을 열면 망내에서 RAYTeams가 실행 중인 PC들이 자동으로 나열됩니다. 각 PC 카드에는 그 PC에 연결된 장비(SN)가 함께 표시됩니다.

목록에 있어야 할 PC가 안 보이면: 그 PC의 전원·네트워크·RAYTeams 실행 여부를 확인하고 새로고침.
장비가 자동 검색되지 않으면: 장비 수동 등록으로 SN을 입력하고 그 장비가 연결된 PC를 지정합니다.
잘못 등록된 장비는 카드에서 삭제할 수 있습니다.

2단계 — 역할 지정 (CT 서버 / RAYFace 서버)

묶을 PC를 선택한 뒤, 각 PC 카드에서 역할을 지정합니다.

역할	규칙
CT 서버	CT 장비가 있는 사이트라면 정확히 1대 지정
RAYFace 서버	RAYFace 장비가 있는 사이트라면 정확히 1대 지정

두 역할은 서로 다른 축이므로, 사이트 구성에 따라 같은 PC가 두 역할을 겸할 수도 있고 다른 PC일 수도 있습니다. 지정이 빠졌거나 2대 이상 지정되면 화면 상단에 사유가 표시되고 다음 단계로 넘어가지 않습니다.

3단계 — 네트워크 묶기

대상 PC를 체크한 상태에서 네트워크 묶기를 실행합니다. 구성이 이미 잡혀 있는 사이트에서는 네트워크 다시 묶기로 표시됩니다.

4단계 — 설정·라이선스 적용

설정/라이선스 적용 버튼을 누르면 "정말 적용하시겠습니까?" 확인이 한 번 더 뜹니다(오조작 방지 2단계 확인). 확인하면 각 PC에 설정과 라이선스가 적용됩니다.

5단계 — 리부트

적용이 끝나면 각 PC를 재부팅해야 설정이 반영됩니다. 재부팅 안내가 화면에 표시되며, 이 단계를 빠뜨리면 설정이 적용되지 않은 것처럼 보입니다.

연결 실패로 표시되는 PC가 있다면 — 그 PC의 연결·방화벽 문제를 먼저 해결한 뒤 재시도하세요. 일부 PC만 실패한 경우 나머지는 정상 적용됩니다.

"5DI Config" 메뉴가 안 보일 때

이 메뉴는 조건부입니다. RAYTeams가 설치돼 있고 + 그 로컬 서비스가 실행 중일 때만(즉 Console이 localhost:8008에 접속 가능할 때만) 나타납니다. RAYTeams가 설치만 되고 한 번도 실행되지 않았다면 이 로컬 서비스가 아직 떠 있지 않아 메뉴가 숨겨집니다 — 버그가 아니라 정상 동작입니다.

나타나게 하려면:

해당 PC에서 RAYTeams를 한 번 실행하세요(포트 8008에서 로컬 서비스가 기동됩니다).
브라우저에서 CS Console을 새로고침하세요. 그러면 "5DI Config" 메뉴가 나타납니다.

RAYTeams를 실행하고 새로고침해도 계속 안 보이면, RAYTeams 로컬 서비스가 8008 포트에서 응답하지 않는 상태입니다 — RAYTeams가 실제로 실행 중인지, 방화벽/다른 SW가 로컬 포트를 막고 있지 않은지 확인하세요.

기존 5D Installer 사용자 안내

기존 5D Installer는 더 이상 사용하지 않습니다. 지원이 종료되었습니다(실행 자체는 계속 가능).

기존 5D Installer는 ① SW 설치와 ② 5D 구성·라이선스 적용이 나뉘어 있었습니다. 이제는 각각 이렇게 진행합니다.

① SW 설치 — Ray Unified Installer(본 제품)로 진행합니다.
② 구성·라이선스 적용 — 이 5DI Config 화면에서 진행합니다.

②는 기존 5D Installer의 구성·라이선스 적용과 동일하게 사용하면 됩니다. 기능은 모두 같고, Client 수동 추가만 지원하지 않습니다(망내 PC 자동 로드를 사용하세요).

정리하면, 5D 환경에서는 SW 설치는 Ray Unified Installer로, 5D 구성·라이선스 적용은 5DI Config로 진행하면 됩니다.

FAQ · 현장 가이드

기술 배경 없이도 바로 쓸 수 있는 현장용 정리입니다. 문제가 생겼을 때 이 탭을 먼저 확인하세요.

배포 전 체크리스트

Server (대표 PC)

유선 네트워크 · 상시 전원 PC 1대로 고정했는가
CS Console 접속과 비밀번호 설정을 마쳤는가
국가 설정을 직접 지정했는가 (자동 추정에 의존하지 않기)
이 병원에서 쓸 SW와 버전을 확정하고 다운로드까지 완료했는가
진료가 없는 시간대를 확보했는가 (설치 중 실행 중인 앱이 종료됩니다)

Client (진료 PC)

전원·네트워크가 계속 연결된 상태인가 (절전/최대 절전 해제 권장)
사용자가 로그온해 있는가 (권장 — 설치가 로그온한 사용자 화면에서 진행됩니다)
디스크 여유 공간이 충분한가 (대용량 SW는 수 GB, 압축 해제 공간까지 필요)

네트워크·보안 (양쪽 공통)

Server의 들어오는 TCP 8096 이 허용되어 있는가 (설치 시 자동 등록되지만 병원 보안 정책이 덮어쓸 수 있음)
Server가 인터넷(HTTPS 443) 으로 클라우드에 나갈 수 있는가
각 진료 PC에서 ray-client-agent ping --server=http://<ServerIP>:8096 이 성공하는가
백신 실시간 검사에서 C:\Ray\RAYSWInstaller\ 예외를 등록했는가 (대용량 SW에서 특히 권장)
설치할 SW 가 자체적으로 방화벽 예외를 요구하지 않는가 (위 8096 항목은 Agent 통신 기준입니다. SW 별 요건은 그 SW 의 안내 참조)
자세한 내용은 개요·배경 탭의 "네트워크·방화벽·백신 사전 준비" 참조

배포 당일 권장 순서

소수 PC로 파일럿 — 1~2대에 먼저 배포하고 제어판 등록과 실행까지 확인
이상 없으면 전체 확대
Jobs 화면에서 전 PC 완료 여부 확인
대표 SW 1~2개를 실제로 실행해 확인 (설치 완료 ≠ 실행 확인)
이상 PC만 따로 재배포
대상 PC를 1회 재부팅 — 재부팅 안내가 없던 SW도 재부팅 후에야 정상 동작하는 경우가 있습니다

자주 묻는 질문 — 설치·배포

Q. 배포는 얼마나 걸리나요?
SW마다 크게 다릅니다. 작은 SW는 수십 초, 큰 SW는 수 분입니다. 4GB급 대용량 SW는 다운로드와 압축 해제 시간이 추가로 들어 더 오래 걸립니다. 여러 SW를 한 번에 배포하면 그 합만큼 걸립니다.

Q. 여러 SW가 동시에 설치되나요?
아니요. 하나씩 순서대로 설치합니다. 앞 SW의 설치가 끝나야 다음 SW가 시작됩니다. 설치 프로그램끼리 충돌하는 것을 막기 위한 동작입니다.

Q. 진료 중에 배포해도 되나요?
권장하지 않습니다. 설치 전에 대상 SW가 실행 중이면 종료되고, SW에 따라 재부팅이 필요할 수 있습니다. 진료 외 시간에 진행하세요.

Q. 사용자가 PC에 로그온해 있어야 하나요?
권장합니다. 설치는 로그온한 사용자 화면에서 관리자 권한으로 진행됩니다. 로그온한 사용자가 없으면 백그라운드로 설치를 시도하는데, SW에 따라 결과가 달라질 수 있습니다. 안정적인 배포를 위해 로그온 상태에서 진행하세요.

Q. 원격 데스크톱(RDP)으로 접속한 상태에서 배포해도 되나요?
됩니다. 원격으로 접속한 화면도 설치 대상으로 인식합니다. 서버를 원격 관리하는 환경에서도 그대로 사용하세요.

Q. 설치 중에 검은 명령 창이 뜨나요?
뜨지 않습니다. 설치는 화면에 창을 띄우지 않고 진행됩니다. 다만 SW 자체가 설치 화면을 띄우도록 만들어진 경우에는 그 SW의 화면이 보일 수 있습니다.

Q. 완료 표시가 바로 안 되는데 실패인가요?
아닙니다. 설치 프로그램이 완전히 끝날 때까지 기다린 뒤 완료로 표시합니다. 파일이 먼저 복사돼 보여도 설치가 끝난 것은 아니기 때문입니다. 대용량 SW는 몇 분 이상 "설치 중"으로 보이는 것이 정상입니다.

Q. 설치 중에 PC를 끄거나 재부팅했습니다.
해당 SW는 설치가 중단된 상태일 수 있습니다. 그 PC에 다시 배포하세요. 같은 SW를 다시 설치하는 것은 문제가 없습니다.

Q. 이미 설치된 SW를 다시 배포해도 되나요?
됩니다. 항상 전체 패키지를 받아 다시 설치하는 방식이라, 재배포가 곧 복구 수단입니다.

Q. 특정 PC 한 대만 설치할 수 있나요?
됩니다. Clients 화면에서 대상 PC만 선택해 배포하세요.

Q. 다운로드가 중간에 끊기면 어떻게 되나요?
받다 만 임시 파일은 이어받기를 위해 남겨둡니다. 검증을 통과한 파일만 정식 파일명으로 바뀌므로 불완전한 파일이 설치에 쓰이는 일은 없습니다. 진료 PC가 Server에서 받는 구간은 10초 간격 6회까지 자동 재시도하며 받아 둔 지점부터 이어받습니다(v1.2.0). 한도를 넘으면 그 PC의 배포가 '실패'로 표시되므로 해당 PC만 다시 배포하세요 — 이때도 이어받습니다. Server가 클라우드에서 받는 구간은 자동으로 3회까지 재시도합니다.

Q. 이어받기(중단된 지점부터 재개)가 되나요?
v1.2.0부터 지원합니다. 진료 PC가 Server에서 받는 구간(원내)에서 동작하며, 끊긴 뒤 다시 받으면 받아 둔 지점부터 이어갑니다. 짧은 끊김은 자동 재시도로 복구되므로 대부분 담당자가 개입할 일이 없습니다. 단, Server가 클라우드(인터넷)에서 받는 구간은 이어받기가 되지 않습니다. 배포 CDN이 범위 요청을 지원하지 않기 때문입니다. 인터넷 회선이 불안정한 사이트에서는 대용량 SW를 미리 packages 폴더에 넣어두는 방식(Server 탭 참조)을 권장합니다.

Q. 다운로드가 몇 시간째 진행 중인데 실패한 건가요?
전체 소요 시간 제한은 없습니다. 느린 회선에서 수 GB를 받는 중이라면 정상입니다. 데이터가 전혀 오지 않으면 멈춘 것으로 보고 연결을 끊습니다(원내 구간 20초 · 인터넷 구간 3분). 원내 구간은 그 뒤 자동 재시도로 이어받으므로, 잠깐 '재시도 중'이 보였다가 계속되는 것은 정상입니다.

Q. 낮은 버전으로 되돌릴 수 있나요? (다운그레이드)
Installer는 버전의 높낮이를 따지지 않고 지정한 버전을 그대로 설치 실행합니다. 다만 그 SW의 설치 프로그램이 다운그레이드를 거부하는 경우가 많습니다(설치 창은 떴는데 버전이 그대로). 기존 버전을 먼저 제거한 뒤 대상 버전을 설치하세요. 또한 이 경우 배포 작업이 '성공'으로 표시될 수 있으니 작업 후 실제 설치 버전을 반드시 확인하세요.

Q. 설치 후 재부팅이 필요한가요?
Installer가 PC를 자동 재부팅하는 일은 없습니다. 설치 프로그램이 재부팅 필요를 알려주면 Jobs 화면에 "성공 — 재부팅 필요"로 표시되지만, 많은 SW는 이 신호를 보내지 않습니다. 표시가 없다고 재부팅이 불필요한 것은 아니므로, 일괄 배포 후에는 대상 PC를 1회 재부팅하는 것을 권장합니다.

Q. 진료 PC 계정이 관리자가 아니어도 설치되나요?
됩니다. Agent가 관리자 권한으로 상주하므로 로그온 계정이 일반 사용자여도 설치가 진행됩니다(백그라운드 전환). 다만 일부 SW의 설치 프로그램은 화면이 있어야 정상 동작하므로, 배포 시점만이라도 관리자 계정으로 로그온해 두는 것을 권장합니다.

자주 묻는 질문 — 상태 표시

Q. Client가 오프라인(stale)으로 보입니다.
그 PC의 전원·네트워크·Agent 상태를 확인하세요. 전원이 켜져 있고 네트워크도 정상인데 계속 오프라인이면, 해당 PC의 Agent 서비스를 재시작한 뒤 잠시(약 1분) 기다려 보세요.

Q. 완료로 표시됐는데 제어판과 바탕화면에 안 보입니다.
일부 SW는 바탕화면 아이콘을 아예 만들지 않고 시작 메뉴에만 등록합니다(예: RAYTeams). 시작 메뉴에도 없고 실행도 되지 않으면 해당 PC의 Agent 로그와 함께 본사에 문의하세요.

Q. 버전이 올라가지 않습니다.
해당 PC에 실제로 설치된 버전을 먼저 확인하세요. 최신 버전으로 다시 배포해도 그대로면 해당 PC의 Agent 로그와 함께 본사에 문의하세요.

Q. Job이 오랫동안 "설치 중"입니다.
대용량 SW에서는 정상입니다. 30분 넘게 그대로면 해당 PC의 Agent 로그와 함께 본사에 문의하세요.

Q. 배포 후 목록에 SW가 그대로 남아 있습니다.
화면 새로고침을 먼저 해보세요. 그래도 남아 있으면 그 SW의 설치가 실제로 끝나지 않았을 수 있습니다.

Q. SW를 제거했는데 Clients 목록에 계속 '설치됨(초록)'으로 남아 있습니다.
설치 여부 판정은 Windows 제어판(프로그램 추가/삭제) 등록이 아니라, 그 SW의 지정된 파일을 직접 읽어 버전을 확인하는 방식입니다. 따라서 다음 경우 제거 후에도 계속 '설치됨'으로 보입니다.

제거 도구가 그 파일을 삭제하지 않고 남긴 경우
다른 경로에 별도 설치본이 남아 있는 경우 (예: Installer 도입 전 수동 설치본)
Hotfix 버전이 정식본과 같은 버전으로 표기되어 있는 경우

표시는 30초 주기로 갱신되므로, 30초 이상 지나도 그대로면 위 3가지 중 하나입니다. 해당 SW의 설치 폴더에 파일이 남아 있는지 확인해 보시고, 원인이 불분명하면 그 PC의 Agent 로그·설치 폴더 파일 목록·제어판 항목 유무를 함께 본사에 보내주세요.

Q. Hotfix 버전과 정식 배포본을 설치 후에 구별할 수 있나요?
같은 버전으로 표기된 경우 현재는 구별할 수 없습니다. 설치 버전 판정은 실행 파일의 버전 정보를 읽는 방식이라, Hotfix가 정식본과 같은 버전으로 만들어졌으면 화면상 동일하게 보입니다. 현장에서 Hotfix를 별도로 적용한 경우에는 적용 이력을 따로 기록해 두시기 바랍니다. (Hotfix에 다른 버전 번호를 부여하는 방향으로 각 SW 개발팀과 협의 중이며, Installer 쪽에서도 배포 이력 표시 기능을 검토 중입니다.)

자주 묻는 질문 — 환경·설정

Q. Server PC의 IP가 바뀌었습니다.
각 Client가 새 IP를 알아야 합니다. Client PC에서 서버 주소를 새 IP로 다시 지정하세요. IP가 자주 바뀌는 환경이면 대표 PC에 고정 IP를 권장합니다.

Q. 콘솔 비밀번호를 잊었습니다.
해당 PC에서 비밀번호 재설정 절차로 새로 설정할 수 있습니다(본사 제공 스크립트 사용). 원격에서는 재설정할 수 없습니다.

Q. 인터넷이 느리거나 대용량 SW를 미리 준비해 가고 싶습니다.
설치 파일을 대표 PC의 C:\Ray\RAYSWInstaller\packages\ 폴더 최상위에 미리 복사해 두세요. 화면을 새로고침하면 버전 선택 목록에 로컬 · v버전 으로 나타나고, 클라우드에서 다시 받지 않습니다. 자세한 규칙은 Server 탭의 "설치 패키지를 미리 넣어두기"를 참조하세요.

Q. 인터넷이 아예 없는 병원입니다.
위 방식은 설치 파일 다운로드만 없애줍니다. SW 목록과 최신 버전 조회에는 대표 PC의 인터넷 연결이 필요하므로, 완전 오프라인 사이트는 본사에 문의하세요. SW를 통째로 포함한 오프라인 배포 패키지는 현재 제공되지 않습니다.

Q. 목록에 없는 SW를 설치하고 싶습니다.
현장에서 임의로 추가할 수 없습니다. 관리 대상 SW 목록은 본사가 정하므로 본사에 요청하세요.

Q. 국가를 잘못 설정했습니다.
설정 화면에서 변경하고, 이후 SW 목록·버전이 새 기준으로 바뀐 것을 확인하세요.

Q. Server와 Client를 한 PC에 같이 설치할 수 있나요?
아니요. 같은 PC에 함께 설치할 수 없습니다. 대표 PC 자신에게 SW를 설치하려면 Clients 화면의 자기 자신 항목을 사용하세요.

Q. Agent는 자동으로 업데이트되나요?
예. Server와 Client 모두 자동 업데이트됩니다. 적용까지 최대 1시간 정도 걸릴 수 있습니다.

Q. 방화벽에서 무엇을 열어야 하나요?
Server(대표 PC)의 들어오는 TCP 8096 과 나가는 HTTPS 443 입니다. 진료 PC는 Agent 용도로는 들어오는 규칙이 필요 없고, Server로 나가는 8096만 되면 됩니다. 이는 Unified Installer 자신의 통신 기준이며, 설치 대상 SW 가 요구하는 방화벽 예외는 별개입니다 — 해당 SW 의 구성 안내를 확인하세요. Server 설치 시 8096 규칙이 자동 등록되지만 병원 보안 정책이 이를 덮어쓸 수 있으니 확인하세요. 허용해야 할 클라우드 주소 목록은 개요·배경 탭의 "네트워크·방화벽·백신 사전 준비"에 있습니다.

Q. 백신 예외를 등록해야 하나요?
정식 릴리스 Agent는 코드 서명이 되어 있어 대체로 문제가 없습니다. 다만 대용량 SW를 다루는 사이트에서는 C:\Ray\RAYSWInstaller\ (특히 packages\) 를 실시간 검사 예외로 등록하는 것을 권장합니다. 실시간 검사가 설치 파일을 붙잡으면 설치가 느려지거나 실패할 수 있습니다.

Q. 받은 설치 파일은 어디에 저장되나요?
Server는 C:\Ray\RAYSWInstaller\packages\ 에 원본 파일명 그대로, 진료 PC는 C:\Ray\RAYSWInstaller\data\client-cache\binaries\<SW>\<버전>\ 에 저장됩니다. 디스크 공간이 필요하면 지워도 되며, 다음 배포 때 다시 받습니다.

본사 문의 시 함께 보내주세요

정확한 자료가 있으면 원인 확인이 크게 빨라집니다.

증상과 발생 시각 (예: "8/7 14:20경 A PC에 RAYFace 배포, 완료 표시 후 실행 안 됨")
대상 PC와 SW·버전 (Clients 화면 캡처면 충분)
Agent 로그 파일 — 해당 PC의 C:\Ray\RAYSWInstaller\logs\ 에서 그날 날짜 파일
CS Console 화면 캡처 — Jobs 화면과 Clients 화면
이미 시도한 조치 (재배포·재부팅 등)
상태 표시가 실제와 다른 경우 — 그 SW의 설치 폴더에 남아 있는 파일 목록, 제어판 '프로그램 추가/삭제' 항목 유무(있다면 표시된 버전), Server의 C:\Ray\RAYSWInstaller\packages\index.json

로그 파일이 가장 중요합니다. 설치를 언제 시작해 언제 끝냈고 어떤 결과였는지가 기록되어 있어, 추측 없이 원인을 좁힐 수 있습니다.