Polycom® VMC 2.0 SharePoint TIM Integration Guide
1.0 | July 2010 | 3725-77100-010B
Trademark Information Polycom®, the Triangles logo, ReadiManager®, SoundPoint®, SoundStation®, ViaVideo®, VoiceStation®, Vortex®, and VSX® are registered trademarks of Polycom, Inc. Convene™ , Global Management System™, iPower™, MGC™, People+Content™, People On Content™, Polycom Conference Suite™, Polycom Converged Management Application™ (CMA™), Polycom Distributed Media Application™ (DMA™), Polycom HD Voice™, Polycom PathNavigator™, Polycom VideoPlus™, Polycom VoicePlus™, PVX™, RAS™, ReadiConvene™, RMX 2000™, RSS™, V2iU™, VBP™, VS4000™, and VTX™ are trademarks of Polycom, Inc. All other trademarks are the property of their respective owners. Patent Information The accompanying product is protected by one or more U.S. and foreign patents and/or pending patent applications held by Polycom, Inc.
© 2010 Polycom, Inc. All rights reserved. Polycom, Inc. 4750 Willow Road Pleasanton, CA 94588-2708 USA No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Polycom, Inc. Under the law, reproducing includes translating into another language or format. As between the parties, Polycom, Inc., retains title to and ownership of all proprietary rights with respect to the software contained within its products. The software is protected by United States copyright laws and international treaty provision. Therefore, you must treat the software like any other copyrighted material (e.g., a book or sound recording). Every effort has been made to ensure that the information in this manual is accurate. Polycom, Inc., is not responsible for printing or clerical errors. Information in this document is subject to change without notice.
ii
Contents
Contents 1
Before Installing the SharePoint TIM . . . . . . . . . . . . . . . . . . . 1 About the Polycom SharePoint TIM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Important Notes for Server Farm Administrators . . . . . . . . . . . . . . Site Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Site Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Browser Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1 1 2 3 4 4
Polycom VMC 1000 Administrative Portal Settings . . . . . . . . . . . . . . . . . . . . 5
2
Installation and Deployment . . . . . . . . . . . . . . . . . . . . . . . . 7 Installing the SharePoint TIM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Installer Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Polycom SharePoint TIM Deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3
After Installing the SharePoint TIM . . . . . . . . . . . . . . . . . . . 13 Deploying Carousels in Sites in SharePoint . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Branding the TIM Site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 Changing the Look and Feel of the Carousel . . . . . . . . . . . . . . . . . . . . . . . . 17 The Polycom SharePoint TIM supports changing the look and feel of the default carousel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Changing the Carousel Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Timer Solution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 Data Synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 Job Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 Job Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 Solution Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 Program Availability Service Feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Updating Program Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Job Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Job Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22 22 22 23
Undeploy/Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Polycom SharePoint TIM Undeployment . . . . . . . . . . . . . . . . . . . . 23 Add or Remove Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Updating Existing TIM with New Package . . . . . . . . . . . . . . . . . . . . . . 23 Retain the Existing SharePoint TIM site . . . . . . . . . . . . . . . . . . . . . . 23
Polycom, Inc.
iii
Polycom SharePoint TIM Integration Guide
Remove All Components Including the TIM Site . . . . . . . . . . . . . 24
4
SharePoint TIM Architecture . . . . . . . . . . . . . . . . . . . . . . . . 27 Site Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 Site Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 Web Parts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 SharePoint TIM Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 SharePoint TIM Home Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Featured Programs Carousel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Most Popular Programs Carousel . . . . . . . . . . . . . . . . . . . . . . . . . . . Most Recent Programs Carousel . . . . . . . . . . . . . . . . . . . . . . . . . . . . Favorite Programs Carousel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Upcoming Live Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Navigation Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
34 35 36 36 37 37 37
Browse Programs Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 Category Details Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 Channel Details Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 More Programs Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Support for Multiple Program Links and Formats . . . . . . . . . . . . . . . . . . . . 44 Sorting and Filtering in Channel Details and More Programs Page . . . . . 44 Complex Presentations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 Live Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 Automated Broadcasts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 Program Details Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Program Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Program Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Downloadable Media Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Program Action Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Navigation Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
49 50 50 50 50 51
Live Calendar Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 Private Programs Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 Browser Settings Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
5
Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 Errors in Deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Uploading Template Failed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Site Creation Failed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Timer job deployment failed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Web part deployment failed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
55 55 55 56 57
Errors in Undeployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 Site Removal failed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
iv
Polycom, Inc.
Contents
Timer job undeployment failed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 Web part undeployment failed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 Other Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Timer job not working . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . First time install - Web part errors . . . . . . . . . . . . . . . . . . . . . . . . . . Web parts are not shown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Synchronization Service Timer Interval change is not reflected . Web part displays an error message . . . . . . . . . . . . . . . . . . . . . . . . Getting Programs, Channels, and Categories failed . . . . . . . . . . . Test Web Services Using Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Crossdomain.xml for Flash Video . . . . . . . . . . . . . . . . . . . . . . . . . . Resource Not Found Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Polycom, Inc.
59 59 60 60 61 61 61 61 62 63
v
Polycom SharePoint TIM Integration Guide
vi
Polycom, Inc.
1 Before Installing the SharePoint TIM
This chapter describes the Polycom SharePoint Technical Integration Module (TIM). This chapter includes the following sections: •
About the Polycom SharePoint TIM
•
Prerequisites
•
Polycom VMC 1000 Administrative Portal Settings
About the Polycom SharePoint TIM The Polycom SharePoint Technology Integration Module (TIM) delivers a single point of personalized interaction, offering the management capabilities of the Polycom Video Media Center (VMC) 1000 within the Microsoft SharePoint Portal. The Polycom SharePoint TIM is installed using an MSI setup file that copies all the components needed to create and configure the Polycom SharePoint TIM Site. The configuration tool creates the Polycom SharePoint TIM site, deploys the solutions and activates the features in the site. The three main artifacts involved are the Polycom SharePoint TIM site, web parts and timer jobs. This document explains the installation process as well as details about each of these artifacts.
Prerequisites Security 1
The installation should be carried out on the SharePoint server machine using the SharePoint Administrator account. If the SharePoint Administrator account cannot be used then an Active Directory user account meeting the following criteria should be used: a
Polycom, Inc.
These Active Directory user accounts should be made: 1
Polycom VMC 2.0 SharePoint TIM Integration Guide
b
c
Prerequisites
»
Site Collection Administrator of the site under which the Polycom SharePoint TIM site will be installed.
»
Server Farm Administrator.
The Active Directory user account should be present in the db_owner role for the following databases: »
SharePoint_Config.
»
SharePoint_AdminContent.
»
Site Collection database.
The user account should be a local administrator on the SharePoint Server machine.
2
The Polycom VMC 1000 and the SharePoint installations should be part of the same Active Directory domain.
3
The user account (either SharePoint Administrator or the Active Directory user account, depending on which is used) needs to be part of the Super User role in the Polycom VMC 1000.
4
The user account (either SharePoint Administrator or the Active Directory user account, depending on which is used) should have read permissions to Active Directory. NOTE: The account is required for installation as well as for regular running of the portal. It has to be an account with sufficient privileges both in SharePoint and the Polycom VMC 1000 in order to enable it to retrieve all programs, channels, and categories from the Polycom VMC 1000 and update the corresponding lists in SharePoint along with the security mappings.
Important Notes for Server Farm Administrators 1
The installer needs to be run on the Server hosting the SharePoint Central Administration Server. Please make sure that the "Windows SharePoint Services" in the Services console including the "Windows SharePoint Services Administration" and "Windows SharePoint Services Timer" are started on all the SharePoint Servers in the farm.
2
Add the SharePoint Farm Administrator to the Super User role in the Polycom VMC 1000 Administrative Portal.
3
For Server farms with multiple front end servers: a
2
Use the Public URL (load balanced URL) for the Root URL while running the deployment tool. If you are using Alternate Access Mappings to map the URL to a user friendly public URL, then use this user friendly public URL.
Polycom, Inc.
Prerequisites
Before Installing the SharePoint TIM
b
While installing if you observe that the installation is not proceeding further for a long time, go to each front end server and run the following stsadm command in cmd prompt: stsadm -o execadmsvcjobs
NOTE: Please type in this command. Sometimes copying from elsewhere can introduce special characters.
c
The stsadm utility can be found under the following path in each SharePoint server: C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\BIN. If this path is not set in the machine, you might need to go to this directory in cmd before executing this command.
NOTE: You may have to run this command multiple times (up to 3 times because TIM installer deploys 3 SharePoint solutions) before the installation is complete. This command speeds up the execution of a SharePoint timer job.
4
The recommended approach is to deploy the TIM site under the root site collection. If you are deploying the Polycom SharePoint TIM site under a managed path instead of the root site collection, the administrator must set the master page for the newly created site post deployment. After deployment, go to the Site Collection > Site Settings > Master Page under Look and Feel.
For the Site Master Page section, select the Reset all subsites... checkbox and click OK.
Site Collection 1
Polycom, Inc.
A site collection (for example a collaboration portal site) should pre-exist before the artifacts are deployed.
3
Polycom VMC 2.0 SharePoint TIM Integration Guide
2
Prerequisites
When the Polycom SharePoint TIM site is newly created it will inherit permissions from the parent site. If user permissions need to be modified on the newly created site, administrators will have to perform this task manually.
Site Settings The Polycom VMC 1000 and SharePoint installations should have the same time zone settings. 1
The root site of the site collection should have the correct time zone set. The regional settings for this root site will be copied to the new site, created as part of the installation process. NOTE: To check the Regional Settings, browse to the top level site, click Site Actions > Site Settings > Modify All Site Settings > Regional Settings (present under Site Administration section).
2
The Central Administration site should also have the default time zone set to the correct value. To check the Default Time Zone value for the Central Administration site: a
Open the Central Administration site by clicking Start > All Programs > Microsoft Office Server > SharePoint 3.0 Central Administration.
b
Click the Application Management tab.
c
Under the SharePoint Web Application Management section, click on Web Application General Settings.
d
Make sure the Central Administration Web Application is selected in the drop-down.
e
Select the correct time zone value from the drop-down and click OK.
Browser Settings The users' browser settings should be configured to automatically pass the user's credentials to the SharePoint sites; otherwise they will be prompted for a login. In Internet Explorer, under the User Authentication section of the Security Settings for the Local Intranet zone, the Automatic logon only in Intranet zone should be selected. This will ensure that the user credentials of the logged on user are passed automatically to SharePoint and the user is not prompted for username and password.
4
Polycom, Inc.
Polycom VMC 1000 Administrative Portal Settings
Before Installing the SharePoint TIM
Polycom VMC 1000 Administrative Portal Settings For certain views/pages Polycom SharePoint TIM uses the Polycom VMC 1000 player in embedded form within SharePoint. For these pages to work without the user being asked to select the system time, the Viewer Portal must be configured to use system time. To set the Viewer Portal to use system time:
Polycom, Inc.
1
Open the Polycom VMC 1000 Administrative Portal. Navigate to System > Component Configuration.
2
Click the Edit button next to in the Viewer Portal area. The Edit Component Configuration screen will appear.
3
Check the Use System Time box under Viewer Portal.
4
Click Save.
5
Polycom VMC 2.0 SharePoint TIM Integration Guide
6
Polycom VMC 1000 Administrative Portal Settings
Polycom, Inc.
2 Installation and Deployment
This chapter explains the processes of installing and deploying the Polycom SharePoint TIM. This chapter includes the following sections: •
Installing the SharePoint TIM
•
Polycom SharePoint TIM Deployment
Installing the SharePoint TIM Prior to configuring the Polycom SharePoint TIM, the SharePoint TIM configuration tool must be installed.
Installer Setup 1
Polycom, Inc.
Run the setup.exe file. This will start the installation wizard, which will guide you through the installation process.
7
Polycom VMC 2.0 SharePoint TIM Integration Guide
8
Installing the SharePoint TIM
2
The Polycom SharePoint TIM Deployment application will be installed by default under C:\Program Files\Polycom TIM Installer. You can change this path. Click Next once the correct path is entered.
3
Click Next on the following screen. On the final screen, click Close.
4
A shortcut to the configuration wizard will appear on the desktop, as well as in the Programs area of the Start menu.
Polycom, Inc.
Polycom SharePoint TIM Deployment
Installation and Deployment
Polycom SharePoint TIM Deployment After the Polycom SharePoint TIM has been installed, you must launch the Polycom SharePoint TIM configuration wizard. 1
Open the Polycom SharePoint TIM configuration wizard either by clicking on Polycom TIM Deployment shortcut icon on the desktop or by navigating to Start > All Programs > Polycom TIM Deployment. The wizard will then launch.
2
3
Make sure the following parameters are set as per the environment. a
Root Site URL: Enter the name of the site collection where new site is to be created. This is a mandatory field.
b
Web Title - Enter title for the new site. This is a mandatory field.
c
Web URL - Displays the complete web URL of the new site as specified in the above text boxes.
d
Web Description - Enter description of the new site.
e
Check the All Components checkbox. Click the Deploy button.
Before proceeding further in the deployment, you will be prompted to set the configuration settings as per the environment. To reach this screen prior to deploying, click on the Configuration Settings link displayed on the top right corner of the Polycom SharePoint TIM Configuration Wizard.
Polycom, Inc.
9
Polycom VMC 2.0 SharePoint TIM Integration Guide
Polycom SharePoint TIM Deployment
4
The Configuration Settings window will appear.
5
Make sure the following parameters are set as per the environment: a
Polycom Host: Enter the name of the Polycom web server.
b
Polycom Domain: Enter the name of the Polycom Domain.
c
Polycom Login: Should contain user Id of the account used for connecting to the Polycom VMC 1000. For ex. if the user account is \Administrator, the value needs to be set to Administrator. Note this account needs to be part of the Super User role in the Polycom VMC 1000.
d
AD Domain: Enter name of the Active Directory domain where SharePoint and the Polycom VMC 1000 are installed.
e
Polycom Player Host: Enter the server name for the Polycom Player.
f
Synchronization Service Time Interval: The time interval used by synchronization service to execute periodically. Default value is set to 15 minutes.
g
Availability Service Start Time: Start time for the Availability Service to kick off daily. Default value is set to 12:15 AM.
h
The remaining values can be left as defaults.
Click OK. The deployment should proceed.
10
Polycom, Inc.
Polycom SharePoint TIM Deployment
Installation and Deployment
6
Please note that the deployment process takes few minutes. The running status is displayed at the bottom of the window. If you are installing in a server farm environment, please refer to “Important Notes for Server Farm Administrators” on page 2 for deployment information.
7
Once the parameters are set in the Configuration settings, you are ready to run Polycom SharePoint TIM Deployment setup. Click Deploy in the configuration wizard.
8
The Status field displays the following messages during installation:
9
a
Uploading template
b
Creating site
c
Setting Navigation property
d
Setting list property
e
Uploading data to Configuration List
f
Deploying Web Parts
g
Adding Solution Polycom.ViewerPortal.WebParts.wsp
h
Deploying Solution Polycom.ViewerPortal.WebParts.wsp
i
Activating Features for Solution Polycom.ViewerPortal.WebParts.wsp
j
Deploying Timer Jobs
k
Adding Solution Polycom.ViewerPortal.TimerJobs.wsp
l
Deploying Solution Polycom.ViewerPortal.TimerJobs.wsp
m
Activating Features for Solution Polycom.ViewerPortal.TimerJobs.wsp
n
Deployment Complete
After deployment is complete the synchronization service is activated according to the timer interval set. The Application event log displays the start and completion messages of the synchronization service. TIP: If the configuration wizard needs to be run in the context of a different user, browse to the folder C:\Program Files\Polycom TIM Installer\ (or the path you chose during installation) and execute the file PolycomInstallerSDK.exe. It will prompt you for the account credentials; once entered it will launch the Wizard in the new user's context. This may be necessary in cases in which logon to the SharePoint Server machine with a user account with necessary privileges is prohibited.
Polycom, Inc.
11
Polycom VMC 2.0 SharePoint TIM Integration Guide
12
Polycom SharePoint TIM Deployment
Polycom, Inc.
3 After Installing the SharePoint TIM
This chapter explains tools and customization available after changing . This chapter includes the following sections: •
Deploying Carousels in Sites in SharePoint
•
Branding the TIM Site
•
Changing the Look and Feel of the Carousel
•
Timer Solution
•
Data Synchronization
•
Program Availability Service Feature
•
Undeploy/Uninstall
Deploying Carousels in Sites in SharePoint Although the Polycom TIM site comes with various carousels and views installed out of the box, some customers might need the carousels to be deployed in sites other than the Polycom TIM site. To facilitate this, the Categories, Channels and Programs Carousels can be deployed to sites other than the Polycom SharePoint TIM site. To do so please follow the steps below: 1
Polycom, Inc.
Log in as Administrator.
13
Polycom VMC 2.0 SharePoint TIM Integration Guide
14
Deploying Carousels in Sites in SharePoint
2
Go to the top level site collection site settings
3
Under Galleries, click on Web Parts.
4
In the Web Part Gallery, click on New
5
Select the Web Part Polycom.ViewerPortal.WebPartsPhase2.CarouselWebPart. Also check the box Overwrite if file already exists? and click on Populate Gallery.
6
Go to the SharePoint Site where you want to deploy the Carousel. Click on Edit Page
Polycom, Inc.
Deploying Carousels in Sites in SharePoint
Polycom, Inc.
After Installing the SharePoint TIM
7
Click on Add a Web Part and select CarouselWebPart.
8
Click on Edit and select Modify Shared Web Part
9
Go to Polycom Settings and select the Carousel Name of the Carousel that you want to add from the Drop down and enter the URL of the Polycom SharePoint TIM site that was installed as a part of the TIM installation.
15
Polycom VMC 2.0 SharePoint TIM Integration Guide
Branding the TIM Site
10 Click OK. Exit Edit mode and refresh the page. If you see and error on the page, close the browser window and open a new browser window. You will see the newly added carousel.
Branding the TIM Site The Polycom SharePoint TIM can be altered to adhere to your corporate branding requirements. To brand the Polycom SharePoint TIM:
16
1
Go to Site Collection > Site Settings. Under Look and Feel, click Master Page.
2
For the Site Master Page section, select the desired master page. Check the box to apply master page to subsites (shown below) and click OK.
Polycom, Inc.
Changing the Look and Feel of the Carousel
3
After Installing the SharePoint TIM
The above steps will apply your corporate brand master page to the TIM site, provided you are using one for your top level site collection. If you plan to further customize the look and feel of the carousels, you can upload your own custom css and images to the "Custom CSS" library in the TIM site.
NOTE: Please keep the name of the css file the same as the existing one (StplCss.css). Back up this css file before overwriting.
4
To go to the "Custom CSS" library, go to the TIM Site Settings > Site Libraries and Lists.
5
Open Custom CSS.
Changing the Look and Feel of the Carousel The Polycom SharePoint TIM supports changing the look and feel of the default carousel.
Location The steps below explain the locations of the resources to be used in changing the look and feel of the carousel.
Polycom, Inc.
17
Polycom VMC 2.0 SharePoint TIM Integration Guide
1
Changing the Look and Feel of the Carousel
The CSS and images are stored in a Custom CSS document library on the TIM site. Open the TIM site. Click on Site Actions > View All Site Content > Custom CSS.
2
Locate the StplCss file. NOTE: Please keep the name of the CSS file the same as the existing one (StplCss.css). Take a backup of this CSS file before overwriting if you need to replace it.
18
3
The images are stored in Images folder in this document library; some images, however, are stored in the Images1 picture library.
4
Either change the image name in CSS class or upload new image with same name.
5
Check in the files once changes are done.
6
For images, maintain the earlier size.
Polycom, Inc.
Changing the Look and Feel of the Carousel
After Installing the SharePoint TIM
Changing the Carousel Style The screenshot below shows the carousel after changing the look and feel. The changes can be done in CSS or by updating the image.
To change the carousel style: 1
Go to the Polycom Enterprise Video site.
2
Go to Custom CSS document library (…//Custom%20CSS/Forms/AllItems.aspx). Open stpCSS.CSS file SharePoint designer and check out the file Find the featureBox CSS class which is applied to the Carousel: a
Background Image: Find .featuredBox .featuredContent CSS class and change the background image: VideoBg.jpg. This image resides in Custom Css > Images > VideoBg.jpg.
NOTE: Maintain the same resolution of current Image.
b
Program Box: Find the .featuredBox .featuredContent .featuredDisplayDiv ul li CSS class and change the styles. LiBg.jpg image is used as a background image, which is in Custom CSS > Images folder.
c
Program Title: Find the following CSS class and change the font style: featuredBox .featuredContent .featuredDisplayDiv div.summaryBlock .featuredHeadline
d
Polycom, Inc.
Program Description: Find the .featuredBox .featuredContent .featuredDisplayDiv UL LI CSS class and change the styles.
19
Polycom VMC 2.0 SharePoint TIM Integration Guide
e
Timer Solution
Previous Image: Go to the Image1 Picture library and find the Go_Left.gif image. Change the image or edit and modify the image style.
NOTE: Maintain the same resolution of current Image.
f
Next Image: Go to the Image1 Picture library and find the Go_Left.gif image. Change the image or edit and modify the image style.
NOTE: Maintain the same resolution of current Image.
Timer Solution Timer solution is a SharePoint solution that creates two timer jobs: Polycom SharePoint TIM Program Availability Service and Polycom SharePoint TIM Synchronization Service. This solution is globally deployed on all servers in the Farm. In Central Administration Site > Operations > Solution Management, a solution named "Polycom.viewerportal.timerjobs" solution is displayed. Solution properties are shown by clicking on the solution name.
Data Synchronization Synchronization Service feature is activated at the Polycom SharePoint TIM site. This feature executes a timer job periodically. During every execution it calls the Polycom web service API to synchronize the data from Polycom into SharePoint. Whenever this service runs, it logs the last execution time in the Polycom Configuration list on the Polycom SharePoint TIM site. Next execution checks this timestamp and gets only those changes from Polycom that have taken place after this timestamp. These changes are updated in the SharePoint site. Execution interval can be changed by updating the Sync Service Timer Interval value in Polycom Configuration list. The default interval is 15 minutes. IMPORTANT: For the new value to be reflected in the timer job definition, the corresponding feature needs to be deactivated first and then reactivated
20
Polycom, Inc.
Data Synchronization
After Installing the SharePoint TIM
Job Definition Once the timer solution is deployed, it adds, "Polycom Synchronization Service" Timer Job definition entry in the Timer jobs list. This is available in Central Administration Site->Operations->Timer Job Definitions. Please note that Timer job definition for Sync Service will not be shown if the corresponding feature is not activated.
Job Status When the Synchronization Service Timer Job is executed at least once, it will be displayed in Timer Job status. The status column shows whether it ran successfully or failed. The last run time of the job is also displayed.
Solution Features All features in the Web part solution are web parts and are activated on the site collection level. Each web part corresponds to one feature. Site collection features of the root site of the Polycom site show these features. There are fourteen web parts in the web part solution:
Polycom, Inc.
a
Archive Program Links web part
b
Browser Capabilities web part
c
Category Carousel web part
d
Channel Carousel web part
e
Downloadable Media Links web part
f
Favorite Programs web part
g
Featured Programs web part
h
Parent Program Link web part
i
Private Program Links web part
j
Program Actions web part
k
Program Details web part
l
Program Links web part
21
Polycom VMC 2.0 SharePoint TIM Integration Guide
m
Program Availability Service Feature
Upcoming Live Events web part
Program Availability Service Feature Updating Program Status Program Availability Service feature is activated at Polycom SharePoint TIM site. This feature executes a timer job daily. During every execution it checks for the program availability and expiration dates. The programs that have available date greater than current date and programs that have expiration date less than or equal to current date are hidden from all users by setting item level security on the list item. These programs are not accessible to the users either through browse or search and are available only to the service account. The start time for the execution can be changed by updating the Availability Service Start Time item value in Polycom Configuration list. The default start time is 12:15:00 AM.
Job Definition Once the timer solution is deployed it adds "Polycom Program Availability Service" Timer Job definition entry in the Timer jobs. This is available in Central Administration Site > Operations > Timer Job Definition. Timer job definition will not be shown if the corresponding feature is not activated.
22
Polycom, Inc.
Undeploy/Uninstall
After Installing the SharePoint TIM
Job Status When Program Availability Service Timer Job is executed at least once, it will be displayed in Timer Job status. The status column shows whether it ran successfully or failed. The last run time of the job is also displayed.
Undeploy/Uninstall Undeploy the Polycom SharePoint TIM before uninstalling the setup.
Polycom SharePoint TIM Undeployment Open the Polycom SharePoint TIM Configuration wizard by clicking on the shortcut on the desktop or from Start> All Programs > Polycom TIM Deployment. Check the All components checkbox and click the Undeploy button.
Add or Remove Programs Open the Add or Remove Programs window from Control Panel, select the Polycom SharePoint TIM application and click on the Remove button to uninstall.
Updating Existing TIM with New Package If you have a SharePoint TIM site running and want to update it with a new hotfix, there are two ways for this:
Retain the Existing SharePoint TIM site If you have a SharePoint TIM site running with data on it and do not want to create a new site then you just have to deploy the WSPs. Follow the steps below:
Polycom, Inc.
1
Open the existing Qumu SharePoint TIM Installer and enter the appropriate values for root site url and web url. Site URL will contain the value of URL of the parent site of Qumu TIM site. Web URL should be the exact URL of the Qumu TIM site.
2
Uncheck the check box for all components, check the checkbox for Web Parts and click on Undeploy.
3
Now check the checkbox for Timer Jobs and click on Undeploy.
4
Check the status as the undeployment goes. If it fails at some point, refer the trouble shooting section if there are errors in Undeployment.
23
Polycom VMC 2.0 SharePoint TIM Integration Guide
Undeploy/Uninstall
5
Now Open Add/Remove programs and remove 'Qumu SharePoint TIM Installer' version.
6
Open the new package folder and double click on Setup.exe. This will install the new Qumu TIM Installer. Make sure the version is other than the earlier installed version.
7
Now open this new installer to deploy new WSPs.
8
Enter the appropriate values for root site url and web url. Site URL will contain the value of URL of the parent site of the Qumu SharePoint TIM site. Web URL should be the exact URL of the Qumu SharePoint TIM site.
9
Uncheck the check box for all components, check the checkbox for Web Parts and click on Deploy.
10 Now check the checkbox for Timer Jobs and click on Deploy. 11 Once the installation is completed, restart Internet Information Services Manager (IIS). Click Start…Programs…Administrative Tools…IIS. Click Restart. If you have multiple Web Fronts End Servers, restart IIS on all servers. 12 Also restart the Windows SharePoint Services timer (WSS Timer). Click on Start programs…Services…Windows SharePoint Services timer. Restart this service. Again, if you have multiple Web Fronts End Servers, restart WSS Timer on all servers. 13 If the new installer needs changes in the existing TIM site then refer the document named 'Qumu SharePoint TIM - Changes in existing TIM Site'. If this document is not present in the build folder that means there are no changes in the existing TIM site. 14 Open the newly created site and open the configuration list. Make sure the Synchronization service timestamp value is blank.
Remove All Components Including the TIM Site If you want to recreate a totally new TIM site then follow the steps below:
24
1
Browse to the existing TIM site. Check if this site has any subsites. Click on Site Settings…Sites and Workspaces.
2
If there are any sites listed here. Delete those sites by clicking on the child site…Site Settings…Delete this site.
3
Make sure all child sites in the TIM site are deleted.
4
Open the Qumu SharePoint TIM Configuration Wizard and enter the appropriate values for root site url and web url.
5
Select the check box for all components and click on Undeploy.
6
Check the status as the undeployment goes. If it fails at some point, refer the trouble shooting section if there are errors in Undeployment.
Polycom, Inc.
Undeploy/Uninstall
After Installing the SharePoint TIM
7
Now open Add/Remove programs and remove 'Qumu SharePoint TIM Installer' version.
8
Open the new package folder and double click on Setup.exe. This will install the new Qumu TIM Installer. Make sure the version is another than the earlier installed version.
9
Now use this installer to install Qumu TIM site. Refer to the installer section in this document.
10 Once the installation is completed, restart Internet Information Services Manager (IIS). Click Start…Programs…Administrative Tools…IIS. Click Restart. If you have multiple Web Fronts End Servers, restart IIS on all servers. 11 Also restart the Windows SharePoint Services timer (WSS Timer). Click on Start programs…Services…Windows SharePoint Services timer. Restart this service. Again, if you have multiple Web Fronts End Servers, restart WSS Timer on all servers. 12 Open the newly created site and open the configuration list. Make sure the Synchronization service timestamp value is blank.
Polycom, Inc.
25
Polycom VMC 2.0 SharePoint TIM Integration Guide
26
Undeploy/Uninstall
Polycom, Inc.
4 SharePoint TIM Architecture
This chapter explains the default configuration of the Polycom SharePoint TIM. This chapter includes the following sections: •
Site Pages
•
Site Lists
•
Images
•
SharePoint TIM Content
•
SharePoint TIM Home Page
•
Browse Programs Page
•
Category Details Page
•
Channel Details Page
•
More Programs Page
•
Support for Multiple Program Links and Formats
•
Sorting and Filtering in Channel Details and More Programs Page
•
Complex Presentations
•
Live Events
•
Automated Broadcasts
•
Program Details Page
•
Live Calendar Page
•
Private Programs Page
•
Browser Settings Page
Site Pages Once the setup is complete the Polycom SharePoint TIM Site is created at the URL specified during deployment. Open the site in a browser.
Polycom, Inc.
27
Polycom VMC 2.0 SharePoint TIM Integration Guide
Site Lists
This site contains the following pages: •
Home page- Default.aspx
•
Live Calendar
•
Private Programs
•
Browser Settings
•
Browse Programs
•
Category Details
•
Channel Details
•
Program Details
Site Lists The Polycom SharePoint TIM Site contains the following lists:
28
•
Polycom Categories List - stores Categories (searchable)
•
Polycom Channels List - stores Channels (searchable)
•
Polycom Programs List - stores Programs (searchable)
•
Polycom Domain Options List - stores Domain Options
•
Polycom Favorite Programs List - stores Favorites for all users
•
Polycom Private Programs Codes List - stores the access codes for all the private programs
•
Polycom Program Content List - stores the program content such as links to downloadable media or live program links Polycom, Inc.
Site Lists
SharePoint TIM Architecture
•
Polycom Program Security Mappings List - stores the security mappings for programs that are not accessible to all users
•
Polycom Configuration List - contains configuration items. If any of these field need to be changed post installation, after editing the corresponding field follow the steps below: a
Deactivate and Reactivate the Polycom Synchronization Service, found under Site Features in the installed TIM site.
b
Restart Timer Services found in the Services console. If SharePoint is installed in a farm configuration, then you will need to restart Timer Service in each front end server in the server farm.
The Polycom Configuration List includes: — Sync Timestamp - This value is used by Synchronization Service to log the last successful run time. The value is blank by default. — Max Folder Items - This lists Polycom Programs, Polycom Channels, Polycom Program Content, Polycom Program Security Mappings, Polycom Favorite Programs, and Polycom Private Program codes contains items stored inside subfolders. This value decides how many items to store in one folder. Generally items ranging from 1000 to 2000 per folder give good performance. — Availability Service Timestamp - This timestamp stores the last successful run time for the Availability service. — Polycom Host - Name of the Polycom web server. This is needed for the synchronization Service to retrieve data from Polycom. — Polycom Domain - Name of the Polycom Domain. This is needed for the synchronization Service to retrieve data from the Polycom VMC 1000. — Polycom Login - User Id of the account used to connect to the Polycom VMC 1000. This is needed for the synchronization Service to retrieve data from the Polycom VMC 1000. — AD Domain - Active Directory Domain Name. This is needed for the synchronization Service to map user IDs present in security mappings to login names. — Sync Service Time Interval - The time interval used by synchronization service to execute periodically. — Availability Service Start Time (Obsolete)- Daily Start time for the Availability Service execution — Add GMT offset - Needed for DateTime fields where the value for these fields needs to account for GMT offset. Keep this value false by default unless otherwise instructed. — Player URL - Template for the player URL. — Polycom Player Host - Name of the Polycom application server. This is needed for launching the player from SharePoint. Polycom, Inc.
29
Polycom VMC 2.0 SharePoint TIM Integration Guide
Images
— Cache Delay - Default value of 5 minutes. This delay is needed for the Synchronization service to make sure updates from the Polycom web service are not missed because of the caching mechanism in the Polycom Web Service. Usually the Polycom web service maintains a cache of a few minutes. Because of this caching mechanism, without the cache delay, the Synch service might not get category/channel/program updates from the Polycom web service if the Synch service run time is very close to the time update happens in the Polycom Admin portal. Cache Delay of 5 minutes or more will ensure that most recent updates are available to the synch service whenever it runs. — NoOfRecordsToBeUpdateForViewCount- Default value 15. This value indicates the number of programs for whom the view count needs to be fetched. This is ordered by the most number of view counts. So a value of 15 will fetch the view counts for the 15 most viewed programs. — Event Logging- Default values is true. By default TIM logs are created in the Event Viewer of the Front end server. This value can be set to false if logging to the event viewer needs to be disabled. — Exclude Servers - Comma separated list of Front end server names in the SharePoint farm that need to be excluded from Synch Service execution. In case of a multiple front end server farm, we need to make sure that the Synch service runs only on one server in the farm. So if there are 3 front end servers (S1, S2, S3) in the SharePoint farm and we decide that the timer service will run only on S1 then the "Exclude Servers" should have a value of S2, S3.
Images The Polycom VMC 1000 Viewer Site contains an image library named Images1. From the Quick Launch click on View All Site Contents, and under Picture Libraries click on Images1 to view all the images stored in this library. 1
30
Administrators can change the images displayed in the web parts by uploading new images with the same name (and extension) to this library.
Polycom, Inc.
Images
SharePoint TIM Architecture
2
Images1 library contains the following images (Page/Web Part containing the image is listed on the right): Image
Page/Web Part
AppleQuickTime.gif
Browser Settings page
LivProgram.jpg
Used to represent a Live Program in Channel Details Page and Program Details Page
Presentations.jpg
Used to represent a Complex Presentation in Channel Details Page and Program Details Page
AutomatedBroadcast.jpg
Used to represent an Automated Broadcast in Channel Details Page and Program Details Page
Go_Right.gif
Used to represent the "Right Arrow" in a Carousel
Go_Left.gif
Used to represent the "Left Arrow" in a Carousel
default_event.jpg
Used if image is missing for Channels or Programs
Cancel.gif
Private Programs page
FeaturedChannel.gif
Category Details page - Browse Channels web part
FlashPlayerProgramContent Icon.gif
Program Details page - Program Links web part
InternetExplorer.gif
Browser Settings page
LiveProgramIcon.gif
Channel Details Page - Browse Programs web part Program Details Page
MozillaFireFox.gif
Browser Settings page
MpegPlayerProgramConten tIcon.gif
Program Details page - Program Links web part
NullImageIcon.gif
Program Filter web part
OK.gif
Private Programs page
PrivateProgramIcon.gif
Channel Details Page - Browse Programs web part Program Details Page
Polycom, Inc.
QuickTimePlayerProgramC ontentIcon.gif
Program Details page - Program Links web part
RealPlayer.gif
Browser Settings page
RealPlayerProgramContentI con.gif
Program Details page - Program Links web part
31
Polycom VMC 2.0 SharePoint TIM Integration Guide
Images
Image
Page/Web Part
VODProgramIcon.gif
Channel Details Page - Browse Programs web part Program Details Page
3
WindowsPlayerProgramCon tentIcon.gif
Program Details page - Program Links web part
Download.gif
Program Details page - Downloadable Media Links web part
As an example, if you want to change the LiveProgramIcon image: a
Create an image file with name LiveProgramIcon.gif.
b
Open the Images1 library.
c
Click Upload > Upload Picture. Make sure Overwrite existing files option is checked.
d
The Add Picture screen will open. Click on Browse, select your new image file, and press OK. This will add the image in the image library.
Web Parts The Polycom TIM site contains web parts to present data to the user. Listed below are web parts corresponding to the pages they belong to: 1
2
3
4 32
Home page contains: a
Upcoming Live Events List View
b
Featured Programs Carousel
c
Favorite Programs Carousel
Category Details page contains: a
Category Information
b
Channel Thumbnails
Channel Details page contains: a
Channel Information
b
Program Thumbnails
Program Details page contains: Polycom, Inc.
SharePoint TIM Content
SharePoint TIM Architecture
5
a
Program Information
b
Parent Program
c
Archived Programs
d
Program Actions
e
Program Links
f
Downloadable Media Links
Calendar page contains: a
6
Private Programs page contains: a
7
Private Programs
Browser Settings page contains: a
8
Live Events Calendar View
Browser Capabilities
Browse Programs page contains: a
Categories Carousel
b
Channels Carousel
c
Programs Carousel
SharePoint TIM Content The Polycom SharePoint TIM is typically deployed as a site within the organization's internal SharePoint Portal deployment. Users may access this site either by keying in the URL for this site into their browser directly or by using the navigation provided within the organization's SharePoint Portal implementation. Note that the user must have the necessary permissions to be able to access this site. Additionally, each user will be able to view only those programs that they have been given access to. The site contains the following pages:
Polycom, Inc.
1
Polycom SharePoint TIM Home page
2
Browse Programs Page
3
Category Details Page
4
Channel Details Page
5
More Programs Page
6
More Channels Page
7
Program Details Page
33
Polycom VMC 2.0 SharePoint TIM Integration Guide
8
Live Calendar Page
9
Private Programs Page
SharePoint TIM Home Page
10 Browser Settings Page
SharePoint TIM Home Page Polycom SharePoint TIM Home page is the landing page for the Polycom SharePoint TIM Viewer Portal. The home page displays the following carousels and navigation links.
34
Polycom, Inc.
SharePoint TIM Home Page
SharePoint TIM Architecture
Number of thumbnails available in a carousel can be modified by setting the "Number of Items Per Page" property in each of the Carousels. For example in the screenshot below this property has been set to 15. This will enable the user to navigate 15 thumbnails within the carousel.
To configure the above properties you will need to login with the required permissions. Click on Edit page, and then click on Modify Web Part Properties. For detailed instructions refer steps 8 and 9 under section 3.
Featured Programs Carousel
This web part gives a carousel view of Programs that are selected as Featured Items in the Polycom VMC 1000 Administrative Portal. The left and right arrows allow a user to navigate to other programs in the carousel. Clicking on a thumbnail takes the user to the Program Details Page for the corresponding Program. This Carousel will display only those Programs that the user has access to.
Polycom, Inc.
35
Polycom VMC 2.0 SharePoint TIM Integration Guide
SharePoint TIM Home Page
Most Popular Programs Carousel
This web part gives a carousel view of Programs that have been most viewed by users of the system. The view count is based on the view count recorded and maintained by the Polycom VMC 1000 every time a user plays a program. The left and right arrows allow a user to navigate to other programs in the carousel. The maximum number of programs available in the Carousel is configurable using the web part properties. Clicking on a thumbnail takes the user to the Program Details Page for the corresponding Program. This Carousel will display only those Programs that the user has access to.
Most Recent Programs Carousel
This web part gives a carousel view of Programs that were recently added to the system. This sorting is based on the most recent "Available Date" of the Programs in the Polycom VMC 1000. The left and right arrows allow a user to navigate to other programs in the carousel. The maximum number of programs available in the Carousel is configurable using the web part properties. Clicking on a thumbnail takes the user to the Program Details Page for the corresponding Program. This Carousel will display only those Programs that the user has access to.
36
Polycom, Inc.
SharePoint TIM Home Page
SharePoint TIM Architecture
Favorite Programs Carousel
A user may designate certain programs to be his or her favorites. This functionality is provided to the user in the Program Details Page (described in the Program Details Page section) and Channel Details Page. The Favorite Programs list provides a convenient way for users to access Programs marked as their favorite. Below this carousel there is a More Favorites Link that takes the user to a Favorite Page. Here the user can view/delete his or her Favorite Programs in a Page view.
Upcoming Live Events
Upcoming Live Events are live events that are scheduled for the upcoming week. The user has the ability to scroll back and forth to view a different range of events. The user may additionally click on any of the programs listed in this web part to view its details. This Carousel will only display only those Programs that the user has access to.
Navigation Links Navigation links to content in the Polycom SharePoint TIM are available in the Quick Launch bar. The Quick Launch bar is available to the user from all pages in Polycom SharePoint TIM site.
•
Polycom, Inc.
Home: This link takes the user back to the Polycom SharePoint TIM Home Page
37
Polycom VMC 2.0 SharePoint TIM Integration Guide
Browse Programs Page
•
Live Calendar: This link takes the user to a Calendar View of Live Programs (see the Calendar Page section for additional information)
•
Private Programs: This link takes the user to the Private Programs Page where the user may provide the access code to view private programs (see the Private Program Page section for additional information).
•
Browser Settings: This link takes the user to the Browser Settings Page where the user may view the current capabilities of the user's browser and the components required to get a rich user experience when viewing Polycom SharePoint TIM content (see Browser Settings Page for additional information).
•
Browse Programs: This link takes the user to the Browse Programs page where the user may browse programs based on Categories and Channels, view details and launch Polycom SharePoint TIM content (see Browse Programs Page for additional information).
Browse Programs Page Polycom SharePoint TIM Programs may be organized hierarchically under Categories and Channels. An organization may choose not to have Categories and/or Channels in this hierarchy. This page has three different carousels dedicated to Categories, Channels and Programs. Depending on the carousel, clicking on a thumbnail will take the user to the Category Details, Channel Details or the Program Details page (descriptions for each of these pages is detailed in later sections in this document).
38
Polycom, Inc.
Browse Programs Page
SharePoint TIM Architecture
Note that these carousels are filtered to display only the content that is accessible by the user.
Polycom, Inc.
39
Polycom VMC 2.0 SharePoint TIM Integration Guide
Category Details Page
Category Details Page
The Category Details Page displays information about a specific category and displays a list of Channels associated with that Category. A user may get to the Category Details Page by clicking on a Category thumbnail in the Category Carousel. Category links may also be displayed in Search results (see the Search section for additional details). The Category Details page displays the following information: •
Category description
•
A List of the Channels within this Category that the user has access to. The following summary information is displayed for each Channel that is listed. — Channel Image — Channel Name — Channel Description Clicking on a specific Channel thumbnail will take the user to the Channel Details Page (see the Channel Details Page section for additional information). — Alphabetical Filter for Channels. Clicking on an alphabet will display only the channels that begin with that alphabet.
40
Polycom, Inc.
Channel Details Page
SharePoint TIM Architecture
Channel Details Page
The Channel Details Page displays information about a specific channel and displays thumbnails of Programs associated with that Channel. A user may get to the Channel Details Page by clicking on a thumbnail in the Channels Carousel. Channel links are displayed in several pages within the Polycom SharePoint TIM (Category Details Page, Featured Channels Web Part on the Home Page etc.). Channel links may also be displayed in Search results (see the Search section for additional details). The Channel Details page displays the following information: •
Channel description
•
Thumbnails of the Programs that are associated with the Channel (note that the list is trimmed to display only those Programs that the user has access to). The following summary information is displayed for each Program that is listed. — Program Name — Program Description — Live/VOD/Private Program/ Automated Broadcast Indicator — Duration Clicking on a specific Program thumbnail will update the Current Program details in the same page. The following summary information is displayed for each Program that is clicked
Polycom, Inc.
41
Polycom VMC 2.0 SharePoint TIM Integration Guide
Channel Details Page
— Embedded video Links that can be selected and played in an embedded player — Program Name — Program Description — Downloadable Medial Links — Program Action Links
42
Polycom, Inc.
More Programs Page
SharePoint TIM Architecture
More Programs Page The More Programs Page is very similar to the Channel Details Page except the fact that it displays a list of all Programs regardless of their affiliations to any Channel or Categories. It can be accessed via the "More Programs" link in the Browse Programs Page. This page has been provided if the users of the system do not want to drill down using Categories and Channels.
Polycom, Inc.
43
Polycom VMC 2.0 SharePoint TIM Integration Guide
Support for Multiple Program Links and Formats
Support for Multiple Program Links and Formats
The Polycom SharePoint TIM supports multiple links per program. It also supports multiple video/file formats per program. A user will be required to click on the corresponding link in a program to view the associated video. The embedded player will change accordingly. For example if a user clicks on a Flash video, the video will play in an embedded JW Flash player. If a user clicks on a video supported by windows media player, the video will play in an embedded Windows Media player.
Sorting and Filtering in Channel Details and More Programs Page The Polycom SharePoint TIM allows users to sort and filter programs to enable quicker and more efficient program retrieval.
44
Polycom, Inc.
Sorting and Filtering in Channel Details and More Programs Page
SharePoint TIM Architecture
The user can sort the Programs by selecting the Sort By parameter and then the Sort Order of Ascending or Descending.
Programs can be filtered in two ways: •
Polycom, Inc.
Filter by Program Type
45
Polycom VMC 2.0 SharePoint TIM Integration Guide
•
Sorting and Filtering in Channel Details and More Programs Page
Filter by Alphabet Users can click on a letter to retrieve the programs with Titles that begin with the selected letter.
The user can also use the sorting and filtering capabilities described above in conjunction with each other, thus making the program retrieval capability more powerful.
46
Polycom, Inc.
Complex Presentations
SharePoint TIM Architecture
Complex Presentations
Complex Presentations are On-Demand programs that include additional elements such as HTML files, images along with videos as part of an overall presentation. As a result a Complex Presentation is best played in a new window within the Polycom VMC 1000 Player. To facilitate this, whenever a user clicks on a link for a complex presentation, Polycom SharePoint TIM will inform the user that the link represents a complex presentation and provide a link to view the complex presentation in the Polycom VMC 1000 Player.
Polycom, Inc.
47
Polycom VMC 2.0 SharePoint TIM Integration Guide
Live Events
Live Events Live Events are best played in a new window within the Polycom VMC 1000 Player. To facilitate this, whenever a user clicks on a link for a Live Event, Polycom SharePoint TIM will inform the user that the Program is a Live Event and provide all available streams to view the Live event in the Polycom VMC 1000 Player.
48
Polycom, Inc.
Automated Broadcasts
SharePoint TIM Architecture
Automated Broadcasts
Automated Broadcasts are similar to Live Events except that the source of the stream is a video file that is played at a scheduled time. As a result, Automated Broadcasts are best played in a new window within the Polycom VMC 1000 Player. To facilitate this, whenever a user clicks on a link for an Automated Broadcast, the Polycom SharePoint TIM will inform the user that the Program is an Automated Broadcast and provide all available streams to view the Automated Broadcast event in the Polycom VMC 1000 Player.
Program Details Page The Program Details Page displays information about a specific Program and allows users to perform actions on that Program. A user may get to the Program Details Page by clicking on a link to a Program in the Featured Programs Carousel, Most Popular Programs Carousel, Favorite Programs Carousel, Upcoming Live Events and Private Programs Page etc. Also Program links are displayed in Channel Details page (Open
Polycom, Inc.
49
Polycom VMC 2.0 SharePoint TIM Integration Guide
Program Details Page
Program in a New Window) if a user wishes to open the Program Details page from the Channel Details Page. Program links may also be displayed in Search results (see the Search section for additional details). The information displayed for a Program varies on the type of program being accessed. Additionally, the actions available to a user are also dependent on the Domain Options settings of the Polycom SharePoint TIM deployment. The Program Details Page contains the following information
Program Information The key attributes of the Program are listed in this section. Some of the fields are listed below: •
Category the Program belongs to
•
Channel the Program belongs to
•
Program Name
•
Program Description
•
Available Date
•
Expiration Date
•
Duration
Program Links This section displays the links available to view the Program. Each link displays an image indicating the program that will be used to display the content along with a description of the type of content. Note that there may be several links associated with a single Program. Clicking on the link will launch the Polycom SharePoint TIM Player Page to display the Programming. The contents of the Player Page are dependent on the type of the Program being viewed (Live/VOD) and the artifacts associated with the Program.
Downloadable Media Links This section displays a list of downloadable files associated with a Program. The list provides an image that indicates the type of file and a description of the file. Clicking on the link provides the user with the option to download the file or open the file using the application associated with the media.
Program Action Links This section provides the user with links to perform utility tasks against the Program. Note that some of the links may be disabled based on the Domain Options configured for the Polycom SharePoint TIM. 50
Polycom, Inc.
Live Calendar Page
SharePoint TIM Architecture
The following links are displayed to the user: •
Add to Favorites: This allows the user to add the Program to his list of favorites. The Favorite Programs list is displayed on the Polycom SharePoint TIMHome page in the Favorite Programs list (see the Polycom SharePoint TIM Home Page section for details).
•
Add Alert: This link allows users to monitor changes to the Program by receiving alerts when the Program changes. Clicking on the link takes the user to the SharePoint Alerts management interface where users may configure how they would like to receive alerts. Note that this functionality relies on the native SharePoint Alert management capabilities and hence is dependent upon the users profile information with SharePoint.
•
Save as iCalendar: This link allows the user to download the Program as an iCalendar file. This link is enabled only for Live programs
Navigation Links See “Navigation Links” on page 37.
Live Calendar Page The Calendar View Page is opened when the user clicks on the Calendar View link in the Quick launch bar. A Calendar view displays the Polycom SharePoint TIM "Live Programs" in a Calendar. Users have the ability to synchronize this calendar with Outlook and optionally export a Program as an iCalendar file. Note that the users will only see those Programs that they have access to. The default view for the Calendar is the "Month" view. This view displays the current month with Program names displayed on the corresponding dates. The user has the ability to scroll through the list of months to view future and past Programs. Additionally, users have the ability to switch to a "Day" or a "Week" view. The "Day" view displays a list of list of Live Programs for a specific day while the "Week" view allows the users to view the list of Live Programs by week. Note that the Quick Launch bar displays additional context sensitive links pertinent to the "Month", "Week" or "Day" view. The "Action" button available in the bar on top of the calendar provides the user the ability to connect and synchronize the calendar with Outlook.
Polycom, Inc.
51
Polycom VMC 2.0 SharePoint TIM Integration Guide
Private Programs Page
Private Programs Page A Private Program is a Polycom SharePoint TIM Program that requires the user to provide an Access Code before the user can view its contents. The Private Program Page allows the user to specify this access code. Users are brought to the Private Program Page if they click on the "Private Programs" navigation link or if they click on a Program that has been defined as a Private Program in Polycom SharePoint TIM. Note that Private Programs are listed with a "lock" image. The Private Program Page displays a text box that requires the users to enter an Access Code. If a valid Access Code is supplied, the user is redirected to the Program Details Page for that Program. If multiple Programs are associated with that Access Code then the user is shown the list of Programs associated with that Access Code. The user needs to pick a Program from this list to view its details. Note that Access Code entered by the user is valid for the duration of the user's session i.e. once a valid Access Code has been entered for a Program, the user will not be prompted for an "Access Code" for that Program for the duration of the users session.
Browser Settings Page To enjoy the full streaming experience of Polycom SharePoint TIM content, users may need to install additional software. The Browser Settings Page displays the links for downloading these applications. This page also displays information about the browser the user is using to view the Portal and the current settings that are relevant to the Polycom SharePoint TIM experience.
52
Polycom, Inc.
Browser Settings Page
SharePoint TIM Architecture
The Browser Settings Page is accessed from the Navigation Links in the Quick Launch Bar.
Polycom, Inc.
53
Polycom VMC 2.0 SharePoint TIM Integration Guide
54
Browser Settings Page
Polycom, Inc.
5 Troubleshooting
This chapter outlines common troubleshooting procedures during installation and deployment of the Polycom SharePoint TIM. This chapter includes the following sections: •
Errors in Deployment
•
Errors in Undeployment
•
Other Troubleshooting
•
Test Web Services Using Tool
Errors in Deployment For all error messages during deployment, check the Event Viewer log. Errors are logged under the Application log. Important: Only one Polycom SharePoint TIM site installation on a SharePoint server is supported for this release. If you try to install another site you may face errors during installation.
Uploading Template Failed Make sure the file Polycom Viewer Site.stp is present in the deployment folder C:\Program Files\Polycom TIM Installer\SetupFiles. Note: If you chose a different path during installation use that path instead. Make sure all the pre-requisites mentioned in section 2 are in place.
Site Creation Failed Site with the specified URL may already exist. Give a different URL in the configuration wizard. If the error is related to template upload error make sure all pre-requisites are in place.
Polycom, Inc.
55
Polycom VMC 2.0 SharePoint TIM Integration Guide
Errors in Deployment
Timer job deployment failed 1
Check if MediaPublisher.ViewerPortal.TimerJobs.wsp file is present in the deployment folder C:\Program Files\Polycom TIM Installer\SetupFiles.
2
Check if the timer job solution already exists in the Central Administration site. a
Deactivate the following features: Polycom TIM Synchronization service and Polycom TIM Program Availability service, from the Polycom SharePoint TIM site (Site Actions > Site Settings > Site Features > Deactivate).
3
Retract and delete the solution: Polycom.ViewerPortal.TimerJobs.wsp solution through Central Administration site.
4
If the solution cannot be removed through the web user interface, open command prompt and: a
Retract the solution: stsadm -o retractSolution MediaPublisher.ViewerPortal.TimerJobs.wsp -immediate
b
Delete the solution from the solution store: stsadm -o deleteSolution MediaPublisher.ViewerPortal.TimerJobs.wsp
c
If the above command does not work, forcibly delete the solution using the following command: stsadm -o deleteSolution MediaPublisher.ViewerPortal.TimerJobs.wsp -override
5
Redeploy only the Timer jobs using the Configuration Wizard.
6
If it continues to fail repeat above steps (1 through 5) and perform the following steps from the command prompt: a
Change directory to C:\Program Files\Polycom TIM Installer\SetupFiles.
b
Add the timer job solution: stsadm -o addsolution -filename MediaPublisher.ViewerPortal.Timerjobs.wsp
c
Deploy the timer job solution: stsadm -o deploysolution -name MediaPublisher.ViewerPortal.Timerjobs.wsp -local -allowgacdeployment
56
Polycom, Inc.
Errors in Deployment
Troubleshooting
d
Activate the following features on the Polycom Viewer Site: Polycom TIM Synchronization service and Polycom TIM Program Availability service (Site Actions > Site Settings > Site Features > Activate).
NOTE: This assumes all prerequisites are in place.
Web part deployment failed 1
Check if MediaPublisher.ViewerPortal.WebParts.wsp and MediaPublisher.ViewerPortal.WebPartPhase2.wsp file is present in deployment folder C:\Program Files\Polycom SharePoint TIM Installer\SetupFiles.
2
Check if web part solution Polycom.ViewerPortal.WebPartPhase2.wsp already exists in the Central Administration site.
3
Deactivate the Web Parts (listed in section 5.4) on the site collection using the SharePoint interface (Site Actions > Site Settings > Modify All Site Settings > Site Collection Features > Deactivate).
4
Retract and delete the solution: MediaPublisher.ViewerPortal.WebPartPhase2.wsp through Central Administration site.
5
If the solution cannot be removed through the web user interface open command prompt and: a
Retract the solution: stsadm -o retractSolution MediaPublisher.ViewerPortal.WebPartPhase2.wsp -immediate -allcontenturls
b
Delete the solution from the solution store: stsadm -o deleteSolution MediaPublisher.ViewerPortal.WebPartPhase2.wsp
c
If the above command does not work, forcibly delete the solution: stsadm -o deleteSolution MediaPublisher.ViewerPortal.WebPartPhase2.wsp -override
6
Redeploy only the web parts using the Configuration Wizard.
7
If it continues to fail, repeat above steps (1 through 5) and perform the following steps from the command prompt: a
Change directory to C:\Program Files\Polycom SharePoint TIM Installer\SetupFiles.
b
Add the web part solution: stsadm -o addsolution -filename MediaPublisher.ViewerPortal.WebPartPhase2.wsp
Polycom, Inc.
57
Polycom VMC 2.0 SharePoint TIM Integration Guide
c
Errors in Undeployment
Deploy the web part solution: stsadm -o deploysolution -name MediaPublisher.ViewerPortal.WebPartPhase2.wsp -immediate -allcontenturls -allowgacdeployment
d
Activate the Web Parts (listed in section 5.4) on the site collection using the SharePoint interface (Site Actions > Site Settings > Modify All Site Settings > Site Collection Features > Deactivate).
NOTE: This assumes all prerequisites are in place.
Errors in Undeployment Site Removal failed Delete the site manually using the SharePoint interface (Site Actions > Site Settings > Delete this Site). Delete the ‘Polycom Viewer Site’ site template from the Site Collections site template gallery (if present).
Timer job undeployment failed 1
Open the Polycom SharePoint TIM site and deactivate the features: Polycom TIM Synchronization service and the Polycom TIM Program Availability service.
2
Retract and delete the solution MediaPublisher.ViewerPortal.TimerJobs.wsp through the Central Administration site.
3
If the solution cannot be removed through the web user interface open command prompt and: a
Retract the solution: stsadm -o retractSolution MediaPublisher.ViewerPortal.TimerJobs.wsp -immediate
b
Delete the solution from the solution store: stsadm -o deleteSolution MediaPublisher.ViewerPortal.TimerJobs.wsp
c
If the above command does not work, forcibly delete the solution using the following command: stsadm -o deleteSolution MediaPublisher.ViewerPortal.TimerJobs.wsp -override
58
Polycom, Inc.
Other Troubleshooting
Troubleshooting
Web part undeployment failed 1
Open the site collection containing the MediaPublisher SharePoint TIM site and deactivate the web part features listed in section 5.4
2
Retract and delete the solution: MediaPublisher.ViewerPortal.WebParts.wsp through Central Administration site.
3
If the solution cannot be removed through the web user interface open command prompt and a
Retract the solution: stsadm -o retractSolution MediaPublisher.ViewerPortal.WebParts.wsp -immediate -allcontenturls
b
Delete the solution from the solution store stsadm -o deleteSolution MediaPublisher.ViewerPortal.WebParts.wsp
c
If the above command does not work, forcibly delete the solution using the following command stsadm -o deleteSolution MediaPublisher.ViewerPortal.WebParts.wsp -override
Other Troubleshooting Timer job not working
Polycom, Inc.
1
Check the error in the Event Viewer. Click on Start > Programs > Administrative Tools > Event Viewer. Try to resolve this error.
2
If this fails, open Windows SharePoint Timer Services. Click on Start > Programs > Windows SharePoint Timer Services.
3
Check the user name here. Timer is running under the context of this user. Make sure this user has access to the Polycom Service Portal. Restart this timer service. Restart on all front end servers.
4
Open the Polycom TIM site and change the value of Synchronization service timer as blank.
5
Deactivate and activate the Synchronization service feature on the Polycom TIM site. Click on Site Settings > Site Features.
6
Open Global Assembly Cache by typing assembly on the Run prompt.
7
Make sure the following dlls are listed. a
MediaPublisher.ViewerPortal.Core.
b
MediaPublisher.ViewerPortal.CorePhase2. 59
Polycom VMC 2.0 SharePoint TIM Integration Guide
c
MediaPublisher.ViewerPortal.WebPartPhase2
d
MediaPublisher.ViewerPortal.Utilities
e
MediaPublisher.ViewerPortal.Services
f
MPAPI_Phase2
Other Troubleshooting
8
Open Services from Administrative tools.
9
Restart the Windows SharePoint Services Timer service.
First time install - Web part errors 1
The first time the site is installed and you try to access the site, you will see errors in the web parts.
2
The error message will be "Cannot Display web part” or “Error displaying web part. Please contact your Administrator."
3
This error occurs because the Sync Service has not yet started. After the sync service runs at least once and pulls in the domain options, the errors will disappear. Please check the event viewer application log to make sure the sync service has started execution.
Web parts are not shown 1
If the web parts are not registered properly or if the dlls are missing, then the Polycom SharePoint TIM site will display a page with Errors and the following message inside the web parts: "Web Part Error: A Web Part or Web Form Control on this Page cannot be displayed or imported. The type could not be found or it is not registered as safe."
60
2
Open web.config file of the root site of the Polycom site.
3
Search for the SafeControls tag.
4
SafeControls entry for the following dlls should be present a
MediaPublisher.ViewerPortal.Core
b
MediaPublisher.ViewerPortal.CorePhase2
c
MediaPublisher.ViewerPortal.WebPartPhase2
d
MediaPublisher.ViewerPortal.Utilities
e
MediaPublisher.ViewerPortal.Services
5
Open Global Assembly Cache by typing assembly on the Run prompt.
6
Make sure these three .dlls are listed.
7
Open the Site Collection Features for the Site Collection hosting the Polycom SharePoint TIM site.
8
Make sure all the web parts as listed in have been activated. Polycom, Inc.
Other Troubleshooting
Troubleshooting
Synchronization Service Timer Interval change is not reflected 1
If the Synchronization service timer is already running and you have changed the timer interval from the 15 default value to different value, then this change will not reflect unless you recreate the timer job.
2
For this open the TIM site and go to site features. Deactivate the 'Polycom Synchronization Service' feature.
3
Wait for a while and now again Activate this feature.
Web part displays an error message 1
Check Event Viewer Application log on the SharePoint Server machine.
2
Make sure there are no Error entries in the log.
3
In some cases if a property is changed, the web part is not updated correctly or displays an error message. When you update the property first click the Apply button and then click OK.
Getting Programs, Channels, and Categories failed 1
To troubleshoot timer service, go to Polycom Configuration list.
2
Edit Sync Timestamp and delete the value of Sync Timestamp.
3
Go to Site Settings page. Click on the site feature under Site Administrator.
4
Deactivate the Polycom Synchronization Service Feature; then reactivate it.
Test Web Services Using Tool
Polycom, Inc.
1
Open the Polycom folder from Program Files. Browse for the file PolycomProgramService.exe and double click this file to open the window.
2
Enter Polycom Host, Polycom Domain, and the Login Name of the user that is mentioned in the configuration list.
3
Click on Get Programs button. It will call GetPrograms web method from Polycom Program web service. The web service URL is displayed. The result is shown on the right section of the window. The number of programs received from the Polycom VMC 1000 and the program names are displayed.
4
Clicking on Get Channels and Get Categories will get the channels and categories from the Polycom web service and display their names on the right side. Channel and Category count is also displayed.
61
Polycom VMC 2.0 SharePoint TIM Integration Guide
5
Other Troubleshooting
Any error encountered while calling the web service is displayed on the right side of the window and also in the Event viewer. In case of error, please confirm the values for Polycom host, Polycom Domain, and Login name. If the error still persists, check the service portal log from the Polycom server.
Crossdomain.xml for Flash Video Use crossdomain.xml file to get flash videos to work if the Polycom Service Portal and Sharepoint TIM site are in different domains. 1
Open Notepad.
2
Copy and paste the following xml into notepad and save it as crossdomain.xml:
62
3
Open IIS. Go to the Polycom service website.
4
Right click on this website. Click Explore.
Polycom, Inc.
Other Troubleshooting
Troubleshooting
5
Copy and paste the crossdomain.xml in the root of the website.
6
Restart IIS.
Resource Not Found Error After completion of a successful installation of the SharePoint TIM you may see a "Resource Not Found" error when you open the TIM site in the browser.
This error may occur if you deploy the site on the site collection having managed path as 'sites' and the Publishing feature is on for the site collection. To correct this error:
Polycom, Inc.
1
Open the site collection in the browser that is the root site.
2
Click on Site Action > Site Settings > Modify All Site Settings > Master page.
63
Polycom VMC 2.0 SharePoint TIM Integration Guide
3
64
Other Troubleshooting
Check the box for Reset all subsites to inherit this Site Master Page setting.
Polycom, Inc.
