Installation Guide

SAP ERP 6.0 Enhancement Package 4

Using SAINT / JSPM

Target Audience
n System Administrators
n Technology Consultant

PUBLIC
Document version: 1.1 ‒ 04/30/2009
Document History

Caution
Before you start the implementation, make sure you have the latest version of this document. You
can find the latest version at the following location: http://service.sap.com/instguides.

The following table provides an overview of the most important document changes.
Version Date Description

1.0 11/21/2008 First version.

1.1 4/30/2009 Updates of About this Document and of SAP Solution Manager Support Package level

2/32 PUBLIC 04/30/2009

Table of Contents

Chapter 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . 5
1.1 About this Document . . . . . . . . . . . . . . . . . . . . . 5
1.2 Before You Start . . . . . . . . . . . . . . . . . . . . . . . 6
1.2.1 SAP Notes . . . . . . . . . . . . . . . . . . . . . . . . . 6

Chapter 2 Planning . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.1 Installation Process Overview . . . . . . . . . . . . . . . . . . 9
2.2 Identifying the Software Components . . . . . . . . . . . . . . . 9
2.3 Planning the Installation Strategy . . . . . . . . . . . . . . . . 9
2.4 Support Package Requirements . . . . . . . . . . . . . . . . . 10

Chapter 3 Preparation . . . . . . . . . . . . . . . . . . . . . . . . 13
3.1 Preparing the SAP ERP System . . . . . . . . . . . . . . . . . 13
3.2 Preparing the SAP Solution Manager System . . . . . . . . . . . . 13
3.3 Updating ABAP Installation Tools and SAP Kernel . . . . . . . . . . 13
3.4 Preparing the Java Support Package Manager . . . . . . . . . . . . 14
3.5 Downloading Enhancement Packages . . . . . . . . . . . . . . . 15

Chapter 4 Installation . . . . . . . . . . . . . . . . . . . . . . . . 19
4.1 Installing ABAP Components . . . . . . . . . . . . . . . . . . 19
4.2 Installing Java Components and Portal Content . . . . . . . . . . . 20
4.3 Importing Process Integration Content . . . . . . . . . . . . . . 25
4.4 Updating the BI Content Add-On . . . . . . . . . . . . . . . . 25

Chapter 5 Follow-Up Activities . . . . . . . . . . . . . . . . . . . . 27

5.1 Activating Business Functions . . . . . . . . . . . . . . . . . . 27

04/30/2009 PUBLIC 3/32

4/32 PUBLIC 04/30/2009
1 Introduction

1 Introduction

1.1 About this Document

This document describes the installation of enhancement package 4 on an existing SAP ERP 6.0 system.
The information in this document is intended for SAP system administrators with operating system,
database, and SAP NetWeaver Application Server knowledge.
The installation procedure described in this document focusses on the SAP Add-On Installation Tool
(transaction SAINT) and the Java Support Package Manager (JSPM). However, the standard tool for
installing enhancement package 4 is the SAP Enhancement Package Installer (SAPehpi). Exceptions
from this standard are only allowed if one of the following cases apply:
n Your SAP ERP 6.0 system runs on a 32 bit machine
As SAPehpi is not available for 32 bit systems, you have to use SAINT and JSPM.

Note
With SAP Add-On Installation Tool (transaction SAINT) it is not possible to install enhancement
package 4 in one step on an SAP ERP 6.0 ABAP system. You first have to install enhancement
package 3 and then update to enhancement package 4.

n You want to update your Java applications with enhancement package 4 without updating the
underlying SAP NetWeaver Application Server Java from SAP NetWeaver 7.0 to enhancement
package 1 for SAP NetWeaver 7.0.
This requires that you install the Java part of enhancement package 4 using the Java Support
Package Manager (regardless whether your system runs on a 32 bit or 64 bit hardware).
In all other cases, use the SAP Enhancement Package Installer. Using this tool shortens the downtime
during the enhancement package installation significantly. It benefits from a repository cloning and
switch procedure, where an additional application server instance is installed temporarily and used to
install the enhancement package in parallel to production operation. SAPehpi is available for 64bit
machines only. For more information, see the document Installation Guide ‒ SAP Enhancement Package
Installation on SAP Service Marketplace at http://service.sap.com/erp-inst SAP ERP 6.0 SAP
enhancement packages for SAP ERP 6.0 SAP enhancement package 4 for SAP ERP 6.0 .

Integration
For general information about enhancement packages for SAP ERP, for example, the enhancement
package concept, realized business functions and processes, see the corresponding Master Guide. The

04/30/2009 PUBLIC 5/32

1 Introduction
1.2 Before You Start

Master Guide is available in SAP Service Marketplace at http://service.sap.com/erp-inst SAP

