Sap Library Guide Unix

Installation GuideSAP Library Installation and UpdateFor SAP systems based on SAP NetWeaver 7.0 EHP1 (SAP ERP 6.0EHP4, SAP CRM 7.0, SAP SCM 7.0, SAP SRM 7.0)

Target Audience

n System Administratorsn Technical Consultants

PUBLICDocument 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 . . . . . . . . . . . . . . . . . . . . . . . 5

Chapter 2 Installing and Updating SAP Library . . . . . . . . . . . . . . 7

Chapter 3 Installing and Updating SAP Library Content for an EnhancementPackage . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Chapter 4 Additional Information . . . . . . . . . . . . . . . . . . . 154.1 Mounting a CD / DVD for AIX . . . . . . . . . . . . . . . . . 154.2 Mounting a CD / DVD for HP-UX . . . . . . . . . . . . . . . . 164.3 Mounting a CD / DVD for Linux . . . . . . . . . . . . . . . . . 184.4 Mounting a CD / DVD for Solaris . . . . . . . . . . . . . . . . 184.5 Downloading Installation DVDs from SAP Service Marketplace . . . . . 194.6 Performing a Remote Installation with SAPinst . . . . . . . . . . . 204.7 Starting SAPinst GUI Separately . . . . . . . . . . . . . . . . . 224.8 Interrupted Installation with SAPinst . . . . . . . . . . . . . . . 244.9 Troubleshooting with SAPinst . . . . . . . . . . . . . . . . . . 26

11/10/2008 PUBLIC 3/30

4/30 PUBLIC 11/10/2008

1 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/CDsin two formats: standard HTML (Plain HTML) and compiled HTML (HTML help). Subdirectoriescontain the different language versions

SAP Notes for the Installation

Youmust read SAP Note 1261881before you start the installation. This SAP Note contains the mostrecent 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 athttp://service.sap.com/notes.

11/10/2008 PUBLIC 5/30

http://service.sap.com/~form/handler?_APP=01100107900000000342&_EVENT=REDIR&_NNUM=1261881&_NLANG=en&_NVERS=0

http://service.sap.com/notes



