Media Server 24.1

# Set Up Rolling Buffers

The settings for your rolling buffers are stored in a separate configuration file. This is so that you can share the rolling buffer configuration between multiple Media Servers . For example, you might have one Media Server writing video to a rolling buffer and another generating playlists.

A default rolling buffer configuration file is included with Media Server in the `/encoding/rollingBuffer` folder.

In `rollingBuffer.cfg`, you can control the following settings:

- the location of the root folder for each rolling buffer.
- the maximum number and size of the files allocated to each rolling buffer. The number of files multiplied by their size gives the total amount of storage for a rolling buffer. Media Server saves video across multiple files because this is beneficial to disk performance. You can set a default value for all rolling buffers and override it for individual rolling buffers.
- the prefixes added to URLs used in playlists.

NOTE: Apart from the settings in the `[Defaults]` section, do not edit the rolling buffer configuration file in a text editor. To add or modify rolling buffers, use the ACI actions provided by Media Server.

To set the path to the rolling buffer configuration file

1. Open the Media Server configuration file and find the `[Paths]` section.

2. Ensure that the path to the rolling buffer configuration file is set, for example:

       [Paths]
       RollingBufferConfigPath=./encoding/rollingBuffer/rollingBuffer.cfg

   Relative paths must be relative to the Media Server working directory. If you share a rolling buffer configuration file between multiple Media Servers, specify a UNC path.

3. Save and close the configuration file.
4. If you made any changes to the configuration file, restart Media Server.

To configure default settings for rolling buffers

1. Open the rolling buffer configuration file.

2. In the `[Defaults]` section, set the following parameters:

   `RootPath` | The path of the directory to store the rolling buffer files in. Relative paths must be relative to the rolling buffer configuration file.
   `MaxFiles` | The maximum number of files for each rolling buffer.
   `MaxFileSizeMB` | The maximum size in MB for each file.
   `MediaSegmentTemplate` | (Optional) A template to use to construct the URL of every media segment in a playlist.
   `VariantSegmentTemplate` | (Optional) A template to use to construct the URL of every `GetPlaylist` action that is produced by Media Server.

   For example:

       [Defaults]
       RootPath=C:\VideoRecording\
       MaxFiles=10
       MaxFileSizeMB=100

   For more information about these configuration parameters, refer to the Media Server Reference.

To add a new rolling buffer

- Use the ACI action `AddStream`, for example:

      /action=AddStream&Stream=NewsChannel&MaxFiles=10&MaxFileSize=100

  where the `Stream` parameter is required and specifies the name of the rolling buffer. The other parameters are optional and override the default rolling buffer settings.

To remove a rolling buffer

CAUTION: This deletes all video that has been stored in the rolling buffer.

- Use the ACI action `RemoveStream`, for example:

      /action=RemoveStream&Stream=NewsChannel

  where the `Stream` parameter is required and specifies the name of the rolling buffer to remove.

For more information about the actions that you can use to configure rolling buffers, refer to the Media Server Reference.

Copyright 2023 Open Text
Version 24.1 | Last updated December 2023

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: IDOL Media Server 24.1

Topic Title: Set Up Rolling Buffers