Kaltura Video Plugin for Jive Deployment Guide

Printer-friendly version
Audience / Tech Expertise: 

This guide describes how to deploy the Kaltura Video Plugin for Jive and the deployment of the NodeJS middleware application. This guide pertains to version 9.0.1.0-1 of the Kaltura Video Plugin for Jive.

The following topics are described:

Software Version

The application is developed for the following versions:

  • Jive SDK: Jive Node SDK version 0.2.17
  • NodeJS: v6.11.3 or or v9.3.0
  • Jive SBS on premise: 9.0.1.0

Upload the Kaltura Video Plugin for Jive

     To Upload the Plugin

  1. Log into the Admin Console at http://community.mydomain.com/admin with a privileged user account.
  2. Click on the main “System” tab, then the “Plugins” tab.

    The available Plugins screen is displayed.
  3. Click “Add Plugin” in the left-hand column.
  4. Upload the Kaltura Video Plugin.

Configure the Plugin Settings

  1. In the Admin Console, click on the main "System" tab, then the "Management" tab.
  2. Click "System Properties" in the left-hand column.
  3. Create a new system property.
    1. Property Name:  kaltura.partnerid
    2. Property Value:  a number that identifies your Kaltura account.
  4. Click"Save Property". 
  5. Repeat the process and create a new system property with:
    1. Property Name:  kaltura.instance.url
    2. Property Value:  The KAF URL at which Kaltura can be contacted.
      The value of this parameter is likely similar to: http://[instanceid].mediaspace.kaltura.com.
  6. Click the "Save Property" button
  7. Repeat the process and create a new system property with:
    1. Property Name:  kaltura.admin.secret
    2. Property Value:  The secret token that authorizes the Jive system to interact with Kaltura services.
  8. Click the "Save Property" button.
  9. (Optional) Repeat the same process and create new optional system property with:
    1. Property Name:  kaltura.service.url
    2. Property Value:  the Kaltura service URL
      This property is not required for most installations, its default value is:  http://www.kaltura.com,

Restart the Jive Application Server

The Jive Application must be restarted to load the new plugin.

Back to Top

Deploying the Add-on

     To set up the database

  1. Create a Mongo database.
  2. Copy the DB connection string into jiveclientconfiguration.json.

For additional details on connection strings see: https://docs.mongodb.com/manual/reference/connection-string/

The jiveclientconfiguration.json

 

Install the package

     To install the package

  1. Unpack the kaltura-connector-addon-1.0.0.tgz into the desired directory.
  2. Check if the script fix-extension.sh is executable, if not, use chmod +x to do so.

Add-on Signing

Use the jiveclientconfiguration.json to configure and deploy the add-on.

  1. Navigate to Add-on configuration page in Jive.
  2. Command+Click (Mac) or Ctrl+Click (Windows) on "Upload Package".
  3. Paste the UUID found in jiveclientconfiguration.json into the Sign Package field and click Sign.
  4. Copy the generated signature into jiveclientconfiguration.json 'jiveServiceSignature' field.

Multiple signatures representing different Jive instances can be added with spaces separating the signatures.

Set the Middleware Server URL

  1. Determine the URL of the server you will be hosting the middleware server on.
  2. Copy this URL into jiveclientconfiguration.json in the 'clientUrl' field.
  3. The default port for the add-on is 8090, however, if you will be proxying to standard 80/443 http ports, you should set the 'clientUrlExcludesPort' to ‘true' .

Configure the Proxy Server (Optional)

 

If a Proxy server is deployed between the Node server and the Kaltura service, support for the Proxy server is included.

  • Add the following to the main JSON object in jiveclientconfiguration.json file to include parameters in this format:

proxy: {

    host: "myproxy.domain.com",

    port: 3812

}

Start the Server

It is no longer required to run 'npm update‘, the package will ship with all of its dependencies.

  • Run the server by running `node app`.

Install the Add-on

  1. Execute the fix-extension.sh script.
  2. Upload the file kaltura-connector-addon.zip to the Upload Package screen.
    This should display a success message. The Configure Kaltura Add-on for Jive screen is displayed. You should also see the URL of your middleware server noted on that screen .
  3. Before clicking "Save and Activate" configure the Add-on by clicking "Configure Now".
  4. Enter the configuration details for your Kaltura account and click Submit.
  5. After you submit the Configuration details for the Kaltura Add-on for Jive configuration click "Save and Activate“.

Back to Top

Setting Up HTTP

If you plan to run the NodeJS application, you must place the certificate file and the certificate key file in a directory that is accessible for the process owner of the node application.

Open the  configuration.json and change the paths for certificate files according to your environment.

It is not required to have different ports for HTTP and HTTPS. The application tests if there is a certificate available. If so, the application starts a HTTPS listener on the configured port. If not, it starts a HTTP listener on the configured HTTP port.

Back to Top

Document type: 
(1940 reads)