ERP 6.0 SAP enhancement packages for SAP ERP 6.0 .

1.2 Before You Start

1.2.1 SAP Notes

This documentation is complemented by a range of SAP Notes. You must read at least the central
SAP Notes before you start with the enhancement package installation. Since these SAP Notes are
updated regularly, make sure that you always use the newest version which are available in SAP
Service Marketplace at http://service.sap.com/notes.

Central SAP Notes

SAP Note Number Title

1165438 SAP enhancement package 4 for SAP ERP 6.0 -
required SWC
1143022 Installation of Enhancement Package 4 on SAP ERP 6.0
1160106 Enhancement package 4 for SAP ERP: Installing JAVA
1165437 Enhancement package 4 for SAP ERP: Required
Support Packages
1064635 SAP ERP Enhancement Packages: SP Stacks Release
Info Note
1117309 Compatibility of AddOns vs enhancement packages
for ERP 6.0

Related SAP Notes

SAP Note Number Title

1118861 Implementing IS-OIL 603
328181 Changes to extract structures in Customizing Cockpit
822380 Problems w/ add-on inst/upgrade to SAP NW 7.0 AS
ABAP
836200 SAP NetWeaver 7.0: Importing Process Integration
Content
955647 BI_CONT 703:Information on Add-On Support
Packages

6/32 PUBLIC 04/30/2009

1 Introduction
1.2 Before You Start

SAP Note Number Title

1118803 ECC 600 Support Packages and ERP enhancement
packages
1122966 Maintenance Optimizer: Notes for Enhancement
Packages
1137683 Maintenance Optimizer: Notes for Software Lifecycle
Manager
1080821 Deploying patches with JSPM stack option
1124030 JSPM fails parsing stack definition file
917612 Table WEB_FILES-WEB not activated
891983 JSPM: Central SAP Note SAP NetWeaver 2004s AS Java
870445 SAPJup J2EE Engine Password Does Not Change After
an Upgrade

04/30/2009 PUBLIC 7/32

This page is left blank for documents
that are printed on both sides.
2 Planning

2 Planning

2.1 Installation Process Overview

Process
1. You map the business functions to the technical usages.
2. You prepare the SAP system and update SAP Solution Manager and the installation tools, if
required.
3. You select and download the required components and Support Packages using the maintenance
optimizer.
4. You use the SAP Add-On Installation Tool (transaction SAINT) and the Java Support Package
Manager (JSPM) to install the components and Support Packages.
5. You activate the desired business function.

2.2 Identifying the Software Components

Before you start with the installation, you have to identify which are the software units that you
need to install to realize a specific business function. To facilitate the installation, the software
units ‒ ABAP software components, Java software components, XI Content, and Portal Content ‒
have been grouped to technical usages. You only have to select the appropriate technical usage in
the maintenance optimizer of SAP Solution Manager, which will then download all required files
from SAP Service Marketplace.
To identify which technical usage you require, see the attachment of SAP Note 1165438.
If add-ons are installed on your SAP ERP 6.0 system, check in SAP Note 1117309 whether they are
compatible with SAP enhancement package that you want to install.

2.3 Planning the Installation Strategy

When you plan your enhancement package installation, consider the following points:
n You can not uninstall an enhancement package.
n If you have already installed a previous enhancement package, you have to update all components
of this previous version. It is not supported to have a combination of different enhancement
package versions.

04/30/2009 PUBLIC 9/32

2 Planning
2.4 Support Package Requirements

n Combine the enhancement package installation with the implementation of Support Package
stacks. You can install the enhancement package and Support Packages using a single queue
in transaction SAINT and in the Java Support Package Manager. This minimizes the effort (for
example, regarding the potential modification adjustment) since you install the enhancement
package as part of your normal maintenance processes.
As the installation of an enhancement package requires a specific Support Package level on the
SAP system, you can also include all those required Support Packages into the implementation
queue. You do not have to implement the Support Packages in a separate step before you start
with the enhancement package installation.

2.4 Support Package Requirements

The enhancement package that you want to install requires a specific Support Package level in
your system. The Maintenance Optimizer automatically calculates all Support Packages that are a
prerequisite for the enhancement package installation and includes them in the installation queue.
Of course, you can also include a higher Support Package level in the installation queue.

Recommendation
In general, we recommend to install enhancement packages together with the required Support
Packages in one maintenance process. This minimizes the effort, since you do not need to import the
Support Packages in a separate step before you start with the enhancement package installation

