Differences between revisions 28 and 29
⇤ ← Revision 28 as of 2011-01-27 12:26:14 →
Size: 5413
Editor: abr
Comment:
← Revision 29 as of 2011-01-27 12:40:29 → ⇥
Size: 4821
Editor: abr
Comment:
Deletions are marked like this. Additions are marked like this.
Line 29: Line 29:
 1. Shutdown Wowza {{{
sudo /usr/local/sbin/wowzainit.sh stop}}}		  1. Shutdown Wowza (not really nessesary, but please...)
 1. if nessessary remove any files in ~/services/wowza_vhost_doms/
 1. Extract the plugin into ~/services/wowza_vhost_doms/
 1. There should now be these directories
  * applications/
  * conf/
  * bin/
 1. The plugin is now installed, so it needs to be setup.
 1. go to ~/services/wowza_vhost_doms/conf/doms
 1. In that folder, there are two files, Application.xml and doms-wowza-plugin.properties
 1. Edit doms-wowza-plugin.properties, so that these things are set correctly
{{{
ticketCheckerLocation=ADDRESS OF TICKET CHECKER WEBSERVICE, MOST OFTEN http://DOMS_SERVER:PORT/authchecker
storageDir=WHERE THE VIDEO FILES ARE
}}}
 1. This plugin is now configured
 1. go to ~/services/wowza_vhost_doms/conf/domslive
 1. In that folder, there are two files, Application.xml and domslive-wowza-plugin.properties
 1. Edit domslive-wowza-plugin.properties, so that that the two settings mentioned above are set to the same value as for doms-wowza-plugin.properties.
 1. Edit Application.xml so that storageDir points to some temp folder where we can write .stream files for live streaming.
 1. This plugin is now also configured
 1. Restart wowza. The wowza plugin install should now be complete
