> ## Documentation Index
> Fetch the complete documentation index at: https://kvm.xdr.ooo/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenXDR KVM Installer

> Stellar Cyber OpenXDR 구성 요소를 KVM 기반 Linux 환경에 배포하고 운영하기 위한 스크립트 기반 자동화 프레임워크입니다.

OpenXDR deployment automation

# KVM 기반 Stellar Cyber 배포를 반복 가능한 절차로.

KVM 호스트 준비부터 Data Processor와 Sensor VM 배포, 하드웨어·네트워크·스토리지 검증, 재부팅 후 이어서 실행까지 하나의 가이드형 설치 흐름으로 관리합니다.

[설치 프로그램 선택 →](https://kvm.xdr.ooo/ko/getting-started/choose-installer.md)
[빠른 시작](https://kvm.xdr.ooo/ko/getting-started/quickstart.md)

**Prepare**하드웨어, libvirt, 스토리지, 네트워크, passthrough 준비 상태를 검증합니다.**Deploy**DP, Standard Sensor, AIO + Sensor에 맞는 가이드형 배포 절차를 사용합니다.**Resume**재부팅과 부분 실행 뒤에도 단계 상태와 검증 결과를 유지합니다.

## 문서 개요

OpenXDR KVM Installer는 Stellar Cyber OpenXDR 구성 요소를 KVM에 배포할 때 필요한 호스트 작업을 자동화합니다. libvirt, 스토리지, 네트워크, VM 이미지, passthrough, CPU 배치, 재부팅 상태를 각각 수작업으로 구성하는 대신 `whiptail` 메뉴, 작업 상태 저장, 검증 절차를 제공합니다.

이 설치 도구는 다음과 같은 일반적인 배포 작업을 **표준화하고 자동화**하여 운영 복잡성을 줄이도록 설계되었습니다.

* KVM / libvirt 호스트 환경 준비
* Data Processor(DP) 및 Sensor 가상머신 배포
* 네트워크 인터페이스, 브리지, PCI 패스스루 설정
* 연속 자동 실행(Auto Execute) 또는 단계별 실행 모드 지원
* 호스트 설정 및 배포 상태 검증

모든 설치 절차는 **대화형 메뉴 기반 인터페이스**를 통해 실행되며, 운영자는 **필요한 단계만 선택 실행**하거나 **처음부터 끝까지 자동 배포**를 수행할 수 있습니다.

> [!TIP]
>
> **처음 배포합니까?** **[설치 프로그램 선택](https://kvm.xdr.ooo/ko/getting-started/choose-installer.md)** → **[배포 방식 설계](https://kvm.xdr.ooo/ko/getting-started/deployment-guide.md)** → **[요구사항](https://kvm.xdr.ooo/ko/getting-started/requirements.md)** → **[Ubuntu 24.04 준비](https://kvm.xdr.ooo/ko/getting-started/installing-ubuntu-24-04.md)** → **[빠른 시작](https://kvm.xdr.ooo/ko/getting-started/quickstart.md)** 순서로 진행하십시오.

## 빠른 경로

> [card] [1. 설치 프로그램 선택](https://kvm.xdr.ooo/ko/getting-started/choose-installer.md)
>
> DP, Standard Sensor, AIO + Sensor 중 배포 대상에 맞는 설치 프로그램을 선택합니다.

> [card] [2. 배포 방식 설계](https://kvm.xdr.ooo/ko/getting-started/deployment-guide.md)
>
> 베어메탈, 클러스터, 프라이빗 클라우드에 맞는 네트워크와 토폴로지를 결정합니다.

> [card] [3. 요구사항 확인](https://kvm.xdr.ooo/ko/getting-started/requirements.md)
>
> CPU, Memory, Storage, BIOS, NIC 및 접근 요구사항을 확인합니다.

> [card] [4. Ubuntu 24.04 준비](https://kvm.xdr.ooo/ko/getting-started/installing-ubuntu-24-04.md)
>
> KVM 호스트의 BIOS, OS, 스토리지, 네트워크 준비 절차를 확인합니다.

> [card] [5. 빠른 시작](https://kvm.xdr.ooo/ko/getting-started/quickstart.md)
>
> DRY\_RUN, 검증, 실제 실행, 재부팅 후 이어서 실행 순서로 첫 배포를 진행합니다.

> [card] [6. 설치 데모 비디오](https://kvm.xdr.ooo/ko/getting-started/installation-demo-videos.md)
>
> 3개의 설치 데모 영상으로 전체 배포 흐름을 확인합니다.

> [card] [문제 해결](https://kvm.xdr.ooo/ko/operations/troubleshooting.md)
>
> Validation, Log, Step 단위 재실행으로 실패 원인을 확인합니다.

## 이 문서의 대상

이 문서는 다음과 같은 사용자를 대상으로 합니다.

* 온프레미스 XDR 인프라를 운영하는 **Stellar Cyber 시스템 관리자**
* PoC, 스테이징, 운영 환경 배포를 수행하는 **구축 및 배포 담당자**

## 배포 대상

> [card] [Data Processor](https://kvm.xdr.ooo/ko/installers/dp.md)
>
> KVM 호스트를 준비하고 DL/DA 스토리지와 DL-master/DA-master VM, 고성능 네트워크 경로를 구성합니다.

> [card] [Standard Sensor](https://kvm.xdr.ooo/ko/installers/sensor.md)
>
> 관리 네트워크와 SPAN 인터페이스를 포함한 Standard Modular Sensor VM을 배포합니다.

> [card] [AIO + Sensor](https://kvm.xdr.ooo/ko/installers/aio-sensor.md)
>
> 하나의 KVM 호스트에 AIO Data Processor와 Sensor를 함께 배포합니다.

## 설계 원칙 (Design Principles)

OpenXDR KVM Installer는 다음 원칙을 기반으로 설계되었습니다.

### ① 반복 가능성 (Repeatability)

* 모든 설치 단계는 \*\*결정론적(deterministic)\*\*이며
* 안전하게 **재실행 가능**
* PoC, 스테이징, 운영 환경 간 **일관된 결과 보장**

### ② 변경 내용을 확인할 수 있는 운영

* 모든 동작은 로그 및 검증 절차를 통해 **명확히 확인 가능**
* 불투명한 자동화 없이, **무엇이 수행되는지 항상 가시적**

### ③ 선택적 자동화 (Selective Automation)

* 전체 자동 배포 실행 가능
* 또는 배포 시나리오에 따라 **특정 단계만 선택 실행 가능**

### ④ 현장 중심 설계 (Field-driven Design)

* 이론적인 실험 환경이 아닌
* **실제 고객 환경에서의 운영 경험을 기반으로 설계**

## 적용 범위 및 구성

본 문서는 KVM 호스트에서 Stellar Cyber OpenXDR 구성 요소를 배포하는 **전체 라이프사이클**을 다룹니다.

포함 내용:

* 호스트 준비 및 기본 설정
* 가상머신 배포 및 리소스 할당
* 네트워크 및 PCI 패스스루 설정
* 배포 이후 검증 및 상태 점검

주요 대상 환경:

* **온프레미스**
* **KVM 기반 Linux 환경**
* **Ubuntu LTS** (주요 지원 플랫폼)

## 자동화 범위

| 영역 | 자동화 내용 |
| - | - |
| Hardware | CPU, memory, disk, NIC, virtualization, IOMMU 탐지 |
| KVM Stack | KVM/libvirt 설치 및 기본 구성 |
| Networking | Management, NAT/bridge, SR-IOV, SPAN, passthrough |
| 스토리지 | LVM 기반 VM 스토리지 준비 |
| VM 배포 | 이미지 준비, VM 정의 및 배포 |
| Performance | CPU affinity, NUMA-aware placement, PCI passthrough |
| Lifecycle | Step state, reboot, resume |
| Safety | DRY\_RUN, explicit confirmation, full configuration validation |

## 이 설치 도구가 수행하는 작업

OpenXDR KVM Installer는 다음을 수행합니다.

* 반복적이고 오류 발생 가능성이 높은 배포 작업 자동화
* 일관된 설치 순서 및 의존성 관리 강제
* 단계별 실행과 Auto Execute 기반 연속 실행 모두 지원
* 시스템 준비 상태 및 설정 정확성 검증
* 부분 완료 상태에서도 복구 및 이어서 실행 가능

## 이 설치 도구가 수행하지 않는 작업

OpenXDR KVM Installer는 다음을 수행하지 않습니다.

* 제품 공식 문서나 아키텍처 설계를 대체하지 않음
* 문서화된 모범 사례를 넘는 **자동 성능 튜닝 제공 안 함**
* Linux 또는 KVM 운영 지식을 완전히 추상화하지 않음
* 범용 가상머신 관리 플랫폼 역할을 하지 않음

> [!WARNING]
>
> 따라서 **Linux, KVM, 네트워크에 대한 기본적인 이해는 필수**입니다.

## 공통 운영 흐름

```text theme={null}
Hardware 확인
  → Installer 입력값 구성 (DRY_RUN 유지)
  → DRY_RUN으로 전체 흐름 점검
  → Full Configuration Validation
  → FAIL 해결 및 입력값 재확인
  → DRY_RUN=0 전환
  → 전체 Step 또는 개별 Step 실행
  → 필요한 시점에 Reboot
  → 동일 Installer 재실행 후 Resume
  → 배포 후 Validation
```

> [!WARNING]
>
> 설치 프로그램은 네트워크, 스토리지, 커널, 가상화 설정과 VM 정의를 변경할 수 있습니다. 실제 실행 전 반드시 DRY\_RUN과 전체 구성 검증을 수행하십시오.

## 소스 코드 및 기여 방법

설치 스크립트의 소스 코드는 GitHub에서 관리되며, 현장 피드백을 기반으로 지속적으로 개선되고 있습니다.

➡ **[프로젝트 저장소](https://github.com/xdr-labs/OpenXDR-KVM-Installer)**

다음과 같은 기여와 피드백을 환영합니다.

* 버그 리포트
* 개선 제안
* 운영 중 발견된 이슈 및 피드백

## 관련 프로젝트

* [OpenXDR KVM Installer](https://github.com/xdr-labs/OpenXDR-KVM-Installer)
* [XDR Labs](https://xdr.ooo/)
* [Stellar Appliance CLI](https://github.com/xdr-labs/Stellar-appliance-cli)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.