Differences between revisions 1 and 29 (spanning 28 versions)
⇤ ← Revision 1 as of 2011-03-24 13:02:56 →
Size: 4862
Editor: heb
Comment:
← Revision 29 as of 2011-05-03 07:17:17 → ⇥
Size: 3762
Editor: heb
Comment:
Deletions are marked like this. Additions are marked like this.
Line 2: Line 2:
The release package can be found at wowza@iapetus:~/releases/mediestream-wowza-release-package-2.0.9rc2_bundle.zip
Line 4: Line 5:
This is the Wowza plugin in the DOMS project. The purpose of the plugin is to enhances the Wowza streaming server with This is the Wowza plugin in the MedieStream project.
 1. Locate media files in a folder structure decided by BES
 1. Log information when a user starts streaming a program in statistics log
Line 11: Line 14:
 1. Wowza Streaming Server version 2.2.3)  1. Wowza Streaming Server version 2.2.3
Line 13: Line 16:
 1. BES must be installed
 1. Previous version of plugin installed on server at ~wowza/services/wowza_vhost_doms
Line 16: Line 21:
 1. There is one user account for the wowza, and the wowza server is installed in ~/wowza
 1. Check !!! One vhost have been configured (in ~/wowza/conf/VHosts.xml), with the name _domsVHost_ and configDir ~/services/wowza_vhost_doms		  1. There is one user account for the wowza, and the wowza server is installed in ~/wowza. The folder structure is assumed to be:
  a. ~wowza/
   a. bin/
   a. services/
    a. wowza_vhost_kultur/
    a. wowza_vhost_chaos/
    a. wowza_vhost_.../
   a. wowza/

=== Installation procedure ===
 1. Backup/remove old vhost from the DOMS project ~/services/wowza_vhost_doms/
 1. Extract release bundle to a temporary folder on server
 1. Run deploy script from release package

