SAP BusinessObjects Patch Update Guide SAP BusinessObjects Business Intelligence suite 4.0 Support Package 4

2012-08-16

2012 SAP AG. All rights reserved.SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAPBusinessObjects Explorer, StreamWork, SAP HANA and other SAP products and services mentioned

Copyright

herein as well as their respective logos are trademarks or registered trademarks of SAP AG inGermany and other countries.Business Objects and the Business Objects logo, BusinessObjects,Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius, and other Business Objects productsand services mentioned herein as well as their respective logos are trademarks or registeredtrademarks of Business Objects Software Ltd. Business Objects is an SAP company.Sybase andAdaptive Server, iAnywhere, Sybase 365, SQL Anywhere, and other Sybase products and servicesmentioned herein as well as their respective logos are trademarks or registered trademarks of Sybase,Inc. Sybase is an SAP company. Crossgate, m@gic EDDY, B2B 360, B2B 360 Services areregistered trademarks of Crossgate AG in Germany and other countries. Crossgate is an SAPcompany. All other product and service names mentioned are the trademarks of their respectivecompanies. Data contained in this document serves informational purposes only. National productspecifications may vary.These materials are subject to change without notice. These materials areprovided 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 oromissions with respect to the materials. The only warranties for SAP Group products and servicesare those that are set forth in the express warranty statements accompanying such products andservices, if any. Nothing herein should be construed as constituting an additional warranty.

2012-08-16

Contents

Installation...............................................................................................................................5Chapter 1

About this Document...............................................................................................................51.1

Purpose...................................................................................................................................51.1.1

Constraints..............................................................................................................................51.1.2

Variables..................................................................................................................................61.1.3

Planning..................................................................................................................................7Chapter 2

SAP BusinessObjects Patches................................................................................................72.1

Patch platform support.............................................................................................................92.2

Patch language support............................................................................................................92.3

Patch installation limitations and restrictions...........................................................................102.4

Planning your Patch installation..............................................................................................102.5

Downloading Patches.............................................................................................................112.6

Installation scenarios............................................................................................................13Chapter 3

Applying Patches to a system with multiple SAP BusinessObjects products..........................133.1

Updating a distributed SAP BusinessObjects Business Intelligence suite deployment............133.2

Updating web application components...................................................................................133.3

Saving web.xml file modifications...........................................................................................143.4

Patch installation on Windows..............................................................................................15Chapter 4

To install SAP BusinessObjects Patches for server components on Windows.......................154.1

To install SAP BusinessObjects Patches for client components on Windows.........................164.2

Silent installation on Windows................................................................................................164.3

To run a silent installation using a response file on Windows..................................................174.3.1

Silent installation parameters on Windows.............................................................................184.3.2

Uninstalling SAP BusinessObjects Patches on Windows.......................................................184.4

To uninstall SAP BusinessObjects Patches on Windows........................................................184.4.1

Patch installation on UNIX....................................................................................................21Chapter 5

To install the SAP BusinessObjects patch on UNIX................................................................215.1

2012-08-163

Silent installation on UNIX......................................................................................................225.2

To run a silent installation using a response file on UNIX........................................................225.2.1

Silent installation parameters on UNIX...................................................................................235.2.2

To uninstall SAP BusinessObjects Patches on UNIX..............................................................245.3

2012-08-164

Contents

Installation

1.1 About this Document

This guide is intended for the system administrator or IT professional who is responsible for theinstallation, deployment, and maintenance of SAP BusinessObjects Business Intelligence suite.

Topics covered in this guide include: Patch installation on Windows Patch installation on UNIX Silent Patch installation Uninstalling Patches

It is recommended that this guide be used in conjunction with the following Patch documentation: The Patch Release Notes and Fixed issues document which contains information about important

issues, limitations, and work-arounds for the Patch release, as well as information about the defectsaddressed by the Patch.

1.1.1 Purpose

This document is intended as a reference for use by system administrators when updating the BI suitewith the most recent Patch. For the latest information, updates, and other information, visit the supportsite at service.sap.com/bosap-support.

1.1.2 Constraints

