SAP BusinessObjects Live Office Installation Guide SAP BusinessObjects Business Intelligence platform 4.

0 Support Package 2

2011-07-13

Copyright

2011 SAP AG. All rights reserved.SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP BusinessObjects Explorer, StreamWork, and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and other countries.Business Objects and the Business Objects logo, BusinessObjects, Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius, and other Business Objects products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of Business Objects Software Ltd. Business Objects is an SAP company.Sybase and Adaptive Server, iAnywhere, Sybase 365, SQL Anywhere, and other Sybase products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of Sybase, Inc. Sybase is an SAP company. All other product and service names mentioned are the trademarks of their respective companies. Data contained in this document serves informational purposes only. National product specifications may vary.These materials are subject to change without notice. These materials are provided by SAP AG and its affiliated companies ("SAP Group") for informational purposes only, without representation or warranty of any kind, and SAP Group shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP Group products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty. 2011-07-13

Contents

Chapter 1

Introduction.............................................................................................................................5 About the document.................................................................................................................5 Purpose...................................................................................................................................5 Planning..................................................................................................................................7 Overview of Live Office............................................................................................................7 Installation overview.................................................................................................................7 Installation types......................................................................................................................8 Preparation..............................................................................................................................9 Installation prerequisites...........................................................................................................9 Installation.............................................................................................................................11 Installing Live Office...............................................................................................................11 To activate the server component..........................................................................................11 Using the Installation Wizard..................................................................................................11 Running a silent installation....................................................................................................13 Configuring Live Office...........................................................................................................19 Enabling Live Office client components .................................................................................19 Running side-by-side Live Office installation...........................................................................20 Post-Installation....................................................................................................................23 Maintenance mode options for Live Office Installation............................................................23 To uninstall Live Office...........................................................................................................23 More Information...................................................................................................................25 27

1.1 1.2
Chapter 2

2.1 2.2 2.3

Chapter 3

3.1
Chapter 4

4.1 4.1.1 4.1.2 4.1.3 4.2 4.3 4.4

Chapter 5

5.1 5.2
Appendix A Index

2011-07-13

Contents

2011-07-13

Introduction

Introduction

1.1 About the document

This document provides instructions to system administrators and end users about installing and configuring SAP BusinessObjects Live Office.

1.2 Purpose
This document is intended for system administrators who install and configure SAP BusinessObjects Live Office, and end users who use the product. For the latest information, patches, and other information, visit the SAP BusinessObjects support site: http://service.sap.com/bosap-support.

2011-07-13

Introduction

2011-07-13

Planning

Planning

2.1 Overview of Live Office

SAP BusinessObjects Live Office (Live Office) is an add-on for Microsoft Office applications that gives you access to up-to-date information stored in the SAP BusinessObjects Business Intelligence platform. With Live Office, you can insert content from Web Intelligence, Crystal Reports, and Universe Queries in your Microsoft Office documents (PowerPoint, Word, Excel, or Outlook). When you insert an object, a reference to the BI platform location is also inserted. When you open the document later using the Microsoft Office application, you can refresh the objects and see the current data in your document. For more information about Live Office features, see the Live Office User's Guide.

2.2 Installation overview

This section provides a list of main topics for installing SAP BusinessObjects Live Office: Installation prerequisites Installing Live Office To activate the server component Using the Installation Wizard Running a silent installation Configuring Live Office Enabling Live Office client components Running side-by-side Live Office installation To uninstall Live Office

2011-07-13

Planning

2.3 Installation types

