Specify the legacy file version naming convention for recorded files in Wowza Streaming Engine

This article describes how to enable legacy file version naming in Wowza Streaming Engine™ media server software 4.0 and later so that file names of recorded segments conform to the naming scheme used by Wowza Media Server™ 3.1.2 and earlier.

Recorded stream file naming in Wowza Streaming Engine


Wowza Streaming Engine appends _[SegmentNumber] to the end of the file name of the current recording as needed to create a unique file name. This is done incrementally for the group of files that belong to the same recording session:

myStream_2014-02-11-13.18.01.441-MST_0.mp4 Oldest recording
myStream_2014-02-11-13.18.01.441-MST_1.mp4
myStream_2014-02-11-13.18.01.441-MST_2.mp4 Newest recording

Wowza Streaming Engine also includes recording start time, 2014-02-11-13.18.01.441-MST in the preceding example, in the file name. The start time is based on a template string and identifies the group of files as belonging to the same recording.

If you start recording a new live stream that's also named myStream, the new recording start time timestamp (2014-02-11-13.19.19.081-MST, below) identifies the group of files as belonging to the new recording:

myStream_2014-02-11-13.19.19.081-MST_0.mp4 Oldest recording
myStream_2014-02-11-13.19.19.081-MST_1.mp4
myStream_2014-02-11-13.19.19.081-MST_2.mp4 Newest recording

Recorded stream file naming in Wowza Media Server 3.1.2 and earlier


In Wowza Media Server 3.1.2 and earlier, the file name of the current recording is always the same as the stream name of the live stream, for example, myStream.mp4. If you stop the recording and then start recording again, _[SegmentNumber] is appended to the file name of the previously recorded file. For example, myStream.mp4 is renamed to myStream_0.mp4 and myStream_1.mp4 is created for the new recording. This is done incrementally for the group of files that belong to the same recording session:

myStream_0.mp4 Oldest recording
myStream_1.mp4
myStream.mp4 Newest recording

When some time elapses and you then start recording a new live stream that is also named myStream, Wowza Media Server continues to version the recorded files in the same manner. However, because a recording start time timestamp isn't included in the name of the recorded file, it can be difficult to determine from the file name which files belong to which recording session:

myStream_0.mp4 Oldest recording from the previous session
myStream_1.mp4
myStream_2.mp4 Newest recording from the previous session
myStream_3.mp4 Oldest recording from the current session
myStream_4.mp4
myStream.mp4 Current recording

Enable the legacy recorded file naming convention in Wowza Streaming Engine


Note: Don't enable legacy recorded file naming if you're using the SEGMENT_BY_DURATION, SEGMENT_BY_SIZE, or SEGMENT_BY_SCHEDULE segmentation types to record live streams.
  1. In the Wowza Streaming Engine Manager contents panel, click the live application name (for example, live).
     
  2. On the live application page Properties tab, click StreamRecorder Defaults in the Quick Links bar.
    Note: Access to the Properties tab is limited to administrators with advanced permissions. For more information, see Manage credentials.
  3. In the StreamRecorder Defaults area, click Edit.
  4. Click the Enabled check box for the streamRecorderUseSimpleFileVersioningNaming property, and then select the option True for the property.


     
  5. Click Save.
  6. Click Restart in the upper-right corner of the live application page to restart the application.

Alternatively, you can configure the streamRecorderUseSimpleFileVersionNaming property in XML.

  1. Navigate to [install-dir]/conf/[application]/ and open Application.xml a text editor.
  2. Add the streamRecorderUseSimpleFileVersionNaming property to the <StreamRecorder>/<Properties> container in the file as follows:
<StreamRecorder>
    <Properties>
        <Property>
            <Name>streamRecorderUseSimpleFileVersionNaming</Name>
            <Value>true</Value>
            <Type>boolean</Type>
        </Property>
    </Properties>
<StreamRecorder>

More resources