Share Point 2010 - Office Web Apps

  • Published on
    10-Oct-2014

  • View
    88

  • Download
    8

Embed Size (px)

Transcript

SharePoint 2010 - Office Web AppsInstallation, Configuration and Troubleshooting Guide

Brendan GriffinPremier Field Engineer brendan.griffin@microsoft.com

Prepared for Customer Tuesday, 29 November 2011

The information contained in this document represents the current view of Microsoft Corporation on the issues discussed as of the date of publication and is subject to change at any time without notice to you. This document and its contents are provided AS IS without warranty of any kind, and should not be interpreted as an offer or commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information presented. The information in this document represents the current view of Microsoft on the content. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED, OR STATUTORY, AS TO THE INFORMATION IN THIS DOCUMENT. The example companies, organizations, products, domain names, e-mail addresses, logos, people, places, and events depicted herein are fictitious. No association with any real company, organization, product, domain name, email address, logo, person, places, or events is intended or should be interred. Code snippets, samples, or examples contained in this document are provided AS-IS without warranties of any kind. Do not distribute. The descriptions of other companies products in this document, if any, are provided only as a convenience to you. Any such references should not be considered an endorsement of support by Microsoft. Microsoft cannot guarantee their accuracy, and the products may change over time. Also, the descriptions are intended as brief highlights to aid understanding, rather than as thorough coverage. For authoritative descriptions of these products, please consult their respective manufacturers.

Page iiSharePoint 2010 - Office Web Apps, Installation, Configuration and Troubleshooting Guide, Prepared by Brendan Griffin "SharePoint 2010 - Office Web Apps" last modified on 29 Nov. 11, Rev 10

Revision and Signoff SheetChange RecordDate 27/10/2011 Author Brendan Griffin Version .1 Change reference Initial draft for review/discussion

ReviewersName Version approved Position Date

Page iiiSharePoint 2010 - Office Web Apps, Installation, Configuration and Troubleshooting Guide, Prepared by Brendan Griffin "SharePoint 2010 - Office Web Apps" last modified on 29 Nov. 11, Rev 10

Table of ContentsIntroduction ................................................................................................................... 1 Office Web Apps - Overview ........................................................................................ 2 Deploying Office Web Apps ......................................................................................... 3Installing Office Web Apps ...................................................................................................... 3 Configuring the default file open behaviour ............................................................................. 4 Starting Office Web Apps Services ......................................................................................... 5 Creating the Office Web Apps service applications ................................................................. 5 Activating the Office Web Apps feature ................................................................................... 5

Configuring Office Web Apps ...................................................................................... 7OneNote ................................................................................................................................. 7 PowerPoint.............................................................................................................................. 8 Creating a PowerPoint Broadcast Site ...................................................................................11 Word ...12 Office Web Apps Cache .........................................................................................................14

Un-installing Office Web Apps ................................................................................... 17 Troubleshooting Office Web Apps ............................................................................ 18

Page ivSharePoint 2010 - Office Web Apps, Installation, Configuration and Troubleshooting Guide, Prepared by Brendan Griffin "SharePoint 2010 - Office Web Apps" last modified on 29 Nov. 11, Rev 10

IntroductionThis document provides details of how to deploy, configure and troubleshoot Office Web Apps in a SharePoint 2010 environment, it makes the assumption that Office Web Apps will be deployed to an existing SharePoint 2010 farm. Instructions on how to deploy Office Web Apps to a new SharePoint 2010 farm can be found here - Deploy Office Web Apps (Installed on SharePoint 2010 Products) http://technet.microsoft.com/en-us/library/ff431687.aspx#bkmk_ins_exis_farm

Page 1SharePoint 2010 - Office Web Apps, Installation, Configuration and Troubleshooting Guide, Prepared by Brendan Griffin "SharePoint 2010 - Office Web Apps" last modified on 29 Nov. 11, Rev 10