In addition, you have to consider all other components in your system that are not updated by the
enhancement package. We recommend to update them to the equivalent Support Package stack level.
Equivalent here means the Support Package stack level which corresponds to the Support Package
level included in the enhancement package. An enhancement package includes all corrections
of a specific Support Package level for the comprised components. As an enhancement package
only updates parts of the system, other parts would remain on a lower Support Package level. We
recommend to avoid such an inconsistent state of Support Package levels in your system by importing
the equivalent Support Package stack for all components.

Note
You may not be able to integrate a Support Package because the import conditions are not met. This
can occur if you have already installed an enhancement package and thus increased the component
version of a component. The Support Package still demands the previous component versions as
a prerequisite, the increased component version is not defined as valid. To solve this, you have to
update the import conditions as described in SAP Note 1118803.

10/32 PUBLIC 04/30/2009

2 Planning
2.4 Support Package Requirements

For information about the Support Package requirements of the ERP system, see SAP Note 1165437
and for the equivalent Support Package level, see SAP Note 1064635.
For information about the Support Package level requirements of additional systems or components
(for example, the BI Content Add-On or the Business Client), see SAP Note 1165437.

04/30/2009 PUBLIC 11/32

This page is left blank for documents
that are printed on both sides.
3 Preparation

3 Preparation

3.1 Preparing the SAP ERP System

Before you start the enhancement package installation, perform the following actions in your SAP
ERP system:
n Process your V3 update entries
If changes are introduced into the interface structures of the V3 update modules by the
enhancement package, you may no longer be able to update these update entries.
n Process your entries in the extraction queues
If changes are introduced into the interface structures of the qRFC function modules by the
enhancement package, you may no longer be able to update these entries.
n Delete your entries in the reconstruction tables for the logistics extraction applications
If changes to the extraction structures are introduced by the enhancement package, you may no
longer be able to use these entries.

Procedure
For information about the required actions, see SAP Note 328181.

3.2 Preparing the SAP Solution Manager System

1. Make sure that you have installed at least SAP Solution Manager 7.0 Support Package 15.
2. Update the Solution Manager Content to at least ST-ICO 150 Support Package 15.
3. Implement the SAP Notes listed in SAP Note 1122966.
4. If you want to use the software lifecycle management capabilities of SAP NetWeaver in the
maintenance optimizer, see SAP Note 1137683.
See also the documentation in the SAP Library at http://help.sap.com/nw70 SAP NetWeaver
7.0 Library <Language> SAP NetWeaver by Key Capability Solution Life Cycle Management by Key
Capability Software Life Cycle Management Software Lifecycle Manager Working with the SLM
Installing Live Update .

3.3 Updating ABAP Installation Tools and SAP Kernel

1. Make sure that you have installed at least SPAM/SAINT version 029.

04/30/2009 PUBLIC 13/32

3 Preparation
3.4 Preparing the Java Support Package Manager

We recommend to always import the latest version of the SPAM/SAINT update before you import
installation packages.
For more information, see also SAP Note 822380.
2. Update the SAP kernel to SAP kernel 7.01.

3.4 Preparing the Java Support Package Manager

1. Make sure the following requirements are met prior to the enhancement package installation:
n You have familiarized yourself with SAP Note 891983 before you start the Java Support Package
Manager.
n The system to be updated is fully functional.
n The SAP NetWeaver Application Server Java (AS Java) and the database have been backed up.
n You have not deleted, renamed, or created any directories and files in the following directories
and their subdirectories: /usr/sap/<SAPSID>/SYS/exe and /usr/sap/<SAPSID>/SYS/profile.
Otherwise, JSPM cannot detect the kernel and the system profiles, and cannot be started.
If a backup of the kernel and the system profiles has been required, it has been created in a
different directory.
n The <sapsid>adm user has Read permissions for the global EPS inbox directory
/usr/sap/trans/EPS/in.
n If your database is SAP MaxDB, the overwrite mode for the log area has been activated.
n The database and the SDM repository have been synchronized.
For more information, see the SAP Library documentation for JSPM available at
http://help.sap.com/nw70 SAP NetWeaver 7.0 Library <Language> SAP NetWeaver Library
Administrator’s Guide Technical Operations Manual for SAP NetWeaver Administration of SAP NetWeaver
Systems AS Java (Application Server for Java) Software Logistics Software Maintenance Java Support
Package Manager . Then choose Troubleshooting JSPM Does Not Update the Versions of the Deployed
Components .
n There is enough disk space.
For more information, see section Requirements for Free Disk Space in the SAP Library
documentation for JSPM (see the navigation path above).
n Your current SAPCAR tool is able to extract the Support Packages for the SAP kernel and
other OS level binaries delivered as SAR files.

Recommendation
You can download the latest version of SAPCAR from SAP Service Marketplace at
http://service.sap.com/patches Entry by Application Group Additional Components
SAPCAR .
Put the downloaded version in the same directory in the JSPM inbox, in which the kernel SAR
files reside, so that JSPM can use this version for extracting the SAR files.