There are two types of installation methods to run the installation program for Live Office: Interactive installation This type of installation involves running a program from the installation media. An interactive wizard prompts for all information related to the installation. Use this option to select individual installation options from a series of screens. This is the default installation method. Silent installation This type of installation is performed for large-scale deployment. You can choose to perform one of the following silent installations: Scripted silent installation involves writing parameters to a response.ini file, and then using the file to run the installation program. Installation options can be given in a response file rather than directly on the command-line. This type of silent installation uses the -r command-line parameter to read installation options from the response file. Use this option if you want to install multiple machines with the same configuration. Installation options stored in a response file can be overridden by giving them on the command-line. Command-line silent installation involves passing parameters to the installation program directly. Installation options are given on the command-line, which override the installation program's default values. The command-line can be used to give some or all installation options. When an installation option is not given on the command-line, the installation program uses a default value.

2011-07-13

Preparation

Preparation

3.1 Installation prerequisites

Before installing SAP BusinessObjects Live Office, make sure the following requirements are met: You have Administrator rights on the computer where you will be installing Live Office. Microsoft .NET Framework 3.5 or higher is installed. Microsoft Office is installed. For a list of supported versions, see the Supported Platform document for SAP BusinessObjects Business Intelligence platform. The SAP BusinessObjects Business Intelligence platform Supported Platforms document is available at https://www.sdn.sap.com/irj/boc/articles. To use Microsoft Office 2003, the update for Office 2003 (KB907417) must be installed on the client machine. This update is available from the Microsoft Support site.

Note: It is not necessary to have access to the BI platform to install Live Office. However, to use the software, SAP BusinessObjects Business Intelligence platform including Live Office Web Services for Java application server must be accessible from the client machine. For more information about deploying the BI platform web applications to a supported Java web application server, including the Web Services dswsbobje.war file, see the the SAP BusinessObjects Business Intelligence platform Web Application Deployment Guide.

2011-07-13

Preparation

10

2011-07-13

Installation

Installation

4.1 Installing Live Office

SAP BusinessObjects Live Office (Live Office) consists of server (Web Services) components and client components. The server components are installed automatically with both the premium and professional editions of SAP BusinessObjects Business Intelligence platform. With the professional edition of BI platform, however, you must purchase a license for Live Office to activate the server component. For information about activating the server component, see To activate the server component. The client components are automatically available to install with both the professional and premium editions of SAP BusinessObjects Business Intelligence platform. They must be installed on each machine that will be using the Live Office functionality.

4.1.1 To activate the server component

Note: For the premium edition of SAP BusinessObjects Business Intelligence platform, the Web Services component is installed automatically and activation is not required. To activate the Web Services component for the professional edition of BI platform, complete the following steps: 1. Locate your Live Office license key. 2. Click Start > Programs > SAP BusinessObjects BI platform 4.0 > SAP BusinessObjects BI platform > SAP BusinessObjects BI platform Central Management Console. 3. In the Central Management Console, under "CMC Home", click License Keys. 4. In the" License Key" dialog box, in the Add Key box, type your Live Office license key and click Add. The Web Services component is activated and all Live Office features and options are functional.

4.1.2 Using the Installation Wizard

11

2011-07-13

Installation

The Live Office Installation Wizard works with the Microsoft Windows Installer to guide you through the installation process. The wizard automatically recognizes your computer's operating system and checks for software platform requirements. It updates files as required. For a current list of the supported platforms and information about platforms and configurations for this release of Live Office, see the SAP BusinessObjects Business Intelligence platform Supported Platforms document available at https://www.sdn.sap.com/irj/boc/articles. Note: If the wizard detects that the same version of Live Office is already installed on your system, it starts in Maintenance mode so you can repair or remove the existing version.

4.1.2.1 To install the Live Office client

