How to use IPv6 networking in Wowza media server software

Wowza™ media server software supports IPv6 by default; however, the computer that the media server software is installed on must also support IPV6, and Java JDK 1.7 (or later) is required.

Steps

  1. Test to see if your computer supports IPv6:
     
    • On Windows, open a command prompt window and type the following at the command prompt (Note that "::1" is the IPv6 version of "127.0.0.1" or "localhost"):
      ping ::1
      Expected output:
      Reply from ::1: time<1ms
      Reply from ::1: time<1ms
      Reply from ::1: time<1ms
      Reply from ::1: time<1ms
    • On Linux, test in the SSH console:
      cat /proc/net/if_inet6
      Expected output:
      fe80000000000000103139fffx8320x4 02 40 20 80 eth0
      00000000000000000000000000000001 01 80 10 80 lo
  2. If the computer supports IPv6, install Java JDK 7 or Java JDK 8, then update the JAVA_HOME environment variable to point to the Java JRE. For example:
    C:\Program Files\Java\jdk1.7.0\jre
    Start the Wowza media server software in standalone mode (/bin/startup.bat or startup.sh) and check the startup lines to see if the JDK is in use. You should see information similar to the following:
     
    INFO server comment - Java Version: 1.7.0-ea
    INFO server comment - Java VM Version: 21.0-b12
    INFO server comment - Java Spec Version: 1.7
    INFO server comment - Java Home: C:\Program Files\Java\jdk1.7.0\jre
  3. Ensure that the Java property java.net.preferIPv4Stack is set to false.
     
    • On Wowza Streaming Engine™ software, open the [install-dir]/conf/Tune.xml in a text editor, set the following line as shown below, and then restart the media server to apply the changes:
       
      -Djava.net.preferIPv4Stack=false
    • On Wowza Media Server™ software, open the /bin/setenv.bat (or /bin/setenv.sh) file in a text editor, and then uncomment and set the following line as shown below:

      Windows
      set JAVA_OPTS=%JAVA_OPTS% -Djava.net.preferIPv4Stack=false
      Linux
      JAVA_OPTS="$JAVA_OPTS -Djava.net.preferIPv4Stack=false"
    Note: If running on Windows, open the bin/WowzaStreamingEngine-Service.conf file in a text editor and add (or modify) the following wrapper.java.additional value:
    wrapper.java.additional.[n]=-Djava.net.preferIPv4Stack=false
    Where [n] is the next index in the list of wrapper.java.additional items that aren't commented-out.
  4. Now you can test. Use the [install-dir]/examples/VideoOnDemandStreaming/FlashRTMPPlayer examples and enter the following information in the example player webpage:
    Server: rtmp://[::1]/vod
    Stream: mp4:Sample.mp4
    Note the square brackets surrounding the IPV6 address.

    You can get the IPV6 address of your remote server with the ipconfig command in Windows, or the ifconfig command in Linux.

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