WowzaStreamingEngineConfiguration

for360camliveStreaming

ThisguidewillhelpyoutoconfigureWowzaStreamingEnginemediaserverfor360camlive
streaming.ThecamerawillpushstreamtoWowzaserver.Theguidedoesnotexplainthe
Wowzasoftwareinstallation.Forthis,refertotheseguides:

https://www.wowza.com/forums/content.php?217HowtoinstallandconfigureWowzaStreamingEngine
http://www.wowza.com/resources/WowzaStreamingEngine_UsersGuide.pdf

1GetyourWowzaserverconfiguration

AfteropeningWowzaStreamingEngineManagerinawebbrowser,youmustretrievetheIP
addressandtheserverstreamingport.

Clickthe
Home
tabinWowzaStreamingEngineManager

ServerIP/Port

Retrieveserverparameters

HostServer
52.26.171.123
HostPort 1935

Makesurethestreamingportisopenonyourrouter,firewall,andinyouriptables.

2Createaconfigurationfileforthecamera

Aftergettingstreamingsettings,youmustcreateaconfigurationfilethatwillbeusedbythe
camera.ThefilewillbecopiedtotheSDcardinsertedinthecamera.
Filename:stream.txt
Filepath(SDcard):MISC/
Filecontent:"SeverIPAddress""StreamingPort""StreamingName"
Example:52.26.171.1231935live/360live

Note:Theparametersmustbeononelinewithaspaceasaseparator!!!

3Disablesecurityrestrictionforinputsources

Clickthe
Applications
tabinWowzaStreamingEngineManagerandthenclick
live
Onthe
live
page,goto
SourceSecurity

Securitysettings

Youcaneditsettings:

Editsecurityoptions

4ImproveServerPerformances

Forbestperformance,youmustchangesomeparameterswhosedefaultvaluescause
limitations.But,theseparametersarenotexposedwithintheEngineManagerwebUI.So,you'll
needtoedittheXMLconfigurationfilesfromyourserver.

TheXMLconfigurationfilesarelocatedinthe
[installdir]/conf
folderoftheWowzaStreaming
Enginemediaserversoftwareinstallation.Youcanrefertothisguidefordetailsabout
configurationfiles.
http://www.wowza.com/resources/WowzaStreamingEngine_ConfigurationReference.pdf

4.1EC2instances

IftheWowzaStreamingEnginemediaserversoftwareisinstalledonEC2instance,youllneed
toconnecttoyourInstanceManagementtoretrievetheconnectionparameterstoyourserver.

Formoreinformationsaboutconnectiontoyourinstance:
https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/putty.html?console_help=true

Serverconnectionparameters

4.1.1Prerequisites

Downloadandinstall
winSCP
and
PuTTY
.

GettheIDoftheinstance
GetthepublicDNSnameoftheinstance
Locatetheprivatekey(.pem)
EnableinboundSSHtrafficfromyourIPaddresstoyourinstance

4.1.2ConvertingYourPrivateKeyUsingPuTTYgen

PuTTYandwinSCPdonotnativelysupporttheprivatekeyformat(.pem)generatedbyAmazon
EC2.PuTTYhasatoolnamed
PuTTYgen
,whichcanconvertkeystotherequiredPuTTY
format(.ppk).Youmustconvertyourprivatekeyintothisformat(.ppk)beforeattemptingto
connecttoyourinstanceusingPuTTYandwinSCP.

StartPuTTYgen(forexample,fromthe
Start
menu,click
AllPrograms
>
PuTTY
>
PuTTYgen
).
Under
Typeofkeytogenerate
,select
SSH2RSA
.

Click
Load
.Bydefault,PuTTYgendisplaysonlyfileswiththeextension

.ppk
.
Tolocate
your

.pem
file,
selecttheoptiontodisplayfilesofalltypes
.

Selectyour

.pem

fileforthekeypairthatyouspecifiedwhenyoulaunchyourinstance,
andthenclick
Open
.Click
OK
todismisstheconfirmationdialogbox.
Click
Saveprivatekey
tosavethekeyintheformatthatPuTTYanwinSCPcanuse.
PuTTYgendisplaysawarningaboutsavingthekeywithoutapassphrase.Click
Yes
.
Specifythesamenameforthekeythatyouusedforthekeypair(forexample
,
mykeypair
).
PuTTYautomaticallyaddsthe

.ppk
fileextension
.

