Installation Guide

SAP Library Installation and Update

For SAP systems based on SAP NetWeaver 7.0 EHP1 (SAP ERP 6.0
EHP4, SAP CRM 7.0, SAP SCM 7.0, SAP SRM 7.0)
Target Audience
n System Administrators
n Technical Consultants

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/30

PUBLIC

11/10/2008

Table of Contents

Chapter 1

Introduction

. . . . . . . . . . . . . . . . . . . . . . .

Chapter 2

Installing and Updating SAP Library . . . . . . . . . . . . . .

Chapter 3

Installing and Updating SAP Library Content for an Enhancement

Package . . . . . . . . . . . . . . . . . . . . . . . . . .

11

Additional Information . . . . . . . . . . . . . .
Mounting a CD / DVD for AIX . . . . . . . . . . . .
Mounting a CD / DVD for HP-UX . . . . . . . . . . .
Mounting a CD / DVD for Linux . . . . . . . . . . . .
Mounting a CD / DVD for Solaris . . . . . . . . . . .
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
18
18
19
20
22
24
26

Chapter 4
4.1
4.2
4.3
4.4
4.5
4.6
4.7
4.8
4.9

11/10/2008

PUBLIC

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.

3/30

4/30

PUBLIC

11/10/2008

Introduction

1 Introduction

This document explains how to install SAP Library.

Prerequisites

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/30

This page is intentionally left blank.

Installing and Updating SAP Library

2 Installing and Updating SAP Library

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 20], 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 19].
n Check the value of the environment variable TEMP, TMP, or TMPDIR:

11/10/2008

PUBLIC

7/30

Installing and Updating SAP Library

l Make sure that your operating system does not delete the contents of the temporary directory
/tmp or the contents of the directories to which the variable TEMP, TMP, or TMPDIR points for
example, by using a crontab entry.
l SAPinst normally creates the installation directory sapinst_instdir directly below the
temporary directory. SAPinst finds the temporary directory by checking the value of the
environment variables TEMP, TMP, or TMPDIR. If no value is set for these variables, SAPinst uses
/tmp as default installation directory.
If you want to use an alternative installation directory, set the environment variable TEMP, TMP,
or TMPDIR to the required directory using the following commands:
Shell Used

Command

Bourne shell (sh)

TEMP=<directory>
export TEMP

C shell (csh)

setenv TEMP <directory>

Korn shell (ksh)

export TEMP=<directory>

l Make sure that you have at least 60 MB of free space in the installation directory for each
installation service. In addition, you need 200 MB free space for the SAPinst executables. If
you cannot provide 200 MB free space in the temporary directory, you can set one of the
environment variables TEMP, TMP, or TMPDIR to another directory with 200 MB free space for the
SAPinst executables.
l Make sure that the temporary directory has the permissions 777.
The SAPinst Self-Extractor extracts the SAPinst executables to the temporary directory.
These executables are deleted again after SAPinst has stopped running.
If required, you can terminate SAPinst and the SAPinst Self-Extractor by pressing Ctrl+C .
Caution

If SAPinst cannot find a temporary directory, the installation terminates with the error FCO-00058.
n Make sure that your DISPLAY environment variable is set to <host_name>:0.0, where <host_name>
is the host on which you want to display the SAPinst GUI.
Shell Used

Command

Bourne shell (sh)

DISPLAY=<host_name>:0.0
export DISPLAY

C shell (csh)

setenv DISPLAY <host_name>:0.0

Korn shell (ksh)

export DISPLAY=<host_name>:0.0

Procedure

1. Log on to the host as user root.

8/30

PUBLIC

11/10/2008

Installing and Updating SAP Library

2. Create a help destination directory with sufficient disk space in which you want SAP Library
to be installed.
3. Mount the Installation Master DVD.
Only valid for: AIX

For more information about how to mount DVDs on AIX, see Mounting a CD / DVD for AIX [page 15].
End of: AIX
Only valid for: HP-UX