This page is intentionally left blank.

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 onthe local display: When you start SAPinst, SAPinst GUI and the GUI server also start. SAPinst GUIconnects 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 withSAPinst [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 likevncviewer or nxserver/nxclient ‒ offered by various vendors or open source ‒ for remote access toSAPinst 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 GBl Minimum disk space:

u2.2 GB in the help destination directory

u4.3 GB of temporary disk space for every required installation DVD that you have to copyto a local hard disk

u1.2 GB of temporary disk space for the installationl 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 DVDYou can find the detailed naming of these DVDs in the Media List of your SAP application availableat 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


http://service.sap.com/pam

http://service.sap.com/instguides


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 ‒ forexample, by using a crontab entry.

l SAPinst normally creates the installation directory sapinst_instdir directly below thetemporary directory. SAPinst finds the temporary directory by checking the value of theenvironment 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 eachinstallation service. In addition, you need 200 MB free space for the SAPinst executables. Ifyou cannot provide 200 MB free space in the temporary directory, you can set one of theenvironment variables TEMP, TMP, or TMPDIR to another directory with 200 MB free space for theSAPinst 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


2. Create a help destination directory with sufficient disk space in which you want SAP Libraryto be installed.

3. Mount the Installation Master DVD.

Only valid for: AIX

Formore information about how tomount DVDs on AIX, seeMounting 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, seeMounting 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, seeMounting a CD / DVD for Linux[page 18].End of: Linux

Only valid for: Solaris

For more information about how to mount DVDs on Solaris, seeMounting 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 theWelcome screen.

Note

n During the installation, the default ports 21200, 21212, and 4239 are used for communicationbetween SAPinst, GUI server, SAPinst GUI, and HTTP server. SAPinst uses port 21200 tocommunicate with the GUI server. The GUI server uses port 21212 to communicate withSAPinst GUI. 4239 is the port of the HTTP server, which is part of the GUI server. You get anerror 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


5. In theWelcome screen choose <your SAP application> Software Life-Cycle Options SAP LibraryInstallation 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.

Note

SAP Library destination is the path to the help destination directory that you have created.

ResultSAPinst installs the SAP Library.

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

10/30 PUBLIC 11/10/2008


3 Installing and Updating SAP Library Content for an Enhancement Package

3 Installing and Updating SAP LibraryContent for an Enhancement Package

This procedure tells you how to update an already installed SAP Library after installing additionalenhancement packages and activating new Business Functions.

n Install means that you install SAP Library content for additional enhancement package(s) fromscratch.

n Update means that you update existing SAP Library content for additional enhancementpackage(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 onthe local display: When you start SAPinst, SAPinst GUI and the GUI server also start. SAPinst GUIconnects 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 withSAPinst [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 likevncviewer or nxserver/nxclient ‒ offered by various vendors or open source ‒ for remote access toSAPinst 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 GBl Minimum disk space:

u2.2 GB in the help destination directory

u4.3 GB of temporary disk space for every required installation DVD that you have to copyto a local hard disk

u1.2 GB of temporary disk space for the installationl 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


http://service.sap.com/pam


l Installation Master DVD

l Documentation DVDYou can find the detailed naming of these DVDs in the Media List of your SAP application availableat 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 ‒ forexample, by using a crontab entry.

l SAPinst normally creates the installation directory sapinst_instdir directly below thetemporary directory. SAPinst finds the temporary directory by checking the value of theenvironment 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 eachinstallation service. In addition, you need 200 MB free space for the SAPinst executables. Ifyou cannot provide 200 MB free space in the temporary directory, you can set one of theenvironment variables TEMP, TMP, or TMPDIR to another directory with 200 MB free space for theSAPinst 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

http://service.sap.com/instguides


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), becausereading from DVDs mounted with NFS might fail.

Only valid for: AIX

Formore information about how tomount DVDs on AIX, seeMounting a CD / DVD for AIX [page 15].End of: AIX


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


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


For more information about how to mount DVDs on Solaris, seeMounting 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 theWelcome screen.

11/10/2008 PUBLIC 13/30


Note

n During the installation, the default ports 21200, 21212, and 4239 are used for communicationbetween SAPinst, GUI server, SAPinst GUI, and HTTP server. SAPinst uses port 21200 tocommunicate with the GUI server. The GUI server uses port 21212 to communicate withSAPinst GUI. 4239 is the port of the HTTP server, which is part of the GUI server. You get anerror 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 theWelcome screen choose <your SAP application> Software Life-Cycle Options SAP LibraryInstallation 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.

Note

SAP Library destination is the path to the help destination directory that you created wheninstalling 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 tothe update text file. To generate the update text file that contains information about theinstalled and activated Business Functions before SAP Library update you should call a reportKW_UPDATE_BF_IO.Business Functions update retrieval mode from RFC requires you to specify the parameters for theSAP System Connectivity for RFC call.

8. Choose Next.

ResultSAPinst checks which Business Functions are installed and activated in your system and updates theSAP Library according to information about activated Business Functions.

More InformationSee SAPNote 1272588 for known issues when updating an already installed SAP Library after installingadditional enhancement packages and activating new Business Functions.

14/30 PUBLIC 11/10/2008


4 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 Add / Change / Show / Delete File Systems CDROM

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

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 / DVDmanually with the following command: mount -v

cdrfs -r /dev/cd0 /sapcd.

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 Additional Information4.2 Mounting a CD / DVD for HP-UX

d) Select the CD / DVD device /dev/cd0.e) Place the cursor on field Directory over which to mount and choose F4 .f) Select /sapcd.g) Place the cursor on field Type of File System and choose F4 .h) Select cdrfs.i) ChangeMount as Read Only system to YESj) Choose ENTER .k) To exit smitty, choose F10 .

