• 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® 3.6 and earlier.

    Contents



    Related Articles



    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:
      Code:
      # 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):
      Code:
      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. Once the connection is made, the stream will be pulled to the server until Stream Manager is used to disconnect the stream.

    Note: With the release of Wowza Streaming Engine™ 4.0, the preferred way to create and publish .stream files is to use 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 3.6 and earlier

    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:
        Code:
        <StreamType>live</StreamType>
      2. Set the HTTPStreamers property to:
        Code:
        <LiveStreamPacketizers>cupertinostreamingpacketizer, smoothstreamingpacketizer, sanjosestreamingpacketizer, mpegdashstreamingpacketizer, mpegdashstreamingrepeater</LiveStreamPacketizers>
      3. Set the Streams/LiveStreamPacketizers property to:
        Code:
        <LiveStreamPacketizers>cupertinostreamingpacketizer, smoothstreamingpacketizer, sanjosestreamingpacketizer, mpegdashstreamingpacketizer, mpegdashstreamingrepeater 
           </LiveStreamPacketizers>
      4. Set the RTP/Authentication/PlayMethod property to:
        Code:
        <PlayMethod>none</PlayMethod>

    Connecting the stream in Wowza Media Server 3.6 and earlier

    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:
      Code:
      # 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.


    Updated: For Wowza Media Server 3.6 on 06-10-2013
    Comments 20 Comments
    1. ztatic -
      Is it possible to use the streammanger via something like cfhttp? and if so would you have any docs on that? Or is it possible to start/stop streams programmatically?
    1. lisa_w -
      Your question was answered in the forum post. No need to double post.
    1. ajsinclair -
      Is there anyway to manage streams from the command line?
    1. salvadore -
      Quote Originally Posted by ajsinclair View Post
      Is there anyway to manage streams from the command line?
      You can use this Java class:
      How to set up a command line interface to Wowza API to start/stop VHost using JMX

      Salvadore
    1. kmax1940 -
      Is there a way to have the streams auto connect when the computer restarts?

      I hate to think I will have to go start each stream every time it restarts.

      Thanks
    1. kmax1940 -
      I found this article:
      http://www.wowza.com/forums/content....upStreams.xml)

      Thanks
    1. WildcatObserver -
      So If I am streaming live RTMP can i restream so that it can be rtsp for an android? Im in desperate need...have a broadcast in an hour.
    1. rrlanham -
      Yes, if you have rtmp playback working you can do rtsp playback. You need UDP ports to be open between Wowza and Android. The audio should be AAC (not MP3), and there are some size restrictions noted on the RTSP Trouble Shooting Guide

      Richard
    1. WildcatObserver -
      Im encoding using Adobe media encoder I have everything working for IOS or PC's. I dont have the option to change from MP3....am I just dead in water for Android listeners?
    1. WildcatObserver -
      And I am wanting live...for android to listen live. Ill worry about playback later...if Im understanding you correctly.
    1. WildcatObserver -
      I am using JW Player. Here is the info on that:
      <script type='text/javascript'>
      jwplayer('player3Ux5cHCWqNw3').setup({
      file: 'rtmp://54.221.250.87/live/Stream1',
      image: 'www.wildcatobserver.com\images\ObserverHeaderPNG.png',
      title: 'Wildcat Observer',
      autostart: true,
      controls: true,
      width: '600',
      height: '45',
      fallback: 'false'
      });
      </script>

      Is there a way to "restream" that to rtsp for android? THe example above I use for pc's...I have the IOS working....If anyone can share some code or help Id really appreciate it.
    1. rrlanham -
      Use RTSP in Android. I don't think JW player is useful. You can test RTSP playback in VLC. The playback URL would be:

      rtsp://54.221.250.87/live/Stream1'

      But the mp3 audio is a problem

      Richard
    1. WildcatObserver -
      Quote Originally Posted by rrlanham View Post
      Use RTSP in Android. I don't think JW player is useful. You can test RTSP playback in VLC. The playback URL would be:

      rtsp://54.221.250.87/live/Stream1'

      But the mp3 audio is a problem

      Richard
      So do i use stream manager to restream to that? if so, what are the settings for it? Media Caster type and such? and do I select restream from the live/_definst_? and should I call the stream something other than Stream1?
    1. rrlanham -
      No, if you already have rtmp playback working rtsp playback will work too. Test with VLC with the URL I have shown.

      Re-streaming with MediaCaster involves IP cameras or mpeg-ts encoders with live streams at rtsp or udp addresses. You are asking about rtsp playback.

      Richard
    1. WildcatObserver -
      So I need to download VLC? Is that the URL you mention?
    1. rrlanham -
      VLC is very useful for testing rtsp playback. You can get it from that site, yes.

      Richard
    1. nimigeanu -
      Hello Wowza,

      Is seems that whenever starting a stream through StreamManager, via either API or web interface, the app instance will never again stop, even after stream itself is stopped.
      Do you know of any way to fix this?

      Thank you,
      Gabriel
    1. rrlanham -
      Gabriel,

      If there are no clients connected or trying to connect, the application instance should unload in 60 seconds. Make sure there are no clients connected.

      Richard
    1. nimigeanu -
      Quote Originally Posted by rrlanham View Post
      Gabriel,

      If there are no clients connected or trying to connect, the application instance should unload in 60 seconds. Make sure there are no clients connected.

      Richard
      Hello Richard, thank you for the tip.
      I am sure there are no clients connected.
      Thank you,
      Gabriel
    1. rrlanham -
      If you can, send a short log file that replicates this to support@wowza.com. Include a link to this thread for reference.

      Richard