Prerequisites


Skype for Business

  1. Ask the Skype for Business server administrator to send you a file copy of the certificate chain that is used by the Skype for Business server.

  2. Go to the server at which you will install the webinar connector (see the “Server Architecture” section below) and perform the following two actions:

    1. Download and install Unified Communications Managed API 5.0 Runtime.

    2. Install this certificate chain as described here.

How to Set Up Integration with a Webinar Service

Download Webinar Connector

You can download webinar connectors here.

Server Architecture

Webinar connectors can be located on a separate server or on one of the servers of your SharePoint farm.

A webinar connector database can be located on the same SQL server as the ShareKnowledge databases or on a separate SQL server. For each webinar connector, you should create a separate webinar connector database.

Internet access is required for webinar connectors.

server_architecture.png

Create New Database

Create a webinar connector database:

  1. Open SQL Management Studio and create new DB.

  2. Open new query window, select just created DB and run script “webinar.sql”

Create New IIS Website

  1. Create a new site in IIS:

    1. Open “IIS Manager” - [server name] - “Sites” - “Add Website”.

    2. “Physical Path” must point to the site’s folder (containing “HPVRWebinarManager.svc”). The server at which the site’s folder is located must be in the same network as your SharePoint farm.

    3. Choose a site name.

    4. Choose a free port.

  2. Choose a user for the site’s application pool:

    1. Open “IIS Manager” - [server name] - “Application Pools” - [webinar connector site name] - “Advanced Settings” - “Identity”

    2. User must have the following privileges:

      1. Full access for the website’s folder.

      2. Read and write permissions on the database if the “Integrated Security” option is set to “True” (the “db_datareader” and the “db_datawriter” fixed database roles are sufficient).

Edit “Web.config” of Webinar Connector

  1. Go to the website’s folder and open the “Web.config” file.

  2. Find the “connectionStrings” section:

        <connectionStrings>
        <add name="WebinarEntities" connectionString="metadata=res://*/Webinars.csdl|res://*/Webinars.ssdl|res://*/Webinars.msl;provider=System.Data.SqlClient;provider connection string=&quot;data source=.\sqlexpress;initial catalog=webinars;integrated security=True;multipleactiveresultsets=True;App=EntityFramework&quot;" providerName="System.Data.EntityClient" />
        </connectionStrings>
    
  3. Edit the following fragment (see about connection strings here):

        data source=.\sqlexpress;initial catalog=webinars;integrated security=True;multipleactiveresultsets=True;App=EntityFramework
    
    1. “Data source”: type your SQL server name.

    2. “Initial catalog”: type the name of the database that was created earlier.

  4. Comment out the “IWebinarEventOperationFactory” sections for webinar connectors that you will not use. Uncomment the same section for the webinar connector that you want to set up and edit the following parameters (click on a name below):


    1. Cisco WebEx® Meetings

    Parameter Description
    webExId The Webex ID.
    password The user password.
    siteName You can copy this value from the URL: https://[SiteName].webex.com.
    siteId The Site ID. You may leave this field blank.
    centerType Type “Meeting” in this field if you want to create WebEx Meetings. Type “Event” if you want to create WebEx Events.
    template You might use parameter “template” to use WebEx templates to create events in ShareKnowledge. If you do not use templates, you should leave this parameter blank. Otherwise, enter the name of template from WebEx.
    allowAnyoneHostMeeting The value for property “Let anyone with a host account on this site host my meeting” is taken from this parameter (irrespective of whether WebEx templates exist or not). “True” = checked. “False” = deselected.


    2. Adobe® Connect™

    Parameter Description
    baseurl The “Account URL*” field in Adobe Connect (for example, http://meet12345678.adobeconnect.com/). Please use “http” instead of “https” here.
    login The “Username” field in Adobe Connect, which is the email address that you provided during the registration.
    password The “Password” field in Adobe Connect.
    accountId This ID can be retrieved from the following URL: http://meet12345678.adobeconnect.com/api/xml?action=common-info, where http://meet12345678.adobeconnect.com/ is the “Account URL*” field. You should follow this link and find the “account-id” field there. Alternatively, you should select “Administration” - “Account Summary” - “Account Information”; this ID is the second part of the “Name” field (the digits after the hyphen).
    useSeminarRooms “true” = use Adobe® Connect™ seminars; “false” = do not use them


    3. Skype for Business

    Parameter Description
    isSipEnabled Sets a value for the “Conference​Schedule​Information.​Phone​Access​Enabled” property. When it is set to “true”, participants can join the conference over the phone. Available values: “true” and “false”.
    isPassKeyEnabled If you set it to “true”, conference passcodes will be added to training events’ URLs. Available values: “true” and “false”.
    applicationUserAgent The string is used to identify this application (i.e. the Skype for Business webinar connector). The default text is “Webinars.Service”. See also here.
    conferenceAccessLevel This property is not used. (The webinar connector always sets the access level for conferences to the “SameEnterprise” mode.)
    serverName The Skype For Business server URL.
    ownerUri The user’s Skype For Business server login. This user has access to Skype For Business and can create conferences. For example: “sip:johndoe@example.com”.
    userName The user name (of the user specified in the “ownerUri” property).
    domain The user domain.
    password The user password.
    ldapPath This property is not used.

Check Availability of Webinar Connector

  1. Open the http://.../HPVRWebinarManager.svc page in a web-browser from any server of your SharePoint farm. This page must be accessible from all servers of your farm.

  2. The webinar connector is accessible from this server if you can see this page:
    04.png

Edit “Web.config” of ShareKnowledge

  1. Run “IIS Manager” on the server where ShareKnowledge is deployed - “Sites” - [the ShareKnowledge site] - “Explore” - open the “web.config” file.

  2. Edit the “system.serviceModel” section as follows:

        <system.serviceModel>
        <serviceHostingEnvironment aspNetCompatibilityEnabled="true" />
        <client>
        <endpoint address="http://webinarConnectorSite:8087/HPVRWebinarManager.svc" binding="basicHttpBinding" contract="ServiceReference.IWebinarManager" name="Cisco WebEx Meetings" />
        </client>
        </system.serviceModel>
    

    Each webinar service requires a separate “endpoint address” string. An endpoint address points to the server on which a corresponding webinar connector is located.

  3. If the ShareKnowledge web application was extended, you should make the same changes for the IIS site related to the extended web application.

  4. Edit the “Web.config” file on all the servers where ShareKnowledge is deployed, including web front-end and application servers.

Final Check

  1. Create a new instructor-led training in ShareKnowledge.

  2. Go to the event creation page, click on the “Format” field and select the webinar service that you have just configured.

  3. Create this event. If it is successfully created, then integration with this webinar service is completed.

Supported Webinar Services

  1. Cisco WebEx® Meetings

  2. Adobe® Connect™

  3. Skype for Business