This guide does not describe how to set up a host operating system, supported database, web applicationserver, or web server. If you are planning to use a dedicated database, web application server, or webserver, it must be installed and functioning before SAP BusinessObjects Business Intelligence platformcan be installed. Refer to the vendor documentation for more information on installing or upgradingthese components.

2012-08-165

Installation

1.1.3 Variables

The following variables are used throughout this guide.

DescriptionVariable

The directory where the BI platform is installed.

On aWindowsmachine, the default directory is C:\Program Files (x86)\SAPBusinessObjects\.

2012-08-166

Installation

Planning

2.1 SAP BusinessObjects Patches

A separate Patch is available for each SAP BusinessObjects package, as outlined in the following table.

2012-08-167

Planning

DescriptionPatch

Use this Patch to update the BI platform installations.

This Patch is also intended for SAP BusinessObjectsEdge Business Intelligence (BI)

SAP BusinessObjects Business Intelligenceplatform Patch

Use this Patch to update the BI platform Client Toolsinstallations. Client tools include: Web Intelligence Rich Client Business View management tool Report Conversion tool Web services query tool Universe design tool Information design tool Translation management tool Data Federation administration tool Widgets for SAP BusinessObjects Business Intelli-

gence platform Translation management tool Developer Components

SAP BusinessObjects Business Intelligence plat-form Java SDK

SAP BusinessObjects Business Intelligence plat-form .NET SDK

SAP BusinessObjects Business Intelligence plat-form Web Services Consumer SDK

SAP Crystal Reports Java SDK

SAP BusinessObjects Business Intelligenceplatform Client Tools Patch

Use this Patch to update SAP Crystal Reports 2011 in-stallations.

Note:If you are running SAPCrystal Reports 2011, see "Patchinstallation limitations and restrictions".

SAP Crystal Reports 2011 Patch

Use this Patch to update SAPCrystal Reports for Enter-prise installations.

SAP Crystal Reports for Enterprise Patch

Use this Patch to update SAPCrystal Server 2011 instal-lations.

SAP Crystal Server 2011 Patch

Use this Patch to update SAP BusinessObjects LiveOffice installations.

SAP BusinessObjects Live Office Patch

2012-08-168

Planning

DescriptionPatch

Use this Patch to update SAP Crystal Presentation De-sign installations.

SAP Crystal Presentation Design Patch

Use this Patch to update SAP BusinessObjects Dash-board Design installations.

SAP BusinessObjects Dashboard DesignPatch

Use this Patch to update SAP BusinessObjects Explorerinstallations.

SAP BusinessObjects Explorer Patch

2.2 Patch platform support

The following table shows the platform support for each Patch.

LinuxSolarisAIXWindowsSupport Package

SAPBusinessObjects Business Intelligenceplatform

SAPBusinessObjects Business Intelligenceplatform Client Tools

SAP Crystal Reports 2011

SAP Crystal Server 2011

SAP Crystal Reports for Enterprise

SAP BusinessObjects Live Office

SAP Crystal Presentation Design

SAP BusinessObjects Dashboard Design

SAP BusinessObjects Explorer

2.3 Patch language support

A Patch only contains string resources for English, and any string fix resolutions contained in the Patchwill be displayed in English. Translations for string fixes are added to the next available Support Packagecontaining the fix.

2012-08-169

Planning

2.4 Patch installation limitations and restrictions

The following limitations and restrictions apply to Patch installation: Patches are maintenance installations, not complete product installations. An SAP BusinessObjects

product must be installed in order to install a Patch. A Patch only updates files that are already installed. For example, if you previously performed a

custom installation, the Patch will only update the subset of files that were installed during the original,custom installation.

Patches can only be installed in their entirety. You cannot install a subset of Patch updates. It is required that all components in a SAP BusinessObjects system be at the same maintenance

level. For example, SAP BusinessObjects server, client, and web components must be at the samemaintenance level. If you update one component of your SAP BusinessObjects system, you mustalso update the other components. If you uninstall a Patch for one component in your system, youmust uninstall the same Patch for the other components.

If you install a new SAPBusinessObjects product or component to your system after Patch installation,you must re-apply the Patch to the machine where you installed the new product or component toensure that all SAP BusinessObjects products and components are at the same Patch level.

Patches are designed for a specific maintenance package level. For example, a Patch designed forSupport Package 2 cannot be installed if your system is at only the Support Package 1 level. Youmust upgrade to the Support Package 2 level before installing that Patch.

