WMS Archive Data Writer

The WMS Archive Data Writer plug-in is used to write data from a broadcast publishing point to a file. You can configure the following options for the plug-in.

Item Description

Start archiving when publishing point starts

Select this check box to have the plug-in start archiving when the publishing point is started.

Directory

Type a path to the archive file, including an archive file name template. The default path is %systemdrive%\WMPub\WMArchive\folder\Archive_YearMonthDay.asf, where folder represents a folder with the same name as the source publishing point. If you are using a remote computer for administration, this path is the archive file location on the server, not on the remote computer. You can use a Universal Naming Convention (UNC) path or an absolute path.

The default archive file name template is Archive_YearMonthDay.asf, where Year is the year that the archive file is closed, Month is the month, and Day is the day. When the archive file is closed, the template is used to determine the appropriate file name. For example, if the archive file is closed on January 1, 2007 and the default file name template is used, the resulting archive file name is Archive_20070101.asf.

You can use environment variables and wildcard characters in the path and archive file name. Wildcard characters must be delimited by less than (<) and greater than (>) characters. For more information, see Archive wildcard characters reference.

If you change the path or name of the archive file after the publishing point has started, you must stop and restart archiving before the change takes effect.

In the Windows Media Services snap-in, you can do the following:

  • Click Browse to specify a new directory and file name for the archive file.

  • Click Expand to display the full path and file name for the current archive file. If the value of a wildcard character cannot be resolved, it will be replaced in the file name by an underscore character (_). If the value of the wildcard character can be determined when the broadcast publishing point and the archiving plug-in are active, then the wildcard character will be expanded to the placeholder variable, for example <F> will expand to PL_ROLE.

Note

This plug-in cannot be enabled or disabled while the publishing point is streaming content. If you want to archive your broadcast, you must enable the plug-in before you start your publishing point.

Note

To change the archive file path after archiving has started, you must stop archiving, change the path, and then restart archiving. You can manually start and stop archiving on the Source tab of the publishing point.

Note

A new archive file cannot overwrite an existing archive file. A version number is added to the end of the archive file name to differentiate between files, if necessary.

Note

Archive files are always saved using the Advanced Systems Format (ASF), regardless of the format of the original content.

Note

If the WMS Archive Data Writer plug-in is enabled and packets are lost during streaming, the Troubleshooting list displays the event and the number of lost packets.

Note

If you are streaming content that includes video and you enable this plug-in and Fast Start on your publishing point, clients that connect to your publishing point may miss the first few seconds of the broadcast. If you want to use the Fast Start feature, it is recommended that you use a different publishing point to create the archive file.

Note

By default, archive files are created on the system drive of your server. If you do not have adequate disk space on your system drive, make sure to change the default path. This plug-in will stop archiving and post a warning message to the Troubleshooting list if you do not have at least 60 megabytes (MB) of free disk space.

Note

In the event of a network outage or stream interruption that exceeds two seconds in length, the archive file is closed. If the publishing point reconnects to the stream, a new archive file is created and starts archiving from that point. The Troubleshooting list will report the amount of time lost during the stream interruption.

Note

If you archive your streamed content by using the default name and the default directory, the content may be vulnerable to unauthorized access. To protect your archived content, save it to a location that is outside the WMRoot directory structure or implement additional network security measures.

Note

The server does not use your user account to access folders and other resources; it uses the Network Service account by default. If you are saving files to a location other than %systemdrive%\WMPub and its subdirectories, make sure that the Network Service account has Read and Write permissions for the folder. If the Network Service account does not have permissions for a folder, the server will not be able to save files to it. For more information, see About rights.

See Also

Concepts

Browsing for content sources