For more information about how to mount DVDs on HP-UX, see Mounting a CD / DVD for HP-UX
[page 16].
End of: HP-UX
Only valid for: Linux

For more information about how to mount DVDs on Linux, see Mounting a CD / DVD for Linux
[page 18].
End of: Linux
Only valid for: Solaris

For more information about how to mount DVDs on Solaris, see Mounting a CD / DVD for Solaris
[page 18].
End of: Solaris

4. Start SAPinst from the Installation Master DVD by entering the following commands:
cd <Installation Master_DVD>/IM_<OS>
./sapinst

SAPinst GUI starts automatically by displaying the Welcome screen.

Note

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

11/10/2008

PUBLIC

9/30

Installing and Updating SAP Library

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

SAPinst installs the SAP Library.

More Information

See SAP Note 1272588 for known issues when installing the SAP Library with SAPinst.

10/30

PUBLIC

11/10/2008

Installing and Updating SAP Library Content for an Enhancement Package

3 Installing and Updating SAP Library

Content for an Enhancement Package

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 20], 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/30

Installing and Updating SAP Library Content for an Enhancement Package

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 19].
n Check the value of the environment variable TEMP, TMP, or TMPDIR:
l Make sure that your operating system does not delete the contents of the temporary directory
/tmp or the contents of the directories to which the variable TEMP, TMP, or TMPDIR points for
example, by using a crontab entry.
l SAPinst normally creates the installation directory sapinst_instdir directly below the
temporary directory. SAPinst finds the temporary directory by checking the value of the
environment variables TEMP, TMP, or TMPDIR. If no value is set for these variables, SAPinst uses
/tmp as default installation directory.
If you want to use an alternative installation directory, set the environment variable TEMP, TMP,
or TMPDIR to the required directory using the following commands:
Shell Used

Command

Bourne shell (sh)

TEMP=<directory>
export TEMP

C shell (csh)

setenv TEMP <directory>

Korn shell (ksh)

export TEMP=<directory>

l Make sure that you have at least 60 MB of free space in the installation directory for each
installation service. In addition, you need 200 MB free space for the SAPinst executables. If
you cannot provide 200 MB free space in the temporary directory, you can set one of the
environment variables TEMP, TMP, or TMPDIR to another directory with 200 MB free space for the
SAPinst executables.
l Make sure that the temporary directory has the permissions 777.
The SAPinst Self-Extractor extracts the SAPinst executables to the temporary directory.
These executables are deleted again after SAPinst has stopped running.
If required, you can terminate SAPinst and the SAPinst Self-Extractor by pressing Ctrl+C .
Caution

If SAPinst cannot find a temporary directory, the installation terminates with the error FCO-00058.
n Make sure that your DISPLAY environment variable is set to <host_name>:0.0, where <host_name>
is the host on which you want to display the SAPinst GUI.

12/30

PUBLIC

11/10/2008

Installing and Updating SAP Library Content for an Enhancement Package

Shell Used

Command

Bourne shell (sh)

DISPLAY=<host_name>:0.0
export DISPLAY

C shell (csh)

setenv DISPLAY <host_name>:0.0

Korn shell (ksh)

export DISPLAY=<host_name>:0.0

Procedure

1. Log on to the host as user root.

2. Mount the Installation Master DVD.
Note

Mount DVDs locally. We do not recommend that you use Network File System (NFS), because
reading from DVDs mounted with NFS might fail.
Only valid for: AIX

For more information about how to mount DVDs on AIX, see Mounting a CD / DVD for AIX [page 15].
End of: AIX
Only valid for: HP-UX

For more information about how to mount DVDs on HP-UX, see Mounting a CD / DVD for HP-UX
[page 16].
End of: HP-UX
Only valid for: Linux

For more information about how to mount DVDs on Linux, see Mounting a CD / DVD for Linux
[page 18].
End of: Linux
Only valid for: Solaris

For more information about how to mount DVDs on Solaris, see Mounting a CD / DVD for Solaris
[page 18].
End of: Solaris