Line 32: Line 52:
 1. Extract installation package to ~/tmp/wdp_1.0/ {{{
unzip releases/DOMS-Wowza-plugin-1.0rc2_install-package.zip -d tmp/wdp_1.0/}}}
Line 35: Line 53:
 1. Remove old vhost installation (if existing) {{{
mv wowza_vhost_doms tmp/old}}}

 1. Copy content of ~/tmp/wdp_1.0/ to wowza virtual host {{{
cp -R tmp/wdp_1.0/DOMS-Wowza-plugin-1.0rc2_install-package wowza_vhost_doms}}}

 1. Setup the virtual host:
  i. Create the virtual host. Edit ''<Wowza-install-dir>/conf/VHosts.xml''. Add: {{{
<VHost>
 <Name>_domsVHost_</Name>
 <ConfigDir>/home/<user>/wowza_vhost_doms</ConfigDir>
 <ConnectionLimit>0</ConnectionLimit>
</VHost>}}}

  i. Edit ''/home/<user>/wowza_vhost_doms/conf/VHost.xml''. Set the correct value for the two host port elements (''Root/VHost/HostPortList/HostPort/Port''):
   * First entry (RTMP protocol) to 1935
   * Second entry (Admin Hostport) to 8086
 1. Create folder structure:
  i. Symlink: ''wowza_vhost_doms/streamingContent'' -> ''<path_to_bes_output_folder>''
  i. Create folder: ''wowza_vhost_doms/streamingContentLive''
  i. Symlink: ''wowza_vhost_doms/streamingContent/files'' -> ''wowza_vhost_doms/streamingContent''
 1. Set location of media files. Edit ''/home/<user>/wowza_vhost_doms/conf/<app>/Application.xml'' for both applications ''doms'' and ''domslive''. Change element ''Root/Application/Streams/StorageDir'' to location of media files produced by Broadcast Extraction Service.
  a. doms: /home/<user>/streamingContent
  a. domslive: /home/<user>/streamingContentLive

 1. Setup Ticket issuer in property file ''doms-wowza-plugin.properties'' for both applications (doms and domslive). Look for property {{{
ticketCheckerLocation=http://<ticket_issuer>:<port>/authchecker}}}

 1. Start Wowza {{{
sudo /usr/local/sbin/wowzainit.sh start}}}

Release note for Wowza plugin version 1.0rc3

Released 26. januar 2011

TODO where to get the release

New features

This is the Wowza plugin in the DOMS project. The purpose of the plugin is to enhances the Wowza streaming server with

  1. User authentication
  2. Translating the user request URL to a specific media file
  3. Enable live streaming

Installation instructions for STAGE and PROD

Prerequisites for the installation

  1. Java 6
  2. Wowza Streaming Server version 2.1.2 or newer (tested on 2.2.3)
  3. DOMS must be installed with ticket issuer

We assume that wowza have been configured in the way that SB it maintenance prefers. This means that

  1. There is one user account for the wowza, and the wowza server is installed in ~/wowza
  2. One vhost have been configured (in ~/wowza/conf/VHosts.xml), with the name _domsVHost_ and configDir ~/services/wowza_vhost_doms

Installation procedure

  1. Shutdown Wowza (not really nessesary, but please...)
  2. if nessessary remove any files in ~/services/wowza_vhost_doms/
  3. Extract the plugin into ~/services/wowza_vhost_doms/
  4. There should now be these directories
    • applications/
    • conf/
    • bin/
  5. The plugin is now installed, so it needs to be setup.
  6. go to ~/services/wowza_vhost_doms/conf/doms
  7. In that folder, there are two files, Application.xml and doms-wowza-plugin.properties
  8. Edit doms-wowza-plugin.properties, so that these things are set correctly 

ticketCheckerLocation=ADDRESS OF TICKET CHECKER WEBSERVICE, MOST OFTEN http://DOMS_SERVER:PORT/authchecker
storageDir=WHERE THE VIDEO FILES ARE
  1. This plugin is now configured
  2. go to ~/services/wowza_vhost_doms/conf/domslive
  3. In that folder, there are two files, Application.xml and domslive-wowza-plugin.properties
  4. Edit domslive-wowza-plugin.properties, so that that the two settings mentioned above are set to the same value as for doms-wowza-plugin.properties.
  5. Edit Application.xml so that storageDir points to some temp folder where we can write .stream files for live streaming.
  6. This plugin is now also configured
  7. Restart wowza. The wowza plugin install should now be complete

Release note for Wowza plugin version 1.0rc2

Released medio januar 2011

The release package can be found at doms@iapetus:~/releases/DOMS-Wowza-plugin-1.0rc2_install-package.zip

New features

This is the first version of the Wowza plugin in the DOMS project. The purpose of the plugin is to enhances the Wowza streaming server with

  1. User authentication
  2. Translating the user request URL to a specific media file
  3. Enable live streaming

Installation instructions for STAGE and PROD

Prerequisites for the installation

  1. Java 6
  2. Wowza Streaming Server version 2.1.2
  3. DOMS must be installed with ticket issuer

Installation procedure

  1. Shutdown Wowza 

    sudo /usr/local/sbin/wowzainit.sh stop

  2. Extract installation package to ~/tmp/wdp_1.0/ 

    unzip releases/DOMS-Wowza-plugin-1.0rc2_install-package.zip -d tmp/wdp_1.0/

  3. Remove old vhost installation (if existing) 

    mv wowza_vhost_doms tmp/old

  4. Copy content of ~/tmp/wdp_1.0/ to wowza virtual host 

    cp -R tmp/wdp_1.0/DOMS-Wowza-plugin-1.0rc2_install-package wowza_vhost_doms
  5. Setup the virtual host:

    1. Create the virtual host. Edit <Wowza-install-dir>/conf/VHosts.xml. Add: 

      <VHost>
 <Name>_domsVHost_</Name>
 <ConfigDir>/home/<user>/wowza_vhost_doms</ConfigDir>
 <ConnectionLimit>0</ConnectionLimit>
</VHost>

    2. Edit /home/<user>/wowza_vhost_doms/conf/VHost.xml. Set the correct value for the two host port elements (Root/VHost/HostPortList/HostPort/Port):

      • First entry (RTMP protocol) to 1935
      • Second entry (Admin Hostport) to 8086
  6. Create folder structure:

    1. Symlink: wowza_vhost_doms/streamingContent -> <path_to_bes_output_folder>

    2. Create folder: wowza_vhost_doms/streamingContentLive

    3. Symlink: wowza_vhost_doms/streamingContent/files -> wowza_vhost_doms/streamingContent

  7. Set location of media files. Edit /home/<user>/wowza_vhost_doms/conf/<app>/Application.xml for both applications doms and domslive. Change element Root/Application/Streams/StorageDir to location of media files produced by Broadcast Extraction Service.

    1. doms: /home/<user>/streamingContent

    2. domslive: /home/<user>/streamingContentLive

  8. Setup Ticket issuer in property file doms-wowza-plugin.properties for both applications (doms and domslive). Look for property 

    ticketCheckerLocation=http://<ticket_issuer>:<port>/authchecker

  9. Start Wowza 

    sudo /usr/local/sbin/wowzainit.sh start

Release note for Wowza plugin version 1.0 (last edited 2011-02-14 10:50:40 by abr)