# Getting Started with Linux

Linux에서 OvenMediaEngine Enterprise를 시작하려면 아래 [전제 조건](#undefined)을 확인한 후 [설치 방법](#undefined-2)을 따라 진행하십시오.

## 전제 조건

### OS 요구사항

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

* Ubuntu 24.04 LTS
* Ubuntu 22.04 LTS
* RHEL 9
* RHEL 8

## 설치  경로

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

* 설치 경로: `/usr/share/ovenmediaengine`
* 로그 경로: `/var/log/ovenmediaengine`

## 설치 방법

### 자동 다운로드 및 설치

설치 스크립트를 활용하여 한번의 명령어로 OvenMediaEngine Enterprise를 쉽게 설치 할 수 있습니다.

#### 설치 스크립트 다운로드

{% code overflow="wrap" %}

```bash
curl -fsSL https://packages.ovenmediaengine.cloud/scripts/install-ovenmediaengine-enterprise.sh -o install-ovenmediaengine-enterprise.sh && chmod +x install-ovenmediaengine-enterprise.sh
```

{% endcode %}

#### 설치 및 업그레이드

{% tabs %}
{% tab title="최신 버전" %}

#### \[최초 설치]

최초 설치시에 유효한 라이선스 키를 파라미터로 입력 후 설치 스크립트를 실행하세요.

```bash
sudo ./install-ovenmediaengine-enterprise.sh -k 'Your.License.Key'
```

#### \[업그레이드]

최신 버전으로 업그레이드 하려는 경우는 라이선스 키 입력 없이 바로 설치 스크립트를 실행하세요.

{% code overflow="wrap" %}

```bash
sudo ./install-ovenmediaengine-enterprise.sh
```

{% endcode %}
{% endtab %}

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

```bash
sudo ./install-ovenmediaengine-enterprise.sh --list
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   OvenMediaEngine Enterprise — Installer  v1.0.0
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✔  Detected OS: ubuntu 24.04 (family: debian)

▶ Available versions
  ℹ  Fetching available versions from apt repository...

    1  0.20.5.1-2
    2  0.20.4.3-1
    3  0.20.4.2-1
    4  0.20.4.1-1
    5  0.20.4.0-1
    6  0.20.3.0-1

  ℹ  Install a specific version with: -v <VERSION>
```

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

```bash
VERSION=0.20.4.3-1
sudo ./install-ovenmediaengine-enterprise.sh -k 'Your.License.Key' -v $VERSION
```

{% endtab %}
{% endtabs %}

#### 삭제

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

```bash
sudo ./install-ovenmediaengine-enterprise.sh --uninstall
```

### 패키지 파일로 설치

#### 패키지 다운로드

OvenMediaEngine Enterprise는 `.deb` 및 `.rpm` 파일 형식으로도 패키지가 제공됩니다. OME Enterprise 팀으로부터 패키지 파일 다운로드 링크를 받으셨다면, 해당 파일을 다운로드하고 아래 지침에 따라 설치 및 실행하십시오.

#### 설치 스크립트 다운로드

{% code overflow="wrap" %}

```bash
curl -fsSL https://packages.ovenmediaengine.cloud/scripts/install-ovenmediaengine-enterprise.sh -o install-ovenmediaengine-enterprise.sh && chmod +x install-ovenmediaengine-enterprise.sh
```

{% endcode %}

#### 설치

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

{% code overflow="wrap" %}

```bash
sudo ./install-ovenmediaengine-enterprise.sh -k 'Your.License.Key' -f <ovenmediaengine-enterprise-package-file>
```

{% endcode %}

#### 삭제

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

```bash
sudo ./install-ovenmediaengine-enterprise.sh --uninstall
```

### 실행

다음 명령어들을 통해 OvenMediaEngine Enterprise를 시작/중지 할 수 있습니다.

```bash
# Start OvenMediaEngine
sudo systemctl stop ovenmediaengine
sudo systemctl start ovenmediaengine

# Start Web Console (OvenStudio)
sudo systemctl stop ovenstudio
sudo systemctl start ovenstudio

# Start OvenMediaEngine Delivery Module
sudo systemctl stop ovenmediaengine-delivery
sudo systemctl start ovenmediaengine-delivery
```

## 설치 후 설정 변경

### License Key 변경

라이선스 키를 잘못 입력했거나 변경된 경우 아래 명령어를 통해 라이선스 키를 변경 할 수 있습니다.

```bash
sudo ./install-ovenmediaengine-enterprise.sh -c -k 'Your.License.Key'
```

### Host Address 변경

설치 시 자동 설정 된 호스트 주소를 변경하거나, TLS 사용을 위해 도메인 설정이 필요한 경우 호스트 주소를 변경 할 수 있습니다.

```bash
sudo ./install-ovenmediaengine-enterprise.sh -c -H 'Your.Host.Address'
```

## 기본 설정 포트

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

### OvenMediaEngine

<table><thead><tr><th width="200">Port</th><th>Purpose</th></tr></thead><tbody><tr><td>1935/TCP</td><td>RTMP Input</td></tr><tr><td>9999/UDP</td><td>SRT Input</td></tr><tr><td>4000/UDP</td><td>MPEG-2 TS Input</td></tr><tr><td>9000/TCP</td><td>Origin Server (OVT)</td></tr><tr><td><p>80/TCP</p><p>443/TLS</p></td><td><p>Low Latency HLS (LLHLS) Streaming</p><p><em><mark style="color:red;">* Streaming over non-TLS is not allowed with modern browsers.</mark></em></p></td></tr><tr><td><p>80/TCP</p><p>443/TLS</p></td><td>WebRTC Signaling (both ingest and streaming)</td></tr><tr><td>3478/TCP</td><td>WebRTC TCP relay (TURN Server, both ingest and streaming)</td></tr><tr><td>10000 - 10009/UDP</td><td>WebRTC Ice candidate (both ingest and streaming)</td></tr><tr><td><p>80/TCP</p><p>443/TLS</p></td><td>Thumbnail Extraction</td></tr></tbody></table>

### Web Console (OvenStudio)

<table><thead><tr><th width="200">Port</th><th>Purpose</th></tr></thead><tbody><tr><td>8080/TCP</td><td>Running Web Console</td></tr></tbody></table>