Webdispatcher Unix
Webdispatcher Unix
Target Audience
n Technology consultants
n System administrators
PUBLIC
Document version: 1.30 03/28/2008
Document History
Caution
Before you start the implementation, make sure you have the latest version of this document. You
can find the latest version on SAP Service Marketplace http://service.sap.com/instguides.
The following table provides an overview on the most important document changes:
Version Date Description
Chapter 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . 5
1.1 Web Dispatcher . . . . . . . . . . . . . . . . . . . . . . . 5
1.2 SAP Notes for the Installation . . . . . . . . . . . . . . . . . . 6
1.3 Online Information from SAP . . . . . . . . . . . . . . . . . . 7
1.4 Naming Conventions . . . . . . . . . . . . . . . . . . . . . 7
Chapter 2 Planning . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.1 Basic System Parameters . . . . . . . . . . . . . . . . . . . . 9
Chapter 3 Preparation . . . . . . . . . . . . . . . . . . . . . . . . 11
3.1 Hardware and Software Requirements . . . . . . . . . . . . . . . 11
3.1.1 Running the Prerequisite Checker in Standalone Mode (Optional) . . . . 12
3.1.2 Requirements for AIX . . . . . . . . . . . . . . . . . . . . 13
3.1.3 Requirements for HP-UX . . . . . . . . . . . . . . . . . . . 16
3.1.4 Requirements for Linux . . . . . . . . . . . . . . . . . . . . 18
3.1.5 Requirements for Linux for System z . . . . . . . . . . . . . . . 20
3.1.6 Requirements for Solaris . . . . . . . . . . . . . . . . . . . . 22
3.1.7 Requirements for the Instance . . . . . . . . . . . . . . . . . 26
3.2 Creating Operating System Users Manually (Optional) . . . . . . . . . 26
3.3 SAP Directories . . . . . . . . . . . . . . . . . . . . . . . 27
3.4 Installing the Java Runtime Environment . . . . . . . . . . . . . 28
3.5 Preparing the Installation DVDs . . . . . . . . . . . . . . . . . 29
3.5.1 Required Installation DVDs . . . . . . . . . . . . . . . . . . 29
3.5.2 Downloading Installation DVDs from SAP Service Marketplace (Optional) . 30
Chapter 4 Installation . . . . . . . . . . . . . . . . . . . . . . . . 33
4.1 Running SAPinst . . . . . . . . . . . . . . . . . . . . . . 33
4.2 Performing a Remote Installation with SAPinst (Optional) . . . . . . . 37
4.3 Starting SAPinst GUI Separately (Optional) . . . . . . . . . . . . . 38
4.4 Interrupted Installation with SAPinst . . . . . . . . . . . . . . . 40
1 Introduction
This documentation describes how to install the Web Dispatcher for an existing SAP system.
We recommend to install the Web Dispatcher when you use an SAP system with several application
servers for web applications.
The Web dispatcher is situated between the Internet and your SAP system. It is the entry point for
HTTP(s) requests into your system, which consists of one or more SAP NetWeaver application servers.
Figure 1:
As a "software web switch", the Web dispatcher can reject or accept connections. When it accepts a
connection, it balances the load to ensure an even distribution across the servers.
You can use the Web dispatcher in ABAP+Java systems as well as in pure Java systems and in pure
ABAP systems.
Recommendation
The Web dispatcher is recommended when you use an SAP system with several SAP NetWeaver
application servers for Web applications.
The Web dispatcher can run on the machine that is connected directly to the Internet and requires
minimal configuration. You only have to enter the following data in the profile file:
n Port on which the HTTP(s) requests are to be received
Parameter icm/server_port_<xx>
n Host and HTTP port of the SAP message server
Parameters rdisp/mshost and ms/http_port)
Example
If you need to be able to call the Web application externally for example using the URL
www.shop.acme.com this host name must be mapped internally to the Web dispatcher, which
then forwards the HTTP(S) request to a suitable application server.
More Information
Recommendation
For more information see the Web Dispatcher documentation on the Help Portal:
help.sap.com/nw2004s SAP NetWeaver Library SAP NetWeaver by Key Capability Solution Life
Cycle Management by Key Capability System Management SAP Web Dispatcher .
You must read the following SAP Notes before you start the installation. These SAP Notes contain 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 in the SAP
Service Marketplace at http://service.sap.com/notes.
Variables
Variables Description
<SAPSID> SAP system ID in uppercase letters
<sapsid> SAP system ID in lowercase letters
<DBSID> Database ID in uppercase letters
<dbsid> Database ID in lowercase letters
<host_name> Name of the corresponding host
<user_home> Home directory of the user performing the installation.
<INSTDIR> Installation directory for the SAP system
<DVD_DIR> Directory on which a DVD is mounted
<OS> Operating system name within a path
<SCHEMA_ID> Database schema ID
Example
Log on as user <sapsid>adm and change to the directory /usr/sap/<SAPSID>.
If your SAP system ID is C11, log on as user c11adm and change to the directory /usr/sap/C11.
2 Planning
The tables below list the basic system parameters that you need to determine before you start the
installation. For all other SAP system parameters, use the F1 help in the SAPinst screens.
Parameters Description Your Value
File system for the home /home/<username> ...
directory user
Note
/home/ is only a recommendation.
SAP system mount /<sapmnt> is the base directory for the SAP system. ...
directory For /<sapmnt> you can use a directory of your choice.
Do not add <SAPSID> as subdirectory because the
system adds this directory automatically.
Example
If you enter /<sapmnt>, the system creates the
directory /<sapmnt>/<SAPSID>.
SAP System ID <SAPSID> The SAP System ID <SAPSID> identifies the whole SAP ...
system.
Caution
Choose your SAP system ID carefully. You cannot
change the SAP system ID after the installation.
Caution
Do not use 02, 75 for the instance number because:
n 02 is used to determine the port number for
report RSLGCOLL, which is 14<instance_number> by
default. The port 1402 however is already used by
the OS process rstlisten. If you decide to use 02 as
the instance number anyway, the instance fails to
start during the installation process. You then have
to change the port number for report RSLGCOLL
manually to continue with the installation.
n 75 is already used by the operating system. For
more information, see SAP Note 29972
End of: HP-UX
Operating System (OS) SAPinst will create the operating system user ...
User <sapsid>adm automatically unless you created it manually
[page 26] before starting SAPinst.
SAPinst prompts you to assign a password during the
input phase of the installation.
Message Server Host The host on which the message server is located (profile ...
parameter rdisp/mshost)
Message Server HTTP Port HTTP port of the message server (profile parameter ...
ms/server_port_<xx>)
Password for the In order to use the web administration interface for ...
Internet Communication the Internet Communication Manager (ICM) and
Management (ICM) user SAP Web Dispatcher, an administration user webadm is
created by SAPinst.
You have to assign a password for this user.
3 Preparation
Caution
If your hosts do not fully meet the requirements, you might experience problems when working
with the SAP system.
Process Flow
Note
For the most recent updates to the Prerequisite Checker, always check SAP Note 855498.
Before installing your SAP system, you can run the Prerequisite Checker in standalone mode to check the
hardware and software requirements for your operating system (OS) and the SAP instances.
Note
When installing your SAP system, SAPinst automatically starts the Prerequisite Checker and checks the
hardware and software requirements in the background.
Prerequisites
Only valid for: IBM DB2 for z/OS
n You have to select the operating system type of your central instance host when running the
Prerequisite Checker.
End of: IBM DB2 for z/OS
n You have installed the correct Java Runtime Environment (JRE) [page 28].
n You have prepared the installation master DVD on the required installation host [page 29].
Procedure
1. You start SAPinst [page 33].
2. On the Welcome screen, choose Software Life-Cycle Options Additional Preparation Options Prerequisites
Check .
3. Follow the instructions in the SAPinst dialogs and enter the required parameters.
Note
For more information about each parameter, position the cursor on the parameter field and
choose F1 in SAPinst.
When you have finished, the Parameter Summary screen appears summarizing all parameters you have
entered. If you want to make a change, select the relevant parameters and choose Revise.
4. To start the Prerequisite Checker, choose Start.
Result
The Prerequisite Check Results screen displays the results found. If required, you may also check the
results in file prerequisite_checker_results.html, which you find in the installation directory.
Only valid for: AIX
Note
The information here is not intended to replace the documentation of the AIX operating system.
You can perform AIX-specific steps as follows:
n Manually by entering AIX commands with the appropriate options
n Using System Management Interface Tool (SMIT), a menu-driven system administration tool
If you have problems with the function keys, you can also use ESC and the corresponding number
to simulate the function key (for example, F4 is equivalent to ESC and 4 ).
Hardware Requirements
CPU The recommended minimum hardware is either two physical single core processors or
one physical dual core processor.
Software Requirements
Other Requirements
Keyboard You can set the keyboard by typing this command on the directly connected console:
smitty chkbd
You can select your keyboard under Motif by setting a language environment (LANG),
for which a National Language Support (NLS) component is installed. The settings
take effect after reboot.
Network Test the network connection to the database server with this command:
/etc/ping <db_server_name> 100 10
n The information here is not intended to replace the documentation of the HP-UX operating
system (OS). For more information about HP-UX, see http://docs.hp.com.
n HP has released HP-UX 11i for the Itanium processor family. HP-UX 11i for Itanium is built from
the same code base as HP-UX 11i for PA-RISC and has the same look-and-feel.
In general, all OS requirements for HP-UX are valid for both the PA-RISC version and the Itanium
versions.
There are some exceptions due to new functionality of the latest HP-UX releases. They are listed in
the appropriate sections of this documentation.
n For more information about HP-UX 11iv3 and HP-UX 11.31, see SAP Note 1031960.
n As of HP-UX 11.31, HP offers a new web-based tool for system management, System Management
Homepage (SMH). You can start it in text mode or in web-based mode.
For more information about how to start it in web-based mode, see http://docs.hp.com.
The host machine must meet the following requirements:
Hardware Requirements
CPU The recommended minimum hardware is either two physical single core processors or
one physical dual core processor.
To display the number of CPUs in a system call, enter the following command:
ioscan -fnkCprocessor
Software Requirements
Example
iso_8859.1 or hp_roman8
Other Requirements
Keyboard You can set the keyboard on an ASCII console as follows. A configuration menu bar is
activated via the User/System key:
config keys terminal config
Note
n The information here is not intended to replace the documentation of the Linux operating
system (OS).
n For more information about the installation on Linux, see SAP Note 171356.
n For information about SAP on Linux, see http://sdn.sap.com/irj/sdn/linux.
The host machine must meet the following requirements:
Hardware Requirements
Caution
On Linux for System z, the DVD drive cannot be connected to the central
instance host. However, you can connect the CD / DVD drive to any other host
that is connected to the central instance host.
End of: IBM DB2 for z/OS
End of: IBM DB2 for Linux and UNIX and Windows;IBM DB2 for z/OS;MaxDB;MS SQL
Server;Oracle
l You can configure multiple DVD drives. For more information, see Mounting a CD /
DVD for Linux [page 48].
Example
Here are some examples of hardware-specific commands for RAID devices:
/sbin/fdisk /dev/rd/c0d0
/sbin/fdisk /dev/ida/c0d0
CPU The recommended minimum hardware is either two physical single core processors or
one physical dual core processor.
Software Requirements
Linux kernel version Check the Linux kernel version with this command:
uname -r
Linux kernel parameter Check the Linux kernel parameter settings with this command:
settings /sbin/sysctl a
Activated hardware Check the activated hardware drivers with this command:
drivers lsmod
Shared memory file Check the size of the shared memory file system with this command:
system df k /dev/shm
n On SUSE LINUX
rcnfs status
rcnfsserver status
rcportmap status
System language For the installation, you must choose English as the operating system language on
all Linux hosts that run SAP software.
National Language To display available locales, enter the following command:
Support (NLS) locale -a
Check the output for locales such as the following:
de_DE, en_US
locales are available as an attachment of SAP Note 171356.
LDAP (Lightweight If you want to use LDAP, you need the LDAP libraries that are usually installed with
Directory Access the openldap RPM. To check, enter this command:
Protocol) rpm -qa | grep openldap
Make sure that the output of this command contains at least one of the following
RPM packages:
n Red Hat Linux:
openldap2
n SUSE LINUX
openldap2
openldap2client
C compiler The C compiler gcc must be installed. To check, enter this command:
rpm -qa | grep gcc
Make sure that the output of this command contains a gcc RPM package.
Other Requirements
Network Test the network connection to the database server with the following command:
ping -c 10 <db_server_name>
The information here is not intended to replace the documentation of the Linux operating system
(OS).
The host machine must meet the following requirements:
Note
For more information about the installation of Linux for System z, see SAP Note 81737.
Hardware Requirements
Software Requirements
Linux kernel version Check the Linux kernel version with this command:
uname -r
Linux kernel Check the Linux kernel parameter settings with this command:
parameter settings /sbin/sysctl -a
SUSE Linux only: To check whether suse-sapinit is installed, enter the following command:
suse-sapinit must be rpm -qa | grep sapinit
installed The output must contain:
sapinit
Activated hardware Check the activated hardware drivers with the following command:
drivers lsmod
Shared memory file Check the size of the shared memory file system with the following command:
system df -k /dev/shm
saplocales To check whether the required saplocales are installed, enter the following
command:
rpm -qa | grep saplocales
The output must contain the following:
saplocales-<GLIBC>-<VERS>
<GLIBC> is the installed glibc version
<VERS> is the saplocales version
saplocales are available as an attachment of SAP Note 171356.
LDAP (Lightweight If you want to use LDAP, you need the LDAP libraries that are usually installed with
Directory Access the openldap RPM. To check, enter this command:
Protocol) rpm -qa | grep openldap
Make sure that the output of this command contains at least one of the following
RPM packages:
n SUSE Linux
openldap2
openldap2client
C compiler The C compiler gcc must be installed. To check, enter the following command:
rpm -qa | grep gcc
Make sure that the output of this command contains a gcc RPM package.
Other Requirements
Network To test the network connection to the database server, enter the following command:
ping -c 10 <db_server_name>
Note
The information here is not intended to replace the documentation of the Solaris operating system
(OS). For more information, see the Solaris online documentation at http://docs.sun.com.
Hardware Requirements
RAM Display the available working memory with the following command:
/usr/sbin/prtconf |grep Memory
CPU The recommended minimum hardware is either two physical single core
processors or one physical dual core processor.
Display the status and number of existing CPUs with the following command:
/usr/sbin/psrinfo
Software Requirements
National Language To display which locales are available, enter the following command:
Support (NLS) locale -a
The following files must be available: iso_8859_1, en_US.
Lightweight Directory If you want to use LDAP, you required the following LDAP library:
Access Protocol (LDAP) libldap.so
Patches To check the installed patches, enter the following command:
/bin/showrev -p
Note
For more information about relevant patches, see the following SAP Notes:
n Sun Solaris 9: SAP Note 550585
n Sun Solaris 10: SAP Note 832871
n Solaris 10 on x64: SAP Note 908334
C++ runtime The Shared Library Patch for C++ must be installed.
environment
Solstice DiskSuite Check whether Solstice DiskSuite is installed with this command:
/bin/pkginfo | /usr/bin/grep SUNWmd
For more information, see the documentation for Solstice DiskSuite.
Veritas Volume If you do not use Solstice DiskSuite, check whether Veritas Volume Manager is
Manager installed:
/bin/pkginfo | /usr/bin/grep SUNWvx
For more information, see the documentation for Veritas Volume Manager.
Other Requirements
C++ runtime Make sure that the shared library patch for C++ is installed.
environment
Installation In a standard Solaris installation, /tmp is a tmpfs file system.
directory tmpfs is a memory-based file system that uses kernel resources relating to the VM
system and page cache as a file system.
Once mounted, a tmpfs file system provides standard file operations and semantics.
tmpfs is so named because all files and directories are lost after reboot or unmounts.
For this reason, we recommend that you create a directory /temp on a ufs file system.
The Web Dispatcher host must meet at least the following requirements for the Web Dispatcher
instance:
Requirement Values and Activities
Hard disk space n Hard disk drives with sufficient space for the Web Dispatcher instance.
For more information, see Setting up File Systems [page 27].
n 4.3 GB of temporary disk space for every required installation DVD that you
have to copy to a local hard disk. .
n 1.2 GB of temporary disk space for the installation.
Minimum RAM 500 MB
Swap space AIX, Solaris, z/OS: 3 * RAM
Linux, HP-UX: 2 * RAM
Network File System Network File System (NFS) must be installed.
(NFS)
If you do not want SAPinst to create operating systems users, groups and services, you can optionally
create them manually before the installation.
If you want to use global accounts which are configured on a separate host, you need to run the
installation service Operating System Users and Groups on this host.
For more information, see Running SAPinst [page 33].
SAPinst checks whether the required users and groups already exist. If not, it creates new users and
groups as necessary.
SAPinst chooses available user IDs and group IDs.
Users and Their Primary Groups
User Primary Group Additional Group Comment
<sapsid>adm sapsys sapinst SAP system administrator
Caution
If these operating system users already exist, make sure that they are assigned to group sapinst.
sapinst <sapsid>adm
SAPinst automatically creates the directories listed in the following figures and tables.
Before running the installation, you have to set up the required file systems manually. In addition,
you have to make sure that the required disk space for the directories to be installed is available
on the relevant hard disks.
The figure below assumes that you have set up one file system for the SAP system mount directory
<sapmnt> and one file system for the /usr/sap directory. However, you have to decide for which
directories you want to set up separate file systems. If you do not set up any file system on your
installation host, SAPinst creates all directories in the root directory /.
SAPinst prompts you only for the <sapmnt> directory during the installation. See also Basic SAP
System Parameters [page 9].
Figure 2:
The instance name (instance ID) of the Web Dispatcher instance is W<Instance_Number>, for example
W00.
Note
The listed file system sizes are initial SAP requirements.
Depending on your operating system, you might also have to add space for administrative purposes.
You need to prepare your system for SAPinst. This includes the installation of a Java Runtime
Environment (JRE), which is required both for SAPinst and the SAPinst GUI.
Note
If required, you can perform a remote installation using a standalone SAPinst GUI on a separate
Windows or UNIX host. This lets you perform the installation on a remote host, controlling it
with the SAPinst GUI from a local host. If you want to perform a remote installation, see Performing
a Remote Installation with SAPinst [page 37]. In this case, you need at least a JRE on the local host to
start the SAPinst GUI there.
Procedure
1. Check the JRE versions that are released for SAP systems in the Product Availability Matrix (PAM):
a) Go to http://service.sap.com/pam.
b) On the right-hand panel, choose SAP NetWeaver SAP NetWeaver 7.0 (2004S) .
c) Choose tabstrip JSE Platforms.
Note
For more information about the recommended JRE version for your operating system and about
how to download it, see SAP Note 723909.
Since the JRE is not part of the SAP shipment, you need to download and install it. The JRE
is part of the JDK (Java Development Kit).
n If the JRE is already installed
Check the installed version of the JRE by entering:
java -version
Note
SAPinst checks environment variable SAPINST_JRE_HOME for a valid Java runtime environment.
If SAPINST_JRE_HOME is not found, SAPinst also checks JAVA_HOME.
Note
If you use a Sun Java VM, you have to perform the following:
Edit the configuration file $JAVA_HOME/jre/lib/security/java.security and replace entry
securerandom.source=file:/dev/random with securerandom.source=file:/dev/urandom.
You need the following installation DVDs for the Web Dispatcher installation:
Short Name of Required DVD Full Label of Required DVD
Installation Master DVD SAP NetWeaver 7.0 SR<support release number>
Installation Master
Kernel DVD SAP NETWEAVER 7.0 SR<support release
number> Kernel (DVD), according to operating
system
Note
Normally you obtain the installation DVDs as part of the installation package you received from SAP.
However, you can also download installation DVDs from SAP Service Marketplace [page 30].
More Information
You can find a complete list of all media shipped with SAP NetWeaver 7.0 in the document
Media List for SAP NetWeaver 7.0 SR<support release number> on SAP Service Marketplace at
http://service.sap.com/installNW70 Installation .
You normally obtain the installation DVDs as part of the installation package from SAP.
However, you can also download installation DVDs from SAP Service Marketplace at:
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 on SAP Service Marketplace 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.
Note
SAPCAR asks if you want to replace existing files, for example LABELIDX.ASC. Always accept
with Yes.
4 Installation
You have to install the Web Dispatcher using the SAPinst tool.
Here you find information how to start and run SAPinst on your installation host.
Prerequisites
n Check that your installation hosts meets the requirements for the installation. For more
information, see Hardware and Software Requirements [page 11].
n 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 variables TEMP, TMP, or TMPDIR point, for
example by using a crontab entry.
Note
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.
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 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.
n Make sure that your SAPINST_JRE_HOME environment variable is set to a valid Java Runtime
Environment (JRE).
Only valid for: AIX
n If the operating system is AIX 64-bit, make sure that the PATH variable points to a JDK/JRE for
AIX 64-bit.
End of: AIX
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
filesize unlimited
datasize 2097148 KB
stacksize 8192 KB
coredumpsize unlimited
descriptors 8192
memorysize unlimited
Output Properties
time(seconds) unlimited
file(blocks) unlimited
data(kbytes) 2097148
Output Properties
stack(kbytes) 8192
coredump(blocks) unlimited
nofiles(descriptors) 8192
memory(KBytes) unlimited
If your parameter settings differ from the settings above, change these values accordingly.
Example
If you have to change the value for descriptors to 8192, proceed as follows:
u In csh execute:
limit descriptors 8192
u In sh or ksh execute:
ulimit -n 8192
Procedure
1. Mount the Installation Master DVD.
2. Start SAPinst from the Installation Master DVD in one of the following ways:
n Using the default installation directory (recommended)
Enter the following commands:
cd <Installation Master_DVD>/IM_<OS>
./sapinst
Caution
Make sure that your current working directory is not an IM_<OS> directory belonging to
another operating system.
For example, the following constellation causes an error:
$ cd /sapcd2/IM_HPUX_IA64
$ /sapcd2/IM_HPUX_PARISC/sapinst
The right constellation is as follows:
$ cd /sapcd2/IM_HPUX_PARISC
$ /sapcd2/IM_HPUX_PARISC/sapinst
Note
n During the installation, the default ports 21200 and 21212 are used for communication between
SAPinst, GUI server, and SAPinst GUI. SAPinst uses port 21200 to communicate with the GUI
server. The GUI server uses port 21212 to communicate with SAPinst GUI. 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>.
n To get a list of all available SAPinst properties, start SAPinst as described above with the option
-p:
./sapinst -p.
3. On the Welcome screen, choose Standalone Engines Web Dispatcher Web Dispatcher Installation
4. Follow the instructions in the SAPinst input dialogs and enter the required parameters.
Note
To find more information on each parameter during the Define Parameters phase of the installation,
position the cursor on the field of the respective parameter and press F1 .
After you have entered all requested input parameters, SAPinst displays the Parameter Summary screen.
This screen shows both the parameters that you entered and those that SAPinst set by default.
5. If required, change the displayed parameters as follows:
a) Select the parameters you want to change.
b) Choose Revise.
SAPinst displays input screens for the selected parameters.
c) Enter the new values for the parameters.
6. To start the installation, choose Start.
SAPinst starts the installation and displays the progress of the installation.
When the installation has successfully completed, SAPinst displays the screen Finished successfully.
7. If required, delete directories with the name sapinst_exe.xxxxxx.xxxx after SAPinst has finished.
Sometimes these remain in the temporary directory.
Note
If there are errors with SAPinst Self-Extractor, you can find the Self-Extractor log file
dev_selfex.out in the temporary directory.
Recommendation
We recommend that you keep all installation directories until you are sure that the system is
completely and correctly installed.
More Information
If you have problems during the installation, see Troubleshooting with SAPinst [page 52].
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.
Prerequisites
n The remote host meets the prerequisites before starting SAPinst [page 33].
n Both computers are in the same network and can ping each other.
To test this:
l Log on to your remote host and enter the command ping <local host>.
l 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. Enter the following commands:
cd <Installation_Master_DVD>/IM_<OS>
./sapinst -nogui
For more information, see Running SAPinst [page 33].
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.
4. Start SAPinst GUI on your local host as described in Starting SAPinst GUI Separately [page 38].
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 37].
If you want to run SAPinst GUI on a different host from SAPinst and the GUI server, you have to
start SAPinst GUI separately.
Prerequisites
You have installed the Java Runtime Environment [page 28] on the host on which you want to start SAPinst
without SAPinst GUI.
<DVD drive>:\IM_WINDOWS_<platform>
End of: IBM DB2 for Linux and UNIX and Windows;IBM DB2 for z/OS;MaxDB;MS SQL Server;Oracle
Note
l If you enter the command without additional parameters, SAPinst GUI uses the local host
as default. SAPinst GUI starts and tries to connect to the GUI server and SAPinst. Since
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.
l For a list of options to start SAPinst GUI, change to the same directory as your SAPinst
executable and enter the command startinstgui.bat -h.
Caution
Make sure that the root user has not set any environment variables for a different SAP system or
database.
2. Mount your installation DVD.
Note
Mount the DVD locally. We do not recommend that you use Network File System (NFS).
Note
l If you enter the command without additional parameters, SAPinst GUI uses the local host
as default. SAPinst GUI starts and tries to connect to the GUI server and SAPinst. Since
SAPinst and 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 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.
l For a list of options to start SAPinst GUI, change to the same directory as your SAPinst
executable and enter the command ./startInstGui.sh -h.
The SAP system installation might be interrupted for one of the following reasons:
n An error occurred during the dialog or processing 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 about 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 Exit 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 again, 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 SAPinst continues the installation from the current point.
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).
Note
If there is only one component to install, the Welcome screen does not appear.
Continue old installation SAPinst continues the interrupted installation from the point of failure.
5 Post-Installation Activities
Procedure
1. Open a web browser.
2. Enter the following URL:
http://<web_dispatcher_host>:<web_dispatcher_port>/sap/admin
If you did not enter a specific port number, <web_dispatcher_port> is by default
81<instance_number>.
3. Log on as user webadm with the password that you entered during the input phase of the
installation.
The SAP Web Dispatcher Monitor screen appears.
4. We recommend that you change the password of webadm immediately after the installation for
security reasons.
For more information on how to change passwords of existing users using the Admin Handler,
see http://help.sap.com/nw70 Knowledge Center for SAP NetWeaver 7.0 (2004s) Functional View
[close] SAP NetWeaver by Key Capability Solution Lifecycle Management by Key Capability System
Management SAP Web Dispatcher Administration of the SAP Web Dispatcher Using the Web Administration
Interface Area menu Section HTTP Handler
After installing the Web Dispatcher you have to configure and operate it.
You find all important information in the SAP Web Dispatcher documentation on the Help Portal. See
http://help.sap.com/nw70 SAP NetWeaver 7.0 Library English SAP NetWeaver by Key Capability
Solution Lifecycle Management by Key Capability System Management SAP Web Dispatcher
6 Additional Information
Note
<medium-mountdir> refers to either <cd-mountdir> or <dvd-mountdir>.
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 / DVD manually with the following command: mount -v
cdrfs -r /dev/cd0 /sapcd.
Note
The placeholder <medium-mountdir> is used for either <cd-mountdir> or <dvd-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>
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
Example
For example, <medium-mountdir> is /sapcd.
4. Perform task.
5. Exit SAM.
Example
For example, <medium-mountdir> is /sapcd.
Note
The following is not valid for Linux for zSeries. If you need to mount your CD/DVD on Linux for
System z, see Mounting a CD/DVD for Linux for System z [page 49].
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
Mounting a CD / DVD can be achieved either by mounting a CD / DVD drive of a UNIX workstation
by using NFS, or by copying the contents to the Linux file system after mounting the CD / DVD
on a Windows workstation.
NFS server
The Windows system must have third-party software installed providing the functions of an NFS
server. On Linux, the NFS client must be configured.
SAMBA
When using SAMBA, the CD / DVD cannot be accessed directly by Linux. Instead, the contents
must be copied to the Linux file system.
On Linux, SAMBA must be installed and configured. You have to provide a directory structure on
Linux for a copy of the CD / DVD. For every CD, a temporary disk space of about 650 MB is necessary,
and for every DVD a temporary disk space of about 4.3 GB. Define the directory as network share.
On the Windows system, map the share as network drive and copy the CD / DVD using the command:
xcopy <medium> <dest> /s/e
where <medium> is the CD / DVD drive and <dest> specifies the destination network drive and path.
End of: Linux IBM DB2 for z/OS
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.
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
After the installation, you can start vold using the following command:
/usr/sbin/vold.
End of: Solaris
You can start and stop the Web Dispatcher instance using the SAP Management Console (MC).
Prerequisites
Make sure that the SAP start service sapstartsrv is running:
For a new SAP system installation based on SAP NetWeaver 7.0 this service is still running after the
installation has finished successfully.
Procedure
1. Start a Web browser and enter the following URL:
http://<hostname>:5<instance_number>13
Example
If the instance number is 53and the host name is saphost06, you enter the following URL:
http://saphost06:55313
More Information
For more information about the SAP Management Console, see:
http://help.sap.com/nw70 SAP NetWeaver 7.0 Library English SAP NetWeaver Library SAP
NetWeaver by Key Capability Application Platform by Key Capability Java Technology Administration
Manual J2EE Engine J2EE Engine Administration Tools SAP Management Console
You can start and stop the Web Dispatcher instance by running the startsap and stopsap scripts.
Example
If the instance number is 01, then the command is startsap all W01.
Example
If the instance number is 01, then the command is stopsap all W01.
The following procedure describes how to uninstall a Web Dispatcher instance using SAPinst.
Procedure
1. Start SAPinst [page 33].
2. On the Welcome screen, choose Software Life-Cycle Options Uninstall System / Standalone Engine /
Optional Standalone Unit .
3. Follow the instructions in the SAPinst input dialogs.
Note
To find more information on each parameter during the Define Parameters phase of uninstalling,
position the cursor on the field of the respective parameter and press F1 .
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 dialog or processing phase, do either of the following:
n Try to solve the problem
n Abort the installation with Exit
For more information, see Interrupted Installation with SAPinst [page 40].
n 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.
4. If SAPinst GUI does not start, check the file sdtstart.err in the current <user_home> directory.
5. If SAPinst GUI aborts during the installation without an error message, restart SAPinst GUI as
described in Starting SAPinst GUI Separately.
Example Description
< > 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>.
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
Example Textual cross-references to an internet address, for example, http://www.sap.com
/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