YourprivatekeyisnowinthecorrectformatforusewithPuTTYandwinSCP.Youcannow
connecttoyourinstanceusingPuTTY'sSSHclient.

4.1.3TransferringFilestoYourInstanceUsingWinSCP

AfterinstallingwinSCP,

StartWinSCP.

Atthe
WinSCPlogin
screen,for
Fileprotocol
,choose
SFTP
For
Hostname
,enterthepublicDNSaddressforyourinstance.
For
Username
,enterthedefaultusernameforyourAMI.ForAmazonLinuxAMIs,the
usernameis

ec2user
.
ForRedHatAMIstheusernameis

root
,
andforUbuntu
AMIstheusername
is
ubuntu
.
Specifytheprivatekeyforyourinstance.

FornewerversionsofWinSCP,youneedto
click
Advanced
toopentheadvancedsitesettings,andthenunder
SSH
,
click
Authentication
tofindthe
Privatekeyfile
setting.
WinSCPrequiresaPuTTYprivatekeyfile(
.ppk
),thatyouhavegeneratedwith
PuTTYgen.

Enterthepathtoyourprivatekey,orclickthe
""
buttontobrowseforthefile.Then,click
OK
.

Click
Login
toconnect,andclick
Yes
toaddthehostfingerprinttothehostcache.

Aftertheconnectionisestablished,intheconnectionwindowyourLinuxinstanceisontheright
andyourlocalmachineisontheleft.Youcandraganddropfilesdirectlyintotheremotefile
systemfromyourlocalmachine.

Draganddropthisfilesfromlocalmachinetotheremotemachine

VHostNew.xml

ApplicationNew.xml

wowza_conf.sh

ForVHostNew.xml,thenewparametersare:
<SocketConfiguration>
<ReuseAddress>true</ReuseAddress>
<ReceiveBufferSize>800000</ReceiveBufferSize>
<ReadBufferSize>800000</ReadBufferSize>
<SendBufferSize>800000</SendBufferSize>

ForApplicationNew.xml

<Streams>
<StreamType>live</StreamType>

Changescript(wowza_conf.sh)permissions:Rightclickonthefilename,andthenclick
Properties.
Settheexecutepermission

(
X
).

OpensessioninPuTTY:Click
Commands
andclick
OpeninPuTTY
.

RunthescriptonPuTTYconsole.
Typethiscommandonyourconsole:
./wowza_conf.sh

4.2StandaloneServer

IftheWowzaStreamingEnginemediaserversoftwareisinstalledonyourpersonalserver,you
candothesameprocedurefromthesection4.1.3.
Youcanalsoconnectdirectlytoyourserverandchangethistwofiles.

[installdir]/conf/VHost.xml

[installdir]/conf/live/Application.xml

5TranscodingforLiveApplication

Clickthe
Applications
tabinWowzaStreamingEngineManagerandthenclick
live
Onthe
live
page,goto
Transcoder

Click
EnableTranscoder
Cick
Transrate(Default)
fortransratetemplate

Disable/Modifydefaultsencodeoutput(checked)

a) ClickonEncodename,thenyoucan
Edit
or
DisableEncode

b) Click
ReturntoTranscoderTemplate

c) Repeatactiona)andb)foreachEncodenamethatyouwantmodifyordisable

AddnewEncodeoutput

a) Click
AddEncode

b)Fillthevariousparameters(EncodeName,OutgoingStreamName,VideoSettings,
AudioSettings)
c)Click
Add
toconfirmtheconfiguration.Youshouldseethenewconfigurationatthe
endofEncodelist(butnotenabledyet).
d)ClickonthenewEncodenameandthenclick
EnableEncode
e)Click
ReturntoTranscoderTemplate
f)Repeatactiona)toe)foreachnewoutput

SetAdaptiveBitrateStreamNameGroups

a) Click
StreamNameGroup

b) Clickon
pen
("
Editthisstreamnamegroup
")for
all
group

c)SelecttherightEncodenamestoadd,andtheleftEncodenamestoremove
d)Click
Save
e)Youcandothesameformobilegroup

RestartApplication

Click
Restart

Restartyourserver

Clickthe
Server
tabinWowzaStreamingEngineManager
Onthe
Server
page,goto
ServerSetup
Click
Restart

NotethattheexplanationslocatedtotherightoftheWowzaStreamingEngineManager
pagescanhelpyou.Donothesitatetoreadthemtounderstandtheconfigurations.