1. Navigate to the Live Office installation package and run setup.exe. Note: For a network-based application, locate the file on your network, and run it. 2. Choose your preferred language for the installation setup and click OK. The Installation Wizard verifies that all installation prerequisites have been satisfied for your system and displays the status of each item. If not, the Live Office installation is stopped. 3. If necessary, correct any prerequisite issues and restart the Live Office installation process. To continue, click Next. The Live Office Setup page opens. 4. Click Next. The "License Agreement" page opens. 5. Review the Live Office License Agreement. When you are ready, click I accept the Licence Agreement and click Next. The "Specify the Destination Folder" page opens. 6. Type the path to the location where you want to install Live Office or click Browse to navigate to the location. Click Next. The "Choose Language Packs" page opens. 7. Select the languages you want to include in the installation or select All Languages and then click Next. Note: In this release, the stand-alone language pack is not supported. If you want an additional language support after installation, you will have to uninstall and reinstall the product. The "Choose Installation Type" page opens. 8. For installation type, select one of the following options and click Next: Typical -- choose this option to install Live Office and all the available Live Office features.

12

2011-07-13

Installation

Custom -- choose this option if you want to install Live Office excluding specific features.

If you selected a typical installation, the "Start Installation" page opens. Continue with step 10. If you selected a custom installation, the "Select Features" page opens. 9. If you selected a custom installation, deselect any of the following features that you don't want to include in the installation: Tip: To determine if your system has enough available space to install Live Office and the selected features, click Disk Cost. The wizard analyzes your system and displays the available disks, their available space, the space required to install the selected features, and the amount of space that will be available after the installation. Click OK to close the "Disk Costing" window.
Option Description

Panel for Outlook

Installs the Live Office Panel that allows easy access to content stored in SAP BusinessObjects Business Intelligence platform repositories from within Microsoft Outlook. Requires about 5MB of disk space.

Connector for Crystal Reports Installs a connector that allows you to work with Crystal reports in Live Office. Requires about 70MB of disk space. Connector for SAP BusinessOb- Installs a connector that allows you to upload and analyze Mijects Explorer crosoft Excel data in SAP BusinessObjects Explorer. Connector for Web Intelligence Installs a connector that allows you to work with Web Intelligence and Queries content and Universe queries in Live Office. Requires about 5MB of disk space. The "Start Installation" page opens. 10. Click Next. Live Office is installed on your system. When you open a Microsoft Office application, the Live Office menu and toolbar are available. You can now log on to SAP BusinessObjects Business Intelligence platform and use Live Office. For more information about using Live Office, see the SAP BusinessObjects Live Office User's Guide.

4.1.3 Running a silent installation

For a silent installation, system administrators can run a script from the command line to automatically install Live Office components on any machine in their system without the installation program prompting them for information. The silent installation is not available from the Live Office Setup program and is intended only for experienced system administrators. A silent installation is particularly useful when system administrators need to perform multiple installations and do not want to interrupt people who are working on machines in their system. System administrators

13

2011-07-13

Installation

can also use the silent installation command in their own installation scripts. For example, if an organization uses scripts to install software on machines, system administrators can add the silent installation command to their scripts. A silent installation can be run using two methods: command line and response file.

4.1.3.1 To use the command line method

A command line silent installation of Live Office consists of the command setup.exe followed by several parameters that provide information about the installation. The example below installs the desired language version of Live Office to the SAP BusinessObjects directory without prompting users for information or settings:
setup.exe -q installdir="C:\Program Files\SAP BusinessObjects\" installtype="default" setupuilanguage="en" selectedlanguagepacks="en;fr;tr"

Note: A syntax error might occur due to the restriction of windows command prompt if you do not use quotes during the command line installation method. Note: When you perform a silent installation, you accept the end-user license agreement by default. You can find a copy of the license agreement in the Collateral>Docs folder of your product CD. Note: Parameters not listed in this table may be available but have not been tested. Untested parameters are not supported. Installation settings Description Specifies the language for the installation. For a list of language codes, see Supported languages codes.

SetupUILanguage=en

14

2011-07-13

Installation

Installation settings