Patches designed for the same Support Package level are cumulative. Therefore, it is unnecessaryto install an earlier Patch from a particular Support Package level on top of a later Patch at that samelevel.

The Patch installation program can automatically redeploy web application components to the webapplication server only if the bundled Tomcat web server was used, and those components weredeployed automatically at initial installation time. If the web application components were initiallydeployed using the WDeploy tool, you must use WDeploy to redeploy those components afterinstalling the Patch. For more information see "Updating web application components".

If you are performing a silent installation using a response file, you must create the response filewith the setup.exe or install.sh file from the target Patch installation package. Response filesgenerated for a Patch installation are specific to that Patch, and cannot be shared between fullinstallations and update installations, or between Support Package installations and Patch installations.

2.5 Planning your Patch installation

Before applying a Patch to your system the following planning steps are recommended:

Review the Patch Release Notes and Fixed Issues document to determine if defects addressed bythe Patch are relevant to your SAP BusinessObjects installation, and for important issues, limitations,and works-arounds for the Patch release.

2012-08-1610

Planning

Identify all SAP BusinessObjects products and components that require updates.

For the SAP BusinessObjects 4.0 release, Patches are provided for each product that has its owninstaller. Refer to "SAP BusinessObjects Patches" to identify the Patches required for your upgrade. On windows, installed patches can be determined from the Windows Add/Remove Programs

list. On unix, installed patches can be determined by running \modifyorremoveproduct.sh

It is required that all SAP BusinessObjects products and components be at the same support packageand patch level. If you have a distributed installation or you are running multiple SAP BusinessObjectsproducts, ensure that all products and distributed components are updated. This includes BI platformservers, client tools, web components, and other SAP BusinessObjects products such as SAPCrystal Reports and Live Office.

If you have SAP BusinessObjects web application components installed, ensure that you havedefined an update path for these components. The update path depends on how you initially deployedthe web application components. For more information, see "Updating web application components".

Before you begin, review "Patch installation limitations and restrictions". Review "Patch installation scenarios". The scenarios may help you plan your upgrade. Before you begin, gather all required documentation. Depending on your upgrade, additional

documentation such as the SAP BusinessObjects Business Intelligence Platform Installation Guidemay be required.

2.6 Downloading Patches

SAP BusinessObjects Patches are available for download from the SAP Support Portal: http://service.sap.com/patches.

2012-08-1611

Planning

2012-08-1612

Planning

Installation scenarios

This topic describes common Patch installation scenarios that may help you plan your Patch installation.

3.1 Applying Patches to a system with multiple SAP BusinessObjects products

Due to product interdependencies, it is required that all SAP BusinessObjects products be at the samemaintenance level. For example, if you want to apply a patch to SAPCrystal Reports on a systemwhereyou run SAP Crystal Reports, Live Office, and the BI platform, you must apply patches for all threeproducts so that all products are running at the same patch level. In this scenario, you must apply aSAP Crystal Reports patch, a Live Office patch, and an BI platform patch.

3.2 Updating a distributed SAP BusinessObjects Business Intelligence suitedeployment

If you are installing a patch on a distributed BI suite deployment, where servers and components areinstalled across multiple computers, you must first install the patch on the computer where the CentralManagement Server (CMS) is installed.

If your deployment has multiple clusters, the credentials for the first CMS that you upgrade must beused when upgrading the other clusters.

3.3 Updating web application components

How you apply a patch update to BI platform web application components depends on how thecomponents were originally deployed.

One of the following three scenarios apply: If you deployed the BI platformWAR files to the default, bundled Tomcat server using the installation

program, the patch installation program allows you to update them automatically.

2012-08-1613

Installation scenarios

Follow the patch installation program steps in this guide.

If you deployed the BI platform WAR files manually to your web application server, updates mustbe applied manually after installing the patch.

Manual deployment instructions for web application components are found in the SAPBusinessObjects Business Intelligence Platform Web Application Deployment Guide.

If you deployed the BI platform WAR files using the WDeploy tool to your web application server,you can apply updates manually or use the WDeploy tool after installing the patch.

