{"id":39567,"date":"2016-08-28T13:48:02","date_gmt":"2016-08-28T08:18:02","guid":{"rendered":"http:\/\/www.tothenew.com\/blog\/?p=39567"},"modified":"2016-08-29T09:29:58","modified_gmt":"2016-08-29T03:59:58","slug":"wowza-servers-application-management-using-rest-api","status":"publish","type":"post","link":"https:\/\/www.tothenew.com\/blog\/wowza-servers-application-management-using-rest-api\/","title":{"rendered":"Wowza Servers Application Management using REST-API"},"content":{"rendered":"

\"wowza-streaming-engine-horizontal-1024-1920x600\"<\/p>\n

Wowza Streaming Engine<\/b> is a streaming software utility which is developed by Wowza Media Systems. The utility is capable of streaming various types of videos and audio files on mobile, tablet and personal computer etc. The types of streaming videos include live video and on-demand streaming. It is basically a Java application<\/a> which is supported on almost all types of operating systems.<\/span><\/p>\n

Use Case
\n<\/b>In this blog, I\u2019ll be demonstrating the use of Wowza REST-API which can be used to automate the tasks<\/a> on Wowza servers running in your application stack. The tasks include creating new application channels, copying existing channels to create new ones and deleting the non-required applications using command\u00a0line as it is a bit tedious and repetitive task when performed from Wowza\u2019s GUI. The tasks can be automated using shell scripts in any language.<\/p>\n

Enabling Wowza REST-API
\n<\/b>To enable Wowza REST-API in an existing Wowza server, go to the installation directory of Wowza [install_dir]\/conf\/Server.xml and add the following code snippet:<\/p>\n

[js]
\n <RESTInterface>
\n <Enable>true<\/Enable>
\n <IPAddress>*<\/IPAddress>
\n <Port>8087<\/Port>
\n <!– none, basic, digest–>
\n <AuthenticationMethod>none<\/AuthenticationMethod>
\n <DiagnosticURLEnable>true<\/DiagnosticURLEnable>
\n <SSLConfig>
\n <Enable>false<\/Enable>
\n <KeyStorePath><\/KeyStorePath>
\n <KeyStorePassword><\/KeyStorePassword>
\n <KeyStoreType>JKS<\/KeyStoreType>
\n <SSLProtocol>TLS<\/SSLProtocol>
\n <Algorithm>SunX509<\/Algorithm>
\n <CipherSuites><\/CipherSuites>
\n <Protocols><\/Protocols>
\n <\/SSLConfig>
\n <IPWhiteList>*<\/IPWhiteList>
\n <IPBlackList><\/IPBlackList>
\n <EnableXMLFile>false<\/EnableXMLFile>
\n <DocumentationServerEnable>true<\/DocumentationServerEnable>
\n <DocumentationServerPort>8089<\/DocumentationServerPort>
\n <!– none, basic, digest–>
\n <DocumentationServerAuthenticationMethod>none<\/DocumentationServerAuthenticationMethod>
\n <Properties>
\n <Property>
\n <Name>restUserHTTPHeaders<\/Name>
\n <Value>Access-Control-Allow-Origin:*|Access-Control-Allow-Methods:OPTIONS,GET,PUT,DELETE,POST|Access-Control-Allow-Headers:Content-Type<\/Value>
\n <\/Property>
\n <\/Properties>
\n <\/RESTInterface>[\/js]<\/p>\n

Options which can be set from the above configuration:
\n<\/b>1) Port: <\/b>Port on which you want the REST-API to respond to the queries
\n<\/span>2) Authentication Method: <\/b>The authentication method to be used while accessing the REST-API interface
\n<\/span>3) SSL Certificate: <\/b>SSL setup for the REST-API (if required)
\n<\/span>4) IP (Whitelist and Blacklist): <\/b>To specifie the IP addresses from where<\/span> we want to access\/deny \u00a0the REST-API interface
\n<\/span>5) Custom Headers: <\/b>Custom headers to be used with REST-API<\/span><\/p>\n

Note:<\/b> After modifying the Server.xml configuration file in Wowza, there is a need to restart the Wowza Streaming Engine.<\/span><\/p>\n

Important Commands For REST-API:<\/b><\/p>\n

1) To get list of Wowza channels:
\n<\/b><\/b><\/p>\n

[js]
\ncurl -X GET –header ‘Accept:application\/json; charset=utf-8’ http:\/\/localhost:8087\/v2\/servers\/_defaultServer_\/vhosts\/_defaultVHost_\/applications
\n[\/js]<\/p>\n

2) To get the information of a single Wowza Application (Channel: live1)
\n<\/b><\/p>\n

[js]curl -X GET –header ‘Accept:application\/json; charset=utf-8’ http:\/\/localhost:8087\/v2\/servers\/_defaultServer_\/vhosts\/_defaultVHost_\/applications\/live1[\/js]<\/p>\n

\u00a03) To create a single Wowza Application (Channel: live2)
\n<\/b><\/p>\n

[js]curl -X POST –header ‘Accept:application\/json; charset=utf-8’ –header ‘Content-type:application\/json; charset=utf-8’ http:\/\/localhost:8087\/v2\/servers\/_defaultServer_\/vhosts\/_defaultVHost_\/applications\/live2 –data @body.json [\/js]<\/p>\n

Note: <\/b>In body.json, we can pass the JSON body of the application\u2019s information. We can edit the output of the step 2 accordingly and use it to create a new channel.<\/p>\n

4) \u00a0\u00a0To delete a single Wowza Application (Channel: live2)
\n<\/b><\/p>\n

[js]curl -X DELETE –header ‘Accept:application\/json; charset=utf-8’ http:\/\/localhost:8087\/v2\/servers\/_defaultServer_\/vhosts\/_defaultVHost_\/applications\/live1 [\/js]<\/p>\n

By using the above documentation, you can automate the process of managing Wowza applications using customized scripts on multiple Wowza servers.<\/span><\/strong><\/p>\n","protected":false},"excerpt":{"rendered":"

Wowza Streaming Engine is a streaming software utility which is developed by Wowza Media Systems. The utility is capable of streaming various types of videos and audio files on mobile, tablet and personal computer etc. The types of streaming videos include live video and on-demand streaming. It is basically a Java application which is supported […]<\/p>\n","protected":false},"author":170,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"iawp_total_views":19,"footnotes":""},"categories":[1174,2348,1],"tags":[3938,3931,3932,3939,3934,3936,3935,3933,3937],"class_list":["post-39567","post","type-post","status-publish","format-standard","hentry","category-aws-2","category-devops-technology","category-technology","tag-using-wowza-on-aws","tag-wowza","tag-wowza-application-management","tag-wowza-automation","tag-wowza-aws","tag-wowza-channels-api","tag-wowza-management-on-linux","tag-wowza-on-aws","tag-wowza-streaming-engine-on-aws"],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t