Description Default installation path: C:\Program Files\SAP BusinessObjects\. Specifies the machine and target directory where you want to install Live Office. Replace the default value with the full path for the installation directory. Customized installation path: When you install Live Office in the following path: C:\SAP\ and try to run the Dashboard Design installer, the installation path defaults to C:\SAP\, and you will not able to change it. Specifies the language packs to install. Separate each language with a semicolon. For a list of language codes, see Supported languages codes. Specifies the type of installation you want to use where "Default" is a typical installation and "Custom" allows you to specify the features to include in the installation. If InstallType is set to "custom", this option specifies the Live Office features to install where LiveOffice.CrystalRe ports is the Crystal Reports connector, LiveOffice.WebI is the Web Intelligence connector, and LiveOffice.BIPanel is the Live Office Panel. Specifies the type of authentication to use where <authenticationType> can be one of the following options: secEnterprise

installdir=c:\Program Files\SAP BusinessObjects\

selectedlanguagepacks=en;tr

InstallType=custom

Features=LiveOffice.CrystalRe ports,LiveOffice.WebI,LiveOffice.Explor er, LiveOffice.BIPanel

CMSAUTHENTICATION= <authentication Type>

secSAPR3 secLDAP secWinAD This is an optional parameter. If you do not set this parameter, Enterprise authentication is used. Specifies the URL for the web service. This is an optional parameter.

WEBURL=<URL>

15

2011-07-13

Installation

Installation settings

Description Specifies the name of the SAP BusinessObjects Business Intelligence platform server.

NAMESERVER=<server name>

Note: If you do not include this parameter, the installation uses the name of the installation machine. Enables the Single Sign On feature so the logon credentials can be used to access all databases. This feature is not enabled by default. Performs the installation silently, without prompting the user. This parameter changes the installation UI mode.

SINGLESIGNON

-q "filepath"

When you run setup.exe -q installdir="c:\live office\"; a silent installation is performed. The installation directory will be set to "c:\live office\", all parameters that are not mentioned from the command line will be left with default settings. Reads the INI response file at the path specified by filepath, and installs Live Office based on the settings in the file.

-r "filepath"

Note: In the INI response file, there is a section "others". Set the key to /qb to perform an installation with a progress meter. Set the key to /qa to perform a complete silent installation. Writes an INI response file to the path specified by filepath.

-w "filepath"

Note: You can follow all the steps of the installation up to the final dialog box in the sequence, then cancel the installation. This creates the INI response file without installing Live Office.

16

2011-07-13

Installation

4.1.3.2 To use the response file method

A response file silent installation of Live Office consists of the command setup.exe followed by the parameter -r and the location of the response file where the installation information is provided. The example below runs the silent installation with the response file located in the c:\sap businessobjects enterprise directory:
Setup.exe -r c:\sap businessobjects enterprise\response.ini

Use the following command to run the response file on a shared server:
setup.exe -r "\\sharedserver\response.ini"

4.1.3.2.1 To create a response file for a scripted silent installation

Before you run a scripted silent installation, you can use the SAP BusinessObjects Business Intelligence platform Live Office media to create a response.ini file. Note: Live Office is shipped with a sample response.ini file where the Live Office installation file is located. You can modify values based on the sample response file, or create a customized response file by using the "-w" parameter. 1. Run setup.exe -w C:\response.ini from the Live Office media. The Live Office installation wizard appears. 2. Proceed through the wizard, selecting your installation options. Follow the instructions in the To install Live Office media section. 3. On the "Start installation" page, click Next, and then click OK. The installation program writes your installation options to the response.ini file, and closes. You can now open response.ini in a text editor to review your installation options. Example: In this example, the selected installation options includes English and Turkish language packs, English installation language, Live Office, and Available features.
### Installation directory installdir=C:\<INSTALLDIR> ### property.InstallType.description# installtype=custom ### Language Packs Selected to Install selectedlanguagepacks=en;tr ### Setup UI language setupuilanguage=en ### Available features ### ------------------

17

2011-07-13

Installation

