IIS7 or later

Installation

Please note that Live is not available for IIS7 or later (Apache is available on Windows for that purpose, see Basic Apache configuration on Windows).

Prerequisites

To install the IIS module, first follow the instructions for installing the Unified Packager ('mp4split') package for Windows:

  • For installing USP version 1.14.0 or later, see this page.

  • For older USP versions, see this page.

This is required, because the IIS module depends on files in the Unified Packager ('mp4split') package. There is no need to install any other prerequisite packages, apart from the C++ redistributable which is always required.

Note that the system PATH setting (not the user-specific setting) must contain the C:\Program Files\Unified Streaming\bin directory (USP version 1.14.0 or later), or C:\Program Files\Unified Streaming (USP versions older than 1.14.0). After adjusting the system PATH setting, it is safest to reboot the system, ensuring all running processes use the same value.

IIS package

IIS packages are provided as ZIP files, downloadable from https://stable.zip.unified-streaming.com/windows/x86_64/ (stable releases) or https://beta.zip.unified-streaming.com/windows/x86_64/ (beta releases).

Our packages are targeted at 64 bit, X86 Windows Server 2016, 2019 or Windows 10/11 Pro.

Changed in version 1.14.0: For a given USP version, the name of the ZIP file to download is iis7_mod_smooth_streaming_<USP version>-<revision>.zip. You should pick the highest available <revision> number, which is normally 1. For example, for USP version 1.14.0, the name of the ZIP file for the iis7_mod_smooth_streaming package is iis7_mod_smooth_streaming_1.14.0-1.zip.

Attention

Packages for different USP versions are binary incompatible and cannot be mixed in the same installation directory.

To install a given package:

  • Check its prerequisites. Install both its third-party prerequistes and any prerequisite USP packages for the same USP version first.

  • Download the ZIP file and unzip it to your installation directory (normally C:\Program Files\Unified Streaming).

  • Inspect the contents of the installation directory to see if the package's files ended up in their expected locations. See Installation directory layout.

Configuration

Open up IIS Manager. We will configure three things: mime types, modules and handler mappings.

Mime types

  • Select 'MIME types'.

  • Select 'Add'.

  • Set 'File name extension' to '.ismc' and 'MIME type' to 'text/xml'.

  • Click 'OK'.

Modules

  • Select 'Modules'.

  • Select 'Configure Native Modules'.

  • Select 'Register'.

  • Set 'Name' to 'ModSmoothStreaming'.

  • Set 'Path' to the path where the mod_smooth_streaming.dll is located:

    • C:\Program Files\Unified Streaming\iis7\bin for USP version 1.14.0 or later

    • C:\Program Files\Unified Streaming for USP versions older than 1.14.0

  • Click 'OK'.

  • Click 'OK' again.

Handler mappings

  • Select Handler Mappings.

  • Select 'Add Module Mapping'.

  • Set 'Request Path' to '*.ism'.

  • Set 'Module' to 'ModSmoothStreaming'.

  • Set 'Name' to 'ModSmoothStreaming'.

  • Click 'Request Restrictions'.

  • Set 'Mappings' to 'Invoke handler only if request is mapped to file'.

  • Set 'Verbs' to 'All verbs'.

  • Set 'Access' to 'Execute'.

  • Click 'OK'.

  • Click 'OK' again.

The module now appears under the 'Enabled' Handler Mappings.

Warning

Please install your License Key now, otherwise streaming will not work!

After restarting IIS, you can continue with verifying your setup.

Specifics for IIS

License file location:

The license file must be located in the directory accessible by the webserver, this is usually found at this path:

c:\windows\system32\inetsrv\usp-license.key

Please ensure it is truly a .key file and not a .txt file with a .key extension. (Show all file extensions should be enabled)

It is also required that the handler for the .mp4 file extension is added to the IIS webserver. Otherwise you will get the mp4 file back as it is stored on disk.

The video/mp4 mime type for this file extension should therefore also exist in the IIS Mime Types or in a web.config file.

Options

There are no specific configuration options available for IIS7 or later.

The Windows event log will contain any error messages, using X-Mod-Smooth-Streaming as tag, this will immediately inform you if there is an issue with the license key being found, it's path or if there is an error loading the module.

Note

If the IIS Media Services are already installed on the server this may hijack or prevent any requests being made to the USP Smooth Streaming Module by altering rewrite rules.