Instructions for the WDeploy tool are found in the SAP BusinessObjects Business IntelligencePlatform Web Application Deployment Guide.

You must first install the patch to obtain the updated WAR files in order to redeploy them manually orusing the WDeploy tool. If you are applying multiple patch updates in a row, install all updates first toobtain a final set of WAR files once that can be redeployed once.

Note:You must update any deployed BI platform WAR files as part of your Patch upgrade. It is required thatall BI suite components, including web applications, be at the same version level.

3.4 Saving web.xml file modifications

When a patch is installed, the web.xml files for SAP BusinessObjects web applications that have beendeployed to a web application server are overwritten. This means that any customizations that you'vemade by changing the web.xml files are lost after applying a Patch update.

If you modified a web.xml file for a web application and do not want to lose your modifications, youmust make the modifications in the BI platform installation directory. OnWindows systems, this directoryis \SAP BusinessObjects Enterprise XI 4.0\warfiles\webapps. On UNIXsystems, this directory is /sap_bobj/enterprise_xi40/warfiles/webapps.Then, after you've applied the patch, rebuild the affected .war files and redeploy the .war files to theweb application server.

2012-08-1614

Installation scenarios

Patch installation on Windows

You must have Administrator privileges on your Windows system to run a SAP BusinessObjects Patchinstallation.

In order to free resources on the machine on which you are installing this patch, it is recommended thatyou use the Central Management Console (CMC) to stop all of the BI platform servers on the machinebefore installing the patch, with the following exceptions: Server Intelligence Agent (SIA) Central Management Server (CMS) Input and Output File Repository Servers (FRS) CMS system database

These services and servers must be running for the installation to proceed.

Note:If you have modified web.xml files for web applications, see "Saving web.xml file modifications" beforeyou apply a patch.

Note:If you are updating a product that contains server components, the installation program prompts youfor information for your deployment's Central Management Server (CMS). This is required to updatecontent that is stored in the CMS database, such as localized strings for server properties.

4.1 To install SAP BusinessObjects Patches for server components on Windows

This procedure is used to install patches that update the SAP BusinessObjects Business Intelligenceplatform server package running on Windows. This package updates BI platform server components.

1. Launch the installation by running setup.exe

2. Choose a language for the installation program to use during the installation process, and click OK.The installation program checks your system to ensure the proper prerequisites are in place

3. Click Next.4. In the "Welcome" dialog box, click Next to proceed.5. In the "License Agreement" dialog box, review the contents of the End User License Agreement,

and click Next to proceed if you agree to the terms.If the patch includes server components, the "CMS" dialog box is displayed.

2012-08-1615

Patch installation on Windows

6. Type the Hostname, Port Number, and Administrator Password for your deployment's CMS, andclick Next to continue.

7. In the "Start Installation" dialog box, click Next to begin the installation.The update will install.

Note:If web applications are updated as part of the patch, depending on the options you chose when youoriginally installed SAP BusinessObjects BI Platform a post installation dialog box may appear withadditional instructions for redeploying your .war files.

8. Click Finish.

4.2 To install SAP BusinessObjects Patches for client components on Windows

This procedure is used to install Patches for SAP BusinessObjects client applications. This includesthe following packages: SAP BusinessObjects Business Intelligence platform Client SAP BusinessObjects Business Intelligence platform Live Office SAP Crystal Reports for Enterprise SAP Crystal Reports 2011 SAP Crystal Presentation Design SAP BusinessObjects Dashboard Design

1. Launch the installation by running setup.exe

2. Choose a language for the installation program to use during the installation process, and click OK.The installation program will perform a check to ensure the required prerequisites are in place.

3. Click Next.4. In the "Welcome" dialog box, click Next.5. In the "License Agreement" dialog box, review the contents of the End User License Agreement,

and click Next to proceed if you agree to the terms.6. In the "Start Installation" dialog box, click Next to begin the installation.

The "Installation Progress" dialog box appears.

4.3 Silent installation on Windows

2012-08-1616

Patch installation on Windows

4.3.1 To run a silent installation using a response file on Windows

Patches can be installed silently using a response file.

Silent installation is particularly useful when you need to quickly performmultiple installations or automateinstallations.