Office Web Apps - OverviewOffice Web Apps gives users a browser-based viewing and editing experience by providing a representation of an Office document in the browser. When a user clicks on a document stored in a SharePoint document library, the document opens directly in the browser. The document appears in the browser similar to how it appears in the Office client application. The Web app also provides many of the same editing features as an Office client application. Office Web Apps provides this representation of an Office Word document, PowerPoint presentation, Excel workbook, or OneNote notebook using native browser objects such as HTML, JavaScript, and images. Each document type is handled differently depending on the Office Web Apps services started and whether the Office Web Apps Feature is activated. A document in the Word Web App, PowerPoint Web App, or Excel Web App can be edited in the browser or can be opened for editing in the associated Office client application. If while viewing or working in a Web app a user clicks the Edit in Browser button on the Home tab of the toolbar, the user can perform light editing tasks in the browser. A notebook in the OneNote Web App can be edited in the browser natively without having to click the Edit in Browser button or it can be opened for editing in the OneNote client application by clicking Open in OneNote. If while in a Web app a user clicks the Open in Word, Open in PowerPoint, Open in Excel, or Open in OneNote button on the toolbar, the document will open in the associated Office client application if it is installed on the client computer. Taken from - http://technet.microsoft.com/en-us/library/ff431685.aspx

Page 2SharePoint 2010 - Office Web Apps, Installation, Configuration and Troubleshooting Guide, Prepared by Brendan Griffin "SharePoint 2010 - Office Web Apps" last modified on 29 Nov. 11, Rev 10

Deploying Office Web AppsFrom a licensing perspective Office Web Apps is included with both Office 2010 Standard and Office 2010 Professional Plus. Office Web Apps can be downloaded from the Microsoft Volume Licensing Service Center - http://www.microsoft.com/licensing/about-licensing/Office2010.aspx#tab=2 Office Web Apps supports both SharePoint Foundation and SharePoint Server 2010. A Silverlight plugin is not required to be installed on the client browser to use Office Web Apps. Having the Silverlight plugin installed improves the page load time for both Word and PowerPoint documents. Silverlight provides no benefits for the Excel and OneNote Web App Deploying Office Web Apps falls into five separate steps: Installing Office Web Apps Configuring the default file open behaviour Starting the Office Web Apps services Creating the Office Web Apps service applications Activating the Office Web Apps features

Installing Office Web AppsThe first step is to install the binaries for Office Web Apps. Updates such as service packs and cumulative updates can be slipstreamed into the Office Web Apps installation media in the same manner as SharePoint Server 2010 by copying extracted updates into the Updates directory.

Install Office Web Apps on each server within the farm by running Setup.exe from the installation media Once Office Web Apps has been installed on every server within the farm, run PSConfig on each server within the farm to complete the installation

Page 3SharePoint 2010 - Office Web Apps, Installation, Configuration and Troubleshooting Guide, Prepared by Brendan Griffin "SharePoint 2010 - Office Web Apps" last modified on 29 Nov. 11, Rev 10

Configuring the default file open behaviourThe second step is to configure the default file open behaviour (optional) One thing to be aware of when deploying Office Web Apps into an existing SharePoint 2010 farm is that it changes the default file open behaviour for Word, PowerPoint, Excel and OneNote documents to open in Office Web Apps. If a user clicks on a document in SharePoint after Office Web Apps have been installed but before the additional configuration such as starting services and creating service applications has been performed, the user can get a broken link in the browser. One way to mitigate this risk is to activate the OpenInClient feature in each site collection, this will ensure that when a user opens a Word, PowerPoint, Excel or OneNote document it uses the client application rather than attempting to use Office Web Apps to render the document.

The Windows PowerShell commands below will activate the OpenInClient feature in each site collection. $defaultOpenBehaviorFeatureId = $(Get-SPFeature -limit all | where {$_.displayname -eq "OpenInClient"}).Id Get-SPSite -limit ALL |foreach{ Enable-SPFeature $defaultOpenBehaviorFeatureId url $_.URL } Once the installation and configuration of Office Web Apps has been performed the behaviour can be changed to open documents in Office Web Apps rather than the client, using the Windows PowerShell commands below. $defaultOpenBehaviorFeatureId = $(Get-SPFeature -limit all | where {$_.displayname -eq "OpenInClient"}).Id Get-SPSite -limit ALL |foreach{ Disable-SPFeature $defaultOpenBehaviorFeatureId url $_.URL } Alternatively this setting can be configured on a per document library basis if required.