14/32 PUBLIC 04/30/2009

3 Preparation
3.5 Downloading Enhancement Packages

2. To prevent the Software Deployment Manager (SDM) from temporarily exceeding the available
disk space during the update process, you can change the file transfer directory of SDM in a system
of SPS09 or higher using the following command sequence:
Only valid for: Windows

n cd <sdm_home>

n StopServer.bat
n sdm.bat jstartup "mode=standalone"
n sdm.bat filetransferdir "dir=<new_dir>"

n sdm.bat jstartup "mode=integrated"

n StartServer.bat
End of: Windows

Only valid for: IBM i5/OS;UNIX

n cd <sdm_home>

n StopServer.sh
n sdm.sh jstartup mode=standalone
n sdm.sh filetransferdir dir=<new_dir>

n sdm.sh jstartup mode=integrated

n StartServer.sh
End of: IBM i5/OS;UNIX

3. To prevent deployment errors during the enhancement package installation process, proceed
as follows:
a) Log on to the Central Instance host.
b) Start the ConfigTool and in the navigation area choose Cluster-data Global server configuration
Managers ServiceManager .
c) In the Global properties panel, set the Custom value of the EventTimeout property to 120.
d) Choose Save.
e) Restart the Central Instance.
4. Make sure that the J2EE administrator password stored in the secure store for offline usage
is identical with the one stored in the User Management Engine (UME). You can change the
password in the secure store as described in SAP Note 870445.

3.5 Downloading Enhancement Packages

To download SAP Enhancement Packages, you use the Maintenance Optimizer in SAP Solution
Manager. The maintenance optimizer supports you in selecting and downloading all required
enhancement package files and Support Packages.
In addition, the maintenance optimizer generates an enhancement package stack configuration
file. This file is accessed by the software logistics tools for installation and upgrade using an RFC

04/30/2009 PUBLIC 15/32

3 Preparation
3.5 Downloading Enhancement Packages

connection. The tools then use this information for installing the enhancement package files and
Support Package stacks.

Prerequisites
n You have identified which technical usages you want to implement. For more information, see the
corresponding Master Guide and SAP Note 1165438.
n You have configured the maintenance optimizer in SAP Solution Manager as described on SAP
Help Portal at http://help.sap.com SAP Solutions SAP Solution Manager SAP Solution Manager
<Release> <Language> Change Management Maintenance Optimizer Planning and Monitoring Product
Maintenance and also in section Automatically Calculating Product Maintenance Files.

Procedure
1. Start SAP Solution Manager using the transaction solution_manager. To start the maintenance
optimizer, choose Operations Change Management Maintenance Optimizer .
2. In the maintenance optimizer, choose the solution for which you want to download enhancement
package files.
3. Choose Create New Maintenance Transaction.
4. Select the product version, for which you want to install the enhancement package.
The maintenance optimizer displays all the systems assigned to the product version.
5. Set the flag for the systems for which you want to install the enhancement package and choose
Continue.
6. On the following screen, choose Enhancement Package Installation and then Find Download Files.
The maintenance optimizer displays all installable product versions (enhancement packages)
with corresponding technical usages.
7. Select the product version and target Support Package stack.
8. Select the technical usage that you want to update with the enhancement package.
9. Choose Find Download Files for the Stack Version.
The Maintenance Optimizer displays the product maintenance files in three successive lists.
10. Select the required files from the displayed lists:
n The first list shows all files that depend on the type of your operating system or database system.
Select the files that correspond to the combination of your operating system and database
and the database-independent files.
n You get to the second list by choosing Continue. This list displays all Support Package files that
are not assigned to the selected Support Package Stack. You must check whether the Support
Packages are suitable for your product maintenance procedure.
Remove the download indicator from the files for the following components:
l Components for which you do not want to download Support Packages,
l Components that you do not want to include in the installation
n The third list displays all product maintenance files that are part of the selected Support
Package Stack.

16/32 PUBLIC 04/30/2009

3 Preparation
3.5 Downloading Enhancement Packages

Select all files that are assigned to the selected Support Package Stack unless you have already
downloaded them. Files that are not selected will not be included later in the download.
11. To download the files, select whether you want to download them with the Software Lifecycle
Manager (SLM) or with the Download Basket, and then choose Select Download Type.
12. Choose Continue and then Confirm File in Download Basket.
A dialog window opens and displays all files.
13. Confirm the download.
Only valid for: IBM i5/OS;UNIX

14. Open your Download Manager and download the files to the EPS inbox directory
(/usr/sap/trans/EPS/in).
End of: IBM i5/OS;UNIX

Only valid for: Windows

