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 Overview of Gateway Installation Procedure

SAP AG

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 Installing the Gateway with GWSETUP

SAP AG

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 Installing the Gateway with GWSETUP

SAP AG

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