Upgrading from the Previous Release
Changes in applicationHost.config
Media Files that are not Throttled
MIME Types that are not Added During Installation
MICROSOFT PRE-RELEASE SOFTWARE LICENSE TERMS - MICROSOFT BIT RATE THROTTLING FOR IIS 7.0
The Bit Rate Throttling module for Windows Server 2008 enables Web administrators to throttle the delivery of any file based on the file type, with additional advanced functionality for digital audio/video files. Throttling can be set at the following levels within Internet Information Services (IIS) Manager: server, site, virtual directory, and file.
For audio and video files, this module automatically detects the encoded bit rate of the file, sends a short burst of data to the client at full throttle to ensure a fast start to their playback experience, and then delivers the content at a throttled rate that is equal to or slightly greater than the encoded bit rate. Several popular digital media file types are pre-defined in the module, and others can be added. Data files are throttled at a configurable constant rate.
The Bit Rate Throttling module includes the following key features:
· Integration with IIS 7.0. The Bit Rate Throttling module is tightly integrated with this new administration interface and configuration store in IIS 7.0. In addition, IIS 7.0 has a new administration tool, and the new Bit Rate Throttling module plugs seamlessly into that paradigm.
· Throttling for any file type. Any file type can be throttled at a constant rate. An administrator can easily specify a new file type and throttling settings through the user interface.
· Advanced media throttling. One of the most significant features in the new Bit Rate Throttling module is the advanced support of audio/video media formats. This includes automatic detection of the encoded bit rate in a file, and intelligent progressive-download throttling based on that. Built-in support is included for digital media with the following file name extensions: .asf, .avi, .flv, .mov, .mp3, .mp4, .rm, .rmvb, .wma, .wmv. An administrator can simply enable Bit Rate Throttling and start intelligently delivering these common media types using the default throttling settings.
· Extensibility. The new Bit Rate Throttling module supports developer extensibility, making it possible for software vendors and hobbyists to add support for additional media formats using simple XML editing. Microsoft is using this extensibility feature to implement the built-in media format support.
· Shared hosting support. By fully integrating into the IIS 7.0 pipeline and configuration model, the new Bit Rate Throttling module makes it possible to host Web page content and intelligently deliver a variety of media from the same Web server, site, or virtual directory. This level of granularity also provides the ability to isolate users through per-user virtual directories.
The following prerequisites must be fulfilled to install the Bit Rate Throttling module:
· You must use IIS 7.0 running on Windows Server 2008 RC0 or later, or on Windows Vista Service Pack 1 (SP1) Release Candidate (RC).
· The IIS Management Console for Internet Information Services 7.0 must be installed to manage the Bit Rate Throttling module using the IIS 7.0 user interface.
· You must install the Bit Rate Throttling module as an administrator. (See Downloading and Installing for more information.)
Two separate downloadable packages are available for the Bit Rate Throttling module. Download the appropriate package for your version of Windows:
· Bit Rate Throttling for IIS 7.0 (x86)
· Bit Rate Throttling for IIS 7.0 (x64)
You must be an administrator on the computer to run the installation package. This can be accomplished by one of the following methods:
· Log on to the computer using the Administrator account.
· Log on to the computer using an account with administrative privileges, open an elevated command prompt (Click Start, click All Programs, click Accessories, right-click Command Prompt, and then click Run as administrator), and then type the following command to run the installation:
msiexec /I bitrate.msi
If you encounter any problems during installation, type the following command in the elevated command prompt to create a log file that contains information about the installation process:
msiexec /L bitrate.log /I bitrate.msi
Analyze this log file after a failed installation to help determine the cause of the failure.
Upgrading from the previous release of the Bit Rate Throttling module is not supported for this release. To get the new features and updates in this release, you must first remove the current Bit Rate Throttling module. For more information, see Uninstalling.
If you elect to remove the Bit Rate Throttling module in IIS Manager, the module is removed from the Web server; however, custom settings for bit rate throttling at different configuration levels are not removed. After the module is removed, IIS may not be able to read the web.config file at these levels and could return an error.
Before removing the module, open it at the site level, and then click Revert to Inherited in the Actions pane to delete local configuration settings. You can then safely proceed with removing the module. For more information, see Remove a Managed Module.
This section describes the changes and new features included in this release of the Bit Rate Throttling module.
This release of the Bit Rate Throttling module adds two new advanced throttling features at the Site level. First, you can now specify a default throttle rate that applies to media files for which the encoded bit rate cannot be determined (for example, when metadata in a media file is missing or corrupted) or when no throttle rate is specified for a media or data file type. Secondly, you can now specify a maximum throttle rate that limits the throttle rate for all media or data files to a specific value. You can set this global maximum value for files to limit the throttle rate, even if the throttle rate setting for a specific file type is higher. These settings do not affect Fast Start.
To use these settings, select a Web site in the Connections pane of the IIS Manager user interface, open the Bit Rate Throttling feature in the Workspace pane, and then click Advanced Settings in the Actions pane. You will see two settings, both in kilobits per second: Default throttle rate, and Maximum throttle rate. The configuration attribute names for these advanced controls in the <bitrateThrottling> node in the applicationHost.config file are as follows.
|
Advanced Throttle Option |
applicationHost.config Attribute Name |
|
Default throttle rate |
defaultThrottleRateKbps |
|
Maximum throttle rate |
maximumThrottleRateKbps |
This release of the Bit Rate Throttling module allows you to enforce connection limits by editing the IIS 7.0 configuration root file applicationHost.config. You can associate a given file type with a connection group by setting an optional connectionLimitGroup attribute on the <add> node within <throttlesetting>. For example, you can set connectionLimitGroup="AudioFiles" as follows:
<add fileExtension=".wma" settingType="media" initialBufferTimeSeconds="10" throttleRatePercentage="100" connectionLimitGroup="AudioFiles" />
Then, in a separate node called "connectionLimitGroups" (also a child of <throttleSettings>) define a connection group that allows you to enforce a connection limit for a group of file types. For example:
<connectionLimitGroups>
<add name="AudioFiles" connectionLimit="200" />
</connectionLimitGroups>
The above example allows up to 200 simultaneous client connections to WMA files on the Web server assuming that no other file types are in the same connection limit group. When a connection limit is reached for a given connection group, clients that request the file type receive an HTTP 503 (Service Unavailable) error. Clients cannot connect and receive throttled content until a connection becomes available.
You can specify unlimited connections to a given file type by setting connectionLimit="0" or by omitting the connectionLimitGroup for a given file type.
Note A site with many applications that each run in different Application Pools will have independent connection group limits on a per-worker-process basis. Aggregate connection limits on a per-server basis are not currently supported.
· The Bit Rate Throttling configuration section in the media section group is locked (overrideModeDefault = "Deny"). Previously, this configuration section was not locked. By unlocking this section (overrideModeDefault = "Allow") at the root level, you can modify various Bit Rate Throttling properties in web.config files for lower levels (such as at the site or virtual directory level) that override the global settings defined in applicationHost.config.
· The throttle setting size and rate units for data file types are now consistent in both the IIS Manager user interface and in applicationHost.config. In addition, the configuration attribute names for the controls in the applicationHost.config file are changed.
|
Data Throttle Option |
applicationHost.config Attribute Name |
|
Fast Start |
initialSendSizeKBytes |
|
Throttle rate |
throttleRateKbps |
Most pre-defined media format files are throttled correctly. However, some non-standard files may have differences in the file header that cause the Bit Rate Throttling module to not detect the encoded bit rate. When this occurs, the file is downloaded to clients with no throttling applied.
Multipurpose Internet Mail Extensions (MIME) types for the following pre-defined digital media file types are not automatically added during installation of the Bit Rate Throttling module.
|
File extension |
MIME type |
|
.mp4 |
video/mp4 |
|
.rmvb |
application/vnd.rn-realmedia-vbr |
If you need to support one or more of these file types on your Web server, after installation is completed, use the Add MIME Type dialog box in IIS Manager to create the MIME types.
For more information, see Configuring MIME Types in IIS 7.0.
The following walkthroughs for the new Bit Rate Throttling module are available on IIS.net:
· Bit Rate Throttling Setup Walkthrough. Describes how to download and install the Bit Rate Throttling module.
· Bit Rate Throttling Configuration Walkthrough. Describes how to configure the Bit Rate Throttling module at the server, site, virtual directory, and file levels.
· Bit Rate Throttling Extensibility Walkthrough. Describes how to use the extensibility interface provided by the Rate Throttling module to add support for additional media file types.
Also, be sure to visit the IIS Media Delivery Blog where IIS team members who work on digital media will talk about the Bit Rate Throttling module and other technologies in the pipeline that will help you better serve digital media content to your users.
FOR USE WITH WINDOWS SERVER 2008 AND WINDOWS
VISTA
These license terms are an agreement between Microsoft Corporation (or based on where you live, one of its affiliates) and you. Please read them. They apply to the pre-release software named above, which includes the media on which you received it, if any. The terms also apply to any Microsoft
· updates,
· supplements,
· Internet-based services, and
· support services
for this software, unless other terms accompany those items. If so, those terms apply.
By using the software, you accept these
terms. If you do not accept them, do not use the software.
If you comply with these license terms, you have the rights below.
1.
INSTALLATION AND USE
RIGHTS.
· You may install and use any number of copies of the software on your premises to design, develop and test your programs only for use with Windows Server 2008 and/or Windows Vista.
· Because the software is a pre-release version, and may not work correctly, you may not use it, alone and/or in conjunction with other programs:
· in hazardous environments requiring fail-safe controls, including without limitation, the design, construction, maintenance or operation of nuclear facilities, aircraft navigation or communication systems, air traffic control, and life support or weapons systems;
· to collect personally identifiable or confidential data; or
· to conduct e-commerce transactions (exchange of goods and services by means of the Internet or other computer networks), including without limitation any shipping, credit card, monetary or other banking transactions.
2. TIME-SENSITIVE SOFTWARE. The term of this agreement is until September 1, 2008 or commercial release, whichever comes first.
3. PRE-RELEASE SOFTWARE. This software is a pre-release version. It may not work the way a final version of the software will. We may change it for the final, commercial version. We also may not release a commercial version.
4. FEEDBACK. If you give feedback about the software to Microsoft, you give to Microsoft, without charge, the right to use, share and commercialize your feedback in any way and for any purpose. You also give to third parties, without charge, any patent rights needed for their products, technologies and services to use or interface with any specific parts of a Microsoft software or service that includes the feedback. You will not give feedback that is subject to a license that requires Microsoft to license its software or documentation to third parties because we include your feedback in them. These rights survive this agreement.
5. Scope of License. The software is licensed, not sold. This agreement only gives you some rights to use the software. Microsoft reserves all other rights. Unless applicable law gives you more rights despite this limitation, you may use the software only as expressly permitted in this agreement. In doing so, you must comply with any technical limitations in the software that only allow you to use it in certain ways. You may not
· disclose the results of any benchmark tests of the software to any third party without Microsoft’s prior written approval;
· work around any technical limitations in the software;
· reverse engineer, decompile or disassemble the software, except and only to the extent that applicable law expressly permits, despite this limitation;
· make more copies of the software than specified in this agreement or allowed by applicable law, despite this limitation;
· publish the software for others to copy;
· rent, lease or lend the software; or
· transfer the software or this agreement to any third party.
6. Export Restrictions. The software is subject to United States export laws and regulations. You must comply with all domestic and international export laws and regulations that apply to the software. These laws include restrictions on destinations, end users and end use. For additional information, see Exporting Microsoft Products (http://www.microsoft.com/exporting/).
7. SUPPORT SERVICES. Because this software is “as is,” we may not provide support services for it.
8. Entire Agreement. This agreement, and the terms for supplements, updates, Internet-based services and support services that you use, are the entire agreement for the software and support services.
9.
Applicable Law.
a. United States. If you acquired the software in the United States, Washington state law governs the interpretation of this agreement and applies to claims for breach of it, regardless of conflict of laws principles. The laws of the state where you live govern all other claims, including claims under state consumer protection laws, unfair competition laws, and in tort.
b. Outside the United States. If you acquired the software in any other country, the laws of that country apply.
10. Legal Effect. This agreement describes certain legal rights. You may have other rights under the laws of your country. You may also have rights with respect to the party from whom you acquired the software. This agreement does not change your rights under the laws of your country if the laws of your country do not permit it to do so.
11. Disclaimer of Warranty. The software is licensed “as-is.” You bear the risk of using it. Microsoft gives no express warranties, guarantees or conditions. You may have additional consumer rights under your local laws which this agreement cannot change. To the extent permitted under your local laws, Microsoft excludes the implied warranties of merchantability, fitness for a particular purpose and non-infringement.
12. Limitation on and Exclusion of Remedies and Damages. You can recover from Microsoft and its suppliers only direct damages up to U.S. $5.00. You cannot recover any other damages, including consequential, lost profits, special, indirect or incidental damages.
This limitation applies to
· anything related to the software, services, content (including code) on third party Internet sites, or third party programs; and
· claims for breach of contract, breach of warranty, guarantee or condition, strict liability, negligence, or other tort to the extent permitted by applicable law.
It also applies even if Microsoft knew or should have known about the possibility of the damages. The above limitation or exclusion may not apply to you because your country may not allow the exclusion or limitation of incidental, consequential or other damages.
Please note: As this software is distributed
in Quebec, Canada, some of the clauses in this agreement are provided below in
French.
Remarque: Ce logiciel étant distribué au
Québec, Canada, certaines des clauses dans ce contrat sont fournies ci-dessous
en français.
EXONÉRATION DE GARANTIE. Le logiciel visé par une licence est offert « tel quel ». Toute utilisation de ce logiciel est à votre seule risque et péril. Microsoft n’accorde aucune autre garantie expresse. Vous pouvez bénéficier de droits additionnels en vertu du droit local sur la protection des consommateurs, que ce contrat ne peut modifier. La ou elles sont permises par le droit locale, les garanties implicites de qualité marchande, d’adéquation à un usage particulier et d’absence de contrefaçon sont exclues.
LIMITATION DES DOMMAGES-INTÉRÊTS ET EXCLUSION
DE RESPONSABILITÉ POUR LES DOMMAGES. Vous pouvez obtenir de Microsoft et
de ses fournisseurs une indemnisation en cas de dommages directs uniquement à
hauteur de 5,00 $ US. Vous
ne pouvez prétendre à aucune indemnisation pour les autres dommages, y compris
les dommages spéciaux, indirects ou accessoires et pertes de bénéfices.
Cette
limitation concerne:
·
tout
ce qui est relié au logiciel, aux services ou au contenu (y compris le
code) figurant sur des sites Internet tiers ou dans des programmes tiers ; et
·
les réclamations au titre de
violation de contrat ou de garantie, ou au titre de responsabilité stricte, de
négligence ou d’une autre faute dans la limite autorisée par la loi en vigueur.
Elle
s’applique également, même si Microsoft connaissait ou devrait connaître
l’éventualité d’un tel dommage. Si votre pays n’autorise pas l’exclusion ou la
limitation de responsabilité pour les dommages indirects, accessoires ou de
quelque nature que ce soit, il se peut que la limitation ou l’exclusion
ci-dessus ne s’appliquera pas à votre égard.
EFFET JURIDIQUE. Le présent contrat
décrit certains droits juridiques.
Vous pourriez avoir d’autres
droits prévus par les lois de votre pays. Le présent contrat ne modifie pas les
droits que vous confèrent les lois de votre pays si celles-ci ne le permettent
pas.
© 2007 Microsoft Corporation