Open your Download Manager and download the files to the EPS inbox directory
(<Drive>:\usr\sap\trans\EPS\in).
End of: Windows

04/30/2009 PUBLIC 17/32

This page is left blank for documents
that are printed on both sides.
4 Installation

4 Installation

4.1 Installing ABAP Components

To install the ABAP components of the enhancement package, you use the SAP Add-On installation
Tool (transaction SAINT).
Below, the installation procedure is outlined. The description assumes that your system is configured
in a Solution Manager landscape. For a detailed description, see the SAP NetWeaver Library at
http://help.sap.com/nw70 SAP NetWeaver 7.0 Library <Language> SAP NetWeaver by Key
Capability Solution Life Cycle Management by Key Capability Software Life Cycle Management Software
Maintenance Add-On Installation Tool .

Procedure
1. Unpack and load the installation packages.
a) Log on to the system in client 000 using the following user:
n UNIX: <sid>adm
n IBM i5/OS: <SID>OFR
n Windows:<SID>adm
b) Switch to the transport directory:
n UNIX and IBM i5/OS: /usr/sap/trans
n Windows: <DRIVE>:\usr\sap\trans
c) Unpack the archive containing the packages with the following command:
n UNIX: SAPCAR -xvf /<download directory>/<PATH>/<ARCHIVE>.CAR
n IBM i5/OS: SAPCAR ’-xvf /QOPT/<download directory>/<PATH>/<ARCHIVE>.CAR
n Windows: SAPCAR -xvf <download directory>:\<PATH>\<ARCHIVE>
The unpacked packages are automatically displayed in the EPS inbox in the transport directory.
d) Call transaction SAINT and choose Installation Package Load Packages From Application Server .
The list of uploaded packages is displayed.
e) Choose Back to return to the initial screen of the Add-On installation tool.
2. We recommend to use five parallel R3trans processes for the import. To define the number of
parallel R3trans processes, choose Extras Settings Import Queue tab .
3. To start the installation process, choose Start on the initial screen of the Add-On installation tool.
4. Choose Stack Configuration. A dialog box opens, providing a list of configurations in maintenance
optimizer that are available for your system.
5. Choose the required configuration and confirm your choice by choosing Continue.

04/30/2009 PUBLIC 19/32

4 Installation
4.2 Installing Java Components and Portal Content

6. In the Add On Selection dialog box, the packages for the selected configuration are listed. Check
the selection and confirm by pressing Continue.
You have to enter a password for each component. The passwords are available in SAP Note 1143022.
The system calculates the complete installation queue including any Support Packages.
7. Decide whether to include a modification adjustment transports in the installation queue.
8. Choose between the conventional import mode and the downtime-minimized import mode.
9. If you have modified SAP objects but have not included any adjustment transports, or if the
included adjustment transports do not cover all objects that need adjusting, the Add-On
Installation Tool prompts you to perform a modification adjustment during one of the subsequent
phases. For the modification adjustment, you use transactions SPAU and SPDD. For a detailed
description, see the SAP NetWeaver Library at http://help.sap.com/nw70 SAP NetWeaver 7.0
Library <Language> SAP NetWeaver by Key Capability Solution Life Cycle Management by Key Capability
Software Life Cycle Management Software Maintenance Add-On Installation Tool Adjusting Modifications.
10. To complete the installation process, choose Continue. In the subsequent installation phases,
program code and program texts that have been made obsolete by the imported objects are
physically deleted from the database. The import process is complete.

4.2 Installing Java Components and Portal Content

To install the Java components of the enhancement package, you use the Java Support Package
Manager (JSPM).
Below, the installation procedure is outlined. The description assumes that your system is configured
in a Solution Manager landscape. For a detailed description, see the SAP NetWeaver Library at
http://help.sap.com/nw70 SAP NetWeaver 7.0 Library <Language> SAP NetWeaver by Key
Capability Solution Life Cycle Management by Key Capability Software Life Cycle Management Software
Maintenance Java Support Package Manager .
JSPM is also used to install Portal Content. If the business function you want to realize requires the
installation of Portal Content, you also can proceed as described below.

1. Log on as user <sapsid>adm to the Central Instance host.

Note
If your operating system is IBM i5/OS, log on as user <SID>ADM or <SID>OFR.

2. Close the SAP Management Console (MMC) and the SDM remote GUI client.
3. For UNIX and Windows: To start the JSPM, navigate to the directory
<INSTDIR>/<SID>/<Central_Instance_Name>/j2ee/JSPM and run the go script
file.

20/32 PUBLIC 04/30/2009

4 Installation
4.2 Installing Java Components and Portal Content