3. Start SAPinst from the Installation Master DVD by entering the following commands:
cd <Installation Master_DVD>/IM_<OS>
./sapinst

SAPinst GUI starts automatically by displaying the Welcome screen.

11/10/2008

PUBLIC

13/30

Installing and Updating SAP Library Content for an Enhancement Package

Note

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.

SAP Library

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.

14/30

PUBLIC

11/10/2008

Additional Information

4 Additional Information

Only valid for: AIX

4.1 Mounting a CD / DVD for AIX

Note
<medium-mountdir> refers to either <cd-mountdir> or <dvd-mountdir>.

Use the following procedure to mount a CD / DVD:

Procedure

1. Log on as user root.

2. Add a CD / DVD file system.
a) Enter the command smitty.
b) Choose Physical & Logical Storage File Systems
File Systems Add a CDROM File System .
c) To get a list of device names, choose F4 .
Select a device name.
d) Enter the mount point <medium-mountdir>.

Add / Change / Show / Delete File Systems

CDROM

Example
<medium-mountdir>

is /sapcd

e) Choose ENTER .
f) To exit smitty, choose F10 .
3. Mount the CD / DVD as follows:
Note

Alternatively, you can mount the CD / DVD manually with the following command: mount
cdrfs -r /dev/cd0 /sapcd.

-v

a) Enter the command smitty.

b) Choose Physical & Logical Storage File Systems Mount a File System .
c) Place the cursor on File System Name and choose F4 .

11/10/2008

PUBLIC

15/30

4
4.2

Additional Information
Mounting a CD / DVD for HP-UX

d)
e)
f)
g)
h)
i)
j)
k)

Select the CD / DVD device /dev/cd0.

Place the cursor on field Directory over which to mount and choose
Select /sapcd.
Place the cursor on field Type of File System and choose F4 .
Select cdrfs.
Change Mount as Read Only system to YES
Choose ENTER .
To exit smitty, choose F10 .

F4 .

End of: AIX

Only valid for: HP-UX

4.2 Mounting a CD / DVD for HP-UX

Proceed as follows to mount a CD or DVD.
Note

The placeholder <medium-mountdir> is used for either <cd-mountdir> or <dvd-mountdir>.

Mounting a CD / DVD Manually

1. Log on as user root.

2. To create a mount point for CD / DVD, enter the following command:
mkdir /<medium-mountdir>
Example
<medium-mountdir>

is /sapcd

3. To find out the hardware address of the CD/DVD drive, proceed as follows:
a) Enter the following command:
ioscan -fnkCdisk

A list of all devices is displayed

b) Note the hardware address of the CD/DVD drive, for example c0t4d0.
4. To check that the driver is part of the kernel (skip this step if the CD / DVD drive is already
working), enter the following command:
grep cdfs /stand/system

5. To mount the CD / DVD on HP-UX 11.11 or 11.23, enter the following command:
mount -r -F cdfs -o rr /dev/dsk/<diskdevice> <medium-mountdir>

To mount the CD / DVD on HP-UX 11.31, enter the following command:

mount -r -F cdfs -o rr /dev/disk/<diskdevice> <medium-mountdir>

16/30

PUBLIC

11/10/2008

4
4.3

Additional Information
Mounting a CD / DVD for Linux

Example

HP-UX 11.11 or 11.23: mount -r -F cdfs -o rr /dev/dsk/c0t4d0 /sapcd

HP-UX 11.31: mount -r -F cdfs -o rr /dev/disk/c0t4d0 /sapcd
Mounting a CD / DVD Using SAM for HP-UX 11.11 or HPUX 11.23

1. Enter the command:

/usr/sbin/sam

2. Choose Disks and Filesystems

3. Enter the mount directory:

Disk Devices

Actions

Mount

<medium-mountdir>
Example

For example, <medium-mountdir> is /sapcd.

4. Perform task.
5. Exit SAM.
Mounting a CD / DVD Using SMH for HP-UX 11.31