To run a silent installation using a response file you must first create a .ini file using the installationprogram. Once you have created the .ini file, you can run a silent installation by running the setup.exe command and specifying the path to the .ini file.

Note:

If you are performing a silent installation using a response file, you must create the response filewith the setup.exe or install.sh file from the target Support Package or Patch installationpackage. Response files cannot be shared between refresh installations,update installations, SupportPackage installations or Patch installations.

When creating a response file with the GUI installation program, passwords entered via the GUI arenot written to the response file: Replace the starred entries (********) with your passwords beforeperforming a silent installation.

1. Create an installation .ini file (a response file).

a. Open a command line console.b. From the directory that contains the SAP BusinessObjects setup.exe file, run the setup.exe

command with the write option (-w) specified:

setup.exe -w

where filename.ini is the name you have given to the response file and responsefilepathis the location where you want the file created.

Note:If a file path is not specified, the file is stored in the directory that setup.exe is run from. Theinstallation program must have write permissions on this directory.

c. Press Enter to launch the installation program.d. Follow the on-screen instructions to enter your preferred installation settings until you reach the

Start installation dialog box.e. Click Cancel to abort the installation setup.

All parameters from the installation program, both user defined and default, are recorded in the.ini file which is saved to the directory you specified.

2. You can now run a response file installation using the .ini file by issuing setup.exe commandwith the read option specified (-r):

Log files for the install are stored at \InstallData\logs.

2012-08-1617

Patch installation on Windows

4.3.2 Silent installation parameters on Windows

The following table lists parameters that are used for response file silent installation on Windows. It isrecommended that you create response files using the SAP BusinessObjects setup program (setup.exe) as described in "To run a silent installation using a response file on Windows".

DescriptionParameter

Specifies the name of the Central Management Server (CMS)

remoteCMSname=""

RemoteCMSname

Specifies the port used by the CMS

remotecmsport="6400"

remotecmsport

Must specifie the "administrator" account for the CMS.remotecmsadmin-name

Specifies the password for the Administrator account for the CMS.

remotecmspassword=""

remotecmspass-word

4.4 Uninstalling SAP BusinessObjects Patches on Windows

Patches can only be uninstalled one at a time, in the reverse order of installation. When uninstallingPatches, ensure that all of the products in your deployment are at the same version before using thesystem.

4.4.1 To uninstall SAP BusinessObjects Patches on Windows

1. In Windows, click Start, point to Settings, and then select Control Panel.2. Double-click Add or Remove Programs.3. Highlight the Patch entry in the list of programs and click Change/Remove.

The "Application Maintenance" dialog box appears.

2012-08-1618

Patch installation on Windows

4. Select Remove and click Yes.5. Wait while the appropriate files are removed and the necessary configuration is carried out. Click

Finish.

2012-08-1619

Patch installation on Windows

2012-08-1620

Patch installation on Windows

Patch installation on UNIX

In order to free resources on the machine on which you are installing this patch, it is recommended thatyou use the Central Management Console (CMC) to stop all of the BI platform servers on the machinebefore installing the patch, with the following exceptions: Server Intelligence Agent (SIA) Central Management Server (CMS) Input and Output File Repository Servers (FRS) CMS system database

These services and servers must be running for the installation to proceed.

Note:If you have modified web.xml files for web applications, see "Saving web.xml file modifications" beforeyou apply a Patch.

Note:If you are updating server components, the installation program prompts you for information for yourdeployment's Central Management Server (CMS). This is required to update content that is stored inthe CMS database, such as localized strings for server properties.

5.1 To install the SAP BusinessObjects patch on UNIX

1. Launch the installation by running the following command from the patch installation source filelocation:setup.sh InstallDir=

where is the installation directory of your SAP BusinessObjects product.

2. Select the language you want the installation program to run in and press Enter.A dialog box appears that shows the installation directory you have specified.

3. Verify the installation directory and press Enter to start the installation.The installation program will check to ensure the required prerequisites are in place.

4. Press Enter to continue.A Welcome screen will be displayed.

5. Press Enter to continue.

2012-08-1621

Patch installation on UNIX

The license agreement will be displayed.

6. Review the content of the License agreement and press Enter to agree and proceed.If the patch includes server components, you will be prompted for your CMS credentials.

