OvenMediaEngine Enterprise
한국어
English한국어
한국어
English한국어
  • Introduction
  • OvenMediaEngine Configuration
  • Getting Started
    • Getting Started with Ubuntu
    • Getting Started with RHEL
    • Getting Started with Docker
  • Enterprise-grade Features
    • Web Console
      • Web Console Configuration
      • Sign In
      • Change Password
      • Web Console Home
        • Stream List
      • Stream Monitoring
        • Managed and Instant Streams
        • Scheduled Channels | 0.16.4.0+
        • Multiplex Channels | 0.16.5.0+
      • Monitoring
      • Logs
      • Configuration Files
      • Settings
        • Server
        • Live Sources (Ingress Protocols)
          • RTMP | 0.9.0.0+
          • WebRTC/WHIP | 0.12.0.0+/0.15.1.0+
          • SRT | 0.12.0.0+
          • MPEG-2 TS | 0.10.4.0+
          • Scheduled Channel | 0.16.4.0+
          • Multiplex Channel | 0.16.5.0+
        • ABR and Transcoding
          • Transcoding
          • Output Profiles
          • Adaptive Bitrate Streaming (ABR) | 0.14.3.0+
          • Encodes
          • Conditional Transcoding
        • Streaming (Egress Protocols)
          • WebRTC/WHIP | 0.9.0.0+/0.15.1.0+
          • Low Latency HLS (LLHLS) | 0.14.0.0+
          • Legacy HLS | 0.16.6.0+
        • TLS Encryption | 0.14.0.0+
        • Access Control
          • Signed Policy | 0.12.0.0+
          • Admission Webhooks | 0.12.2.0+
        • Thumbnail | 0.15.7.0+
        • Recording | 0.16.5.0+
        • Push Publishing | 0.15.14.0+
        • REST API | 0.11.0.0+
        • Alert | 0.15.11.0+
      • Restart
    • Record Delivery | 0.16.5.0+
    • Digital Rights Management (DRM)
      • OvenMediaEngine Configuration for DRM | 0.16.0.0+
      • PallyCon DRM Configuration | 0.16.4.0+
    • Hardware-Accelerated Video Encoding | 0.16.4.0+
    • Proxy Protocol Integration | 0.16.6.2+
    • Event Monitoring | v0.18.1.0 +
      • Configuration
      • Event Specification
    • Advanced Management Tool
      • API Storage | 0.17.0.0+
      • Restart Application | 0.17.0.0+
      • Publisher Extension
      • RTMP Authentication | 0.17.2.0+
      • Generating Audio PTS | 0.17.2.3+
      • Inserting AMF0 messages in RTMP Push Publisher | 0.17.3.0+
      • Inserting ad markers (EXT-X-CUE-OUT/EXT-X-CUE-IN) | v0.17.3.0+
      • Inserting SEI into H.264 (AVC) Streams | v0.18.0.0+
  • Release Notes
    • 0.18.1 (최신: 2025년 03월 28일)
    • 0.18.0
    • 0.17.3
    • 0.17.2
    • 0.17.1
    • 0.17.0
    • 0.16.8
    • 0.16.7
    • 0.16.6
    • 0.16.5
    • 0.16.4
Powered by GitBook
On this page
  • 전제 조건
  • OS 요구사항
  • 설치 경로
  • 설치 방법
  • apt Repository를 사용하여 설치
  • 패키지 파일로 설치
  • 설치 후 단계
  • License Key 등록
  • Host IP 설정
  • 실행
  • 기본 설정 포트
  • OvenMediaEngine
  • Web Console (OvenStudio)
  • 방화벽 설정 예제
  1. Getting Started

Getting Started with Ubuntu

PreviousGetting StartedNextGetting Started with RHEL

Last updated 3 months ago

Ubuntu에서 OvenMediaEngine Enterprise를 시작하려면 을 확인한 다음 를 따라 진행하세요.

전제 조건

OS 요구사항

OvenMediaEngine Enterprise를 설치하려면 아래 Ubuntu 버전 중 하나가 필요합니다.

  • Ubuntu 24.04 LTS

  • Ubuntu 22.04 LTS

  • Ubuntu 20.04 LTS

설치 경로

기본적으로 OvenMediaEngine Enterprise는 다음 경로에 설치 됩니다.

  • 설치 경로: /usr/share/ovenmediaengine

  • 로그 경로: /var/log/ovenmediaengine

설치 방법

apt Repository를 사용하여 설치

새로운 서버에 OvenMediaEngine Enterprise를 처음 설치 할 때, apt Repository를 먼저 설정해야 합니다. 그 이후 Repository를 통해 지속적인 설치 및 업데이트를 할 수 있습니다.

OvenMediaEngine 설치용 apt Repository 설정

Repository를 설정하려면 유효한 License Key가 필요합니다.

# You may need to install curl and/or gpg first, if you're on a very minimal host
sudo apt update
sudo apt install curl gpg -y

VALID_LICENSE_KEY="Your.License.Key"

# Install the registry signing key
curl -fsSL "https://buildkite:$VALID_LICENSE_KEY@packages.buildkite.com/ovenmediaengine/ubuntu/gpgkey" | sudo gpg --dearmor -o /etc/apt/keyrings/ovenmediaengine_ubuntu-archive-keyring.gpg

# Stash the private registry credentials into apt auth.conf
echo "machine https://packages.buildkite.com/ovenmediaengine/ubuntu/ login buildkite password $VALID_LICENSE_KEY" | sudo tee /etc/apt/auth.conf.d/ovenmediaengine_ubuntu.conf
sudo chmod 600 /etc/apt/auth.conf.d/ovenmediaengine_ubuntu.conf