1. Enter one of the following commands:

n /usr/sbin/smh
n http://<hostname>:<port>
where <port> is either the default port 2381 or your defined port (for example 2301)
2. Choose Disks and Filesystems File Systems Add CDFS
3. Enter the mount directory:
<medium-mountdir>
Example

For example, <medium-mountdir> is /sapcd.

4. Choose the hardware path.
5. Choose New CDFS
6. Exit SMH.
End of: HP-UX

11/10/2008

PUBLIC

17/30

4
4.4

Additional Information
Mounting a CD / DVD for Solaris

Only valid for: Linux

4.3 Mounting a CD / DVD for Linux

Note

The placeholder <medium-mountdir> is used for either <cd-mountdir> or <dvd-mountdir>.

Procedure

1. Log on as user root.

2. To create a mount point for the CD / DVD, enter the following command:
mkdir <medium-mountdir>
Example
<medium-mountdir>

is /sapcd

3. To mount the first CD / DVD device, enter the following command:

mount -t iso9660 -r <device> <medium-mountdir>

where <device> is /dev/cdrom for non-SCSI CD devices and /dev/scd<n> for SCSI drives with the
device number <n>.
If the file names on the mounted CD / DVD are written in lowercase letters, remount the CD /
DVD with the following commands:
umount <device>
mount -t iso9660 -r -o map=off <device> <medium-mountdir>
End of: Linux
Only valid for: Solaris

4.4 Mounting a CD / DVD for Solaris

In the Solaris operating system, a layer of software manages CDs / DVDs and other media. This is the
volume manager, which automates the interaction between you and your CDs / DVDs. Do not use
this volume manager to mount CDs / DVDs needed for the installation, as the manager does not use
the normal case option. Without this option, some files on CDs / DVDs cannot be found. Mount CDs
/ DVDs for the installation manually as described in the following procedure.
For more information about configuring the volume management, see the SunOS Routine System
Administration Guide.

18/30

PUBLIC

11/10/2008

4
4.5

Additional Information
Downloading Installation DVDs from SAP Service Marketplace

Note

The placeholder <medium-mountdir> is used for either <cd-mountdir> or <dvd-mountdir>.

Procedure

1. Log on as user root.

2. To check if vold (volume daemon) is running, enter the following command:
ps -ef | grep vold

3. If it is running, kill vold.

4. Insert the CD / DVD into your disk drive.
5. To create a mount point, enter the following command:
mkdir /<medium-mountdir>
Example

for example, <medium-mountdir> is /sapcd

6. To mount the CD / DVD, enter the following command:
mount -F hsfs -o nomaplcase,ro /dev/dsk/c0t6d0s2 /<medium-mountdir>

After the installation, you can start vold using the following command:
/usr/sbin/vold.
End of: Solaris

4.5 Downloading Installation DVDs from SAP Service

Marketplace
You normally obtain the installation DVDs as part of the installation package from SAP.
However, you can also download installation DVDs from:
http://service.sap.com/swdc
Download Installations and Upgrades Entry by Application Group
<SAP solution> <SAP product> <SAP release> Installation and Upgrade <operating system>
<database>
If you download installation DVDs, note that DVDs might be split into several files. In this case, you
have to reassemble the required files after the download.
Prerequisites

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.

11/10/2008

PUBLIC

19/30

4
4.6

Additional Information
Performing a Remote Installation with SAPinst

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.
3. Download the objects to the download directory.
4. Extract the individual download objects using SAPCAR, starting with the lowest sequence number
for example 51031387_1, then 51031387_2, and so on.
During the download SAPCAR sets up the structure of the installation DVD.
Note

SAPCAR asks if you want to replace existing files, for example LABELIDX.ASC. Always accept
with Yes.

4.6 Performing a Remote Installation with SAPinst

You use this procedure to install your SAP system on a remote host. In this case, SAPinst and the
GUI server run on the remote host, and SAPinst GUI runs on the local host. The local host is the
host from which you control the installation with SAPinst GUI.
Alternatively you can use an X server for Microsoft Windows or other remote desktop tools such
as VNC Viewer or NX Server / NX Client 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.
Only valid for: Linux;Windows

