Wowza Streaming Engine Configuration for 360cam live Streaming This guide will help you to configure Wowza Streaming Engine media server for 360cam live streaming. The camera will push stream to Wowza server. The guide does not explain the Wowza software installation. For this, refer to these guides: https://www.wowza.com/forums/content.php?217-How-to-install-and-configure-Wowza-Streaming-Engine http://www.wowza.com/resources/WowzaStreamingEngine_UsersGuide.pdf
1 - Get your Wowza server configuration After opening Wowza Streaming Engine Manager in a web browser, you must retrieve the IP address and the server streaming port. -
Clic Click k the the Home tab in Wowza Streaming Engine Manager
Server IP/Port
-
Retrieve Retrieve server server paramete parameters rs
Host Host - Serv Server er Host - Port
52.2 52.26. 6.17 171. 1.12 123 3 1935 1935
Make sure the streaming port is open on your router, firewall, and in your iptables.
2 - Create a configuration file for the camera After getting streaming settings, you must create a configuration configuration file that will be used by the camera. The file will be copied to the SD card inserted in the camera. - File File name: name: strea stream.t m.txt xt - File path (SD card): card): MISC/ MISC/ - File content: "Sever IP Address" " StreamingPo StreamingPort" rt" "Streaming "Streaming Name" - Example: 52.26.171.123 52.26.171.123 1935 live/360live live/360live Note: The parameters must be on one line with a space as a separator !!!
3 - Disable security restriction for input sources ● ●
Clic Click k the the Applications tab in Wowza Streaming Engine Manager and then click live On the live page, go to Source Security
Security settings
You can edit settings:
Edit security options
4 - Improve Server Performances For best performance, you must change some parameters whose default values cause limitations. But, these parameters are not exposed within the Engine Manager web UI. So, you'll need to edit the XML configuration files from your server. The XML configuration files are located in the [install-dir]/conf folder of the Wowza Streaming Engine media server software installation. You can refer to this guide for details about configuration files. http://www.wowza.com/resources/WowzaStreamingEngine_ConfigurationReference.pdf
4.1 EC2 instances If the Wowza Streaming Engine media server software is installed on EC2 instance, you’ll need to connect to your Instance Management to retrieve the connection parameters to your server. For more informations about connection to your instance: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/putty.html?console_help=true
Server connection parameters
4.1.1 Prerequisites ●
● ● ● ●
Download and install winSCP and PuTTY. Get the ID of the inst instance ance Get the public public DNS name of the the instance instance Locate the private key (.pem) Enable inbound inbound SSH SSH traffic from your IP address address to your your instance instance
4.1.2 Converting Your Private Key Using PuTTYgen PuTTY and winSCP do not natively support the private key format (.pem) generated by Amazon EC2. PuTTY has a tool named PuTTYgen, PuTTYgen , which can convert keys to the required PuTTY format (.ppk). You must convert your private key into this format (.ppk) before attempting to connect to your instance using PuTTY and winSCP. ● ●
Start PuTTYgen PuTTYgen (for example, from the Start menu, Start menu, click All Programs > PuTTY > PuTTYgen). PuTTYgen ). Und Under Type of key to generate, generate, select SSH-2 RSA. RSA.
●
Click Load. Load. By default, PuTTYgen displays only files with the extension .ppk. To locate your .pem file, select the option to display files of all types .
●
Sele Select ct your your .pem file for the key pair that you specified when you launch your instance,
●
and then click Open. Open. Click OK OK to dismiss the confirmation dialog box. Click Save private key key to save the key in the format that PuTTY an winSCP can use. PuTTYgen displays a warning about saving the key without a passphrase. Click Yes. Yes.
●
Specify the the same name name for the the key that that you used used for the key pair (for (for example , my-key-pair). PuTTY automatically adds the .ppk file extension .
Your private key is now in the correct format for use with PuTTY and winSCP. You can now connect to your instance using PuTTY's SSH client. 4.1.3 Transferring Files to Your Instance Using WinSCP After installing winSCP, ●
Start Start WinSCP WinSCP..
● At the the WinSCP login screen, login screen, for File protocol, protocol, choose SFTP ● For Host name, name, enter the public DNS address for your instance. ● For User name, name, enter the default user name for your AMI. For Amazon Linux AMIs, the user name is ec2-user. For Red Hat AMIs the user name is root, and for Ubuntu AMIs the user name is ubuntu.
●
Specify the private key for your instance. For newer versions of WinSCP, you need to click Advanced to open the advanced site settings, and then under SSH, click Authentication Authentication to find the the Private key file file setting. WinSCP requires a PuTTY private key file ( .ppk), that you have generated with
PuTTYgen.
Enter the path to your private key, or click the "…" button to browse for the file. Then, click OK. OK. ●
Click Login Login to connect, and click Yes click Yes to add the host fingerprint to the host cache.
After the connection connection is established, established, in the connection connection window your Linux instance is on the right and your local machine is on the left. You can drag and drop files directly into the remote file system from your local machine.
●
Drag and drop this this files from from local machine to the remote machine machine - VHostNew.xml - ApplicationNew.xml - wowza_conf.sh
For VHostNew.xml, the new parameters are: true 800000 800000 800000 ---For For Appl Applic icat atio ionN nNew ew.x .xml ml live -----
●
Change script script (wowza_conf.sh (wowza_conf.sh)) permissions: permissions: Right click on the file name, and then then click Properties. Set the execute permission (X).
●
Open session in PuTTY: Click Commands and click Open in PuTTY. PuTTY.
●
Run the script script on PuTTY PuTTY consol console. e. Type this command on your console: ./wowza_conf.sh
4.2 Standalone Server If the Wowza Streaming Engine media server software is installed on your personal server, you can do the same procedure from the section 4.1.3. You can also connect directly to your server and change this two files. [install-dir]/conf/VHost.xml [install-dir]/conf/live/ [install-dir]/conf/live/Application Application.xml .xml
5 - Transcoding for Live Application ● ●
Clic Click k the the Applications tab in Wowza Streaming Engine Manager and then click live On the live page, go to Transcoder
● ●
Click Enable Transcoder Cick Transrate (Default) for transrate template
●
Disable/Modify Disable/Modify defaults encode output (checked) a) Click on Encode name, then you you can Edit or Disable Encode
b) Clic Click k Return to Transcoder Template
c) Repeat action action a) and b) b) for each Encode Encode name that that you want modify modify or disable disable ●
Add new Encode Encode output output a) Clic Click k Add Encode
b) Fill the various parameters (Encode Name, Outgoing Stream Name, Video Settings, Audio Settings) c) Click Add to confirm the configuration. You should see the new configuration at the end of Encode list (but not enabled yet). d) Click on the new Encode name and then click Enable Encode e) Click Return to Transcoder Template f) Repeat action a) to e) for each new output ●
Set Adaptive Bitrate Stream Name Groups
a) Clic Click k Stream Name Group
b) Click Click on “pen” pen” ("Edit ("Edit this stream name group") group ") for “all “all”” group
c) Select the right Encode names to add, and the left Encode names to remove d) Click Save e) You can do the same for “mobile” group ●
Restart Restart Applicat Application ion
Click Restart
●
Restar Restartt your your serve serverr
- Clic Click k the the Server tab in Wowza Streaming Engine Manager - On the Server page, go to Server Setup - Click Restart
Note that the explanations located to the right of the Wowza Streaming Engine Manager pages can help you. Do not hesitate to read them to understand the configurations.