7. Enter your CMS credentials and press Enter to start the installation.The progress indicator displays the status of the installation.

Note:If web applications are updated as part of the patch, depending on the options you chose when youoriginally installed SAP BusinessObjects BI Platform a post installation screen may appear withadditional instructions for redeploying your .war files.

8. Press Enter to complete the installation.To review details of the installation, you can view the contents of the installation log file located in/InstallData/logs/

5.2 Silent installation on UNIX

5.2.1 To run a silent installation using a response file on UNIX

Patches can be installed silently using a response file.

Silent installation is particularly useful when you need to quickly performmultiple installations or automateinstallations.

To run a silent installation using a response file you must first create a response file.

The following steps describe how to create a response file using the SAP BusinessObjects installationprogram. Once you have created the response file, you can run a silent installation by running the./setup.sh command and specifying the path to the response file.

Note:

If you are performing a silent installation using a response file, you must create the response filewith the setup.exe or setup.sh file from the target support package or patch installation package.Response files cannot be shared between support package installations and patch installations.

When creating a response file with the GUI installation program, passwords entered via the GUI arenot written to the response file: Replace the starred entries (********) with your passwords beforeperforming a silent installation.

1. Create a response file.

2012-08-1622

Patch installation on UNIX

From the patch installation source file location, run the .setup.sh command with the writeoption (-w) specified:

./setup.sh installDir= -w

a.

where is the SAP BusinessObjects installation directory and is the path and file name for the response file you are creating.

b. Press Enter to launch the installation program.c. Follow the on-screen instructions to enter your preferred installation settings until you reach the

Start installation dialog box of the setup program, the press Enter.The settings are recorded in the response file.

2. You can now run a response file installation by issuing ./setup.sh command with the -r optionspecified:

./setup.sh InstallDir= -r

where is the path and name of the response file youcreated.

3. Press Enter to launch the installation.

5.2.2 Silent installation parameters on UNIX

The following table lists parameters that are commonly used for response file silent installation on UNIX.It is recommended that you create a response files using ./setup.sh and the -w parameter, asdescribed in "To run a silent installation using a response file on UNIX".

DescriptionParameter

Specifies the name of the Central Management Server (CMS)

remoteCMSname=""

RemoteCMSname

2012-08-1623

Patch installation on UNIX

DescriptionParameter

Specifies the port used by the CMS

remotecmsport="6400"

remotecmsport

Specifies the administrator account for the CMS.remotecmsadmin-name

Specifies the password for the Administrator account for the CMS.

remotecmspassword=""

remotecmspass-word

5.3 To uninstall SAP BusinessObjects Patches on UNIX

1. To uninstall a patch, execute the following command from the root directory of your SAPBusinessObjects installation:

./modfiyOrRemoveProducts.sh

The "Add or Remove Programs" dialog box is displayed.

2. Select the SAP BusinessObjects patch you want to remove and press Enter.You will be prompted for your Central Management Server credentials.

3. Enter your CMS credentials and press Enter.4. Select Uninstall Product and press Enter.

A confirmation dialog box is displayed.

5. Select Yes and press Enter.The uninstallation process begins.

2012-08-1624

Patch installation on UNIX

SAP BusinessObjects Patch Update GuideContentsInstallationAbout this DocumentPurposeConstraintsVariables

PlanningSAP BusinessObjects PatchesPatch platform supportPatch language supportPatch installation limitations and restrictionsPlanning your Patch installationDownloading Patches

Installation scenariosApplying Patches to a system with multiple SAP BusinessObjects productsUpdating a distributed SAP BusinessObjects Business Intelligence suite deploymentUpdating web application componentsSaving web.xml file modifications

Patch installation on WindowsTo install SAP BusinessObjects Patches for server components on WindowsTo install SAP BusinessObjects Patches for client components on WindowsSilent installation on WindowsTo run a silent installation using a response file on WindowsSilent installation parameters on Windows

Uninstalling SAP BusinessObjects Patches on WindowsTo uninstall SAP BusinessObjects Patches on Windows

Patch installation on UNIXTo install the SAP BusinessObjects patch on UNIXSilent installation on UNIXTo run a silent installation using a response file on UNIXSilent installation parameters on UNIX

To uninstall SAP BusinessObjects Patches on UNIX