### LiveOffice.LiveOfficeRoot ### LiveOffice.CrystalReports ### LiveOffice.WebI ### LiveOffice.BIPanel ### LiveOffice.Explorer features=LiveOffice.CrystalReports,LiveOffice.WebI,LiveOffice.BIPanel,LiveOffice.Explorer

Note: If you want to add a note or comment to the response.ini file, you can add ### to the beginning of a line. Lines that begin with ### are not processed by setup.exe.

4.1.3.2.2 To run a response file installation

1. ClickStart > Run and type cmd to open the "Command Prompt" window. 2. In the "Command Prompt" window, navigate to the installation folder. 3. Enter the following command: setup.exe -r <response file path>\response.ini, where <response file path> is the path to the response file.

4.1.3.3 Supported languages codes

The following tables lists the supported language codes used in Live Office:
Language Code

Simplified Chinese Traditional Chinese Danish Dutch English Finnish French German Italian Japanese Korean Norwegian (Bokmal) Polish Portuguese (Brazil)

zh_CN zh_TW DA NL EN FI FR DE IT JA KO NB PL PT

18

2011-07-13

Installation

Language

Code

Russian Spanish Swedish Thai Hungarian Slovakian Turkish Czech

RU ES SV TH HU SK TR CS

4.2 Configuring Live Office

If the SAP BusinessObjects Business Intelligence platform server uses reverse proxies, you must configure Live Office to access the reverse proxy URL to view documents in a web browser. For information about enabling reverse proxies and Single Sign On (SSO) for SAP BusinessObjects Live Office, see the Enabling reverse proxies for Java applications servers topic in the SAP BusinessObjects Business Intelligence Platform Deployment and Configuration Guide.

4.3 Enabling Live Office client components

When a user installs Live Office, the Live Office menu and toolbar are enabled for their use. However, if another user logs onto the system, Live Office is not enabled for them and the Live Office menu and toolbar are not available. To enable Live Office for other users, each user must run the enable_addin.exe utility.

4.3.1 To enable the latest Live Office client components

1. Locate enable_addin.exe in the Live Office program folder.

19

2011-07-13

Installation

Tip: By default, the Live Office program folder is located in C:\Program Files\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\Live Office\. 2. To run the utility, double-click enable_addin.exe. 3. In the Live Office Configuration dialog box, select which Microsoft Office applications you want to enable the Live Office Add-In for and click OK. Live Office is enabled. When the user opens a Microsoft Office application, the Live Office menu and toolbar are available. Note: For information about using Live Office, see the SAP BusinessObjects Live Office User's Guide.

4.4 Running side-by-side Live Office installation

If you purchased an upgrade product activation keycode, when you install the upgrade, the installation program does not remove your previous version of Live Office. In general, upgrading Live Office components provides you with a side-by-side installation: a scenario in which you can have both your old and new versions of Live Office installed on the same machine. However, only one installation can be enabled at any time.

4.4.1 To switch between Live Office versions on your machine

You can use the enable_addin.exe utility to switch between different installed Live Office versions. Note: For optimal performance, enable only one version of Live Office at a time. The enable_addin.exe utility is applicable for both the Microsoft Office 2003 and Microsoft Office 2007 applications.

1. Locate enable_addin.exe in the Live Office program folder. Tip: By default, the Live Office XI 4.0 program folder is located in C:\Program Files\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\Live Office\. The default program location of Live Office XI R3 is C:\Program Files\Business Objects\BusinessObjects Enterprise 12.0\Live Office 12.0. 2. Run enable_addin.exe. 3. Click OK.

20

2011-07-13

Installation

The selected Live Office version is enabled for the Microsoft Office application. Note: If the LiveOffice menu is no longer available, rerun the utility to restore the menu.

21

2011-07-13

Installation

22

2011-07-13

Post-Installation

Post-Installation

5.1 Maintenance mode options for Live Office Installation