End of: AIX


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


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 displayedb) 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 alreadyworking), 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 Additional Information4.3 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 HP‒UX 11.23

1. Enter the command:/usr/sbin/sam

2. Choose Disks and Filesystems Disk Devices Actions Mount3. Enter the mount directory:

<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 CDFS3. Enter the mount directory:

<medium-mountdir>

Example

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

4. Choose the hardware path.5. Choose New CDFS6. Exit SMH.

End of: HP-UX

11/10/2008 PUBLIC 17/30

4 Additional Information4.4 Mounting a CD / DVD for Solaris


4.3 Mounting a CD / DVD for Linux

Note


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


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 thedevice 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


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 thevolume manager, which automates the interaction between you and your CDs / DVDs. Do not usethis volume manager to mount CDs / DVDs needed for the installation, as the manager does not usethe 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 SystemAdministration Guide.

18/30 PUBLIC 11/10/2008

4 Additional Information4.5 Downloading Installation DVDs from SAP Service Marketplace

Note


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 ServiceMarketplace

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, youhave to reassemble the required files after the download.

PrerequisitesTo extract the downloaded SAR files make sure that you use the latest SAPCAR version, which youcan find at http://service.sap.com/swdc. You need at least SAPCAR 700 or SAPCAR 640 withpatch 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

http://service.sap.com/swdc







4 Additional Information4.6 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 andan individual sequence number:<material_number>_<sequence_number>

Example

51031387_151031387_2...

n TitleAll 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 acceptwith 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 theGUI server run on the remote host, and SAPinst GUI runs on the local host. The local host is thehost from which you control the installation with SAPinst GUI.Alternatively you can use an X server for Microsoft Windows or other remote desktop tools suchas VNC Viewer or NX Server / NX Client ‒ offered by various vendors or open source ‒ for remoteaccess to SAPinst GUI on Windows workstations. We recommend you use the Hummingbird ExceedX Server, which we use to validate installations with SAPinst. For more information, see SAP Note1170809.

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 Additional Information4.6 Performing a Remote Installation with SAPinst

Caution

The behavior of SAPinst has changed compared to previous versions. SAP no longer delivers anyJCE policy archives within the SAP Java Virtual Machine (SAP JVM). You have to download therequired Java Cryptography Extension (JCE) policy zip file from SAP on the remote host. For moreinformation, see SAP Note 1238121.

Prerequisites

n The remote host meets the prerequisites for starting SAPinst as described in Installing and UpdatingSAP 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 ordatabase.

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 atthe 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 Additional Information4.7 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 GUIseparately 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 itis 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 SAPinstGUI separately on the local host.

Caution

The behavior of SAPinst has changed compared to previous versions. SAP no longer delivers any JCEpolicy archives within the SAP JVM. You have to download the required JCE policy zip file from SAPon 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>

6.

Only valid for: AIX;HP-UX;IBM i5/OS;Linux;Solaris;Windows

Start SAPinst GUI by double-clicking sapinstgui.exeSAPinst GUI starts and tries to connect to the GUI server and SAPinst, using the local hostas default.If SAPinst and the GUI server are running on another host, SAPinst GUI cannot connect and theSAP 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 fromyour local host.

22/30 PUBLIC 11/10/2008



4 Additional Information4.7 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 modeExample:./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


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 32‒bit platform, change to the following directory:<mountpoint_of_Installation_Master_DVD>/IM_LINUX_I386

11/10/2008 PUBLIC 23/30


4 Additional Information4.8 Interrupted Installation with SAPinst

6.

Only valid for: AIX;HP-UX;IBM i5/OS;Linux;Solaris;Windows