You can run SAPinst GUI on a PC with 32-bit while SAPinst is running on a 64-bit installation host.
End of: Linux;Windows

20/30

PUBLIC

11/10/2008

4
4.6

Additional Information
Performing a Remote Installation with SAPinst

Caution

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 user root.

Caution

Make sure that the root user has not set any environment variables for a different SAP system or
database.
2. Mount the Installation Master DVD.
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
as follows:
Shell Used

Command

Bourne shell (sh)

JCE_POLICY_ZIP=<policy zip archive>

export JCE_POLICY_ZIP

C shell (csh)

setenv JCE_POLICY_ZIP <policy zip archive>

Korn shell (ksh)

export JCE_POLICY_ZIP=<policy zip archive>

5. Enter the following commands:

cd <mountpoint_of_Installation_Master_DVD>/IM_<OS>
./sapinst -nogui

SAPinst now starts and waits for the connection to the SAPinst GUI. You see the following at
the command prompt:
guiengine:

no GUI connected; waiting for a connection on host <host_name>, port

<port_number> to continue with the installation.

11/10/2008

PUBLIC

21/30

4
4.7

Additional Information
Starting SAPinst GUI Separately

6. Start SAPinst GUI on your local host as described in Starting SAPinst GUI Separately [page 22].

4.7 Starting SAPinst GUI Separately

You use this procedure to start SAPinst GUI separately. You might need to start SAPinst GUI
separately in the following cases:
n You have logged off from SAPinst.
If you logged off during the installation and you later want to reconnect to the installation while it
is still running, you can start SAPinst GUI separately.
n You want to perform a remote installation [page 20].
If SAPinst GUI runs on a different host from SAPinst and the GUI server, you have to start SAPinst
GUI separately on the local host.
Caution

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

1. Log on as a member of the local administrators group.

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
by entering the following command:
set JCE_POLICY_ZIP=<policy zip archive>

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>
Only valid for: AIX;HP-UX;IBM i5/OS;Linux;Solaris;Windows

6. Start SAPinst GUI by double-clicking sapinstgui.exe

SAPinst GUI starts and tries to connect to the GUI server and SAPinst, using the local host
as default.
If SAPinst and the GUI server are running on another host, SAPinst GUI cannot connect and the
SAP Installation GUI Connection dialog appears.
In this case, enter the name of the host on which SAPinst is running and choose Log on.
The first dialog of the installation appears and you can perform the remote installation from
your local host.

22/30

PUBLIC

11/10/2008

4
4.7

Additional Information
Starting SAPinst GUI Separately

Note

Optionally you can start sapinstgui.exe with the following parameters:

n host=<host name>, where <host name> is the host name of the installation host
n port=<nr>, where <nr> is the port number for the connection to the GUI server
n -accessible enables accessibility mode
Example:
./sapinstgui.exe host=lsi1209 port=3000 -accessible
End of: AIX;HP-UX;IBM i5/OS;Linux;Solaris;Windows

Starting SAPinst GUI on UNIX

1. Log on as user root.

Caution

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

Bourne shell (sh)

JCE_POLICY_ZIP=<policy zip archive>

export JCE_POLICY_ZIP

C shell (csh)

setenv JCE_POLICY_ZIP <policy zip archive>

Korn shell (ksh)

export JCE_POLICY_ZIP=<policy zip archive>

4. Mount your Installation Master DVD.

Note

Mount the DVD locally. We do not recommend that you use Network File System (NFS).
5. Change to the directory of the sapinst executables:
<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

23/30

4
4.8

Additional Information
Interrupted Installation with SAPinst
Only valid for: AIX;HP-UX;IBM i5/OS;Linux;Solaris;Windows

6. Start SAPinst GUI by executing ./sapinstgui