If your Live Office program files become damaged or removed, Live Office will no longer work correctly. In this case, you may be able to repair or modify the Live Office installation by replacing the setup files on the system with the files located in the Live Office installation directory. 1. Navigate to the Live Office installation package and run setup.exe. The Installation Wizard detects that the same version is already installed and runs in Maintenance Mode. 2. Choose one of the following options and click Next: Repair-- restores the Live Office installation by replacing the files on the system with files located in the Live Office installation directory. Remove -- uninstalls the current Live Office installation. Note: Another method of removing Live Office is from "Add/Remove Programs". Modify - modifies the current Live Office installation.

5.2 To uninstall Live Office

1. Click Start > Settings > Control Panel. 2. On the "Control Panel", double-click Add/Remove Programs. 3. Select SAP BusinessObjects Live Office XI 4.0 and click Remove. 4. Click Yes. 5. When the uninstall process completes, click Finish.

23

2011-07-13

Post-Installation

24

2011-07-13

More Information

More Information

Information Resource

Location

SAP BusinessObjects product information

http://www.sap.com Navigate to http://help.sap.com/businessobjects and on the "SAP BusinessObjects Overview" side panel click All Products. You can access the most up-to-date documentation covering all SAP BusinessObjects products and their deployment at the SAP Help Portal. You can download PDF versions or installable HTML libraries. Certain guides are stored on the SAP Service Marketplace and are not available from the SAP Help Portal. These guides are listed on the Help Portal accompanied by a link to the SAP Service Marketplace. Customers with a maintenance agreement have an authorized user ID to access this site. To obtain an ID, contact your customer support representative. http://service.sap.com/bosap-support > Documentation Installation guides: https://service.sap.com/bosap-instguides Release notes: http://service.sap.com/releasenotes

SAP Help Portal

SAP Service Marketplace

The SAP Service Marketplace stores certain installation guides, upgrade and migration guides, deployment guides, release notes and Supported Platforms documents. Customers with a maintenance agreement have an authorized user ID to access this site. Contact your customer support representative to obtain an ID. If you are redirected to the SAP Service Marketplace from the SAP Help Portal, use the menu in the navigation pane on the left to locate the category containing the documentation you want to access. https://cw.sdn.sap.com/cw/community/docupedia

Docupedia

Docupedia provides additional documentation resources, a collaborative authoring environment, and an interactive feedback channel. https://boc.sdn.sap.com/

Developer resources https://www.sdn.sap.com/irj/sdn/businessobjects-sdklibrary

25

2011-07-13

More Information

Information Resource

Location

SAP BusinessObjects articles on the SAP Community Network

https://www.sdn.sap.com/irj/boc/businessobjects-articles These articles were formerly known as technical papers. https://service.sap.com/notes

Notes These notes were formerly known as Knowledge Base articles. Forums on the SAP Community Network https://www.sdn.sap.com/irj/scn/forums http://www.sap.com/services/education Training From traditional classroom learning to targeted e-learning seminars, we can offer a training package to suit your learning needs and preferred learning style. http://service.sap.com/bosap-support Online customer support The SAP Support Portal contains information about Customer Support programs and services. It also has links to a wide range of technical information and downloads. Customers with a maintenance agreement have an authorized user ID to access this site. To obtain an ID, contact your customer support representative. http://www.sap.com/services/bysubject/businessobjectsconsulting Consulting Consultants can accompany you from the initial analysis stage to the delivery of your deployment project. Expertise is available in topics such as relational and multidimensional databases, connectivity, database design tools, and customized embedding technology.

26

2011-07-13

Index
C
client 19 command line 14 components 19 configuring 19 installations (continued) silent (continued) scripted 17

R
requirements 9 response.ini 17

L
languages 18 Live Office 12, 19

S
server activation 11 silent 14 silent installations scripted response.ini 17

I
installation 9, 12, 14 silent 13 supported platforms 12 installations silent response.ini 17

M
maintenance mode modify 23 remove 23 repair 23

27

2011-07-13

Index

28

2011-07-13