# Configure the source
echo -e "deb [signed-by=/etc/apt/keyrings/ovenmediaengine_ubuntu-archive-keyring.gpg] https://packages.buildkite.com/ovenmediaengine/ubuntu/any/ any main\ndeb-src [signed-by=/etc/apt/keyrings/ovenmediaengine_ubuntu-archive-keyring.gpg] https://packages.buildkite.com/ovenmediaengine/ubuntu/any/ any main" | sudo tee /etc/apt/sources.list.d/buildkite-ovenmediaengine-ubuntu.list

패키지 설치

다음 명령어들을 통해 최신 버전을 설치 할 수 있습니다.

sudo apt update
sudo apt install ovenmediaengine

특정 버전의 OvenMediaEngine Enterprise를 설치하려면, 먼저 Repository에서 사용 가능한 버전을 확인 하세요.

# List the available versions
apt-cache madison ovenmediaengine | awk '{ print $3 }'

0.17.2.4-1
...

원하는 버전을 선택 한 후 설치하세요.

VERSION=0.17.2.4-1
sudo apt update
sudo apt install ovenmediaengine=$VERSION

패키지 삭제

다음 명령어를 통해 OvenMediaEngine Enterpirse를 삭제 할 수 있습니다.

sudo apt purge ovenmediaengine

패키지 파일로 설치

다운로드

OvenMediaEngine Enterprise는 deb 패키지로 제공됩니다. OME Enterprise 팀으로부터 deb 패키지를 다운로드 받을 수 있는 링크를 전달 받았다면, 해당 파일을 다운로드 한 후 아래 가이드를 따라 설치 및 실행하십시오.

설치

다음 명령어를 통해 OvenMediaEngine Enterpirse를 설치 할 수 있습니다.

sudo dpkg -i <ovenmediaengine-enterprise-package>.deb
Selecting previously unselected package ovenmediaengine.
(Reading database ... 72282 files and directories currently installed.)
Preparing to unpack <ovenmediaengine-enterprise-package>.deb ...
Unpacking ovenmediaengine (<version>) ...
Setting up ovenmediaengine (<version>) ...

# If you are upgrading, please run "systemctl daemon-reload"
sudo systemctl daemon-reload

/usr/share/ovenmediaengine 경로에 이미 OvenMediaEngine이 설치되어 있는 경우 자동 업그레이드 되며, 기존 설정 파일 또한 유지됩니다.

삭제

다음 명령어를 통해 OvenMediaEngine Enterpirse를 삭제 할 수 있습니다.

dpkg -r ovenmediaengine

# 설정 파일 포함 삭제
dpkg -P ovenmediaengine

수정 된 각종 설정 파일들은 수동으로 삭제해야 합니다.

설치 후 단계

License Key 등록

OvenMediaEngine을 실행하기 전, 유효한 License Key를 등록해야 합니다.

echo 'Your.License.Key' | sudo tee /usr/share/ovenmediaengine/conf/License

Host IP 설정

Web Console (ovenstudio)을 원활하게 사용하기 위해서는 서버의 Host IP를 설정해야 합니다.

echo -e '\nOME_HOST_IP=Your.HOST.IP.Address' | sudo tee -a /usr/share/ovenmediaengine/ovenstudio/system.env

실행

다음 명령어들을 통해 OvenMediaEngine Enterprise를 실행 할 수 있습니다.

# Start OvenMediaEngine
sudo systemctl start ovenmediaengine
# Start Web Console (OvenStudio)
sudo systemctl start ovenstudio
# Start OvenMediaEngine Delivery Module
sudo systemctl start ovenmediaengine-delivery

# If you want to auto-start on boot
sudo systemctl enable ovenmediaengine
sudo systemctl enable ovenstudio
sudo systemctl enable ovenmediaengine-delivery

기본 설정 포트

OvenMediaEngine Enterprise는 기본적으로 아래 나열된 포트를 사용하므로 방화벽 설정이 필요합니다.

OvenMediaEngine

Port
Purpose

1935/TCP

RTMP Input

9999/UDP

SRT Input

4000/UDP

MPEG-2 TS Input

9000/TCP

Origin Server (OVT)

3333/TCP

3334/TLS

Low Latency HLS (LLHLS) Streaming

* Streaming over non-TLS is not allowed with modern browsers.

3333/TCP

3334/TLS

WebRTC Signaling (both ingest and streaming)

3478/TCP

WebRTC TCP relay (TURN Server, both ingest and streaming)

10000 - 10009/UDP

WebRTC Ice candidate (both ingest and streaming)

20080/TCP

20081/TLS

Thumbnail Extraction

Web Console (OvenStudio)

Port
Purpose

8080/TCP

Running Web Console

방화벽 설정 예제

다음 예제와 같이 방화벽을 열 수 있습니다.

sudo ufw allow from any to any port 3333 proto tcp
sudo ufw allow from any to any port 3334 proto tcp
sudo ufw allow from any to any port 1935 proto tcp
sudo ufw allow from any to any port 9999 proto udp
sudo ufw allow from any to any port 4000 proto udp
sudo ufw allow from any to any port 3478 proto tcp
sudo ufw allow from any to any port 9000 proto tcp
sudo ufw allow from any to any port 10000:10009 proto udp
sudo ufw allow from any to any port 8080 proto tcp

설치가 완료되면 를 확인해 주세요.

설치가 완료되면 를 확인해 주세요.

자세한 설정 방법은 를 확인해 주세요.

여기
전제 조건
설치 단계
설치 후 단계
설치 후 단계