Restart Application | 0.17.0.0+

OvenMediaEngine Enterprise version 0.17.0.0-1 supports the Restart Application feature.

You can apply configuration changes to an Application individually without restarting the OvenMediaEngine during service operation. All client connections from other Applications remain intact, except for the specified Application.

API Interface

Request

POST /v1/vhosts/{vhost}/apps/{app}:restart

Header

Authorization: Basic {credentials}

# Authorization
    Credentials for HTTP Basic Authentication created with <AccessToken>

Responses

200 Ok

The request has succeeded

Header

Content-Type: application/json

Body

{
    "message": "OK",
    "statusCode": 200
}
401 Unauthorized

Authentication required

Header

WWW-Authenticate: Basic realm=”OvenMediaEngine”

Body

{
    "message": "[HTTP] Authorization header is required to call API (401)",
    "statusCode": 401
}
404 Not Found

The given vhost name or application name could not be found.

Body

{
    "message": "[HTTP] Could not find the application: [default/app2] (404)",
    "statusCode": 404
}

From Web Console

Restart the Application from the Stream List

  • You can restart the Application by selecting it in the upper left of the Stream List and clicking the Restart button.

Restart the Application from the Server Settings

  1. Click the Settings button on the right side of the Web Console navigation bar to enter the Server Settings page.

  2. You can then restart the Application by scrolling down and clicking the Restart button on the right side of the Application Name in the Virtual Hosts Settings under Applications.

    • If there are multiple applications on the VirtualHost, the Applications will be listed on the Settings screen.

Last updated