Note
If your system is running on IBM i5/OS, to start the JSPM, proceed as follows:
a) To prevent JSPM from automatically starting its GUI, in the file
/usr/sap/<SID>/<Central_Instance_Name>/j2ee/JSPM/param/jspm_config.txt, change
the property /dialog/SDTServerConnection/SDTGui/launch from true to false.
b) On the IBM i5/OS host, run the go script file using the following command:
QSH CMD(’/usr/sap/<SID>/<Central_Instance_Name>/j2ee/JSPM/go’).
c) In the mounted directory /usr/sap/<SID>/<Central_Instance_Name>/j2ee/JSPM, run the
StartGui script file. The JSPM GUI appears.
d) In the Host field, enter the target IBM i5/OS host.

Note
Depending on the system type, <Central_Instance_Name> has the following syntax:
n Standalone Java system: JC<instance_no>
n Add-On system: DVEBMGS<instance_no>

4. Enter your SDM password to log on to the SDM.

5. On the Deployment tab page:
n If your Java Support Package Manager has a Support Package Stack level of 16 or higher, select
the Java Support Package Manager option and update the sap.com/JSPM software component to
the target SPS level.
n If your Java Support Package Manager has a Support Package Stack level of 15 or lower, select the
Business Packages option and update the sap.com/JSPM software component to the target SPS level.

Note
If your Java Support Package Manager has a Support Package Stack level lower than 11, see SAP
Note 1124030.
6. Restart the JSPM and log on with the SDM password.

Recommendation
We strongly recommend that you use the Support and Enhancement Package Stack option when
applying an enhancement package. This option uses the stack configuration file provided by the
maintenance optimizer. The Business and Enhancement Package Installation option is not able to process
the stack configuration file.

04/30/2009 PUBLIC 21/32

4 Installation
4.2 Installing Java Components and Portal Content

Note
You may get a warning telling you that there are patches installed in your system containing fixes,
which might not be included in the target SP Stack. This is possible if you applied patches of the
start SP Stack level that have been delivered later than the target SP Stack delivery date. In order
not to lose these fixes, consider applying the latest patches of the target SP Stack level.
If you need to include the latest patches for a particular component during the update process
with the Support and Enhancement Package Stack option, stop the JSPM after restart and apply SAP Note
1080821. Then start the JSPM again.

7. On the Deployment tab page, select the Support and Enhancement Package Stack option and choose Next.
The enhancement package components and the Support Package stacks that are available for
deployment in the global EPS inbox directory are displayed.
If your system is used for NWDI development and it is either a DEV or a CONS system, and if JSPM
has found any software components in the global EPS inbox directory, these components will be
displayed here so that you can select them for deployment.
8. Select the enhancement package components and Support Package Stack level from the dropdown
box and choose Next.
In this step, JSPM performs various status validations and displays the result of each software
component included in the stack definition XML file on the subsequent screen, which includes
the following possible states:
n OK: Indicates that the SPS level of the corresponding software component is applicable.
n WARNING: Indicates that the corresponding software component comprises custom
modifications in an NWDI-controlled system.
We recommend that you view the details about the component by choosing Show Details:
l If your system is used for NWDI development and it is either a DEV or a CONS system,
you will be informed that JSPM will not deploy the modified software components but
only transport them to the CMS transport directory. JSPM will deploy only the software
components that are not modified.
l If your system is not used for NWDI development, or if your system is used for NWDI
development and it is either a TEST or a PROD system, you will be informed that JSPM has
found newer versions of modified software components and will automatically replace the
original versions with the newer versions. JSPM will deploy all software components that
are not modified together with the replaced versions of the modified software components.
n REVISE: Indicates inconsistencies with the corresponding software component.
The deployment cannot be performed until all problems have been resolved. You can view the
problems by choosing Show Details.
9. If the status of the selected enhancement package and Support Package Stack is OK or WARNING,
choose Start to start the system update. JSPM changes the status to scheduled.
If the SP Stack to be applied includes a kernel update and the current kernel is not already of the
corresponding patch level, JSPM arranges the kernel update as the very first Support Package to be

22/32 PUBLIC 04/30/2009

4 Installation
4.2 Installing Java Components and Portal Content

applied. JSPM updates the kernel binaries of all instances (including Dialog Instances and SCS
instances in a HA environment) whose kernel directories DIR_CT_RUN effectively reside on the host
indicated by the profile parameter SAPGLOBALHOST.

Caution
Kernel binaries of instances, whose kernel directories DIR_CT_RUN are not effectively linked to
the host SAPGLOBALHOST, must be updated individually as described in section Manually Updating
Instances with Kernel Directory Located on Separate Hosts below.

