• How to specify the legacy file version naming convention for recorded files (Wowza Streaming Engine)

    This article describes how to enable legacy file version naming in Wowza Streaming Engine™ software (version 4.0 and later) so that the file names of recorded segments are versioned as they were in Wowza Media Server™ 3.1.2 and earlier.

    Note: For information about similar functionality supported in Wowza Media Server software (version 3.5 and later), see How to specify the legacy file version naming convention for recorded files (HTTPLiveStreamRecord).
    In Wowza Streaming Engine, file names of recorded segments are formatted as follows:
    ${SourceStreamName}_${RecordingStartTime}_${SegmentNumber}
    For example, if you're recording a live stream with the stream name myStream, the file names of the recorded segments might be versioned as:
    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
    This article describes how to enable legacy file version naming so that the file names of recorded segments are versioned as they were in Wowza Media Server 3.1.2 and earlier (without the ${RecordingStartTime} timestamp). For example:
    myStream_0.mp4 <- oldest recording
    myStream_1.mp4
    myStream.mp4 <- newest recording
    Note: For more information about how to record live streams in Wowza Streaming Engine, see How to record live streams (Wowza Streaming Engine).

    File versioning scheme details


    Wowza Streaming Engine

    The file versioning scheme in Wowza Streaming Engine software 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

    The recording starttime (2014-02-11-13.18.01.441-MST), which is based on a template string, identifies this group of recorded files as belonging to the same recording.

    If you start recording a new live stream that's also named myStream, the new recording starttime timestamp value (2014-02-11-13.19.19.081-MST) identifies the group of recorded 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

    Wowza Media Server 3.1.2 (and earlier)

    In the file versioning scheme 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) in order to create a unique file name and a new myStream.mp4 file 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

    In the case where some time passes and you then start recording a new live stream that is also named myStream, the file versioning scheme will continue to version the recorded files in the above manner in order to create unique file names for the recorded files. Because a recording startime timestamp value isn't included in the file names of the recorded files, this can make it difficult to determine which set of recorded files belong to a specific recording session for live streams with the same stream name:
    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

    Enabling legacy file version naming in Wowza Streaming Engine


    Note: We recommend that you don't enable the following property if you're using any of the following segmentationTypes to record live streams: SEGMENT_BY_DURATION, SEGMENT_BY_SIZE, SEGMENT_BY_SCHEDULE.
    To set the default file version naming scheme to the legacy style in Wowza Streaming Engine Manager, do the following:

    1. In the 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.


    To configure [install-dir]/conf/[application]/Application.xml manually, open the file in a text editor and add the property to the <StreamRecorder>/<Properties> container in the file (be sure to get the correct <Properties> container--there are several in Application.xml):
    <StreamRecorder>
        <Properties>
            <Property>
                <Name>streamRecorderUseSimpleFileVersionNaming</Name>
                <Value>true</Value>
                <Type>boolean</Type>
            </Property>
        </Properties>
    <StreamRecorder>
    For additional application configuration details, see How to record live streams (Wowza Streaming Engine).

    Originally Published: 02-11-2014.
    Updated: For Wowza Streaming Engine 4.0.6 on 08-11-2014

    If you're having problems or want to discuss this article, post in our forum.