Start SAPinst GUI by executing ./sapinstguiSAPinst GUI starts and tries to connect to the GUI server and SAPinst, using the local hostas default.If SAPinst and the GUI server are running on another host, SAPinst GUI cannot connect and theSAP 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 fromyour 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 modeExample:./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 pausesand a dialog box appears. The dialog box contains a short description of the choices listed in thetable 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 SAPinstmenu.

The following table describes the options in the dialog box:

Option Definition

Retry SAPinst retries the installation from the point of failure without repeatingany of the previous steps.This is possible because SAPinst records the installation progress in thekeydb.xml file.We recommend that you view the entries in the log files, try to solve theproblem, and then choose Retry.If the same or a different error occurs, SAPinst displays the same dialogbox again.

24/30 PUBLIC 11/10/2008

4 Additional Information4.8 Interrupted Installation with SAPinst

Option Definition

Stop SAPinst stops the installation, closing the dialog box, the SAPinst GUI, andthe GUI server.SAPinst records the installation progress in the keydb.xml file. Therefore,you can continue the installation from the point of failure withoutrepeating 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 youuse Ctrl + C , because this kills the process immediately.

ProcedureThis procedure describes the steps to restart an installation, which you stopped by choosing Stop, orto continue an interrupted installation after an error situation.

1. Log on to your local UNIX host as user root.

Caution


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 theWelcome screen, select the installation service that you want tocontinue and choose Next.

Note

If there is only 1 component to install, theWelcome screen does not appear.

TheWhat Do You Want to Do? screen appears.5. In theWhat Do You Want to Do? screen, decide between the following alternatives and confirm

with OK:

11/10/2008 PUBLIC 25/30

4 Additional Information4.9 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 allinstallation-specific files to a backup directory. Afterwards, you can nolonger continue the old installation option.For the backup directory, the following naming convention is used:<log_day_month_year_hours_minutes_seconds>.

Examplelog_01_Oct_2008_13_47_56

Continue with the Old Option SAPinst continues the interrupted installation option from the point offailure.

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 problemn Abort the installation by choosing Cancel in the SAPinstmenu.

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 suchas missing repaints or refreshes, contact your X Server vendor. The vendor can give youinformation about whether this X Server supports Java Swing-based GUIs and also tell youabout 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 appropriateentries to make entries in the system, for example, “Enter your <User Name>”.

ExampleExample

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 thedocumentation

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 tospecific 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, messagesn Source code or syntax quoted directly from a programn 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 languagewhen they are surrounded by body text, for example, SELECT and INCLUDE

EXAMPLE Keys on the keyboard

11/10/2008 PUBLIC 27/30

http://www.sap.com



SAP AGDietmar-Hopp-Allee 16

69190 WalldorfGermany

T +49/18 05/34 34 34F +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 permissionof 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 othersoftware vendors.

No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permissionof 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 othersoftware 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 SystemsIncorporated 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 registeredtrademarks 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 implementedby Netscape.SAP, R/3, xApps, xApp, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP Business ByDesign, and other SAP productsand services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG inGermany and in several other countries all over the world. All other product and service names mentioned are thetrademarks of their respective companies. Data contained in this document serves informational purposes only. Nationalproduct 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 notbe liable for errors or omissions with respect to the materials. The only warranties for SAP Group products and services arethose that are set forth in the express warranty statements accompanying such products and services, if any. Nothing hereinshould 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.2from Michael Kay (http://saxon.sf.net/), XSLT version 1.

28/30 PUBLIC 11/10/2008

DisclaimerSome components of this product are based on Java™. Any code change in these components may cause unpredictable andsevere 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 oraltered in any way.

Documentation in the SAP Service MarketplaceYou can find this document at the following address: https://service.sap.com/instguides

11/10/2008 PUBLIC 29/30

https://service.sap.com/instguides



SAP AGDietmar-Hopp-Allee 1669190 WalldorfGermanyT +49/18 05/34 34 34F +49/18 05/34 34 20www.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 bechanged without prior notice.

Documents

Sap Library Guide Unix