• How to use Stream Manager in Wowza Media Server 3

    Wowza media server software includes a system for re-streaming called MediaCaster. The MediaCaster system is used for re-streaming IP Camera streams (RTSP/RTP streams), SHOUTcast/Icecast streams and native RTP encoders. The MediaCaster system pulls a stream from a stream source and makes it available for streaming to the different player technologies supported by Wowza Media Server. This system works on demand. When the first request comes in for a given stream, a connection is made to the source stream and the stream is made available to the player. The stream will be pulled to the server until Stream Manager is used to disconnect the stream. Stream Manager is hosted on port 8086.

    Note: This article is for use with Wowza Media Server™ software.

    Contents


    How to use Stream Manager
    How to use Stream Manager with .stream files

    More resources



    How to use Stream Manager


    To use this tool, do the following:

    1. Open [install-dir]/conf/admin.password in a text editor and add a user name and password. For example, to add a new user named myUser with the password myPassword, edit the admin.password file as follows:
      # Admin password file (format [username][space][password])
      #username password
      myUser myPassword
    2. Start Wowza Media Server.

    3. You can connect to the Stream Manager by entering the following URL in a web browser (you'll be prompted for your user name and password):
      http://[wowza-ip-address]:8086/streammanager
      Where [wowza-ip-address] is the IP address of the server running Wowza Media Server.

    How to use Stream Manager with .stream files


    Stream (.stream) files provide a method to replace (alias) complex stream names that are published to Wowza Media Server from sources such as MPEG-TS encoders and IP cameras (RTSP/RTP streams), SHOUTcast/Icecast streams, and native RTP encoders. For example, if your complex stream name on the origin server is udp://0.0.0.0:10000, you can create a stream file named mycoolevent.stream and assign the contents to the complex stream name. Players can then use mycoolevent.stream in playback URLs in place of the more complex stream name. Stream files are stored in an application's streaming file directory and have a .stream file name extension. The MediaCaster system can use .stream files to connect to the stream. After the connection is made, the stream will be pulled to the server until Stream Manager is used to disconnect the stream.

    Note: If you're using Wowza Streaming Engine™ software, you should create and publish .stream files in Wowza Streaming Engine Manager. For more information, see How to create and use .stream files in Wowza Streaming Engine Manager.
    The following sections describe how to configure an application and connect .stream files.

    Application configuration for Wowza Media Server

    1. Create application folder [install-dir]/applications/live.

    2. Create configuration folder [install-dir]/conf/live and copy [install-dir]/conf/Application.xml to this new folder.

    3. Edit the newly copied Application.xml file and make the following changes (some of these settings may already be present):

      1. Set the Streams/StreamType property to:
        <StreamType>live</StreamType>
      2. Set the HTTPStreamers property to:
        <LiveStreamPacketizers>cupertinostreamingpacketizer, smoothstreamingpacketizer, sanjosestreamingpacketizer</LiveStreamPacketizers>
      3. Set the Streams/LiveStreamPacketizers property to:
        <LiveStreamPacketizers>cupertinostreamingpacketizer, smoothstreamingpacketizer, sanjosestreamingpacketizer</LiveStreamPacketizers>
      4. Set the RTP/Authentication/PlayMethod property to:
        <PlayMethod>none</PlayMethod>

    Connecting the stream in Wowza Media Server

    This section provides the basic steps for creating a .stream file and connecting the server to publish the stream.

    1. Use a text editor to create the file [install-dir]/content/myStream.stream and set the contents of this file to the URL of the stream. The file must have a .stream filename extension. For this tutorial, the file used is myStream.stream.

    2. Edit [install-dir]/conf/admin.password and add a user name and password. For example, to add a new user named myUser with the password myPassword, edit the admin.password as follows:
      # Admin password file (format [username][space][password])
      #username password
      myUser myPassword
    3. Start Wowza Media Server.

    4. Use Stream Manager to start the stream:

      1. Enter the following URL in a web browser:
        URL: http://[wowza-ip-address]:8086/streammanager

      2. In the Security dialog box, enter your admin user name and password from above.

      3. In the Stream Manager webpage, click the [start-receiving-stream] link just below the live application folder.

      4. In the Start Receiving Stream dialog box, select the following MediaCaster Type option: rtp.

      5. In the Stream Name field, enter myStream.stream.

      6. Click OK.


    Originally Published: 10-01-2010.
    Updated: For Wowza Media Server 3.6 on 06-10-2013.

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