SAP AG

Installing an SAP Gateway Instance on Windows NT

Overview

Chapter 1: Installing an SAP Gateway Instance on Windows

NT
Overview
This document describes how to install an R/3 Gateway instance with the GWSETUP
tool.

Contents
Overview of Gateway Installation Procedure.............................................................. 12
Preparations................................................................................................................... 12
Software Requirements .............................................................................................. 12
Installing the DLLs for Windows NT ........................................................................... 12
Installing the Microsoft Management Console............................................................ 13
Granting User Rights for the Installation..................................................................... 13
Installing the Gateway with GWSETUP ....................................................................... 14
Installing the GWSETUP Tool .................................................................................... 14
Running GWSETUP ................................................................................................... 15
Errors .......................................................................................................................... 16
Post Processing.......................................................................................................... 16

March 1999

11

Installing an SAP Gateway Instance on Windows NT

SAP AG

Overview of Gateway Installation Procedure

Overview of Gateway Installation Procedure

The Gateway instance is installed with the GWSETUP installation tool. Before you can
use the tool, you have to perform a number of preparatory steps. The following lists all
the steps involved in a gateway installation:
Check whether your system meets the requirements for installing a gateway
Install the latest version of the Dynamic Link Libraries for NT
Install the Microsoft Management Console
Assign the necessary rights to the user that performs the installation
Copy the GWSETUP tool to the machine where you intend to setup the gateway
instance
Install the Gateway instance using GWSETUP
Run the program R3GWSIDEINFO.EXE to add parameters to the gateway
configuration file

Preparations
In preparation for the installation of the gateway you have to:
Check the software requirements
Install the DLLs for Windows NT
Install the Microsoft Management Console
Grant user rights for the gateway installation
These steps are described in the next sections.

Software Requirements
Ensure that the following software is installed on the host where you intend to install the
gateway instance:
Windows NT 4.0 and Service Pack 4
Internet Explorer version 3.0 or later
The next sections describe these preparatory steps.

Installing the DLLs for Windows NT

To install the latest version of the DLLS for NT, run the program r3dllins.exe:
1. Insert the PRESENTATION CD in the CD-ROM drive.
2. Switch to the directory:
<CD_DRIVE>:GATEWAY\NT\I386\NTPATCH
(Alpha: <CD_DRIVE>:\NT\ALPHA\NTPATCH)

3. Start the program r3dllins.exe.

When the installation has finished, you are asked whether you want to reboot. It is
recommended that you reboot to make the changes take effect.

12

March 1999

SAP AG

Installing an SAP Gateway Instance on Windows NT

Preparations

Installing the Microsoft Management Console

To install the Microsoft Management Console (MMC) do the following:
1. Insert the PRESENTATION CD in the CD-ROM drive.
2. Switch to the directory:
<CD_DRIVE>:GATEWAY\NT\I386\MMC
(Alpha: <CD_DRIVE>:\NT\ALPHA\MMC)

3. Run the following two programs in the order given:

IMMC.EXE
ADS.EXE

Granting User Rights for the Installation

The person performing the installation needs certain rights that authorize him to perform
the steps necessary for the installation. The rights required depend on the type of
installation that is to be performed. This can be either a domain or a local installation.
Take care in setting up the users required for the installation otherwise the installation
will fail.
Domain Installation

In a domain installation, the SAP-specific groups and user accounts are stored centrally,
for all hosts, on the Domain Controller. The user that performs this type of installation
must have domain administrator rights and therefore be a member of the group Domain
admins.
Domain Installation Without Domain Administration Rights

If for any reason, you are unable to grant a user domain administrator rights for the
installation, then you can perform the installation as a domain user with local
administrator rights. However you first have to prepare the system as follows:
1. Ask an existing domain administrator to create a new global group called
SAP_<SID>_GlobalAdmin and the following two user accounts.

SAPService<SID>
<sid>adm
Note

Be careful to enter SAPService<SID> , <sid>adm and

SAP_<SID>_GlobalAdmin exactly as specified observing upper and lowercase.
2. Once the accounts have been created assign the users SAPService<SID> and
<sid>adm to the newly created group SAP_<SID>_GlobalAdmin . Also assign the
user <sid>adm to the group Domain Users.
Any domain user with local administrator rights can now perform a domain installation
with GWSETUP without being a member of the Domain admins group.

March 1999

13

Installing an SAP Gateway Instance on Windows NT

SAP AG

Installing the Gateway with GWSETUP

Local Installation

A local installation should only be considered, if the R/3 central instance and database
are installed on a single host without any further application servers. In this case, the
SAP-specific groups and user accounts are stored locally on this host. A user that
performs a local installation needs to have local administrator rights for the central
instance host.

Installing the Gateway with GWSETUP

To install the gateway using the GWSETUP tool, you have to:
Copy the GWSETUP tool to a local directory on the gateway host
Run GWSETUP to install the gateway
Run the program R3GWSIDEINFO.EXE to add parameters to the gateway
configuration file
The following sections describe these steps.