SAPinst GUI starts and tries to connect to the GUI server and SAPinst, using the local host
as default.
If SAPinst and the GUI server are running on another host, SAPinst GUI cannot connect and the
SAP Installation GUI Connection dialog appears.
In this case, enter the name of the host on which SAPinst is running and choose Log on.
The first dialog of the installation appears and you can perform the remote installation from
your local host.
Note

Optionally, you can start sapinstgui with the following parameters:

n host=<host name>, where <host name> is the host name of the installation host
n port=<nr>, where <nr> is the port number for the connection to the GUI server
n - accessible enables accessibility mode
Example:
./sapinstgui host=lsi1209 port=3000 -accessible
End of: AIX;HP-UX;IBM i5/OS;Linux;Solaris;Windows

4.8 Interrupted Installation with SAPinst

The SAP system installation might be interrupted for one of the following reasons:
n An error occurred during the Define Parameters or Execute phase:
SAPinst does not abort the installation in error situations. If an error occurs, the installation pauses
and a dialog box appears. The dialog box contains a short description of the choices listed in the
table below as well as a path to a log file that contains detailed information about the error.
n You interrupted the installation by choosing Cancel in the SAPinst menu.
The following table describes the options in the dialog box:
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.

24/30

PUBLIC

11/10/2008

4
4.8

Additional Information
Interrupted Installation with SAPinst

Option

Definition

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

SAPinst continues the installation from the current point.

View Log

Access installation log files.

Note

You can also terminate SAPinst by choosing Ctrl + C . However, we do not recommend that you
use Ctrl + C , because this kills the process immediately.
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 to your local UNIX host as user root.
Caution

Make sure that the root user has not set any environment variables for a different SAP system or
database.
2. Mount your Installation Master DVD.
Note

Mount the DVD locally. We do not recommend using Network File System (NFS).
3. Enter the following commands:
cd <Installation_Master_DVD>/IM_<OS>
./sapinst

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:

11/10/2008

PUBLIC

25/30

4
4.9

Additional Information
Troubleshooting with SAPinst

Alternative

Behavior

Run a New Option

SAPinst does not continue the interrupted installation option.

Instead, it moves the content of the old installation directory and all
installation-specific files to a backup directory. Afterwards, you can no
longer continue the old installation option.
For the backup directory, the following naming convention is used:
<log_day_month_year_hours_minutes_seconds>.
Example
log_01_Oct_2008_13_47_56

Continue with the Old Option

SAPinst continues the interrupted installation option from the point of

failure.

4.9 Troubleshooting with SAPinst

This section tells you how to proceed when errors occur during the installation with SAPinst.
If an error occurs, SAPinst:
n Stops the installation.
n Displays a dialog informing you about the error.
Procedure

1. To view the log file, choose View Logs.

2. If an error occurs during the Define Parameters or Execute phase, do either of the following:
n Try to solve the problem
n Abort the installation by choosing Cancel in the SAPinst menu.
For more information, see Interrupted Installation with SAPinst [page 24].
n After resolving the problem, you can continue the installation by choosing Retry.
3. Check the log and trace files of the GUI server and SAPinst GUI in the directory
<user_home>/.sdtgui/ for errors.
n If GUI server or SAPinst GUI do not start, check the file sdtstart.err in the current
<user_home> directory.
n If SAPinst GUI aborts during the installation without an error message, restart SAPinst GUI as
described in Starting SAPinst GUI Separately [page 22].
n If you use an X Server for Microsoft Windows or other remote desktop tools for the Remote
Access of SAPinst GUI on Windows Workstations and you experience display problems such
as missing repaints or refreshes, contact your X Server vendor. The vendor can give you
information about whether this X Server supports Java Swing-based GUIs and also tell you
about further requirements and restrictions. See also SAP Note 1170809.

26/30

PUBLIC

11/10/2008

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

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

11/10/2008

PUBLIC

27/30

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 2008 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.
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.

28/30

PUBLIC

11/10/2008

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

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

11/10/2008

PUBLIC

29/30

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 2008 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.