4862
Comment:
|
3354
|
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/ |
Line 23: | Line 31: |
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. 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 |
Line 47: | Line 35: |
=== 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. |
|
Line 48: | Line 41: |
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/}}} |
|
Line 49: | Line 45: |
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/}}} |
|
Line 50: | Line 49: |
= Release note for Wowza plugin version 1.0rc2 = Released medio januar 2011 |
1. Configure ''~/services/wowza_vhost_kultur/conf/VHost.xml'' a. Topmost portnumber:{{{ <Port>1935</Port>}}} a. Under comment {{{<!-- Admin HostPort -->}}}:{{{ <Port>8086</Port>}}} |
Line 53: | Line 55: |
The release package can be found at ''doms@iapetus:~/releases/DOMS-Wowza-plugin-1.0rc2_install-package.zip'' | 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 55: | Line 69: |
== 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 |
== Changelog == |
Line 58: | Line 71: |
1. User authentication 1. Translating the user request URL to a specific media file 1. Enable live streaming |
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 62: | Line 76: |
== 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.
- Locate media files in a folder structure decided by BES
- Log information when a user starts streaming a program in statistics log
Installation instructions for STAGE and PROD
Prerequisites for the installation
- Java 6
- Vlc video player installed
- Wowza Streaming Server version 2.2.3
- DOMS must be installed with ticket issuer
- BES must be installed
- 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
- There is one user account for the wowza, and the wowza server is installed in ~/wowza. The folder structure is assumed to be:
- ~wowza/
- bin/
- services/
- wowza_vhost_kultur/
- wowza_vhost_chaos/
- wowza_vhost_.../
- wowza/
- ~wowza/
Installation procedure
- Backup/remove old vhost from the DOMS project ~/services/wowza_vhost_doms/
- Extract release bundle to a temporary folder on server
- Run deploy script from release package
Configuration
Replace ~/services/wowza_vhost_kultur/streamingContent folder with symbolic link to root of the program media files from BES
Replace ~/services/wowza_vhost_kultur/streamingContentPreview folder with symbolic link to root of the preview media files from BES
Create dir /home/wowza/logs for streaming statistics logs.
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/
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/
Configure ~/services/wowza_vhost_kultur/conf/VHost.xml
Topmost portnumber:
<Port>1935</Port>
Under comment <!-- Admin HostPort -->:
<Port>8086</Port>
Configure ~/wowza/conf/VHosts.xml
Remove
<VHost> <Name>_domsVHost_</Name> <ConfigDir>/home/wowza/services/wowza_vhost_doms</ConfigDir> <ConnectionLimit>0</ConnectionLimit> </VHost>
Add
<VHost> <Name>_kulturVHost_</Name> <ConfigDir>/home/wowza/services/wowza_vhost_kultur</ConfigDir> <ConnectionLimit>0</ConnectionLimit> </VHost>
Changelog
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
Version 2.0.7rc1 released 2011-04-06
- First release candidate of version 2