The kernel update (includes update of SAP Kernel and SAP IGS) using JSPM consists of the
following steps:
a) JSPM stops the Central Instance automatically and request you to manually stop all SCS and
Dialog Instances in a dialog box.
b) After you have stopped all the instances, choose the Next button in the dialog box.
The kernel update starts.

Note
If the system is running in a high availability environment, make sure that the HA software
does not restart the instance automatically during the update.

Note
If kernel binaries of the SCS instance must be updated individually, you must perform this
manually at the time when JSPM is updating the kernel binaries of the Central Instance. In
any case, the SCS kernel must be up-to-date before the next restart.

When the kernel update is finished, a dialog box appears in which you are prompted to restart
the SCS instance manually.
Only valid for: UNIX

c) On UNIX platforms, you must adjust the ownership and permissions of the kernel binaries
before you can proceed with the next step. For more information, see Adjusting the Ownership and
Permissions of Kernel Binaries on UNIX Platforms below.
End of: UNIX

d) Choose Next in the dialog box when the SCS instance is running again.
After the kernel update, JSPM restarts the system for further deployment of the remaining
Support Packages of the stack.

Recommendation
If you must update the kernel binaries of any Dialog Instances, perform the update when JSPM is
updating the remaining Support Packages of the stack in order to save time.

04/30/2009 PUBLIC 23/32

4 Installation
4.2 Installing Java Components and Portal Content

The deployment of the enhancement package components and Support Packages can end with
one of the following statuses:
n DEPLOYED
The enhancement package component or Support Package has been successfully deployed.
n DEPLOYED WITH WARNING
The enhancement package component or Support Package has been deployed but it possibly
may not work properly with other deployed components.
You can view the details by choosing Show Details or examining the log files. You can also view
the details about the component by choosing the Deployed Components tab page.
n ERROR
An error has occurred during the deployment. You can view the details by choosing Show
Details or examining the log files.
You must correct the error to be able to continue with the enhancement package installation.
You can proceed as described for a deployment that finished with status DEPLOYED WITH
WARNING.
l If the error correction does not change the contents in the JSPM inbox, you can continue
the deployment by choosing Resume.
l If the error correction changes the contents in the JSPM inbox, you can choose New
Deployment to redeploy the enhancement package components.
n NOT DEPLOYED
JSPM has not attempted to deploy the software component for certain reasons.
l If your system is not used for NWDI development, you can proceed as described for a
deployment that finished with status ERROR.
l If your system is used for NWDI development, and it is either a DEV or a CONS system, the
status of the modified software components is always NOT DEPLOYED. JSPM has transported
the software components of the Support Package Stack, both modified and not modified,
to the CMS transport directory. The deployment of the modified software components is
handled by NWDI.

Adjusting the Ownership and Permissions of Kernel Binaries on UNIX

Platforms
On UNIX platforms, you must adjust the ownership and execution permissions of the kernel binaries
after the update, regardless whether you performed the update manually or by using JSPM, because
both update procedures are performed with the <sapsid>adm user. Enter the following command
sequence:
For IBM DB2 for Linux, UNIX and Windows:
su root
cd <krnl_directory>
./saproot.sh <SAPSID>
exit
For IBM DB2 for z/OS, SAP MaxDB and Oracle:

24/32 PUBLIC 04/30/2009

4 Installation
4.3 Importing Process Integration Content

su - root
cd <krnl_directory>
./saproot.sh <SAPSID>
exit

4.3 Importing Process Integration Content

Some business functions require an update of the Process Integration content (XI content). You have
to import the new content into the Integration Repository of SAP NetWeaver Process Integration.

Procedure
For a detailed description, see SAP Note 836200.

4.4 Updating the BI Content Add-On

Some business functions require the update of the BI Content Add-On. The BI Content Add-On
Support Packages are applied as common Support Packages using the Support Package Manager
(SPAM).

Procedure
For a detailed description, see SAP Note 955647.

04/30/2009 PUBLIC 25/32

This page is left blank for documents
that are printed on both sides.
5 Follow-Up Activities

5 Follow-Up Activities

5.1 Activating Business Functions

To be able to use the new function of the enhancement package, you must activate the relevant
business functions.

Caution
Once you have activated a business functions, you cannot deactivate it.

Procedure
1. Log on to the development system as a user with authorization SAP_ALL.
2. Disable all batch jobs.
3. Close the system for all other users.
4. Call transaction SFW5.
5. Optionally, choose an Industry Solution in the business function set drop down box.

Caution
You can only activate one business function set.

6. Select the required business functions.

7. To activate a new business function, set the planned status to On and choose Check Changes.
8. If no error is reported, you can activate the new functions by choosing Activate Changes
The batch job for DDIC and BC set activation starts immediately. The job runs between 30 and
120 minutes approximately.
9. When the activation is completed, reschedule all batch jobs in the development system and
unlock the users.

