Aurea Social Video Stream Kontiki integration
Overview
Many organizations who want to use Video Stream to truly make video “social” have already made substantial investments in video streaming infrastructure. One of the popular enterprise-class video storage and streaming technologies that NewsGator customers are using is Kontiki.
Kontiki’s peer-based file sharing mechanism is ideal for geographically disparate environments as it minimizes load on the WAN by streaming from a copy local to a region or office.
This guide describes how to enable Kontiki. Kontiki handles the encoding, storage and streaming mechanism for Video Stream.
For the end-user, the Video Stream experience is the same as using the Video Stream native option.
For the administrator, the Kontiki integration capability deploys as a SharePoint feature.
Compatibility
This integration supports Kontiki 8.2.
Configuring Video Stream to support Kontiki
Below are the steps to enable and disable the Kontiki Integration feature.
The Kontiki Integration feature requires Aurea Social5.1 and Aurea Social Video Stream 5.1 (or later). These should be installed and configured before deploying the Kontiki Integration feature.
Since Kontiki handles the streaming, configuration steps or entries related to the streaming server in the Aurea Social installer or the Video Stream Additional Components installer can be ignored. IIS and the Smooth Streaming Extensions for IIS is not required.
The Kontiki Integration feature requires the Kontiki client to be installed on any machine that views videos. If the Kontiki client is not installed on the user’s machines they cannot view videos.
Make sure you have a Kontiki user account with connector access allowing you to use the Kontiki publishing web service endpoint.
Integration with Kontiki is done through a REST API endpoint protected by SSL. The root certificate used by Kontiki must be trusted by your SharePoint installation.
The root certificate that should be trusted by your SharePoint installation is the “DigiCert High Assurance EV Root CA”.
You can get the certificate from https://www.digicert.com/digicert-root-certificates.htm. Once you have a copy of the certificate on the machine you can proceed with telling SharePoint to trust this certificate.
- Go to Central Administration > Security > Manage Trust.
- Click on New.
- Click on the Browse option of the Root Authority Certificate field
- Select the file that contains the copy of the certificate
The Kontiki integration is contained in the NewsGator.VideoStream.KontikiIntegration.wsp
file. The Kontiki solution is not loaded by any of the NewsGator installers so this needs to be done manually.
You can use STSADM or PowerShell to load this solution file into your SharePoint installation.
Here is an example of the STSADM and PowerShell commands that loads the solution file into SharePoint:
- STSADM :
STSADM –o addsolution –filename .\NewsGator.VideoStream.KontikiIntegration.wsp
- PowerShell:
Add-SPSolution .\NewsGator.VideoStream.KontikiIntegration.wsp
Once the solution has been loaded into your environment you can proceed to Central Administration / System Settings / Manage farm features
and deploy it.
Once deployed, a new Farm level feature is available. This feature is called NewsGator VideoStream Integration With Kontiki (Farm). Activating this feature registers Kontiki as a possible provider for video encoding and streaming.
After enabling the feature you should restart IIS and the SharePoint Timer service on all the servers in the farm.
Once the solution file is deployed and the farm level feature is activated a new Kontiki option appears on the manage page for the VideoStream module.
This option takes you to a Kontiki properties page where you can configure the connection with the Kontiki Publishing web service.
Fields on the properties page:
- Kontiki REST API url: The url used to access Kontiki’s REST endpoint. It is https://api.kontiki.com/api/v1.
- Kontiki REST API access token type: Kontiki’s API can be accessed using either a service token, which Kontiki should supply you with, or a public token. For further details, see Kontiki’s REST API documentation for an explanation of service and public tokens.
- Public token configuration: If you have selected Public Token, you have to fill in this section.
- Company Prefix (mandatory): The company prefix Kontiki provided you with.
- Email (mandatory): Any company email address.
- Service token configuration: If you selected Service Token, you need to fill in the values in this section.
- Service Token (mandatory): The service token Kontiki provided you with. This token gives you rights to do any action using the REST API endpoint.
- Act as user (optional): When using a service token you can optionally elect to impersonate any user. You can use this option if you want to perform video upload and transcoding on Kontiki using a particular user. It is not mandatory.
- Kontiki Client Port Number: The port number the Kontiki clients are configured to listenon in your environment.
Once you have configured access to the Kontiki REST API endpoint you need to tell VideoStream to use Kontiki to encode and stream videos.
To do this, follow the below steps:
- Go to the VideoStream configuration page.
- Change both fields in the Video Stream Service Providers section to be Kontiki Encoder and Kontiki Streaming.
Once changed you can only encode to Progressive download. If you attempt to enable other encoding formats (supported by Video Stream native encoding) the configuration page does not allow you.
To switch back to Video Stream native mode, follow the below steps:
- Select NewsGator Video Stream Encoder and NewsGator Video Stream Streaming in the configuration page.
- Go to Central Administration > Manage Farm Features and deactivate the NewsGator VideoStream Integration With Kontiki (Farm).
- Install the streaming server.
Consult the Aurea Social v5.5 Installation guide for details.