wiki:OvaDeploymentNote-1.0.0

Version 21 (modified by paul, 3 years ago) (diff)

--

V1.0.0 Deployment Note - Feb 28 2012

1. Introduction

OVA v1.0.0 is being released. Four packages are included in the release:

  • OVA for JW5
  • OVA for JW4
  • OVA for Flowplayer
  • OVA for AS3

OVA for JW4 is being depreciated with the v1.0.0 release. It remains available for download on the OVA Developer Site, but will not be deployed to the Longtail repository.

OVA for AS3 remains a download only release available via the "Download the Latest" page on the OVA Developer Site.

OVA for JW5 and OVA for Flowplayer require deployment and may be run in the following modes:

  • Hosted: The preferred solution is OVA running as a "hosted" solution where the OVA files are hosted on the Longtail servers.
  • Self-serve: OVA users may also elect to host the OVA files on their own servers.

In addition to the deployment requirements for the OVA for JW5 and OVA for Flowplayer packages, a number of static support files require deployment to the Longtail CDN to support the OVA Support Site documentation. Section 5 of this release note deals with the deployment instructions for those files.

2. Deploying OVA for JW5 in "Hosted" Mode

When deploying OVA to run in "hosted" mode, two deployments are required:

  • The "trial" deployment to support the "try" page code block
  • The "production" deployment

Two deployments are required to allow the usage of OVA as a trial to be independently tracked to the production usage.

2.1 Deploying the OVA Plugin

Users configuring the "trial" hosted version will configure it as follows:

....
plugins: {
    "ova-jw-trial": {
           // OVA config goes in here
    }
}
....

Users configuring the "production" hosted version will configure it as follows:

....
plugins: {
    "ova-jw": {
           // OVA config goes in here
    }
}
....

OVA for JW5 has both a SWF and minimal Javascript implementation. As such, there are two main files to deploy:

  • ova-jw.swf
  • ova-jw.js

Both files are located in the /dist/swf directory of the distribution package.

2.2 Downloading the OVA for JW5 1.0.0 Release

The distribution package is tagged and checked into SVN on the OVA Developer Site. The OVA for JW5 v1.0.0 distribution package can be downloaded:

  • From the release page on the OVA Developer Site  here
  • Via the SVN browser  here

When downloading the OVA for JW5 v1.0.0 distribution, download either ova.jwplayer.5x.tar.gz or ova.jwplayer.5x.zip. The tagged v1.0.0 OVA for JW5 source tree can be found  here via the SVN source browser .

3. Deploying OVA for Flowplayer in "Hosted" Mode

When deploying OVA for Flowplayer in "Hosted" mode, two instances of the OVA plugin must be deployed to the Longtail CDN:

  • The OVA trial version
  • The OVA production version

3.1 Deploying the OVA Plugin

Users configuring the trial version of the OVA plugin will configure it as follows:

...
plugins: {
    ova: {
          url: "http://ova.longtailvideo.com/flowplayer/ova-trial.swf",
          // OVA configuration goes in here
    }
}

Users configuring the production "hosted" version of OVA will configure it as follows:

...
plugins: {
    ova: {
          url: "http://ova.longtailvideo.com/flowplayer/ova-1.0.0.swf",
          // OVA configuration goes in here
    }
}

Both instances of the OVA SWF should be copied from the same ova.swf file included in the /dist/swf directory of the OVA for Flowplayer distribution package and renamed as follows:

  • Trial SWF to be named ova-trial.swf
  • Production SWF to be named ova-1.0.0.swf

The OVA production SWF is following a versioned numbering scheme as per standard Flowplayer plugins. This allows Flowplayer users to quickly identify the version of the SWF they are running and is a convention that they are used to.

Both instances of the OVA SWF should be addressible on the Longtail CDN in the same directory with an expected path of http://ova.longtailvideo.com/flowplayer/...

As such, the final URLs for the trial and production instances of the OVA SWF are expected to be:

  • http://ova.longtailvideo.com/flowplayer/ova-trial.swf
  • http://ova.longtailvideo.com/flowplayer/ova-1.0.0.swf

In addtion, to run the OVA for Flowplayer examples on the OVA Support Site and the OVA Trial product page, a number of additional Flowplayer specific SWF must also be deployed to the Longtail CDN. These SWF files can be found in the /dist/swf directory of the OVA for Flowplayer distribution package.

The list of Flowplayer related SWF files to deploy includes:

  • flowplayer.3.2.7.swf - the Flowplayer SWF
  • flowplayer.akamai-3.2.0.swf - the Akamai proxy plugin
  • flowplayer.analytics-3.1.5.swf- the GA plugin
  • flowplayer.audio.swf - the audio streamer plugin
  • flowplayer.bwcheck-3.2.5.swf - the bandwidth check plugin
  • flowplayer.cluster-3.2.3.swf - the clustering plugin
  • flowplayer.controls-3.2.5.swf - the controls plugin
  • flowplayer.pseudostreaming-3.2.7.swf - the pseudo streaming plugin
  • flowplayer.rtmp-3.2.3.swf - the RTMP streaming plugin
  • flowplayer.securestreaming-3.2.3.swf - the secure streaming plugin
  • flowplayer.sharing-3.2.1.swf - the sharing plugin

Finally, the Flowplayer Javascript file has to be deployed. This file can be found in the /dist/js directory and is named flowplayer.3.2.6.min.js.

The supporting Flowplayer SWF and Javascript files should be deployed into the same CDN directory as the OVA SWF files - this is expected to be http://ova.longtailvideo.com/flowplayer/....

3.2 Downloading the OVA for Flowplayer 1.0.0 Release

The distribution package is tagged and checked into SVN on the OVA Developer Site. The OVA for Flowplayer v1.0.0 distribution package can be downloaded:

  • From the release page on the OVA Developer Site  here
  • Via the SVN browser  here

When downloading the OVA for JW5 v1.0.0 distribution, download either ova.flowplayer.tar.gz or ova.flowplayer.zip. The tagged v1.0.0 OVA for Flowplayer source tree can be found  here via the SVN source browser .

4. Deploying OVA jQuery Library

OVA also has a jQuery based library that can optionally be used to handle companion code insertion and HTML5 based non-linear ad display. This library is called ova-jquery.js and the file is located in the /dist/js directory of either the OVA for JW5 or OVA for Flowplayer distribution packages.

You can also independently download the ova-jquery.js library via the OVA Developer Site "Latest Releases" download page  here.

The ova-jquery.js library should be deployed on the Longtail CDN so that it can be accessed by trial and production users via a URL such as http://ova.longtailvideo.com/ova-jquery.js

5. Deploying the OVA Support Site Static Files

X