Professional Documents
Culture Documents
PUBLIC
Document version: 1.0 11/10/2008
Document History
The following table provides an overview of the most important document changes.
Version
Date
Description
1.0
11/10/2008
Initial Version
2/26
PUBLIC
11/10/2008
Table of Contents
Chapter 1
Introduction
. . . . . . . . . . . . . . . . . . . . . . .
Chapter 2
Chapter 3
11
Additional Information . . . . . . . . . . . . . .
Downloading Installation DVDs from SAP Service Marketplace
Performing a Remote Installation with SAPinst . . . . . .
Starting SAPinst GUI Separately . . . . . . . . . . . .
Interrupted Installation with SAPinst . . . . . . . . . .
Troubleshooting with SAPinst . . . . . . . . . . . . .
15
15
16
17
19
21
Chapter 4
4.1
4.2
4.3
4.4
4.5
11/10/2008
PUBLIC
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
3/26
4/26
PUBLIC
11/10/2008
Introduction
1 Introduction
You have received the DVD/CD set of SAP Library. The online help is delivered on these DVDs/CDs
in two formats: standard HTML (Plain HTML) and compiled HTML (HTML help). Subdirectories
contain the different language versions
SAP Notes for the Installation
You must read SAP Note 1261881before you start the installation. This SAP Note contains the most
recent information on the installation, as well as corrections to the installation documentation.
Make sure that you have the up-to-date version of each SAP Note, which you can find at
http://service.sap.com/notes.
11/10/2008
PUBLIC
5/26
This procedure tells you how to install and update SAP Library with SAPinst:
n Install means that you install SAP Library from scratch.
n Update means that you update an existing version of SAP Library.
SAPinst includes a SAPinst GUI and a GUI server, which both use Java.
This section describes how to run SAPinst, SAPinst GUI, and the GUI server on the same host and on
the local display: When you start SAPinst, SAPinst GUI and the GUI server also start. SAPinst GUI
connects via a secure SSL connection to the GUI server and the GUI server connects to SAPinst.
If you need to see the installation on a remote display, we recommend you perform a remote installation with
SAPinst [page 16], where SAPinst GUI is running on a separate host from SAPinst and the GUI server.
Alternatively you can use an X server for Microsoft Windows or other remote desktop tools like
vncviewer or nxserver/nxclient offered by various vendors or open source for remote access to
SAPinst GUI on Windows workstations. We recommend you use the Hummingbird Exceed X Server,
which we use to validate installations with SAPinst. For more information, see SAP Note 1170809.
Prerequisites
n Make sure that your host meets the hardware and software requirements:
l Minimum RAM:
0.5 GB
l Minimum disk space:
u 2.2 GB in the help destination directory
u 4.3 GB of temporary disk space for every required installation DVD that you have to copy
to a local hard disk
u 1.2 GB of temporary disk space for the installation
l For supported operating system releases, see the Product Availability Matrix on SAP Service
Marketplace at http://service.sap.com/pam.
n Make sure that you have the following installation DVDs available:
l Installation Master DVD
l Documentation DVD
You can find the detailed naming of these DVDs in the Media List of your SAP application available
at http://service.sap.com/instguides.
You can also download installation DVDs from SAP Service Marketplace. For more information,
see Downloading Installation DVDs from SAP Service Marketplace (Optional) [page 15].
11/10/2008
PUBLIC
7/26
n SAPinst creates the installation directory sapinst_instdir, where it keeps its log files, and which
is located directly in the Program Files directory. If SAPinst is not able to create sapinst_instdir
there, it tries to create sapinst_instdir in the directory defined by the environment variable TEMP.
Procedure
1. Log on to the host with a user account that is a member of the local Administrators group.
2. Create a help destination directory with sufficient disk space in which you want SAP Library
to be installed.
3. Insert the DVD/CD with the language version you want to install into your DVD/CD drive
or mount it locally.
4. Start SAPinst from the SAP Installation Master DVD by double-clicking sapinst.exe from the
following path:
<DVD drive>:\IM_WINDOWS_<platform>
n During the installation, the default ports 21200, 21212, and 4239 are used for communication
between SAPinst, GUI server, SAPinst GUI, and HTTP server. SAPinst uses port 21200 to
communicate with the GUI server. The GUI server uses port 21212 to communicate with
SAPinst GUI. 4239 is the port of the HTTP server, which is part of the GUI server. You get an
error message if one of these ports is already in use by another service.
In this case, you must execute sapinst using the following parameters:
SAPINST_DIALOG_PORT=<free_port_number_sapinst_to_gui_server>
GUISERVER_DIALOG_PORT=<free_port_number_gui_server_to_sapinst_gui>
GUISERVER_HTTP_PORT=<free_port_number_http_server>.
n To get a list of all available SAPinst properties, start SAPinst as described above with the option
-p:
./sapinst -p
5. In the Welcome screen choose <your SAP application> Software Life-Cycle Options
Installation and Update Install/Update SAP Library and then choose Next.
6. Specify the path to the SAP Library files on DVD..
7. Specify the help destination directory and then choose Next.
SAP Library
Note
SAP Library destination is the path to the help destination directory that you have created.
Result
8/26
PUBLIC
11/10/2008
More Information
See SAP Note 1272588 for known issues when installing the SAP Library with SAPinst.
11/10/2008
PUBLIC
9/26
This procedure tells you how to update an already installed SAP Library after installing additional
enhancement packages and activating new Business Functions.
n Install means that you install SAP Library content for additional enhancement package(s) from
scratch.
n Update means that you update existing SAP Library content for additional enhancement
package(s).
SAPinst includes a SAPinst GUI and a GUI server, which both use Java.
This section describes how to run SAPinst, SAPinst GUI, and the GUI server on the same host and on
the local display: When you start SAPinst, SAPinst GUI and the GUI server also start. SAPinst GUI
connects via a secure SSL connection to the GUI server and the GUI server connects to SAPinst.
If you need to see the installation on a remote display, we recommend you perform a remote installation with
SAPinst [page 16], where SAPinst GUI is running on a separate host from SAPinst and the GUI server.
Alternatively you can use an X server for Microsoft Windows or other remote desktop tools like
vncviewer or nxserver/nxclient offered by various vendors or open source for remote access to
SAPinst GUI on Windows workstations. We recommend you use the Hummingbird Exceed X Server,
which we use to validate installations with SAPinst. For more information, see SAP Note 1170809.
Prerequisites
n Make sure that your host meets the hardware and software requirements:
l Minimum RAM:
0.5 GB
l Minimum disk space:
u 2.2 GB in the help destination directory
u 4.3 GB of temporary disk space for every required installation DVD that you have to copy
to a local hard disk
u 1.2 GB of temporary disk space for the installation
l For supported operating system releases, see the Product Availability Matrix on SAP Service
Marketplace at http://service.sap.com/pam.
n Make sure that you have the following installation DVDs available:
11/10/2008
PUBLIC
11/26
1. Log on to the host with a user account that is a member of the local Administrators group.
2. Insert the DVD/CD with the language version you want to install into your DVD/CD drive
or mount it locally.
3. Start SAPinst from the SAP Installation Master DVD by double-clicking sapinst.exe from the
following path:
<DVD drive>:\IM_WINDOWS_<platform>
n During the installation, the default ports 21200, 21212, and 4239 are used for communication
between SAPinst, GUI server, SAPinst GUI, and HTTP server. SAPinst uses port 21200 to
communicate with the GUI server. The GUI server uses port 21212 to communicate with
SAPinst GUI. 4239 is the port of the HTTP server, which is part of the GUI server. You get an
error message if one of these ports is already in use by another service.
In this case, you must execute sapinst using the following parameters:
SAPINST_DIALOG_PORT=<free_port_number_sapinst_to_gui_server>
GUISERVER_DIALOG_PORT=<free_port_number_gui_server_to_sapinst_gui>
GUISERVER_HTTP_PORT=<free_port_number_http_server>.
n To get a list of all available SAPinst properties, start SAPinst as described above with the option
-p:
./sapinst -p
4. In the Welcome screen choose <your SAP application> Software Life-Cycle Options
Installation and Update Install/Update EHP for SAP Library and then choose Next.
5. Specify the path to the SAP Library files on DVD..
6. Specify the SAP Library destination and then choose Next.
12/26
PUBLIC
SAP Library
11/10/2008
Note
SAP Library destination is the path to the help destination directory that you created when
installing SAP Library (see Installing SAP Library [page 7]).
7. Specify which Business Functions update retrieval mode you want to use.
Business Functions update retrieval mode from file requires you to specify the location to
the update text file. To generate the update text file that contains information about the
installed and activated Business Functions before SAP Library update you should call a report
KW_UPDATE_BF_IO.
Business Functions update retrieval mode from RFC requires you to specify the parameters for the
SAP System Connectivity for RFC call.
8. Choose Next.
Result
SAPinst checks which Business Functions are installed and activated in your system and updates the
SAP Library according to information about activated Business Functions.
More Information
See SAP Note 1272588 for known issues when updating an already installed SAP Library after installing
additional enhancement packages and activating new Business Functions.
11/10/2008
PUBLIC
13/26
Additional Information
4 Additional Information
To extract the downloaded SAR files make sure that you use the latest SAPCAR version, which you
can find at http://service.sap.com/swdc. You need at least SAPCAR 700 or SAPCAR 640 with
patch level 4 or higher because older versions of SAPCAR can no longer unpack current SAR files.
For more information, see SAP Note 212876.
Procedure
1. Create a download directory on the host on which you want to run SAPinst.
2. Identify all download objects that belong to one installation DVD according to one or both of the
following:
n Material number
All download objects that are part of an installation DVD have the same material number and
an individual sequence number:
<material_number>_<sequence_number>
Example
51031387_1
51031387_2
...
n Title
All objects that are part of an installation DVD have the same title, such as
<solution><DVD_name><OS> or <database>RDBMS<OS> for RDBMS DVDs.
11/10/2008
PUBLIC
15/26
4
4.2
Additional Information
Performing a Remote Installation with SAPinst
SAPCAR asks if you want to replace existing files, for example LABELIDX.ASC. Always accept
with Yes.
The behavior of SAPinst has changed compared to previous versions. SAP no longer delivers any
JCE policy archives within the SAP Java Virtual Machine (SAP JVM). You have to download the
required Java Cryptography Extension (JCE) policy zip file from SAP on the remote host. For more
information, see SAP Note 1238121.
Prerequisites
n The remote host meets the prerequisites for starting SAPinst as described in Installing and Updating
SAP Library [page 7] or Installing and Updating SAP Library Content for an Enhancement Package [page 11].
n Both computers are in the same network and can ping each other.
To test this:
1. Log on to your remote host and enter the command ping <local host>.
2. Log on to the local host and enter the command ping <remote host>.
Procedure
1. Log on to your remote host as a user that is a member of the local administrators group.
2. Insert the Installation Master DVD in the DVD drive on your remote host.
16/26
PUBLIC
11/10/2008
4
4.3
Additional Information
Starting SAPinst GUI Separately
3. Download the JCE policy zip file from SAP as described in SAP Note 1240081.
4. Set the environment variable JCE_POLICY_ZIP to the location of the downloaded policy zip archive
by entering the following command:
set JCE_POLICY_ZIP=<policy zip archive>
SAPinst now starts and waits for the connection to the SAPinst GUI. You see the following at
the command prompt:
guiengine:
6. Start SAPinst GUI on your local host as described in Starting SAPinst GUI Separately [page 17].
The behavior of SAPinst has changed compared to previous versions. SAP no longer delivers any JCE
policy archives within the SAP JVM. You have to download the required JCE policy zip file from SAP
on the local host. For more information, see SAP Note 1238121.
Starting SAPinst GUI on Windows
4. Insert the SAP Installation Master DVD into your DVD drive.
5. Change to the directory of the sapinst executables:
<DVD drive>:\IM_WINDOWS_<platform>
11/10/2008
PUBLIC
17/26
4
4.3
Additional Information
Starting SAPinst GUI Separately
Make sure that the root user has not set any environment variables for a different SAP system or
database.
2. Download the JCE policy zip file from SAP as described in SAP Note 1240081.
3. Set the environment variable JCE_POLICY_ZIP to the location of the downloaded policy zip archive
as follows:
Shell Used
Command
C shell (csh)
Mount the DVD locally. We do not recommend that you use Network File System (NFS).
5. Change to the directory of the sapinst executables:
18/26
PUBLIC
11/10/2008
4
4.4
Additional Information
Interrupted Installation with SAPinst
<mountpoint_of_Installation_Master_DVD>/IM_<OS>
Note
If you want to start SAPinst GUI on a Linux 32bit platform, change to the following directory:
<mountpoint_of_Installation_Master_DVD>/IM_LINUX_I386
11/10/2008
PUBLIC
19/26
4
4.4
Additional Information
Interrupted Installation with SAPinst
Option
Definition
Retry
SAPinst retries the installation from the point of failure without repeating
any of the previous steps.
This is possible because SAPinst records the installation progress in the
keydb.xml file.
We recommend that you view the entries in the log files, try to solve the
problem, and then choose Retry.
If the same or a different error occurs, SAPinst displays the same dialog
box again.
Stop
SAPinst stops the installation, closing the dialog box, the SAPinst GUI, and
the GUI server.
SAPinst records the installation progress in the keydb.xml file. Therefore,
you can continue the installation from the point of failure without
repeating any of the previous steps (see the procedure below).
Continue
View Log
Procedure
This procedure describes the steps to restart an installation, which you stopped by choosing Stop, or
to continue an interrupted installation after an error situation.
1. Log on as a user who is a member of the local group administrators.
2. Insert the Installation Master DVD in your DVD drive.
3. Change to the required directory:
<DVD drive>:\IM_WINDOWS_<platform>
Double-click sapinst.exe.
4. From the tree structure in the Welcome screen, select the installation service that you want to
continue and choose Next.
Note
If there is only 1 component to install, the Welcome screen does not appear.
The What Do You Want to Do? screen appears.
5. In the What Do You Want to Do? screen, decide between the following alternatives and confirm
with OK:
20/26
PUBLIC
11/10/2008
4
4.5
Additional Information
Troubleshooting with SAPinst
Alternative
Behavior
11/10/2008
PUBLIC
21/26
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
Example
Arrows separating the parts of a navigation path, for example, menu options
Example
Example
Words or characters that you enter in the system exactly as they appear in the
documentation
http://www.sap.com
/example
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
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
22/26
PUBLIC
11/10/2008
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
11/10/2008
PUBLIC
23/26
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 SAPs Support Services and may not be modified or
altered in any way.
Documentation in the SAP Service Marketplace
24/26
PUBLIC
11/10/2008
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