04/30/2009 PUBLIC 27/32

Typographic Conventions

Example Description

<Example> Angle brackets indicate that you replace these words or characters with appropriate
entries to make entries in the system, for example, “Enter your <User Name>”.
Example Arrows separating the parts of a navigation path, for example, menu options
Example
Example Emphasized words or expressions
Example Words or characters that you enter in the system exactly as they appear in the
documentation
http://www.sap.com Textual cross-references to an internet address
/example Quicklinks added to the internet address of a homepage to enable quick access to
specific content on the Web
123456 Hyperlink to an SAP Note, for example, SAP Note 123456
Example n Words or characters quoted from the screen. These include field labels, screen titles,
pushbutton labels, menu names, and menu options.
n Cross-references to other documentation or published works
Example n Output on the screen following a user action, for example, messages
n Source code or syntax quoted directly from a program
n File and directory names and their paths, names of variables and parameters, and
names of installation, upgrade, and database tools
EXAMPLE Technical names of system objects. These include report names, program names,
transaction codes, database table names, and key concepts of a programming language
when they are surrounded by body text, for example, SELECT and INCLUDE
EXAMPLE Keys on the keyboard

28/32 PUBLIC 04/30/2009

 SAP AG
Dietmar-Hopp-Allee 16
69190 Walldorf
Germany
T +49/18 05/34 34 34
F +49/18 05/34 34 20
www.sap.com

© Copyright 2009 SAP AG. All rights reserved.

Some software products marketed by SAP AG and its distributors contain proprietary software components of other
software vendors.
No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission
of SAP AG. The information contained herein may be changed without prior notice.
Some software products marketed by SAP AG and its distributors contain proprietary software components of other
software vendors.
Microsoft, Windows, Excel, Outlook, and PowerPoint are registered trademarks of Microsoft Corporation.
IBM, DB2, DB2 Universal Database, System i, System i5, System p, System p5, System x, System z, System z10, System z9, z10,
z9, iSeries, pSeries, xSeries, zSeries, eServer, z/VM, z/OS, i5/OS, S/390, OS/390, OS/400, AS/400, S/390 Parallel Enterprise Server,
PowerVM, Power Architecture, POWER6+, POWER6, POWER5+, POWER5, POWER, OpenPower, PowerPC, BatchPipes,
BladeCenter, System Storage, GPFS, HACMP, RETAIN, DB2 Connect, RACF, Redbooks, OS/2, Parallel Sysplex, MVS/ESA, AIX,
Intelligent Miner, WebSphere, Netfinity, Tivoli and Informix are trademarks or registered trademarks of IBM Corporation.
Linux is the registered trademark of Linus Torvalds in the U.S. and other countries.
Adobe, the Adobe logo, Acrobat, PostScript, and Reader are either trademarks or registered trademarks of Adobe Systems
Incorporated in the United States and/or other countries.
Oracle is a registered trademark of Oracle Corporation.
UNIX, X/Open, OSF/1, and Motif are registered trademarks of the Open Group.
Citrix, ICA, Program Neighborhood, MetaFrame, WinFrame, VideoFrame, and MultiWin are trademarks or registered
trademarks of Citrix Systems, Inc.
HTML, XML, XHTML and W3C are trademarks or registered trademarks of W3C®, World Wide Web Consortium,
Massachusetts Institute of Technology.
Java is a registered trademark of Sun Microsystems, Inc.
JavaScript is a registered trademark of Sun Microsystems, Inc., used under license for technology invented and implemented
by Netscape.
SAP, R/3, xApps, xApp, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP Business ByDesign, 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 in several other countries all over the world. 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.
This document was created using stylesheet 2007-12-10 (V7.2) / XSL-FO: V5.1 Gamma and XSLT processor SAXON 6.5.2
from Michael Kay (http://saxon.sf.net/), XSLT version 1.

04/30/2009 PUBLIC 29/32

Disclaimer
Some components of this product are based on Java™. Any code change in these components may cause unpredictable and
severe malfunctions and is therefore expressly prohibited, as is any decompilation of these components.
Any Java™ Source Code delivered with this product is only to be used by SAP’s Support Services and may not be modified or
altered in any way.

Documentation in the SAP Service Marketplace

You can find this document at the following address: https://service.sap.com/instguides

30/32 PUBLIC 04/30/2009

This page is left blank for documents
that are printed on both sides.
 SAP AG
Dietmar-Hopp-Allee 16
69190 Walldorf
Germany
T +49/18 05/34 34 34
F +49/18 05/34 34 20
www.sap.com

© Copyright 2009 SAP AG. All rights reserved.

No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP AG. The information contained herein may be
changed without prior notice.