Release note for Wowza plugin version 2.0

The release package can be found at wowza@iapetus:~/releases/mediestream-wowza-release-package-2.0.7rc1_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

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 package 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. 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/
  4. 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/
  5. Configure ~/services/wowza_vhost_kultur/conf/VHost.xml

    1. Topmost portnumber:

      <Port>1935</Port>
    2. Under comment <!-- Admin HostPort -->:

      <Port>8086</Port>
  6. 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>