Page 4SharePoint 2010 - Office Web Apps, Installation, Configuration and Troubleshooting Guide, Prepared by Brendan Griffin "SharePoint 2010 - Office Web Apps" last modified on 29 Nov. 11, Rev 10

Starting Office Web Apps ServicesThe third step is to start the Office Web App services on servers that will be used to render Office documents in the browser. Browse to Central Administration > Application Management > Manage Services on Server Select a WFE from the Server: dropdown list Start the Excel Services, PowerPoint and Word Viewing service If the farm is running SharePoint Server 2010 Enterprise then this may not be required for Excel Services as the service may already be configured Repeat this for all other WFEs within the farm

Creating the Office Web Apps service applicationsThe fourth step is to create the service applications that are required for Office Web Apps to function. Browse to Central Administration > Application Management > Manage Service Applications Select New and then PowerPoint Service Application Enter a name for the service application Select an existing or create a new application pool If required check the Add the application proxy to default group Click OK Repeat the procedure for the Excel and Word Viewing Service Applications - If the farm is running SharePoint Server 2010 Enterprise then this may not be required as there may already be an Excel Services service application

Activating the Office Web Apps featureThe final step is to activate the feature required for Office Web Apps to function on all site collections.

This can be done manually on a per site collection basis or can be automated for all site collections using the Windows PowerShell commands below. $webAppsFeatureId = $(Get-SPFeature -limit all | where {$_.displayname -eq "OfficeWebApps"}).ID Get-SPSite -limit ALL |foreach {Enable-SPFeature $webAppsFeatureId -url $_.URL} Any site collection created after Office Web Apps have been deployed will automatically have the Office Web Apps feature activated. If the feature isnt activated for a site collection Office Web Apps can be used to view documents in a browser if the default behaviour of the document library has been configured to open document in aPage 5SharePoint 2010 - Office Web Apps, Installation, Configuration and Troubleshooting Guide, Prepared by Brendan Griffin "SharePoint 2010 - Office Web Apps" last modified on 29 Nov. 11, Rev 10

browser however if a user attempts to edit the document using the Edit in Browser option, this will return the following error.

Page 6SharePoint 2010 - Office Web Apps, Installation, Configuration and Troubleshooting Guide, Prepared by Brendan Griffin "SharePoint 2010 - Office Web Apps" last modified on 29 Nov. 11, Rev 10

Configuring Office Web AppsOnce Office Web Apps has been installed there are a number of optional additional configuration steps. These are summarised below.

OneNoteOneNote configuration is controlled on a per site collection basis using the Windows PowerShell cmdlet Set-SPOneNoteWebAppConfig, ClipartEnabled Enables support for inserting clipart in Microsoft Word Web App and OneNote Web App. NotebookVersioningEnable Specifies that the notebook use its internal versioning system to track versions. Proxy The URL of the proxy server configured to allow HTTP requests to Office.com to succeed. Used so that the server is able to retrieve and insert clipart in the Word Web App and OneNote Web App. SyncIntervalMaxInSeconds The minimum interval, in seconds, for replicating when the user is idle. The default value is 30. SyncIntervalMinInSeconds The minimum level, in seconds, for replication to occur when a user is idle. The default value is 5. SyncIntervalMinOnHeavyLoadInSeconds The sync interval level, in seconds, for the OneNote Web App when the server is experiencing heavy load. Valid values are 1 to 1000.The default value is 30. SyncIntervalStepInSeconds The amount, in seconds, to increase the interval of replicating when the user is idle. The default value is 5. In the example below SyncIntervalStepInSeconds has been configured to 50 for the HR site collection. Set-SPOneNoteWebAppConfig -Site "http://intranet.contoso.com/sites/HR" SyncIntervalMinInSeconds 50

Page 7SharePoint 2010 - Office Web Apps, Installation, Configuration and Troubleshooting Guide, Prepared by Brendan Griffin "SharePoint 2010 - Office Web Apps" last modified on 29 Nov. 11, Rev 10

PowerPointA number of configuration options are available for the PowerPoint service applications. A number of these settings...