> ## 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.

# AIO & Sensor KVM Installer 사용자 가이드

> Ubuntu Server 24.04 LTS KVM 호스트에 Stellar Cyber OpenXDR AIO와 Sensor VM을 배포하고 초기 설정하는 전체 절차입니다.

# AIO & Sensor KVM Installer 사용자 가이드

![AIO & Sensor KVM Installer 전체 설치 흐름 개요](https://mintcdn.com/kvm-installer/eizaosBNdBuJxqYR/images/AIO-Sensor/1.png?fit=max\&auto=format\&n=eizaosBNdBuJxqYR\&q=85\&s=a597c69b7ed24cd6ca10d0cc58f75659)

## 개요

이 페이지 하나로 **AIO + Sensor 설치부터 어플라이언스 초기 설정까지** 순서대로 진행할 수 있습니다. 제품별 하드웨어 기준, KVM 배포, AIO 초기화, Data Lake 스토리지, Sensor 등록·승인, Receiver 검증까지 모두 포함합니다.

문서 기준 OS는 Ubuntu Server 24.04 LTS입니다. 설치 후 설정만 빠르게 다시 확인하려면 \*\*[AIO & Sensor 초기 구성](https://kvm.xdr.ooo/ko/installers/aio-sensor-initial-configuration.md)\*\*을 사용할 수 있습니다.

## 1. 시스템 아키텍처

### Dell PowerEdge R650 / R660 / R670 검증 구성

![Dell PowerEdge R650, R660, R670에서 검증된 AIO 및 Sensor KVM 아키텍처](https://mintcdn.com/kvm-installer/eizaosBNdBuJxqYR/images/AIO-Sensor/2.png?fit=max\&auto=format\&n=eizaosBNdBuJxqYR\&q=85\&s=145aa939698cdb54fbdb8e50ca7dfb11)

예시 아키텍처 구성은 다음과 같습니다.

| 구성 요소 | 예시 값 |
| - | - |
| 검증된 KVM 호스트 | Dell PowerEdge R650 / R660 / R670 — Ubuntu 24.04 |
| AIO VM | 48 vCPU, 136 GB RAM |
| MDS VM | 44 vCPU, 80 GB RAM |
| Host Access | 1 GbE UTP, 로컬 전용 `192.168.0.100` |
| Management & Data Link | 1 GbE 또는 10 GbE |
| Sensor SPAN | PCI Passthrough |
| OS / VM Disk | 1 × 1.92 TB — Ubuntu 24.04, AIO VM, MDS VM |
| Data Lake | 6 × 3.84 TB — DLm 및 AIO용 |

### 하드웨어 한눈에 보기

`AIO-Sensor-Installer.sh` 설치 흐름은 Dell PowerEdge R650, R660, R670에서 검증되었습니다. 저장소에는 설치 전 확인용으로 **12 vCPU, 16 GB 메모리, 100 GB 여유 공간**이 기재되어 있지만, 이는 **운영 환경 AIO + Sensor 용량 산정 권장값이 아닙니다**. 아래는 문서화된 용량 예시입니다.

| 항목 | 검증 예시 / 요구사항 |
| - | - |
| AIO VM | 48 vCPU, 136 GB RAM |
| Sensor VM | 44 vCPU, 80 GB RAM |
| OS / VM Disk | 1 × 1.92 TB |
| Data Lake | 6 × 3.84 TB |
| Management | NAT Mode |
| Sensor SPAN | PCI Passthrough |
| BIOS | CPU Virtualization 및 VT-d/IOMMU 활성화 |
| OS | Ubuntu Server 24.04 LTS |

> [!WARNING]
>
> 일반적인 12 vCPU / 16 GB / 100 GB 저장소의 기본값을 통합 AIO + Sensor의 운영 환경 용량 산정으로 해석하지 마십시오.

### 아키텍처 개요

Stellar Cyber OpenXDR 플랫폼은 KVM 가상화를 사용하는 단일 물리 서버에 배포됩니다.

설치 프로그램은 다음 구성 요소를 자동으로 생성하고 구성합니다.

* Ubuntu 24.04 기반 KVM 호스트
* libvirt / qemu-kvm 가상화 계층
* AIO 가상 머신 (Data Platform + Analyzer 통합)
* Sensor 가상 머신(들)
* NAT 기반 가상 네트워크
* SPAN 트래픽을 위한 PCI Passthrough
* AIO 및 Sensor 워크로드를 위한 LVM 기반 스토리지
* CPU affinity 및 커널 수준 성능 튜닝

설치 프로그램은 다음 작업을 자동화하여 반복적인 수동 설정을 줄이도록 설계되었습니다.

* 호스트 OS 준비 및 튜닝
* 네트워크 구성 및 변환
* 스토리지 레이아웃 생성
* 가상 머신 라이프사이클 관리
* PCI Passthrough 및 CPU pinning과 같은 성능 중요 설정

## 2. 설치 전 준비 사항 (필수 준비 단계)

### 시스템 요구사항

설치 프로그램을 실행하기 전에 다음 조건이 충족되어야 합니다.

* **root 권한이 필요함**

설치 프로그램은 다음과 같은 저수준 시스템 작업을 수행합니다.

* 네트워크 재구성
* 커널 및 시스템 튜닝
* 디스크 및 파일 시스템 설정
* 가상 머신 생성 및 수정

### 문서 기준 운영체제

* 이 한국어 가이드는 **Ubuntu Server 24.04 LTS** 기준입니다.
* 이전 Ubuntu/OpenXDR 조합은 현재 설치 소스와 대상 릴리스 지원 범위를 별도로 확인하십시오.

## 3. 준비 단계

설치 프로그램을 준비하기 위해 다음 단계를 수행합니다.

1. root 쉘로 전환합니다.

```bash theme={null}
sudo -i
```

2. 현재 디렉터리에 설치 스크립트를 다운로드합니다.

```bash theme={null}
curl -O https://raw.githubusercontent.com/xdr-labs/OpenXDR-KVM-Installer/main/AIO-Sensor-Installer.sh
```

3. 실행 권한을 부여합니다.

```bash theme={null}
chmod +x AIO-Sensor-Installer.sh
```

4. 설치 프로그램을 실행합니다.

```bash theme={null}
./AIO-Sensor-Installer.sh
```

## 4. NIC 준비 및 설계 가이드라인

### 관리 NIC

관리 NIC는 다음 용도로 사용됩니다.

* KVM 호스트에 대한 원격 접속
* AIO 웹 인터페이스 접근
* 외부 관리 트래픽 처리

### Sensor 네트워크 모드

* **NAT 모드만 지원**
* 기본 KVM `virbr0` 네트워크를 사용하여 구현됨
* 이 설계는 배포를 단순화하고 운영 리스크를 줄임

### SPAN 연결 방식

* **PCI Passthrough만 지원**
* 브리지 기반 SPAN 연결은 지원되지 않음
* BIOS에서 IOMMU 활성화 필요
* PCI Passthrough는 Sensor 워크로드에 대해 가장 높은 패킷 캡처 성능을 제공

### NIC 준비 및 설계 가이드라인

설치 중 NIC 선택을 단순화하기 위해, 설치 프로그램 실행 전에 필요한 NIC를 물리적으로 연결하는 것을 강력히 권장합니다.

설치 프로그램은 **링크 상태를 기준으로 인터페이스를 식별**하므로, 케이블이 연결되어 있으면 각 NIC의 역할을 명확히 구분할 수 있습니다.

![NAT uplink NIC 선택 화면](https://mintcdn.com/kvm-installer/eizaosBNdBuJxqYR/images/AIO-Sensor/3.png?fit=max\&auto=format\&n=eizaosBNdBuJxqYR\&q=85\&s=e007e32da4bd559f79c055983d9e56f7)

## 5. 설치 프로그램 탐색

설치 프로그램은 Whiptail로 구현된 대화형 메뉴 기반 인터페이스를 제공합니다.

### 탐색 방법 안내

* **Spacebar 또는 아래 화살표(↓)**: 메뉴 항목 간 이동
* **Enter**: 선택
* **q 또는 ESC**: 도움말 화면 종료 또는 이전 메뉴로 돌아가기

### 상태 인식 실행 방식

설치 프로그램은 **작업 상태를 저장하는 방식**으로 동작합니다.

설치 상태는 다음 경로에 저장됩니다.

```text theme={null}
/root/xdr-installer
```

* 완료된 단계가 기록됨
* 재부팅 또는 중단 이후 다음 미완료 단계부터 재개됨

모든 설치 상태를 초기화하고 처음부터 다시 시작하려면 다음을 실행합니다.

```bash theme={null}
rm -rf /root/xdr-installer
```

### 필수 재부팅 단계

설치 프로그램은 다음 단계 이후 자동으로 시스템 재부팅을 수행합니다.

* **STEP 03 – 네트워크 변환 (netplan → ifupdown)**
* **STEP 05 – 커널 및 시스템 수준 튜닝**

이 재부팅은 필수입니다. 절대로 건너뛰지 마십시오.

재부팅 후 수행 절차:

1. 서버에 다시 로그인
2. 설치 프로그램 재실행
3. 메뉴 1 선택

설치 프로그램은 자동으로 이어서 실행됩니다.

### 메인 메뉴 옵션 개요

#### 1. Auto Execute All Steps

* 다음 미완료 단계부터 모든 단계를 자동 실행
* 재부팅 후 마지막 완료 단계부터 자동 재개
* 권장 용도
  * 초기 설치
  * 재부팅 후 이어서 진행

#### 2. Select and Run Specific Step Only

* 개별 단계를 독립적으로 실행
* 권장 용도
  * AIO VM 재배포
  * Sensor VM 재배포
  * 네트워크 변경
  * 이미지 업데이트
  * SPAN 설정 변경

#### 3. Configuration

설치 파라미터를 구성합니다.

* `DRY_RUN` (default: `1`)
* `AIO_VERSION`
* `SENSOR_VERSION`
* `SENSOR_NET_MODE` (`nat` only)
* `SPAN_ATTACH_MODE` (`pci` only)
* ACPS credentials
  * username
  * password
  * URL

#### 4. 전체 구성 검증

전체 시스템 구성을 검증합니다.

검사 항목:

* KVM
* AIO VM
* Sensor VM
* 네트워크
* SPAN
* 스토리지

상세 로그와 함께 오류 및 경고를 표시합니다.

#### 5. Script Usage Guide

* 내장 도움말 가이드 표시

#### 6. View Log

* 설치 로그 파일 표시

#### 7. Exit

* 설치 프로그램 종료

## 6. 설치 시나리오

### 6.1 신규 설치 (초기 배포)

이 시나리오는 Ubuntu 설치 직후 설치 프로그램을 실행하는 경우에 해당합니다.

#### 초기 구성

메인 메뉴에서 다음을 선택합니다.

```text theme={null}
3) Configuration
```

![AIO & Sensor Installer Configuration 화면](https://mintcdn.com/kvm-installer/eizaosBNdBuJxqYR/images/AIO-Sensor/4.png?fit=max\&auto=format\&n=eizaosBNdBuJxqYR\&q=85\&s=21daaea66ee40bcf68912c6607f83e15)

설치 파라미터를 구성합니다.

* `DRY_RUN` (default: `1`)
  * 기본값: `1` (시뮬레이션 모드)
  * 실제 설치를 수행하려면 `0`으로 설정
* `AIO_VERSION`
* `SENSOR_VERSION`
* ACPS credentials
  * username
  * password
  * URL
* `AUTO_REBOOT` (default: `1`)
* SPAN 모드는 `pci`로 고정
* 네트워크 모드는 NAT로 고정

구성이 완료되면 메인 메뉴로 돌아갑니다.

#### 자동 실행

다음을 선택합니다.

```text theme={null}
1) Auto execute all steps
```

![AIO & Sensor Installer 메인 메뉴의 Auto Execute All Steps](https://mintcdn.com/kvm-installer/eizaosBNdBuJxqYR/images/AIO-Sensor/5.png?fit=max\&auto=format\&n=eizaosBNdBuJxqYR\&q=85\&s=33422d00aa7ccd717c67f7bf250887ca)

설치 프로그램은 다음 단계를 순차적으로 실행합니다.

```text theme={null}
STEP 01 → STEP 02 → STEP 03 → … → STEP 13
```

재부팅이 필요하거나 오류가 발생하면 실행은 자동으로 중단됩니다.

### 필수 재부팅 동작

설치 프로그램은 다음 단계 이후 자동으로 호스트를 재부팅합니다.

* **STEP 03 – 네트워크 설정 변경**
* **STEP 05 – 커널 및 시스템 튜닝**

재부팅 후 수행 절차:

1. 다시 로그인
2. 설치 프로그램 재실행
3. 메뉴 1 선택

다음 미완료 단계부터 자동으로 이어서 실행됩니다.

### 6.2 개별 단계 실행 (특정 단계만 실행)

이 모드는 전체 설치 흐름을 실행하지 않고 단일 설치 단계만 실행할 수 있도록 합니다.

메인 메뉴에서 다음을 선택합니다.

```text theme={null}
2) Select and run specific step only
```

![AIO & Sensor Installer 개별 Step 선택 화면](https://mintcdn.com/kvm-installer/eizaosBNdBuJxqYR/images/AIO-Sensor/6.png?fit=max\&auto=format\&n=eizaosBNdBuJxqYR\&q=85\&s=d160369acf645c646e4005531d73e002)

#### 개별 단계 목록

| Step | 작업 |
| -: | - |
| 01 | Hardware / NIC / SPAN NIC Selection |
| 02 | HWE Kernel Installation |
| 03 | NIC Name / ifupdown Switch and Network Configuration |
| 04 | KVM / Libvirt Installation and Basic Configuration |
| 05 | Kernel Parameters / KSM / Swap Tuning |
| 06 | libvirt Hooks Installation + NTPsec |
| 07 | LVM Storage Configuration (AIO) |
| 08 | AIO Download |
| 09 | AIO VM Deployment |
| 10 | Sensor LV Creation + Image/Script Download |
| 11 | Sensor VM Deployment |
| 12 | PCI Passthrough / CPU Affinity |
| 13 | Install DP Appliance CLI package |

#### 대표적인 사용 사례

* AIO 가상 머신 재배포
* Sensor 가상 머신 재배포
* PCI Passthrough 또는 CPU affinity 재적용
* 실패한 단계 재시도
* 이미지 또는 아티팩트 재다운로드

선택한 단계만 실행되며, 이미 완료된 다른 단계는 변경되지 않습니다.

## 7. 설치 후 검증

설치 완료 후 다음을 선택합니다.

```text theme={null}
4) Full configuration validation
```

![AIO & Sensor Installer 전체 구성 검증 결과 화면](https://mintcdn.com/kvm-installer/eizaosBNdBuJxqYR/images/AIO-Sensor/7.png?fit=max\&auto=format\&n=eizaosBNdBuJxqYR\&q=85\&s=3d2a66dd1cc802967238db53cfead49c)

검증 항목은 다음을 포함합니다.

* KVM 및 libvirt 서비스 상태
* AIO 및 Sensor VM 상태와 자동 시작 설정
* 네트워크 구성
* 스토리지 가용성 및 마운트 포인트

경고가 표시되면 메뉴 2를 사용하여 해당 단계를 다시 실행하십시오.

## 8. 설치 후 일반적인 변경 사항

### 자동 재부팅 알림

* **STEP 03은 항상 재부팅을 트리거합니다.**

### 변경 시나리오

#### 관리 NIC 또는 IP 변경

```text theme={null}
STEP 01 → STEP 03
```

#### SPAN NIC 재구성 (PCI 전용)

```text theme={null}
STEP 01 → STEP 03 → STEP 12
```

#### AIO VM 재배포

```text theme={null}
STEP 07 → STEP 09 → STEP 12
```

> [!WARNING]
>
> 기존 VM은 삭제되며, ES 데이터 스토리지는 재사용할 수 없습니다.

#### Sensor VM 재배포

```text theme={null}
STEP 11 → STEP 12
```

> [!WARNING]
>
> 기존 Sensor VM은 삭제됩니다.

## 9. 필수 AIO & Sensor 초기 구성

전체 구성 검증에서 VM 배포를 확인한 뒤 다음 Appliance 설정을 완료하십시오.

### 9.1 KVM 고정 네트워크

* AIO: `192.168.122.2/24`
* Sensor/MDS: `192.168.122.3/24`
* Gateway: `192.168.122.1`
* DNS: `8.8.8.8`

### 9.2 AIO 구성

`aella / changeme`로 로그인하고 비밀번호를 변경한 뒤:

```text theme={null}
set interface management ip 192.168.122.2/24
set interface management gateway 192.168.122.1
set interface management dns 8.8.8.8
set role AIO
set cluster_name AIO
set cluster_size 1
set cm 192.168.122.2
set otp <YOUR-OTP>
reset
```

초기화 후:

```text theme={null}
show status
```

Platform이 Ready/Healthy 상태인지 확인합니다.

### 9.3 AIO Data Storage 추가

```text theme={null}
show storage
add storage blk vdb
show storage
```

> [!WARNING]
>
> `add storage blk`는 선택한 Device를 Format합니다. 승인 전에 `vdb`와 예상 용량을 확인하십시오.

GUI의 **System → DATA MANAGEMENT → Data Management → Advanced**에서 `/es-data-lvm`으로 마이그레이션하고 **System → DATA MANAGEMENT → Data Lake**에서 **Data Storage Space**를 확인합니다.

### 9.4 Sensor 연결

Sensor에서 `aella / changeme`로 로그인하고 비밀번호를 변경한 뒤:

```text theme={null}
set interface management ip 192.168.122.3/24
set interface management gateway 192.168.122.1
set interface management dns 8.8.8.8
show interfaces
set hostname <UNIQUE-SENSOR-HOSTNAME>
set cm 192.168.122.2
show cm
```

필요한 경우:

```text theme={null}
set proxy http://<PROXY-IP>:<PORT>
set tenant_id <TENANT-ID>
```

**CM Controller = 192.168.122.2**, **Status = Established**를 확인하고 `quit`로 종료합니다.

### 9.5 NTP, Sensor 승인, Receiver

* Sensor NTP/Timezone 구성
* Stellar Cyber에서 Sensor Authorization 수행
* Receiver는 DA-Master가 아니라 **AIO/DP**를 가리켜야 함
* Sensor Profile이 해당 Receiver를 사용하는지 확인
* `show logforwarder` 출력이 없으면 Receiver 설정부터 확인

### 9.6 접속

```text theme={null}
console aio
console mds
```

* AIO SSH: **2222**
* MDS SSH: **2223**

### 9.7 최종 체크리스트

* 전체 구성 검증에 미해결 FAIL이 없음
* AIO = `192.168.122.2/24`, Sensor = `192.168.122.3/24`
* AIO `show status`가 Ready/Healthy
* `vdb` 추가 및 `/es-data-lvm` 마이그레이션 완료
* Sensor Hostname이 고유함
* Sensor `show cm`이 `192.168.122.2`에 **Established**
* NTP/Timezone 및 Sensor Authorization 완료
* Receiver와 Sensor 프로필 정상
* 기본 비밀번호 변경 완료

설치 후 설정만 빠르게 다시 보려면 \*\*[AIO & Sensor 초기 구성](https://kvm.xdr.ooo/ko/installers/aio-sensor-initial-configuration.md)\*\*을 사용하십시오.

## 10. 하드웨어 및 소프트웨어 요구사항

실제 실행 전에 다음을 확인하십시오.

* Ubuntu Server 24.04 LTS
* root 권한
* CPU Hardware Virtualization 활성화
* Sensor PCI Passthrough용 VT-d/IOMMU 활성화
* 의도한 AIO/Sensor 용량을 수용할 CPU와 메모리
* 충분한 OS/VM 스토리지와 전용 Data Lake 디스크
* Management Connectivity와 필요한 Sensor SPAN NIC
* 패키지와 이미지 다운로드용 네트워크 접속
* Network 전환 전 Console 또는 Out-of-Band Access

\*\*[Ubuntu 24.04 설치 가이드](https://kvm.xdr.ooo/ko/getting-started/installing-ubuntu-24-04.md)\*\*는 추가 참고용이며 제품별 하드웨어 가이드는 이 페이지에 요약되어 있습니다.

## 11. BIOS 및 플랫폼 설정

Intel VT-x / AMD-V와 Intel VT-d / AMD-Vi (IOMMU)를 확인하십시오. 문서의 Sensor PCI Passthrough 구성에 필요합니다.


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