=== Configuration ===
 1. Replace ''~/services/wowza_vhost_kultur/streamingContent'' folder with symbolic link to root of the program media files from BES
 1. Replace ''~/services/wowza_vhost_kultur/streamingContentPreview'' folder with symbolic link to root of the preview media files from BES
 
 1. Create dir {{{/home/wowza/logs}}} for streaming statistics logs.

 1. Configure ''~/services/wowza_vhost_kultur/conf/kultur/doms-wowza-plugin.properties'':{{{
ticketCheckerLocation=<ticket_checker_address>, i.e. http://alhena:7880/authchecker-service/tickets
broadcastExtractionServiceRestApi=<bes_address>, i.e. http://iapetus:9311/bes_DEVEL/rest/bes/}}}

 1. Configure ''~/services/wowza_vhost_kultur/conf/kultur_live/domslive-wowza-plugin.properties''{{{
ticketCheckerLocation=<ticket_checker_address>, i.e. http://alhena:7880/authchecker-service/tickets
broadcastExtractionServiceRestApi=<bes_address>, i.e. http://iapetus:9311/bes_DEVEL/rest/bes/}}}

 1. Configure ''~/services/wowza_vhost_kultur/conf/VHost.xml''
  a. Topmost portnumber:{{{
<Port>1935</Port>}}}
  a. Open streaming port in firewall
  a. Under comment {{{<!-- Admin HostPort -->}}}:{{{
<Port>8086</Port>}}}

 1. Configure ''~/wowza/conf/VHosts.xml''
  a. Remove{{{
                <VHost>
                        <Name>_domsVHost_</Name>
                        <ConfigDir>/home/wowza/services/wowza_vhost_doms</ConfigDir>
                        <ConnectionLimit>0</ConnectionLimit>
                </VHost>}}}
  a. Add{{{
                <VHost>
                        <Name>_kulturVHost_</Name>
                        <ConfigDir>/home/wowza/services/wowza_vhost_kultur</ConfigDir>
                        <ConnectionLimit>0</ConnectionLimit>
                </VHost>}}}
Line 20: Line 71:
== Changelog ==
Release history for the mediestream-wowza-plugin project.
Line 21: Line 74:
New entries are added at the top and should include the date for each release as well as mentioning new features briefly. If reported bugs are fixed as part of a release, the Jira numbers should also be enumerated.
Line 22: Line 76:
=== Installation procedure ===
 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. The doms application 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. The domslive application is now also configured
 1. Create a symbolic link ''~/services/wowza_vhost_doms/streamingContentPreview'' that points to the root folder of preview files.
 1. The preview application is now also configured
 1. Restart wowza. The wowza plugin install should now be complete		  1. Added step in releasenote. Released 2011-05-03
  * Open streaming port in firewall
Line 47: Line 79:
 1. Version '''2.0.9rc2''' released 2011-04-13
  * Relocated statistic logs to ~/logs
  * Added statistic extractor program
  * Add shell script helper to request a ticket
Line 48: Line 84:


= 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
 1. Translating the user request URL to a specific media file
 1. Enable live streaming

== Installation instructions for STAGE and PROD ==

=== Prerequisites for the installation ===
 1. Java 6
 1. Wowza Streaming Server version 2.1.2
 1. DOMS must be installed with ticket issuer

=== Installation procedure ===
 1. Shutdown Wowza {{{
sudo /usr/local/sbin/wowzainit.sh stop}}}

 1. Extract installation package to ~/tmp/wdp_1.0/ {{{
unzip releases/DOMS-Wowza-plugin-1.0rc2_install-package.zip -d tmp/wdp_1.0/}}}

 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}}}		  1. Version '''2.0.7rc1''' released 2011-04-06
  * First release candidate of version 2

Release note for Wowza plugin version 2.0

The release package can be found at wowza@iapetus:~/releases/mediestream-wowza-release-package-2.0.9rc2_bundle.zip

New features

This is the Wowza plugin in the MedieStream project.

  1. Locate media files in a folder structure decided by BES
  2. Log information when a user starts streaming a program in statistics log

Installation instructions for STAGE and PROD

Prerequisites for the installation

  1. Java 6
  2. Vlc video player installed
  3. Wowza Streaming Server version 2.2.3
  4. DOMS must be installed with ticket issuer
  5. BES must be installed
  6. Previous version of plugin installed on server at ~wowza/services/wowza_vhost_doms

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. The folder structure is assumed to be:
    1. ~wowza/
      1. bin/
      2. services/
        1. wowza_vhost_kultur/
        2. wowza_vhost_chaos/
        3. wowza_vhost_.../
      3. wowza/

Installation procedure

  1. Backup/remove old vhost from the DOMS project ~/services/wowza_vhost_doms/
  2. Extract release bundle to a temporary folder on server
  3. Run deploy script from release package

Configuration

  1. Replace ~/services/wowza_vhost_kultur/streamingContent folder with symbolic link to root of the program media files from BES

  2. Replace ~/services/wowza_vhost_kultur/streamingContentPreview folder with symbolic link to root of the preview media files from BES

  3. Create dir /home/wowza/logs for streaming statistics logs.

  4. Configure ~/services/wowza_vhost_kultur/conf/kultur/doms-wowza-plugin.properties:

    ticketCheckerLocation=<ticket_checker_address>, i.e. http://alhena:7880/authchecker-service/tickets
broadcastExtractionServiceRestApi=<bes_address>, i.e. http://iapetus:9311/bes_DEVEL/rest/bes/

  5. Configure ~/services/wowza_vhost_kultur/conf/kultur_live/domslive-wowza-plugin.properties

    ticketCheckerLocation=<ticket_checker_address>, i.e. http://alhena:7880/authchecker-service/tickets
broadcastExtractionServiceRestApi=<bes_address>, i.e. http://iapetus:9311/bes_DEVEL/rest/bes/

  6. Configure ~/services/wowza_vhost_kultur/conf/VHost.xml

    1. Topmost portnumber:

      <Port>1935</Port>
    2. Open streaming port in firewall

    3. Under comment <!-- Admin HostPort -->:

      <Port>8086</Port>

  7. Configure ~/wowza/conf/VHosts.xml

    1. Remove

                      <VHost>
                        <Name>_domsVHost_</Name>
                        <ConfigDir>/home/wowza/services/wowza_vhost_doms</ConfigDir>
                        <ConnectionLimit>0</ConnectionLimit>
                </VHost>

    2. Add

                      <VHost>
                        <Name>_kulturVHost_</Name>
                        <ConfigDir>/home/wowza/services/wowza_vhost_kultur</ConfigDir>
                        <ConnectionLimit>0</ConnectionLimit>
                </VHost>

Changelog

Release history for the mediestream-wowza-plugin project.

New entries are added at the top and should include the date for each release as well as mentioning new features briefly. If reported bugs are fixed as part of a release, the Jira numbers should also be enumerated.

  1. Added step in releasenote. Released 2011-05-03
    • Open streaming port in firewall

  2. Version 2.0.9rc2 released 2011-04-13

    • Relocated statistic logs to ~/logs
    • Added statistic extractor program
    • Add shell script helper to request a ticket

  3. Version 2.0.7rc1 released 2011-04-06

    • First release candidate of version 2

Release note for Wowza plugin version 2.0 (last edited 2011-05-03 07:17:17 by heb)