Installing the GWSETUP Tool

Before you can run GWSETUP, you need to copy the required files from the CD to your
hard disk with the program GWSETUP.BAT.
1. Log on to the NT system as one of the following users:
For a domain installation log on to the NT system as a domain user with local
administrator rights. This user must be a member of the Domain Admins group.
For a domain installation, without domain administration rights, you can log on
as a domain user with local administrator rights. However you have to prepare
your system as described in the previous section Domain Installation Without
Domain Administration Rights. This involves creating the group
SAP_<SID>_GlobalAdmin with the two domain user accounts
Sapservice<SID> and <SID>adm before the logon.
For a local installation log on as a user with local administrator rights.
Note

Later when you have to log on to your system again to begin the installation with
GWSETUP, use the same user as the one here.
2. Ensure that the TEMP environment variable has been set. To check the variable
choose Start Settings Control Panel and select the System icon. On the
Environment tab look under User Variables. TEMP is normally set to C:\temp.
Make sure that the specified directory really exists in your file system.
3. Insert the PRESENTATION CD-ROM.
4. Start the program GWSETUP.BAT from the directory:
<CD_DRIVE>:GATEWAY\NT\I386
(ALPHA:<CD_DRIVE>:GATEWAY\NT\ALPHA)

14

March 1999

SAP AG

Installing an SAP Gateway Instance on Windows NT

Installing the Gateway with GWSETUP

The GWSETUP frontend window opens.

5. You are prompted to enter the following:
The name of your R/3 System <SAPSID>
The directory on your hard disk that the GWSETUP files are copied to.
Always choose Next when you have made an entry.
When you have entered the required information, GWSETUP performs the following
actions:
Copies all the files required for the gateway installation to the specified
directory.
Adds the gateway installation option to the NT Programs menu.
Assigns the rights necessary for performing an installation to the user that is
installing the GWSETUP tool.
6. When the installation of GWSETUP files to your hard disk has been completed, a
window appears instructing you either to log off or to reboot your system. Enter Yes.
Depending on the prompt, GWSETUP will now automatically reboot or log off from
your system.

Running GWSETUP
Once you have installed the GWSETUP tool on your local hard disk, you can use it to
install the gateway instance:
Start GWSETUP with the appropriate option from the NT Start menu
Enter the parameter values that you are prompted to enter
In detail, proceed as follows:
1. Log on as the same user that installed the GWSETUP tool to your hard disk.
Caution

If you do not log on as the user that installed GWSETUP, the installation aborts
because you do not have the rights to perform the installation. The following error is
displayed Required Privileges not held by the client is displayed
2. From the NT Start menu, choose Programs SAP R3 Gateway Setup SAP R3
Setup - Standalone Gateway
The INSTGUI window opens.
3. You are prompted to enter values for a number of parameters. This enables you to
give GWSETUP information about the hardware setup and configuration of the
gateway.
When GWSETUP has obtained all the information it needs, it automatically begins with
installation processing. This is indicated by the Installation Progress bar that begins to
move. During this phase, the GWSETUP window shows which step is in progress and
gives a brief explanation of the purpose of the step. The installation takes 5 to 10
minutes.

March 1999

15

Installing an SAP Gateway Instance on Windows NT

SAP AG

Installing the Gateway with GWSETUP

Errors
When an error occurs, GWSETUP automatically switches to the log view and aborts. In
this situation, you need to carefully examine the log entries to find out what has
happened. The log shows errors in red, warnings in green and other information in black.
Arrows are provided, that enable you to quickly jump from warning to warning or error
to error. When you are analyzing an error, it is advisable to always look at previous
warnings as these often contain important clues to what has happened. You can get help
on a particular message by clicking on it and choosing Help.
Further sources of information about the progress of GWSETUP are:
The log file GATEWAY.LOG
The current command file
After the execution of each step, the command file is updated to show the status of
the completed step. A successful step has the status OK, a failed step has the status
Error.
After rectifying an error, you can restart GWSETUP at any time you wish. To restart
GWSETUP, choose the required option from the NT Start menu. GWSETUP
resumes processing with the last step that was in progress when the installation
stopped. In some cases you might have to re-enter parameter values you have already
specified.

Post Processing
In a final step, when GWSETUP has finished processing, parameter values have to be
added to the gateway configuration file sideinfo. This is done with the help of the
program R3GWSIDEINFO.EXE which prompts you for all the required entries. To run
R3GWSIDEINFO.EXE , proceed as follows:
1. Switch to the directory <DRIVE>:\usr\sap\<SID>\<instance_name>\data
2. Start the program R3GWSIDEINFO.EXE.
3. Enter the information you are prompted for.
The program R3GWSIDEINFO.EXE records the information you provide in the sideinfo
file which controls the configuration of the gateway instance.

16

March 1999