메인 콘텐츠로 건너뛰기

AIO & Sensor KVM Installer 사용자 가이드

AIO & Sensor KVM Installer 전체 설치 흐름 개요

개요

이 페이지 하나로 AIO + Sensor 설치부터 어플라이언스 초기 설정까지 순서대로 진행할 수 있습니다. 제품별 하드웨어 기준, KVM 배포, AIO 초기화, Data Lake 스토리지, Sensor 등록·승인, Receiver 검증까지 모두 포함합니다. 문서 기준 OS는 Ubuntu Server 24.04 LTS입니다. 설치 후 설정만 빠르게 다시 확인하려면 **AIO & Sensor 초기 구성**을 사용할 수 있습니다.

1. 시스템 아키텍처

Dell PowerEdge R650 / R660 / R670 검증 구성

Dell PowerEdge R650, R660, R670에서 검증된 AIO 및 Sensor KVM 아키텍처 예시 아키텍처 구성은 다음과 같습니다.

하드웨어 한눈에 보기

AIO-Sensor-Installer.sh 설치 흐름은 Dell PowerEdge R650, R660, R670에서 검증되었습니다. 저장소에는 설치 전 확인용으로 12 vCPU, 16 GB 메모리, 100 GB 여유 공간이 기재되어 있지만, 이는 운영 환경 AIO + Sensor 용량 산정 권장값이 아닙니다. 아래는 문서화된 용량 예시입니다.
일반적인 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 쉘로 전환합니다.
  1. 현재 디렉터리에 설치 스크립트를 다운로드합니다.
  1. 실행 권한을 부여합니다.
  1. 설치 프로그램을 실행합니다.

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 선택 화면

5. 설치 프로그램 탐색

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

탐색 방법 안내

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

상태 인식 실행 방식

설치 프로그램은 작업 상태를 저장하는 방식으로 동작합니다. 설치 상태는 다음 경로에 저장됩니다.
  • 완료된 단계가 기록됨
  • 재부팅 또는 중단 이후 다음 미완료 단계부터 재개됨
모든 설치 상태를 초기화하고 처음부터 다시 시작하려면 다음을 실행합니다.

필수 재부팅 단계

설치 프로그램은 다음 단계 이후 자동으로 시스템 재부팅을 수행합니다.
  • 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 설치 직후 설치 프로그램을 실행하는 경우에 해당합니다.

초기 구성

메인 메뉴에서 다음을 선택합니다.
AIO & Sensor Installer Configuration 화면 설치 파라미터를 구성합니다.
  • DRY_RUN (default: 1)
    • 기본값: 1 (시뮬레이션 모드)
    • 실제 설치를 수행하려면 0으로 설정
  • AIO_VERSION
  • SENSOR_VERSION
  • ACPS credentials
    • username
    • password
    • URL
  • AUTO_REBOOT (default: 1)
  • SPAN 모드는 pci로 고정
  • 네트워크 모드는 NAT로 고정
구성이 완료되면 메인 메뉴로 돌아갑니다.

자동 실행

다음을 선택합니다.
AIO & Sensor Installer 메인 메뉴의 Auto Execute All Steps 설치 프로그램은 다음 단계를 순차적으로 실행합니다.
재부팅이 필요하거나 오류가 발생하면 실행은 자동으로 중단됩니다.

필수 재부팅 동작

설치 프로그램은 다음 단계 이후 자동으로 호스트를 재부팅합니다.
  • STEP 03 – 네트워크 설정 변경
  • STEP 05 – 커널 및 시스템 튜닝
재부팅 후 수행 절차:
  1. 다시 로그인
  2. 설치 프로그램 재실행
  3. 메뉴 1 선택
다음 미완료 단계부터 자동으로 이어서 실행됩니다.

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

이 모드는 전체 설치 흐름을 실행하지 않고 단일 설치 단계만 실행할 수 있도록 합니다. 메인 메뉴에서 다음을 선택합니다.
AIO & Sensor Installer 개별 Step 선택 화면

개별 단계 목록

대표적인 사용 사례

  • AIO 가상 머신 재배포
  • Sensor 가상 머신 재배포
  • PCI Passthrough 또는 CPU affinity 재적용
  • 실패한 단계 재시도
  • 이미지 또는 아티팩트 재다운로드
선택한 단계만 실행되며, 이미 완료된 다른 단계는 변경되지 않습니다.

7. 설치 후 검증

설치 완료 후 다음을 선택합니다.
AIO & Sensor Installer 전체 구성 검증 결과 화면 검증 항목은 다음을 포함합니다.
  • KVM 및 libvirt 서비스 상태
  • AIO 및 Sensor VM 상태와 자동 시작 설정
  • 네트워크 구성
  • 스토리지 가용성 및 마운트 포인트
경고가 표시되면 메뉴 2를 사용하여 해당 단계를 다시 실행하십시오.

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

자동 재부팅 알림

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

변경 시나리오

관리 NIC 또는 IP 변경

SPAN NIC 재구성 (PCI 전용)

AIO VM 재배포

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

Sensor VM 재배포

기존 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로 로그인하고 비밀번호를 변경한 뒤:
초기화 후:
Platform이 Ready/Healthy 상태인지 확인합니다.

9.3 AIO Data Storage 추가

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로 로그인하고 비밀번호를 변경한 뒤:
필요한 경우:
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 접속

  • 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 초기 구성**을 사용하십시오.

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 설치 가이드**는 추가 참고용이며 제품별 하드웨어 가이드는 이 페이지에 요약되어 있습니다.

11. BIOS 및 플랫폼 설정

Intel VT-x / AMD-V와 Intel VT-d / AMD-Vi (IOMMU)를 확인하십시오. 문서의 Sensor PCI Passthrough 구성에 필요합니다.
마지막 수정일 2026년 9월 28일