OpenXDR deployment automation
KVM 기반 Stellar Cyber 배포를 반복 가능한 절차로.
KVM 호스트 준비부터 Data Processor와 Sensor VM 배포, 하드웨어·네트워크·스토리지 검증, 재부팅 후 이어서 실행까지 하나의 가이드형 설치 흐름으로 관리합니다.
Prepare하드웨어, libvirt, 스토리지, 네트워크, passthrough 준비 상태를 검증합니다.
DeployDP, 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) 또는 단계별 실행 모드 지원
- 호스트 설정 및 배포 상태 검증
빠른 경로
1. 설치 프로그램 선택
DP, Standard Sensor, AIO + Sensor 중 배포 대상에 맞는 설치 프로그램을 선택합니다.
2. 배포 방식 설계
베어메탈, 클러스터, 프라이빗 클라우드에 맞는 네트워크와 토폴로지를 결정합니다.
3. 요구사항 확인
CPU, Memory, Storage, BIOS, NIC 및 접근 요구사항을 확인합니다.
4. Ubuntu 24.04 준비
KVM 호스트의 BIOS, OS, 스토리지, 네트워크 준비 절차를 확인합니다.
5. 빠른 시작
DRY_RUN, 검증, 실제 실행, 재부팅 후 이어서 실행 순서로 첫 배포를 진행합니다.
6. 설치 데모 비디오
3개의 설치 데모 영상으로 전체 배포 흐름을 확인합니다.
문제 해결
Validation, Log, Step 단위 재실행으로 실패 원인을 확인합니다.
이 문서의 대상
이 문서는 다음과 같은 사용자를 대상으로 합니다.- 온프레미스 XDR 인프라를 운영하는 Stellar Cyber 시스템 관리자
- PoC, 스테이징, 운영 환경 배포를 수행하는 구축 및 배포 담당자
배포 대상
Data Processor
KVM 호스트를 준비하고 DL/DA 스토리지와 DL-master/DA-master VM, 고성능 네트워크 경로를 구성합니다.
Standard Sensor
관리 네트워크와 SPAN 인터페이스를 포함한 Standard Modular Sensor VM을 배포합니다.
AIO + Sensor
하나의 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 (주요 지원 플랫폼)
자동화 범위
이 설치 도구가 수행하는 작업
OpenXDR KVM Installer는 다음을 수행합니다.- 반복적이고 오류 발생 가능성이 높은 배포 작업 자동화
- 일관된 설치 순서 및 의존성 관리 강제
- 단계별 실행과 Auto Execute 기반 연속 실행 모두 지원
- 시스템 준비 상태 및 설정 정확성 검증
- 부분 완료 상태에서도 복구 및 이어서 실행 가능
이 설치 도구가 수행하지 않는 작업
OpenXDR KVM Installer는 다음을 수행하지 않습니다.- 제품 공식 문서나 아키텍처 설계를 대체하지 않음
- 문서화된 모범 사례를 넘는 자동 성능 튜닝 제공 안 함
- Linux 또는 KVM 운영 지식을 완전히 추상화하지 않음
- 범용 가상머신 관리 플랫폼 역할을 하지 않음
공통 운영 흐름
소스 코드 및 기여 방법
설치 스크립트의 소스 코드는 GitHub에서 관리되며, 현장 피드백을 기반으로 지속적으로 개선되고 있습니다. ➡ 프로젝트 저장소 다음과 같은 기여와 피드백을 환영합니다.- 버그 리포트
- 개선 제안
- 운영 중 발견된 이슈 및 피드백