mysap.com workplace 2.10 - installation guide... and os/400® are registered trademarks of ibm...

SAP® AG • Neurottstr. 16 • D-69190 Walldorf

00 000 000

mySAP.com WorkplaceMiddleware 2.11 - Installation

Guide

Release 2 .11

mySAP.com Workplace Middleware 2.11 - Installation Guide SAP AG

2 November 2000

Copyright©Copyright 2000 SAP AG. All rights reserved.

No part of this brochure may be reproduced or transmitted in any form or for any purpose withoutthe express permission of SAP AG. The information contained herein may be changed withoutprior notice.

Some software products marketed by SAP AG and its distributors contain proprietary softwarecomponents of other software vendors.

Microsoft®, WINDOWS®, NT®, EXCEL®, Word® and SQL Server® are registered trademarks ofMicrosoft Corporation.

IBM®, DB2®, OS/2®, DB2/6000®, Parallel Sysplex®, MVS/ESA®, RS/6000®, AIX®, S/390®,AS/400®, OS/390®, and OS/400® are registered trademarks of IBM Corporation.

ORACLE® is a registered trademark of ORACLE Corporation, California, USA.

INFORMIX®-OnLine for SAP and Informix® Dynamic Server are registered trademarks ofInformix Software Incorporated.

UNIX®, X/Open®, OSF/1®, and Motif® are registered trademarks of The Open Group.

HTML, DHTML, XML, XHTML are trademarks or registered trademarks of W3C®, World WideWeb Consortium, Laboratory for Computer Science NE43-358, Massachusetts Institute ofTechnology, 545 Technology Square, Cambridge, MA 02139.

JAVA® is a registered trademark of Sun Microssystems, Inc. , 901 San Antonio Road, Palo Alto,CA 94303 USA.

JAVASCRIPT® is a registered trademark of Sun Microsystems, Inc., used under license fortechnology invented and implemented by Netscape.

ADABAS® is a registered trademark of Software AG.

SAP, SAP Logo, mySAP.com, mySAP.com Marketplace, mySAP.com Workplace, mySAP.comBusiness Scenarios, mySAP.com Application Hosting, WebFlow, R/2, R/3, RIVA, ABAP, SAPBusiness Workflow, SAP EarlyWatch, SAP ArchiveLink, BAPI, SAPPHIRE, ManagementCockpit, SEM, SAP DB are trademarks or registered trademarks of SAP AG in Germany and inseveral other countries all over the world. All other products mentioned are trademarks orregistered trademarks of their respective companies.

Downloading this DocumentationYou can download this documentation from the following address:

http://service.sap.com/instguides

SAP AG mySAP.com Workplace Middleware 2.11 - Installation Guide

November 2000 3

Typographic Conventions

Type Style Represents

Interface Text Words or characters that appear on the screen. Thisincludes system messages, field names, screen titles,pushbuttons, menu names, and menu options.

Document Title Cross-references to other documentationUser Entry Exact user entry. These are words and characters that you

enter exactly as they appear in the documentation.File Name File names, batch files, paths or directories, and screen

messages<Variable UserEntry>

Variable user entry. Pointed brackets indicate that youreplace these words and characters with appropriateentries.

NAME Names of elements in the SAP System. These includereport names, program names, transaction codes, tablenames, and ABAP language elements.

KEY Keys on your keyboard. These include function keys (forexample, F2) and the ENTER key.

Icons

Icon Meaning

Caution

Example

Note

Recommendation

Syntax

Tip


4 November 2000

Contents

1 MYSAP.COM WORKPLACE MIDDLEWARE 2.11 -INSTALLATION GUIDE................................................................................ 6

2 INSTALLATION PROCESS .......................................................................... 8

2.1 Hardware and Software Requirements ....................................................................................102.1.1 ITS Installation .....................................................................................................................12

2.1.1.1 ITS Installation Requirements ..........................................................................................132.1.1.2 Installation Preparation .....................................................................................................15

2.1.1.2.1 Creating the ITS Administrator Account ....................................................................162.1.1.2.2 Creating the ITS Administrator group ........................................................................172.1.1.2.3 Creating the ITS User Group ......................................................................................18

2.1.1.3 Installation of the Web Server Instances...........................................................................192.1.1.4 Internet Application Components for the mySAP.com Workplace ..................................212.1.1.5 Single Host Installation.....................................................................................................23

2.1.1.5.1 Installing the ITS on a Single Host .............................................................................242.1.1.6 Dual Host Installation .......................................................................................................36

2.1.1.6.1 Installing AGate on the AGate Host ...........................................................................372.1.1.6.2 Installing WGate on the Web Host .............................................................................48

2.1.1.7 Installation of the ITS Instances for Administration Purposes (optional).........................552.1.1.8 Setting the ITS Service Parameter for the Workplace ......................................................612.1.1.9 Mobile Workplace Settings...............................................................................................622.1.1.10 Checking the ITS Installation ..........................................................................................632.1.1.11 Troubleshooting the ITS Installation ...............................................................................65

2.1.2 Internet Graphics Server (IGS) Installation (optional).........................................................682.1.2.1 Preparing the Installation ..................................................................................................692.1.2.2 Installing the Internet Graphics Server (IGS) ...................................................................702.1.2.3 Configuring the Internet Graphics Server (IGS)...............................................................71

2.1.3 Workplace Servlets Installation (optional) ...........................................................................732.1.3.1 Installing and Configuring the SAP DCOM Component Connector ................................742.1.3.2 Drag&Relate Servlet Installation......................................................................................83

2.1.3.2.1 Installing the Drag&Relate Servlet .............................................................................842.1.3.2.2 Configuring a Silent Installation.................................................................................922.1.3.2.3 Configuration of the Drag&Relate Servlet .................................................................942.1.3.2.4 Defining the Drag&Relate Parameter .........................................................................952.1.3.2.5 Activating HTML link generation ..............................................................................96

2.1.3.3 MiniApp Servlet Installation.............................................................................................972.1.3.3.1 Installing the MiniApp Servlet....................................................................................982.1.3.3.2 Configuring a Silent Installation...............................................................................1072.1.3.3.3 Configuration of the MiniApp Servlet ......................................................................1112.1.3.3.4 Defining the MiniApp Servlet for iViews Parameter ...............................................112

2.1.4 Terminal Server Installation (optional)...............................................................................1132.1.4.1 Setting up the Terminal Server .......................................................................................1142.1.4.2 Enabling the ITS to Use the Terminal Server .................................................................1172.1.4.3 Configuring the Workplace Server .................................................................................118

2.1.5 Business Connector Installation (optional) .........................................................................120


November 2000 5

3 OVERVIEW OF RELATED DOCUMENTATION ....................................... 121

4 OVERVIEW OF RELATED SAP NOTES .................................................. 123


6 November 2000

1 mySAP.com WorkplaceMiddleware 2.11 - InstallationGuide

Architecture OverviewThe graphic below illustrates the mySAP.com Workplace software components (dark gray box)and the mySAP.com component systems from an installation point of view.

Workplace Middleware Server (Host)

Frontend Server

Internet Explorer

Browser

(SAP GUI for HTML)

WorkPlaceUser

Frontend

SAP GUI forWindows

WindowsTerminalServer

SAP GUIfor Windows

SAP GUIfor Java

WindowsTerminal

Client

... if SAP GUIruns 'within'

Browser

launch viatemporary starter

Templates,Service Files

Internet Transaction Server

Internet Transaction Server

HTTP-Server

SAP GUI for HTML

Workplace Middleware

HTTP-Server

MiniApp

Drag & Relate Servlet

Portal Builder

JavaPlug In

Workplace Server 2.11

SAP Basis 4.6D

CitrixPlug In

HTTP-Server

(for D&Rw/ SSL)

SAP Business Connector

DCOM CC

APO ≥≥≥≥ 1.1

SEM ≥≥≥≥ 1.0

KW ≥≥≥≥ 4.0

CRM ≥≥≥≥ 1.1

BBP ≥≥≥≥ 2.0B SP 4

R/3 Core≥≥≥≥ 3.1H

BW ≥≥≥≥ 1.2A

mySAP.com Component Systems

Architecture of the mySAP.com Workplace

my SAP.com Workplace 2.11

InternetGraphicServer

MiniApp ServletHTTP-Server

DCOM CC


November 2000 7

Purpose of This DocumentationThis documentation

• Explains in detail in a step-by-step description how to install the following components of theWorkplace Middleware:

− SAP Internet Transaction Server (Single Host and Dual Host installation)

− Internet Graphics Server

− Drag&Relate Servlet

− MiniApp Servlet for iViews

− Terminal Server

• In addition, it outlines the main steps required to install

− Business Connector

• Describes installation specific steps for the Mobile Workplace (First Custumer Shipment:see also SAP Note 319895).

We strongly recommend to read the guide mySAP.com Workplace 2.11Installation - Overview that provides a complete overview of all installation andconfiguration steps. You will find this guide on the CD-ROM:SAP Online Documentation mySAP.com Workplace 2.11 in folder install/Toplevel.


8 November 2000

2 Installation ProcessPurposeThe Workplace Middleware formats the HTML pages that are displayed in the Web browser onthe frontend.

The functions of the SAP Internet Transaction Server (ITS) represent the basic technology of themySAP.com Workplace Middleware, together with a Web server. It mainly controls thegeneration of HTML pages and enables users to interact with the different SAP Systems using aWeb browser.

Every component system and the Workplace Server itself need a separate ITS instance.

If you run different applications or templates in different clients, you must create an ITS instanceper client.

On the other hand you have optional components that increase the functionality (Drag&Relate,Internet Graphic Server, Business Connector, Terminal Server).

Prerequisites• Read the SAP Notes in Overview of Related SAP Notes [on page 123] before beginning the

installation. These SAP Notes contain the most up-to-date information regarding theinstallation and corrections to this installation documentation. Make sure that you have themost recent version of these SAP Notes. You can find SAP Notes on the SAP ServiceMarketplace: http://service.sap.com/notes.

• Make sure that the following Workplace components are already installed:

a. Workplace Server

b. Component Systems.

We strongly recommend to read the guide mySAP.com Workplace 2.11Installation - Overview that provides a complete overview of all installation andconfiguration steps. You will find this guide on the CD-ROM:SAP Online Documentation mySAP.com Workplace 2.11 in folder install/Toplevel.

• Check the hardware and software requirements on page 10.

Process Flow1. On your Web server host(s) you have to install the Web server instance(s) for your ITS

instances to which you want to connect from the Web server host (Installation of the WebServer Instances [Page 19]).

The Web server must support multiple (Web server) instances.Netscape Enterprise Server (NES) supports multiple Web server instances as ofVersion 2.0.Microsoft Internet Information Server (IIS) supports multiple Web server instancesas of Version 4.0; if you are using IIS 4.0, Make sure that the option ‘Run inseparate memory space’ is not activated for each Web Server instance.


November 2000 9

If you install the Internet Information Server 4.0 to access SSL for theDrag&Relate Servlet, bear in mind, that the Netscape Enterprise Server and theInternet Information Server cannot run on one host simultaneously.

2. You have to install one separate SAP Internet Transaction Server instance (ITS Instance) forthe Workplace Server and each logical system .

For the ITS instance of the mySAP.com Workplace Server 2.11 you have to use aITS version 4.6D, Compilation 3.

You also need a separate ITS instance for administration purposes.

a. First install the ITS instance on the Workplace Server: ITS Installation [Page 12]

b. Reboot your system.

c. Install the next ITS instance for one of your component systems: ITS Installation [Page12]

d. Reboot your system.

e. Repeat steps 6 to 7 for each of your logical mySAP.com component systems.

f. Install the ITS instance for the its_adm package if required [Page 55].

3. Install the Internet Graphics Server if required [Page 68].

4. Install the Workplace Servlets if required [Page 73].

5. Install the Terminal Server if required [Page 113].

6. Install SAP Business Connector if required [Page 120].

ResultYou have completed the Workplace Middleware installation.


10 November 2000

2.1 Hardware and Software RequirementsThe following table provides a short overview of the minimum requirements:

Hardware and Software Requirements Overview

Workplace MiddlewareInternet Transaction Server

In the SAP Service Marketplace you can find the latest requirements and sizingrecommendations:

• requirements: http://service.sap.com/ssr

• sizing: http://service.sap.com/workplace; choose the folder Requirements.

Internet Graphic Server (optional): can either be installed on the ITS host or standalone

Hardware Software

• Pentium with 133 MHz

• 64 MB main memory

• Windows NT Server 4.0 or Windows 2000

• Either a 4.6D GUI or no GUI at all (see alsoSAP Note 147519).

Drag&Relate Servlet (optional): you can run it on a separate host or on a WEB server

Hardware Software

• Disk drive: 200 MB

• CPU: Pentium processor

• 512 MB RAM recommended (minimum256 MB)

• Windows NT Server 4.0

• Windows NT Service Pack 5.0

• SAP DCOM Component Connector

• Internet Information Server (Windows NTOption Pack 4 with standard options);only necessary if using SSL via the InternetInformation Server

• Microsoft Transaction Server (optional, toenable connection pooling)


November 2000 11

MiniApp Servlet for iViews (optional): you must run it on a WEB host connected to theWorkplace Server.

Hardware Software

• Pentium processor

• 512 MB RAM recommended (minimum256 MB)

• 200 MB free disk space

• Windows NT Server 4.0 (recommended) orWindows NT Workstation 4.0

• Windows NT Service Pack 5.0

• SAP DCOM Component Connector

• Windows NT Option Pack 4, includingInternet Information Server 4.0

• Microsoft Internet Explorer 5.01 or higher(required for the MiniApp Servlet for iViewsmachine only, and not for SAP Workplaceclient machines).

• MS SQL 7.0 Server (optional,recommended for optimum systemperformance)

Microsoft Terminal Server for the Citrix Client (optional): you must run it on a serverseparate to the ITS server

Hardware Software

Dedicated NT Terminal Server.

Sizing depends on the number ofconcurrent users (e. g. 4 x Pentium Xeon500 MHz with 2GB main memory for up to100 users of SAP GUI).

• Windows NT 4.0, Terminal Server Editionwith SP4 or higher in combination with CitrixMetaframe 1.8 and SP1 or higher isinstalled.

• Alternatively Windows 2000 Server orWindows 2000 Advanced Server withWindows Terminal Services in combinationwith Citrix Metaframe 1.8a or higher arealso supported.

• SAP GUI for Windows 4.6D.


12 November 2000

2.1.1 ITS InstallationThis process describes the main steps for installing the Internet Transaction Server (ITS) for themySAP.com Workplace.

Process FlowTo install the ITS, proceed as follows

1. Check: ITS Installation Requirements [Page 13].

2. Perform: Installation Preparation [Page 15]

This includes setting up the ITS administrator account and defining the ITS user group.

3. Perform a Single Host Installation [Page 23] or a Dual Host Installation [Page 36] , asrequired.

4. Check the installation [Page 63].

5. If necessary, perform: Troubleshooting the ITS Installation [Page 65].


November 2000 13

2.1.1.1 ITS Installation RequirementsBefore you install the Internet Transaction Server (ITS):

1. Check that the hardware and software requirements specified below are met.

2. Check that you have the data listed in the requirements checklists below.

Hardware / Software RequirementsIn SAP Service Marketplace you can find the latest requirements and sizingrecommendations:

• requirements: http://service.sap.com/ssr

• sizing: http://service.sap.com/workplace and click on the folder Requirements.

Requirement ChecklistsThe following tables specify all the information you need to install the ITS. Make sure that youhave this information available before running the ITS setup program.

AGate Configuration Parameters

Homepage(URL displayed when leaving a service)

SAP Parameters

SAP System name

Client

SAP Parameters (Load Balancing or Single Application Server)

Option Load Balancing Single ApplicationServer

SAP message server name √√√√ Not applicable

Port number for SAP message server √√√√ Not applicable

Login group used by ITS √√√√ Not applicable

SAP application server name Not applicable √√√√

SAP System number Not applicable √√√√

SAProuter string √√√√ √√√√

Windows NT System Parameters

Options Use NT Security Set up Security Later

Name of NT user ITSadm √√√√ Not applicable

Password of NT user ITSadm √√√√ Not applicable

Name of NT group ITSusers √√√√ Not applicable


14 November 2000

WGate Installation

Options WGate Installationon Separate Host

Single Host Installation

Name or IP address of AGate host √√√√ Not applicable

Number of ports(sapavw00_<virtual ITS> andsapavwmm_<virtual ITS>) onAGate host

√√√√ Not applicable


November 2000 15

2.1.1.2 Installation PreparationPurposeThis process describes the basic steps needed to prepare for installation of the InternetTransaction Server (ITS).

ProcessBefore installing the ITS, you should perform the following steps:

1. Check the installation requirements (see ITS Installation Requirements [Page 13]).

2. Make sure that the Windows NT 4.0 server and the Web server software have been installedproperly on the Web server host.

3. For security reasons, use the Windows NT File System (NTFS) to store ITS files.

NTFS fully supports Windows NT security and long file names.

To check that you are using NTFS:

a. Select the hard drive icon in the Windows NT Explorer.

b. Click the right mouse button.

c. Choose Properties.

d. Choose the General tab.

e. Check that the specified file system is NTFS.

3. Creating the ITS Administrator Account [Page 16].

4. Creating the ITS Administrator group [Page 17]

5. Creating the ITS User Group [Page 18]

6. Make sure that the TEMP directory is empty.


16 November 2000

2.1.1.2.1 Creating the ITS Administrator Account1. Log on to the Windows NT system as an administrator.

2. On the Windows NT 4.0 desktop, choose Start → Programs → Administrative Tools(Common) → User Manager for Domains.

3. Choose User → Select Domain.

4. Enter a Windows NT domain name for the ITSadm account and choose OK.

5. Choose User → New User.

6. Enter the following values:

Username: ITSadm

Full Name: SAP Internet Transaction Server Administrator

Description: <your description>

Password: <your password>

Confirm Password: <your password>

This documentation uses the ITS administrator account ITSadm, but you are freeto choose any name you like.

7. Choose Groups.

8. Add the new user to the administrator group for the selected domain and choose OK.

9. Choose Profile.

We recommend that you enter the following home directory in the Local Path fieldc:\winnt\Profiles\ITSadm

10. Choose OK.

11. Choose Add to create the ITSadm account.

12. Choose Close to close the New User window.

13. Choose User → Exit to leave the User Manager.

ResultThe ITS administrator account ITSadm is created. You can now create the ITS user group [Page18].


November 2000 17

2.1.1.2.2 Creating the ITS Administrator groupUseYou use this procedure to create the ITS administrator group.

PrerequisitesYou have created the ITS Administrator Account [Page 16].

Procedure1. Log on to the Windows NT system with the ITS administrator account ITSadm.




5. Choose User → New Global Group or New Local Group.


Group Name: ITSAdministrators


This documentation uses the ITS administrator group name ITSAdministrators,but you can choose any name you like.

7. Choose Add.

You see a list of names in the Add Users and Groups dialog box.

8. Select the user(s) you want to add to the ITS administrator group ITSAdministrators.

You should select the ITS administrator account ITSadm and any other members you want toadd.

9. Choose Add.

The selected user(s) are added.

You can always add other users to the group later.

10. Choose OK.

11. Choose OK to return.


ResultThe ITS administrator group ITSAdministrators is created.

You can now creat the ITS User Group [Page 18]


18 November 2000

2.1.1.2.3 Creating the ITS User GroupPrerequisitesYou have created the ITS administrator account [Page 16].

Procedure1. Log on to the Windows NT system with the ITS administrator account ITSadm.




5. Choose User → New Global Group or New Local Group.


Group Name: ITSusers


This documentation uses the ITS user group name ITSusers, but you are free tochoose any name you like.

7. Choose Add.

A list of names is displayed in the Add Users and Groups dialog box.

8. Select group member(s):

9. Choose Add.

The selected user(s) are added.

You can always add other users to the group later.

10. Choose OK.

11. Choose OK to return.



November 2000 19

2.1.1.3 Installation of the Web Server InstancesUseYou create the necessary Web server instances on the required host(s).

You can use either the Microsoft Internet Information Server 4.0 or the Netscape EnterpriseServer 3.51.

If you install the Internet Information Server 4.0 to access SSL for theDrag&Relate Servlet (see Installation of the Drag&Relate Servlet [Page 83]), notethat the Netscape Enterprise Server and the Internet Information Server cannotrun on the same host.

ProcedureInstalling MS Internet Information Server Instances (IIS instances).

The following documentation is a quick guide to creating your MS IIS WebServer instances. For more details, see the Microsoft documentation.If you want to use the Secure Socket Layer (SSL), you have to configure yourIIS Instance according to the Microsoft Documentation.

1. The Internet Explorer 5.01 and Option Pack 4 with the Internet Information Server 4.0 isinstalled on your Web host(s).

2. In the folder C:\InetPub\wwwroot you have to create a new directory for eachmySAP.com component system.

We recommend that you name the new directory according to the mySAP.comcomponent system name, for example C:\InetPub\wwwroot\P30.

You do not need to create a separate directory for the Workplace Server if youuse the Default Web Site that is automatically generated during the IISinstallation (we recommend that you use the Default Web Site: See step 6 below).

3. Select Start → Programs → Windows NT 4.0 Option Pack → Microsoft Internet InformationServer → Internet Service Manager.

4. In the left frame click the Internet Information Server folder.

5. In the right frame select the desired Web host name.

6. Click the right mouse button and choose New → Web Site.

We recommend that you use the Default Web Site (automatically generatedduring the IIS installation) to install the ITS instance for the Workplace Server.This means you do not need to install a separate instance for the WorkplaceServer here.

7. Enter a description in the Web Site Description field and choose Next.


20 November 2000

We recommend that you name the new Web Site according to the SAP Systemname.

8. Enter an unused port (for example, 81 or 82) in the TCP Port this Web Site should use(Default: 80) field.

9. Choose a directory in the Enter the path for your home directory field (see step 2).

10. Choose Next, and then Finish.

The Web Site dialog box disappears.

11. Select the Web site you just created.

12. Right-click the mouse and choose Properties.

13. Choose the Home Directory tab.

14. Choose Apply.

15. If the Web Site is stopped, do the following:

a. Select the stopped Web Site.

b. Right-click the mouse, and choose Start.

16. Repeat the steps above for all necessary IIS instances.

Installing Netscape Enterprise Server Instances.

The following is a quick guide to creating your Netscape Web Server instances.For full details, see the Netscape Documentation.

1. Make sure that Netscape Communicator 4.5 and Netscape Enterprise Server 3.51 areproperly installed.

2. Choose Start → Programs → Netscape SuiteSpot → Administration.

3. Choose Create New Enterprise Server and configure the parameters:

a. Server Port: Set this value to an unused port (for example, 81 or 82).

b. Server Identifier: Set this value to <Hostname>adm.

4. Repeat the steps above for all necessary Web server instances.

ResultYou have installed the necessary Web server instances. Now you can start the ITS Installation.


November 2000 21

2.1.1.4 Internet Application Components for themySAP.com Workplace

DefinitionInternet Application Components (IACs) are complete business solutions for linking the SAPSystem to the Internet. They allow Internet and Intranet users to start transactions, functionmodules and reports from a Web browser.

The ITS setup program allows you to select IAC packages as part of the standard installationprocedure. These packages contain all the files you need to run IACs for specific applications orother purposes.

UseAll IAC's you need during the ITS instances installation for your mySAP.com Workplace are givenon the table below (next page). All packages are located on the CD-ROM SAP ServerComponents 4.6D, Compilation 3 (see Path description in table below).

If you run different applications or templates in different clients, you must createan ITS instance per client.


22 November 2000

Where to install which IAC packages

ITS packages Purpose Where to find

webgui To be installed on all ITS instances Select the packagefrom the Do notinstall box by markingit and pressing Install

4.6D_bas To be installed on Workplace Server ITS Path: its /common/packages/R3/46d

workplac To be installed on the Workplace Server ITS

guistart Contains graphical user interfaces (GUIs)

We recommend to install the guistart on theWorkplace Server ITS

Post-installation stepsIf you are using the Microsoft Internet InformationServer (IIS) you have to set the permissions ofthe Web Server directoriessap\its\mimes\guistart\wngui and jvgui to non-execute and non-script. This can be doneby launching the Internet Service Manager andunchecking the checkboxes Script and Executein the permission panel of the properties dialog ofabove directory.

pbuilder(optional)

To be installed on Workplace Server ITSContains Portal Builder services

wp_comp To be installed on all ITS instancesContains Workplace Component services(MiniALV, Portable Interactive Graphics)

webaddon(optional)

To be installed on component system ITS

mwp (optional) To be installed on all ITS instancesContains components for the Mobile Workplace

Path: its /common/packages/wp/211

Componentspecificpackages

For each component system that you want tointegrate into the mySAP.com Workplace youhave to install the corresponding applicationpackages

Path: its /common/packages/<application>/<release>


November 2000 23

2.1.1.5 Single Host InstallationPurposeThis process describes how to install the Internet Transaction Server (ITS) on a single hostmachine.

This scenario should only be used for development systems.

Performing a single host installation, the WGate and the AGate are installed on the Web host.

PrerequisitesYou have performed: Installation Preparation [Page 15]

You have installed the Web Server instances [Page 19] for each ITS instance.

Before starting the installation, make sure that all other applications are closed.

Process Flow1. Proceed as described in Installing the ITS on a Single Host [Page 24]

2. After the installation check if you want to maintain a special ITS service Parameter [Page 61]for the mySAP.com Workplace log on.


24 November 2000

2.1.1.5.1 Installing the ITS on a Single HostUseThe following is a mySAP.com Workplace specific guide to creating your ITS instances.

For more details about the Internet Transaction Server, see the official SAP documentationSAP@Web Installation Guide (see Overview of Related Documentation [Page 121] ).

PrerequisitesBefore installing the ITS instances you have to make sure that there is already a correspondingWeb Server instance installed (see Installation of the Web Server Instances [Page 19]).

Procedure1. Log on to the Windows NT 4.0 server with the ITS administrator account.

2. Insert the Server Components Packages 4.6D CD-ROM in the CD-ROM drive.

3. Start the Windows NT Explorer.

4. Select the directory <CD-ROM>:\ITS\NT\I386.

5. Double-click setupits.exe and choose OK.

The Welcome screen appears.

6. Choose Next.

The Installation Type screen appears.

7. Select Single-Host. The WGate component and the AGate component will be installed on thesame host.

8. Choose Next.

The Destination Location screen appears.

9. Choose Next to accept the default destination of the ITS main directory, or choose Browse toselect a different destination.

If there is already an ITS instance installed on this machine, the previous installation directoryis used. In this case, the Browse option is not activated, and you cannot change thedestination.

When you choose Next, the ITS Installation Type screen appears.

10. Select the installation type Typical and choose Next.

11. Enter a virtual ITS instance name and choose Next.

We recommend that you use the SAP System name (for example P30) as theinstance name. If there are virtual ITS instances already installed on thismachine, you can display their names in the dropdown list box.


November 2000 25

12. Select a Web server.

As described above, the setup program states whether the server you selected is alreadyattached to a virtual ITS instance.

Using the Internet Information Server, we recommend that you use the DefaultWeb Site (automatically generated during the IIS installation) to connect to theWorkplace Server.

13. Choose Next.


26 November 2000

14. Enter the URL for accessing the Web server.

You must enter the full URL address including Hostname and Domain as shownin the graphic above.You don’t need to enter the HTTPS Access (Secure) information, because theITS setup program echoes this for you automatically. However, you have to entera different port for each instance (443 is the default port); deselect Automatic tomake the fields alterable.

15. Choose Next.


November 2000 27

16. The setup program asks you to choose the IAC package(s) you want to install. Thesepackages contain the IAC-related files to be used for your installation.

17. Select the packages you need for your specific instance as described in Internet ApplicationComponents for the mySAP.com Workplace [Page 21].

Do NOT install the its_adm package!When you have selected all the packages you need for this instance, choose Next andconfirm the installation of Internet Application Components.

18. Specify the maximum number of AGate processes you need. The default number is 1.

19. Choose Next.


28 November 2000

20. Select the configuration type Default configuration.

With this configuration type the ITS is optimized for performance with a large number ofconcurrent users, and sized for a server with a minimum of 128 MB of physical memory. Thisconfiguration is suitable for production systems.

If you select Minimize memory usage, the ITS is optimized for performance with a smallnumber of concurrent users, and sized for a server with a minimum of 32 MB of physicalmemory. This configuration is suitable for development and test systems where performanceis not critical. It is primarily intended to meet the needs of developers installing the ITS ontheir local machines.

21. Choose Next.


November 2000 29

22. Specify the SAP login Information

Enter the following login information, and choose Next:

a. System Name

Enter the name of the primary SAP System with which the ITS is meant to communicate.

The name consists of three alphanumeric characters.

b. Client

Enter the global client used by the ITS to log on to the SAP System.

Do not enter any SAP user ID or password.


30 November 2000

23. Specify the SAP connection information depending on which type of SAP System you have:

To guarantee a balanced load on all application servers running the selected SAP System,the ITS uses the SAP message server. This is the default option, and should be used for allproduction systems.

For development systems where performance considerations are less critical, you canchoose to connect to a single application server.

To improve performance for either of these options, you can also specify a SAProuter.

Depending on the option you select, enter information as specified in the following tables:

Load Balancing (default):

Field Required Value

Message Server Host name of the SAP message server as it is known either bythe domain name server (DNS) or the SAProuter.

Port Number Port number on which the message server is listening.

Only required if you do not specify a SAProuter (see SAPRouter String below).

Login Group If you have entered a valid message server, and either a validport number or SAProuter, you can use the button next to theLogin Group field to get a list of login groups from themessage server.


November 2000 31

Single Application Server:


Application Server Name of the application server.

If you enter a valid message server and either a valid portnumber or SAProuter, you can use the button next to theApplication server field to get a list of possible login groupsfrom the message server.

System Number System number of application server.

SAP Router (optional):


SAP Router String Identifies one or more SAProuter hosts and ports used toconnect to the SAP System.

The syntax used is:/H/<router>/S/<service>

router is the host name of an SAProuter and service iseither the service name or the port number of the SAProuterservice.

If sapdp99/S/service is missing, sapdp99 is used as thedefault service name.

To define more than one SAProuter, you can concatenate thestrings in the same order the routers connect the AGate hostto the SAP System.

If no SAProuter is used to connect to the SAP System, leavethis field blank.

If there is a valid saproute.ini file in the Windows directory,you can use the button next to the SAP Router String field toget a list of SAProuters known to this machine.

You can test the load balancing information by choosing Test.

When you choose Next, the setup program asks about security issues.


32 November 2000

24. Select a security access level.

The ITS setup program can configure Windows NT Security to provide optimal security foryour system.

If you select ITS Administrator and ITS Users, you restrict access to AGate and thus to theservice files, HTML templates, flow files, and language resources, all of which may containsensitive information. In this case, the ITS administrator account has full control of all files,while the ITS user group has the access rights required for development purposes.

During development, access restrictions may be undesirable. You should analyze your needsand decide whether to use the security restrictions provided by the ITS setup program, orwhether to use some other security procedure.

SAP strongly recommends that you install the ITS with restricted access to allsensitive files and services using the Windows NT Security features.


November 2000 33

25. Specify Security Accounts (appears only in case of selecting ITS Administrator and ITSUsers)

If you are using Windows NT Security, enter the following information to set up restrictedaccess:

Field Description

ITS Administrator Name of ITS administrator account.

The user running the ITS setup program must be an ITSadministrator. You cannot choose a different user.

Password ITS administrator password.

Confirm Password Repeat ITS administrator password.

ITS Admin Group Name of ITS administrator group.

Users in the ITS administrator group are authorized toperform administration tasks for one or more ITS instances.

ITS Users Group Name of ITS user group.

Users in the ITS users group are not authorized to performadministration tasks. They have just read-only access to thefiles on the AGate host.

Web Server Account User account under which the Web server is running.

If you chose Administration as the installation type, you go directly to Start Setup.


34 November 2000

26. Enter the homepage URL information

The URL you enter can be for your homepage or any other page that you want to presentafter an IAC has finished.

For example: http://myserver.mydomain.com

The page must be accessible by the client. You can modify this setting in the global servicefile global.srvc any time after the installation.

27. Choose Next.

28. To install the software as specified, choose Finish.

If you want to modify any of your settings, choose Back and proceed backwards through theinstallation procedure.

When you choose Finish, the setup program completes the installation. A dialog box asks ifyou want to read the Release Notes for the release.


November 2000 35

29. Choose No.

30. Confirm with OK and do not reboot your system.

31. Set the value of the parameter ProductionMode for each ITS instance to 1

You can find the parameter in the Windows NT registry (Start → Run, enter regedit )�in

HKEY_LOCAL_MACHINE →→→→ SOFTWARE →→→→ SAP →→→→ ITS →→→→ 2.0 →→→→ <instance_name>→→→→ Programs →→→→ SAPmpr.

32. Reboot your system now.

Your ITS installation for one of your SAP Systems is now complete.

33. Repeat the installation from step 1 to step 32 for each of your required logical systems.34. We recommend that you install the ITS administration instance (Installation of the ITS

Instances for Administration Purposes [Page 55] )

You can modify all relevant ITS settings in the global.srvc file. The default path tothis file is C:\Program Files\SAP\ITS\2.0\SID\services\global.srvc where SIDstands for the mySAP.com component system name (for example P30).

ResultYour single host ITS installation is now complete. You can check the ITS Installation [Page 63].


36 November 2000

2.1.1.6 Dual Host InstallationPurposeThis process describes how to install the Internet Transaction Server (ITS) on two separatehosts.

If you perform a dual host installation, the AGate is installed on the AGate host, and the WGate isinstalled on the Web host. This scenario is strongly recommended for productive usage.

If you use a configuration with two or more hosts, you have to consider the following: All Webserver instances must belong to a common domain to allow Single Sign-On access (usingCookies).

PrerequisitesYou have performed all the preparatory steps [Page 15].

Before starting the installation, make sure that:

• The AGate host has Windows NT 4.0 Server installed.

• The Web server software is installed and operational on the Web host.

• Both computers are on the LAN and can ping each other.

To test this, log on to the Web host and enter the command ping <AGate host> from thecommand prompt. Use the equivalent ping command on the AGate host.

• All other applications are closed.

Process FlowTo perform a dual host installation, you need to:

1. Install AGate on the AGate host [Page 37].

2. Install WGate on the Web host [Page 48].


November 2000 37

2.1.1.6.1 Installing AGate on the AGate HostUseThe following is a mySAP.com Workplace specific guide to create your AGate instances.

For more information about the Internet Transaction Server, see the official SAP documentationSAP@Web Installation Guide (see Overview of Related Installation Guides [Page 121]).

SAP recommends that you always install the AGate (application server side)before the WGate (Web server side).

PrerequisitesYou have performed all the preparatory steps [Page 15].

Before installing the ITS Instances you have to make sure that there is already a correspondingWeb Server instance installed and operational on the Web host (see Installation of the WebServer Instances [Page 19]).

Procedure1. Log on to the Windows NT 4.0 server host on which you want to install the AGate with the

ITS administrator account.

2. Insert the Server Components Package 4.6D CD-ROM in the CD-ROM drive.





6. Choose Next.



38 November 2000

7. Select Dual-Host (SAP Application Server Side) and choose Next.


8. Choose Next to accept the default destination directory, or choose Browse to select adifferent destination.







November 2000 39

11. Enter the full URL address for accessing the Web server and choose Next.

You don’t need to enter the HTTPS Access (Secure) information, because the ITS setupprogram echoes this for you automatically. However, you have to enter a different port foreach instance (443 is the default port); deselect Automatic to make the fields alterable.

12. Choose Next.


40 November 2000

13. The setup program asks you to choose the IAC package(s) you want to install. Thesepackages contain the IAC-related files to be used for your installation.



15. To confirm that you want to proceed, choose Yes.

16. Specify the maximum number of AGate processes you need. The default number is 1.

17. Choose Next.

18. Select the configuration type Default configuration. With this configuration type the ITS isoptimized for performance with a large number of concurrent users, and sized for a server


November 2000 41

with a minimum of 128 MB of physical memory. This configuration is suitable for productionsystems.

19. Choose Next.

20. Specify the SAP login Information.

Enter the following login information, and choose Next:

a. System Name

Enter the name of the primary SAP System with which the ITS is meant to communicate.

The name consists of three alphanumeric characters.

b. Client

Enter the global client used by the ITS to log on to the SAP System.

Do not enter any SAP User or password.


42 November 2000

21. Specify the SAP connection information depending on which type of SAP System you have:

To guarantee a balanced load on all application servers running the selected SAP System,the ITS uses the SAP message server. This is the default option, and should be used for allproduction systems.

For development systems where performance considerations are less critical, you canchoose to connect to a single application server.

To improve performance for either of these options, you can also specify a SAProuter.

Depending on the option you select, enter information as specified in the following tables:

Load Balancing (default):


Message Server Host name of the SAP message server as it is known either bythe domain name server (DNS) or the SAProuter.

Port Number Port number on which the message server is listening.

Needed only if you do not specify a SAProuter (see SAPRouter String below).

Login Group If you have entered a valid message server, and either a validport number or SAProuter, you can use the button next to theLogin Group field to get a list of login groups from themessage server.


November 2000 43

Single Application Server:


Application Server Name of the application server.

If you enter a valid message server and either a valid portnumber or SAProuter, you can use the button next to theApplication server field to get a list of possible login groupsfrom the message server.

System Number System number of application server.

SAP Router (optional):


SAP Router String Identifies one or more SAProuter hosts and ports used toconnect to the SAP System.

The syntax used is:/H/<router>/S/<service>

router is the host name of an SAProuter and service iseither the service name or the port number of the SAProuterservice.

If sapdp99/S/service is missing, sapdp99 is used as thedefault service name.

To define more than one SAProuter, you can concatenate thestrings in the same order the routers connect the AGate hostto the SAP System.

If no SAProuter is used to connect to the SAP System, leavethis field blank.

If there is a valid saproute.ini file in the Windows directory,you can use the button next to the SAP Router String field toget a list of SAProuters known to this machine.

You can test the load balancing information by choosing Test.

When you choose Next, the ITS setup program asks about security.


44 November 2000


The ITS setup program can configure the Windows NT Security to provide optimal securityfor your system.

If you select ITS Administrator and ITS Users, you restrict access to AGate, and thus to theservice files, HTML templates, flow files, and language resources, all of which may containsensitive information. In this case, the ITS administrator account has full control of all files,while the ITS user group has the access rights required for development purposes.

During development, access restrictions may be undesirable. You should analyze your needsand decide whether to use the security restrictions provided by the ITS setup program, orwhether to use some other security procedure.

We strongly recommend that you install the ITS with restricted access to allsensitive files and services using the Windows NT Security features.


November 2000 45



Field Description






Users in the ITS administrator group are authorized toperform administration tasks for one or more ITSinstances.


Users in the ITS user group are not authorized to performadministration tasks. They have read-only access to thefiles on the AGate host.



46 November 2000

If you chose Administration as the installation type, you go directly to Start Setup.

24. Enter the homepage URL information.

The URL you enter can be your own homepage or any other page that you want to presentafter an IAC has finished.

For example: http://myserver.mydomain.com

The page must be accessible by the client. You can modify this setting in the global servicefile global.srvc any time after the installation.

25. Choose Next.

26. To install the AGate as specified, choose Finish.

If you want to modify any of your settings, use the Back button to proceed backwards throughthe installation procedure.

When you choose Finish, the ITS setup program completes the installation. You then see adialog, which asks if you want to read the Release Notes.


November 2000 47

27. Choose No.

28. Confirm with OK and do not reboot your system.

29. Set the value of the parameter ProductionMode for each ITS instance to 1

You find the parameter in the Windows NT registry in

HKEY_LOCAL_MACHINE →→→→ SOFTWARE →→→→ SAP →→→→ ITS →→→→ 2.0 →→→→ <instance_name>→→→→ Programs →→→→ SAPmpr.


Your AGate installation for one of your SAP Systems (Workplace Server / componentsystems) is now complete.

31. Repeat the installation from step 1 to step 30 for your remaining logical systems.

ResultThe installation of your required AGate(s) is now complete. To complete the ITS installation foreach of your SAP Systems (Workplace Server and component systems) you have to install theWGate(s) one the corresponding Web hosts [Ext.].


48 November 2000

2.1.1.6.2 Installing WGate on the Web HostPrerequisitesThe corresponding AGate is installed [Ext.].

Procedure1. Log on to the Windows NT 4.0 Web Host with the ITS administrator account.

2. Insert the Server Components Package 4.6D CD-ROM in the CD-ROM drive.





6. Choose Next.


7. Select Dual-Host (Web Server Side) and choose Next.

8. Choose Next to accept the default destination directory, or choose Browse to select adifferent destination.




November 2000 49





50 November 2000

11. Select a Web server and choose Next.

As described above, the setup program states whether the server you selected is alreadyattached to a virtual ITS instance.

Using the Internet Information Server, we recommend that you use the DefaultWeb Site (automatically generated during the IIS installation) to connect to theWorkplace Server.



13. To confirm that you want to proceed, choose Yes.


November 2000 51

14. Specify the maximum number of AGate processes you need.

15. Specify Connection to the corresponding AGate Host

Enter values for the following and choose Next.

− Name or IP address

This is the AGate host name or address, as known by the domain name server (DNS).

− AGate port number

This is the port number on the AGate host that AGate is listening on.

− ITS Manager port number

If you select Automatic, this value is the value of the AGate port number, plus 9.

If you do not select Automatic, enter the port number as specified in the file<drive>:\<winnt>\system32\drivers\etc\services

where <drive> is the system's hard drive and <winnt> is your Windows NT directory onthe AGate host.

To get the correct value, find the port number for the port sapavwmm_<virtual ITS>.

Both the Web host and the AGate host must have identical settings for the AGatenetwork ports sapavw00_<virtual ITS> and sapavwmm_<virtual ITS>.

− The default value of sapavwmm_<virtual ITS> is 3900.

− The default value of sapavw00_<virtual ITS> is the AGate port number, plus 9.

During the AGate installation, the entries are automatically added to the file<drive>:\<winnt>\system32\drivers\etc\services


52 November 2000

If port 3900 is already in use on the AGate host, the ITS setup programautomatically chooses the next available block of 10 free ports.

During the step ITS Host and Ports’ of the WGate installation please make surethat this port number is entered in the field AGate port number’

When you choose Next, the ITS setup program asks about security.


The setup program can configure the Windows NT Security in a way that provides optimalsecurity for your system.

If you select ITS Administrator and ITS Users, you restrict access to AGate, and to theservice files, HTML templates, language resources, and graphics, all of which may containsensitive information. In this case, the ITS administrator account has full control of all files,while the ITS user group has only access rights required for development purposes.

During development, however, access restrictions may be undesirable. You should analyzeyour needs and decide whether to use the security restrictions provided by the setupprogram, or whether to use some other security procedure.



November 2000 53


If you are using Windows NT Security, enter information in the following fields to set uprestricted access:

Field Description






Users in the ITS administrator group are authorized toperform administration tasks for one or more ITSinstances.


Users in the ITS user group are not authorized to performadministration tasks. They have just view-only access tothe files on the AGate host.



54 November 2000

18. To install the software as specified, choose Finish.

If you want to modify any of your settings, choose Back to proceed backwards through theinstallation procedure.

When you choose Finish, the ITS setup program completes the installation. You then see adialog, which asks if you want to read the Release Notes.

19. Choose Yes.

Read the Release Notes to check for release changes. When you close the Release Notes,the Setup is complete dialog appears.

20. Confirm with OK.


22. Repeat the installation from step 1 to 21 for the remaining WGates in order to complete theinstallation of the ITS instances for all component systems and the Workplace Server.

ResultYour ITS installation is now complete.

You can check the installation [on page 63]


November 2000 55

2.1.1.7 Installation of the ITS Instances forAdministration Purposes (optional)

For more information about all aspects of ITS administration after installation, seethe ITS Administration Guide:On the mySAP.com Workplace server, choose Help → SAP Library → BC - BasisComponents → Frontend Services (BC-FES) → ITS /Web Studio (BC-FES-ITS)→ ITS Administration Guide.In the SAP@Web Studio, choose Help → ITS Administration Guide.

If you use several AGate servers you have to install an administration instance on each AGatehost.

Prerequisites• You have performed all the prepatory steps. (see Installation Preparation [Page 15]).

• You have created a Web server instance for the administration instance. (see Installation ofthe Web Server Instances [Page 19]).

Procedure1. Start the Windows NT Explorer.

2. Insert the Server Component Packages 4.6D CD-ROM in the CD-ROM drive.



5. Double-click setupits.exe and choose OK


6. Select Single-Host and choose Next.


7. Choose Next to accept the default destination of the ITS main directory, or choose Browse toselect a different destination.



8. Select the installation type Administration and choose Next.

The ITS Administrative Instance screen appears.


56 November 2000

9. Choose the default admin instance ADM name by clicking Next.

10. Select a Web server and choose Next.

11. Enter the URL for accessing the Web server and choose Next.

Make sure that you enter the full URL address.

You do not need to enter the HTTPS Access (Secure) information because the setupprogram echoes this automatically. However, you have to enter a different port for each ITSinstance (443 is the default), deselect Automatic to make the fields alterable.


November 2000 57

12. Select the configuration type Minimize memory usage and choose Next.


58 November 2000


The setup program can configure the Windows NT Security in a way that provides optimalsecurity for your system.

If you select ITS Administrator and ITS Users, you restrict access to AGate, and to theservice files, HTML templates, language resources, and graphics, all of which may containsensitive information. In this case, the ITS administrator account has full control of all files,while the ITS user group has the access rights required for development purposes.

During development, however, access restrictions may be undesirable. You should analyzeyour needs and decide whether to use the security restrictions provided by the setupprogram, or whether to use some other security procedure.



November 2000 59

14. Specify Security Accounts.


- ITS Administrator

The user running the setup program must be the ITS administrator, so this name isdisplayed here. You cannot choose a different user.

- Password

The password for the ITS administrator.

- Confirm Password

Enter the password again.

- ITS Admin Group

The name you have chosen for the ITS administrator group.

Users in this group are authorized to perform administration tasks for one or more ITSinstances, as determined by the ITS administrator.

- ITS Users Group

The name you have chosen for the ITS user group.

Users in this group have read-only authorizations. They are not authorized to performadministration tasks for any ITS instances.


60 November 2000

- Web Server Account

The user account under which the Web server is running.

15. To install, choose Finish.

If you want to modify any of your settings, choose Back and proceed backwards through theinstallation procedure.

When you choose Finish, the setup program completes the installation. A dialog box asks ifyou want to read the Release Notes for the release.

16. Choose No.

17. Confirm with OK and reboot your system.

ResultYour administration installation for the Internet Transaction Server is now complete.

You can now access the ITS administration page using the following URL:http://<localhost>/scripts/wgate/admin/!


November 2000 61

2.1.1.8 Setting the ITS Service Parameter for theWorkplace

UseIf you configure the Internet Transaction Server (ITS) so that a user can only log on to oneparticular client, you must ensure that the user cannot enter a different client in the logon screen.To ensure this, you must set a service parameter in the SAPWP service.

PrerequisitesYou must define the client using the ~client parameter in the global service settings for the ITS(global.srvc) or in the service setting for the SAPWP service (sapwp.srvc).

Procedure1. Go to the ITS administration tool.

2. Choose the Workplace Server and go to the service definitions by choosing Configuration →Services → sapwp.srvc.

3. Set the ~hideClientInput parameter to the value 1.

4. Save your changes.

ResultThe next time the user logs onto the Workplace the input field for client is not displayed.


62 November 2000

2.1.1.9 Mobile Workplace SettingsUseIf you want to use the Mobile Worklace, you must activate the device recognition. It will be usedfrom the HTMLBussines Library for mobile devices and to distinguish between different devicetypes.

This setting takes place in a Windows registry key.

PrerequisitesYou are approved as First Customer for the Mobile Workplace.

Procedure1. Log on to your AGate host.

2. Choose Start -> Run.

3. Enter regedit and choose OK.

4. Choose HKEY_LOCAL_HACHINE\SOFTWARE\SAP\ITS\2.0\<ITSInstance>\Programs\SAPDinf.

5. Set the value active to 1.

6. Stop the relevant ITS instance and then start it again.

7. Repeat the steps above for all of your Mobile Workplace ITS instances.


November 2000 63

2.1.1.10 Checking the ITS InstallationProcedureWhen you have completed the ITS installation, you should do the following:

• Check that the installation was successful.

• Ensure that the SAP System is available.

• Verify the ITS connection between the Web browser and the SAP System.

Was the Installation Successful?To check that the installation ran successfully, log on to the host(s) that contain the ITScomponents (WGate, AGate, or both), and follow the procedures in the tables below according tothe installation type.

Check Procedure

Check that the Web server status isStarted and that startup is Automatic.

1. On the Windows NT desktop, choose Start →Settings → Control Panel.

2. Double-click on Services.

3. Find the Web server in the list of Services andcheck that the values in the Status and Startupcolumns are set to Started and Automatic.

Check that the WGate component ispresent.

The location depends on the Web server you areusing:

• If you are using the Microsoft Internet InformationServer (IIS), you can find wgate.dll inC:\Program Files\SAP\ITS\2.0\WGateIIS.

• If you are using the Netscape Enterprise Server(NES), you can find wgate20.dll, wgate30.dll,wgate35.dll, or wgate36.dll in the subdirectoryscripts of the Web server’s root directory.

To see .dll files, make sure that your Windows NTExplorer displays all file types.

Check that the ITS Manager isStarted and that startup is set toAutomatic.

1. On the Windows NT desktop, choose Start →Settings → Control Panel.

2. Double-click on Services.

3. Find the ITS Manager in the list of Services andcheck that the values in the Status and Startupcolumns are set to Started and Automatic. TheITS Manager is listed as ITS Manager - <virtualITS>.


64 November 2000

Is the ITS connected properly?To test the ITS connection, start the sapwp service from a Web browser by entering

http:// <webhost.domain:port>/scripts/wgate/sapwp/!.

If a logon screen does not appear, see Troubleshooting the ITS Installation [Page 65].


November 2000 65

2.1.1.11 Troubleshooting the ITS InstallationPrerequisitesYou have checked the ITS installation [Page 63].

ProcedureIf you have problems, try the following steps:

Emptying the TEMP DirectoryIf you get error messages like General file transfer error when running the ITS setup program,make sure that your TEMP directory is empty and then run the ITS setup program again.

Checking the Trace FilesTo diagnose a problem, you can check the trace files located in the installation directory of yourvirtual ITS under:

C:\Program Files\SAP\ITS\2.0\<virtual ITS>\Traces

Modifying the Trace Facility SettingsTo diagnose a problem, you can also modify the trace facility settings in the Windows NTregistry.

Changing the trace facility settings can adversely affect performance.You can modify the following trace facility settings, as specified in the tables below:

• HKEY_LOCAL_MACHINE\SOFTWARE\SAP\ITS\2.0\Programs\AGate\IoalTraceLevel

Description Trace level for tracing the ITS interface to the SAP System.

Default 1 Errors only.1 Errors only.2 Errors and warnings.

Range

3 Errors, warnings, and information records.

• HKEY_LOCAL_MACHINE\SOFTWARE\SAP\ITS\2.0\<virtual ITS>\Traces\TracePath

Description Path where all virtual ITS trace files are stored.

Default C:\Program Files\SAP\ITS\2.0\<virtual ITS>\Traces


66 November 2000

• HKEY_LOCAL_MACHINE\SOFTWARE\SAP\ITS\2.0\<virtual ITS>\Traces\...

Followedby:

...AGate\TraceLevel

...MManager\TraceLevel

...SAPjulep\TraceLevel

...SAPirf\TraceLevel

...SAPxGDK\TraceLevel

Description Trace level for corresponding trace type.

Default 1 Errors only.1 Errors only.2 Errors and warnings.

Range

3 Errors, warnings, and information records.

• HKEY_LOCAL_MACHINE\SOFTWARE\SAP\ITS\2.0\<virtual ITS>\Traces\...

Followedby:

...AGate\TraceAppend

...MManager\TraceAppend

...SAPjulep\TraceAppend

...SAPirf\TraceAppend

...SAPxGDK\TraceAppend

Description Toggle switch to select one or more trace files. Do not change.

Default 1 Only one trace file; additional records are always appended.1 Only one trace file; additional records are always appended.Range

0 Each new version creates a new trace file; the old one isrenamed with a timestamp in the trace file name.

Changing the AGate HostTo change the AGate host:

1. Run the ITS setup program for the AGate as described in the section Dual Host Installation[Page 36].

2. Change the Windows NT registry key on the WGate host that points to the new AGate.

To do this go to:HKEY_LOCAL_MACHINE\SOFTWARE\SAP\ITS\2.0\<virtual ITS>\Connects\Host

Changing the SAP Connection InformationFor each ITS service, there is a service file called <service>.srvc, where <service> is theservice name.

There is also a global service file called global.srvc, which contains settings that apply to allservices.

All service files are located in the installation directory of your virtual ITS under:C:\Program Files\SAP\ITS\2.0\<virtual ITS>\services

You can create, modify, and manage service files in the SAP@Web Studio. If you modify themmanually using a text editor, do not change the file structure or the syntax.


November 2000 67

The ITS setup program writes SAP connection information to the global service file global.srvc,but you can modify this information according to your requirements. You can also define separateconnection information for each service in the <service>.srvc file.

Settings in service-specific files always override settings in the global service file.

Uninstalling the ITSSometimes, it is more convenient to uninstall the ITS and run the ITS setup program again.

Before uninstalling the ITS, SAP recommends that you:

• Make a backup copy of all the files you want to keep.

• Stop your Web server and the ITS Manager service.

To uninstall the ITS, log on as the ITS administrator and use the standard Windows NT 4.0uninstall procedure.

To do this from the Windows NT 4.0 desktop, choose Start → Settings → Control Panel →Add/Remove Programs.

Reporting Problems to SAPIf you cannot solve a problem, you can report it to SAP (component BC-FES-WGU). When doingthis, please provide as much information as possible. In particular, you should:

1. Make a note of the error message that is displayed in the Web browser.

2. Save all current trace files.

The default location of the trace files is:C:\Program Files\SAP\ITS\2.0\<virtual ITS>\traces\

3. Find a way to reproduce the error.

4. Make a note of your configuration

This information should include details such as

• ITS build

• Windows NT version

• host name(s)

• Web server software

• Web browser software

• network/firewall configuration

• user accounts


68 November 2000

2.1.2 Internet Graphics Server (IGS) Installation(optional)

PurposeThe IGS has the following functions:

• Displaying graphics in SAP GUI for HTML

• Displaying graphics in MiniApps

• Generating graphics based on a given set of data without displaying the graphics in the frontend

The following graphics are currently supported:

• Business graphics

• Networks

• Bar charts

The application server sends data to the IGS using a remote function call (RFC). A graphicscontrol and a bitmap are generated on the IGS and the bitmap is sent back to the applicationserver (in GIF-format or JPEG-format). The bitmap on the application server can then bedisplayed in an HTML frontend (ITS).

There is the following restriction:One IGS can support a maximum of only 16 application servers..

When to Install the IGS for the mySAP.com WorkplaceYou only need to install the IGS for the mySAP.com Workplace, if Java applets are not allowedon your frontend (for example, for security reasons), but you want to display graphics in theMiniApps (normally the graphics are displayed on the frontend using a Java applet).

Process FlowProceed as follows:

1. You check the requirements [Page 10].

2. You prepare the installation [Page 69].

3. You install the IGS [Page 70].

4. You configure the IGS [Page 71].


November 2000 69

2.1.2.1 Preparing the InstallationUseIn order to establish communication between the IGS and the related SAP Systems you have tocreate an RFC-destination on

• the mySAP.com Workplace Server

• all integrated mySAP.com component systems.

Procedure1. Logon to the SAP System

2. Call transaction SM59.

3. Choose "Create".

4. Enter GFW_ITS_RFC_DEST as the RFC destination.

5. Specify "T" as the "Connection type".

6. Choose "Enter".

7. Choose "Registration".

8. Enter RFCCOM.GFW_ITS_RFC_DEST as the "Program ID".

9. Save.

10. Repeat step 1 to 9 for all of your SAP Systems


70 November 2000

2.1.2.2 Installing the Internet Graphics Server (IGS)PrerequisiteYou only need to install the IGS, if you want to display graphics in MiniApps and do not want touse Java..

Procedure1. Log on to the IGS host.

2. Insert the Server Components 4.6D CD-ROM.

3. Execute the program igssetup.exe in directory IGS\NT\I386.

4. The next steps depend on where you have installed the IGS

Installation on a host different from theITS A-Gate

Installation on the ITS A-Gate host

a. After the installation reboot.

b. Logon to the ITS A-Gate host(s).

c. Proceed with step 5.

Proceed directly with step 5

5. On the ITS A-Gate host(s) call up the following html file:<its_instance>\templates\waopig\99\waopig.html

6. Find the line: g_modus = "JAVA".

7. Change it to: g_modus = "IGS"

This ensures that the IGS is used for graphics in MiniApps rather than Java.

8. Make sure that you change line g_modus for each <its_instance>.


November 2000 71

2.1.2.3 Configuring the Internet Graphics Server (IGS)UseYou have to configure the IGS for each Workplace component system.

Procedure1. Logon to the IGS server.

2. Choose Start → Programs → SAP Configuration.

The following window appears.

3. Make sure that the services (connections) you want to configure are stopped. If the service isrunning choose Stop.

4. Choose Add.

The following window appears.


72 November 2000

5. Select the system for which you want to configure the IGS.

6. Specify one or more graphics products (Chart, Barchart or Netchart).

7. Choose Add.

8. Repeat steps 1 to 7 for all your Workplace component systems.

9. To start all services after configuration choose Start.

10. To leave the dialog box, choose Quit.


November 2000 73

2.1.3 Workplace Servlets Installation (optional)PurposeThe Workplace Servlets contains the Drag&Relate Servlet and the MiniApp Servlet for iViews.

Drag&Relate ServletThe Drag&Relate function empowers simple, browser-based navigation, enabling you to executetransactions across system boundaries by linking data from one application to data in anotherapplication. You simply select a business object by clicking it and then drag it onto another objecton the LaunchPad and the system performs an activity.

For example, you could select a purchase order and then drag it onto an icon that launches aWeb site that tracks deliveries, to retrieve information about the delivery status of the selectedpurchase order.

You can use the Drag&Relate function in the following scenarios:

• Dragging R/3 objects to a transaction in the same logical system

• Dragging R/3 objects to a transaction in another logical system

• Dragging R/3 objects to an icon that launches an external Web site

• Dragging MiniApp objects to a transaction in a logical system

• Dragging MiniApp objects to an icon that launches an external Web site

MiniApp Servlet for iViewThe MiniApp Servlet for iViews enables iView and Website Component functionality in SAPWorkplace. An iView is a type of MiniApp that lets you easily extend the reach of your SAPWorkplace to any available data resource on the World Wide Web.

A Website Component defines a relationship between a Web site and a structured databaseaccessed by a Drag and Relate servlet, or by any other HRNP (HyperRelational NavigationProtocol) server. This relationship enables retrieving from a Web site, data related to a selecteddatabase element.

MiniApp Servlet for iViews comes with sophisticated tools for developing, deploying, andadministering both iViews and Website Components. MiniApp Servlet for iViews is also theengine that powers iViews and Website Components at run-time.

The MiniApp Servlet for iViews is installed on a machine running Windows NT Server 4.0(recommended) or Windows NT Workstation 4.0 in the network where SAP Workplace isinstalled.

Process Flow1. Installing and Configuring the SAP DCOM Component Connector [Page 74]

2. Drag&Relate Servlet Installation [Page 83]and MiniApp Servlet Installation [Page 97]


74 November 2000

2.1.3.1 Installing and Configuring the SAP DCOMComponent Connector

UseThe DCOM CC enables communication between the Workplace Servlets (Drag&Relate Servlet /MiniApp Servlet for iViews) and the Workplace components.

PrerequisitesYou meet the requirements [Page 10].

Procedure

Installing the SAP DCOM Connector1. Log on to the server on which you want to install a Workplace Servlet.

If you are already logged on, make sure that all SAP GUIs are closed and allMicrosoft Transaction Server processes are stopped.

2. Insert the Server Components 4.6D CD-ROM in the CD-ROM drive.


4. Select the directory <DRIVE>:\Dcomm_CC\NT\I386\ as the current directory, where<DRIVE> refers to the CD drive.

5. Double-click the SETUP.EXE file.

The installation starts.

6. Read the Welcome dialog box and choose Next.

The License Agreement screen appears.

7. Choose Yes.

The Information dialog box appears.

8. Choose Next.

The Choose Destination Location screen appears.

9. Confirm your destination with Next.

The Select Components dialog box appears.


November 2000 75

10. Select your components.

You must have selected DCOM Connector.

The other components are optional.


76 November 2000

11. Choose Next.

If you have also selected COM4ABAP, then the Configure COM4ABAP dialogbox will appear after choosing next.

The Select Program Folder dialog box appears.


November 2000 77

12. Select your Program folder and choose Next.

The Start Copying Files dialog box appears.

You can review your settings and change them by choosing Back.


78 November 2000

13. If the settings are o.k. choose Next.

a. The installation starts: The Setup status dialog box appears.

b. After the installation has finished the Setup Complete dialog box appears.

14. Choose Finish to reboot your computer.

You have to reboot your computer to complete your installation.


November 2000 79

Configuring the SAP DCOM Connector

You must determine a destination for the Workplace server (for the MiniAppServlet) and all component systems (for the Drag&Relate Servlets).

1. After the reboot choose Start -> Programs -> SAP DCOM Connector -> SAP DCOMConnector.

A browser with the DCOM CC Homepage appears.

2. Choose Destination Administration.

The Destination screen appears.

3. Choose Edit.

4. Choose New

The Web Page Dialog box appears.


80 November 2000

5. In the Enter name for new destination field, enter the name of the logical Workplacecomponent system or the Workplace server.

You can find the system name on the Workplace Server in table T000 (if it hasalready been maintained).Otherwise, you will find the system name in your component system:In the Implementation Guide (IMG) choose Basis Components →Distribution(ALE) →Sending and Receiving Systems→Logical Systems→Assign Client toLogical System.If a logical system has already been assigned, use this name. Otherwise assign aname for the component system that is unique in the SAP System group.


November 2000 81

6. Choose OK.

In the Destination column, the name of your logical system appears.

7. In the Connection section, enter the hostname of the Workplace component system.

8. Enter the system number. For example: 00.

9. In the Logon section, enter the client number. For example: 450.

10. Enter the language. For example: en.


82 November 2000

11. In the Security section, enter a SAP user ID and password.

You have to fill these two fields; otherwise you can not proceed.We recommend not using any valid user and password but instead any invalidstrings, e.g. XXX for user and yyy for password.

12. Choose Save.


November 2000 83

2.1.3.2 Drag&Relate Servlet InstallationPrerequisites• You can implement the Drag&Relate function only in mySAP.com component systems with a

release level of R/3 Release 4.0B or higher. Component systems of R/3 Release level 3.1Hor 3.1I can be used as a target for Drop actions from a component system with an R/3Release level of R/3 Release 4.0B or higher.

• You met the minimum requirements. [Page 10]

• The SAP DCOM Connector has been installed and customized [Page 74] for the componentsystems.

• If you are using the Secure Socket Layer (SSL), you have to install one Microsoft InternetInformation Server (IIS) for the Drag&Relate Servlet (see Installation of the Web ServerInstances [Page 19]).

If you are still considering whether to implement SSL, we recommend installingthe necessary components anyway.

Process Flow1. You install the Drag&Relate Servlet [Page 84] for each logical system in which you want to

implement this function.

You can also predetermine installation settings by configuring a silent installer.This enables another user to simply double-click an executable file to install theservlet. For details, see Configuring a Silent Installation [Page 92].

2. You configure the Drag&Relate Servlet. [Page 94]


84 November 2000

2.1.3.2.1 Installing the Drag&Relate ServletUseFor each productive SAP client that you want to enable for Drag&Relate, you must install theDrag&Relate Servlet.

During the Drag and Relate Servlet installation, when you designate the component system, theinstaller automatically adds to the specified SQL 7 Server installation (or to MSDE) the TopTierOLE DB Provider for SAP, directed at a specific logical component system. This OLE DBProvider functions as a linked server, enabling communication between the Drag and RelateServlet, and the specified logical component system.

DO NOT install the Drag&Relate Servlet for the Workplace Server.Procedure1. Insert the Server Components 4.6D CD-ROM in the CD-ROM drive.


3. Select the directory <CD-ROM>:\wp_servl\Wp211\nt\i386.

4. Double-click runsetup.exe and choose OK.

5. In the Choose Servlet dialog box, choose the Drag and Relate Servlet option.


November 2000 85

6. Choose Next.

If a Microsoft Transaction Server (MTS) installation is not found on the local machine, awarning message appears to that effect.

− To enable connection pooling, exit the Setup, install MTS, and then begin the Setupagain. Basically, connection pooling is a feature of the Microsoft Transaction Server(MTS) that improves system performance.

We highly recommend that servlet users with MTS installed take advantage of thefact that the servlet supports connection pooling, by selecting the ConnectionPooling option during installation.

− To continue the Setup without enabling connection pooling, choose OK.

7. Read the Welcome screen, and choose Next.

If you have already installed Microsoft Data Access Component (MDAC; as part of theInternet Explorer 5.0) you are not prompted to install it.

Otherwise, the MDAC is automatically installed. If you are prompted to reboot, choose OK.Following the reboot, Setup resumes automatically. When the Welcome screen appears,choose Next.

8. If Microsoft SQL Server 7.0 is not detected on the local machine, then the Choose MSDEDestination Location dialog box appears. MSDE is installed in the location you specify. Whena message appears indicating that MSDE has been installed, choose OK.

9. In the Choose Destination Location dialog box, specify the destination folder for theDrag&Relate Servlet and choose Next.

You must enter a different destination folder for each Drag&Relate Servlet thatyou install.


86 November 2000

10. In the Select Program Folder dialog box, specify a program folder and choose Next.

You must enter a different program folder for each Drag&Relate Servlet that youinstall.

11. In the SQL Server 7.0 dialog box, enter the name and password that enables access to theSQL 7.0 installation on the network and choose Next.

Try to access with user sa and no password entry.If it doesn't work, contact your system administrator.

12. In the Drag& Relate Server dialog box, enter the host name of the Windows NT machine onwhich you are installing the Drag&Relate Servlet.

If port number 9999 is already in use, change the port number.

You must enter a different port number for each Drag&Relate Servlet that youinstall.


November 2000 87

13. Choose Next.

In the SAP R/3 Parameters dialog box, enter the name of the corresponding Workplacecomponent system. Note that the destination value is used to identify the server in theWindows NT Services Manager.

In the example below, the server appears in the Windows NT Services Manager under thename Drag and Relate Server SAP_P30.

If you do not know the DCOM Component Connector destination value, open theDCOM CC homepage (Start -> Programs -> SAP DCOM Connector -> SAP


88 November 2000

DCOM Connector) and choose Destination, then choose Edit. The destinationparameter is displayed in this form.

14. Choose Next.

If you want the Drag&Relate Servlet to support Secured Socket Layer (SSL) connections,select the SSL checkbox in the Secured Socket Layer dialog box. Choose Next.

SAP recommends using SSL.


November 2000 89

15. In the Connection Pooling dialog box, select the Enable Connection Pooling option if youwant to enable connection pooling. This dialog box does not appear unless the MicrosoftTransaction Server (MTS) is installed locally.

16. In the Start Copying Files dialog box, verify the installation settings. If you want to change theparameters, choose Back to return to the previous dialog boxes.

17. Choose Next to begin copying the program files.

18. In the Setup Complete dialog box select the Run BOR Model Transporter checkbox.

The BOR Model Transporter reads the BOR schema from the Workplace component systemand imports it into the TopTier Repository.


90 November 2000

The Drag&Relate Servlet includes a repository containing data that describes the structureand logic of the SAP Business Object Repository (BOR). This repository relates to the logicalsystem for which the servlet has been installed. The information in the TopTier repositorymust correspond to the information in the SAP BOR to ensure that the Drag&Relate Servletfunctions correctly.

You must use the BOR Model Transporter after installing the Drag&Relate Servlet and beforeconfiguring Drag&Relate between logical systems.

The related component system must have imported the WP-PI 211 workplaceplug-in, otherwise the BOR import will fail.If your component system has not imported the workplace plug-in yet, uncheckthe Run BOR Model Transporter checkbox and run the BOR Model Transporterlater (see the Drag&Relate documentation guide on the CD ROM SAP OnlineDocumentation mySAP.com Workplace 2.11)

Choose Finish to complete the setup.


November 2000 91

If you select Run BOR Model Transporter, another dialog box appears. Enter your username and password and choose Import.

After the BOR Model Transporter has successfully imported the repository, choose Finish.

19. Repeat the installation from steps 1 to 18 for each Workplace component system. Do notrepeat this procedure for the Workplace Server.


92 November 2000

2.1.3.2.2 Configuring a Silent InstallationUseYou can incorporate a silent installation as part of a batch process. To do so, you set theinstallation parameters in a batch file that also points to the RunSetup.exe file. A user can installthe Drag and Relate Servlet by launching the batch file. The installer runs “silently,” reading thesettings from the batch file rather than prompting the user to select setup options.

ProcedureIn order to configure a silent installation, you create a batch file that includes the following itemsin the order in which they are listed:

• The path to the RunSetup.exe file

• /s /a /s /pInstallDR

• A series of switches (described below)

Each switch must begin with a space and a slash ( /). Each switch must include the switch nameand value, separated by a space. If the value itself contains a space, then enclose the valuewithin quotation marks.

Example:C:\MyDirectory\SubDirectory\runsetup.exe /s /a /s/pInstallDR /pPath "C:\Drag and Relate Servlet" /pFolder"Drag and Relate Servlet 2.11" /pServer server1.sap.com/pPort 9999 /pDCOM Q99 /pSSL 0

In the table below, the switches are listed along with a brief description and the default value.Note that if a switch is not included in the batch file, the default value is automatically used.

pPath Specify the path to the destination folder for the Drag and Relate Servletinstallation.

Default value: C:\Drag and Relate Servlet

pFolder Specify a program folder.

Default value: Drag and Relate Servlet 2.11

pServer Specify the host name of the Windows NT machine on which you are installingthe Drag and Relate Servlet.

Default value: MyComputer.MyCompany.com

pPort Specify the port for the Drag and Relate Servlet.

Default value: 9999

pDCOM Enter the DCOM Component Connector (DCOM CC) destination of the SAPWorkplace servers.

Default value: Q99

pSSL Enter the value “1” if you want the Drag and Relate Servlet to support SecuredSocket layer (SSL) connections. Otherwise, enter “0”. Default value: 0


November 2000 93

Log FileAfter activating the batch file, you can consult the Silent Installer’s log file, TTSetupDR.log, todetermine if installation was successful. You will find this log file in the root of the C: drive of themachine on which you ran the Silent Installer.

When the batch file is activated, the installation parameters it contains are writtento an initialization file called Setup.iss. The installer reads the parameters fromthis file.

Below is a sample log file:[InstallShield Silent]Version=v5.00.000File=Log File[Application]Name= Drag and Relate Servlet 2.11Version=2.11Company=TopTierLang=0009[ResponseResult]ResultCode=0

In the sample, the ResultCode value is “0”. The table below details this and the other possiblevalues of the ResultCode.

Result Code Description 0 Success.

-1 General error.

-2 Invalid mode.

-3 Required data not found in Setup.iss.

-4 Not enough memory available.

-5 File does not exist.

-6 Cannot write to Setup.iss.

-7 Unable to write to the log file.

-8 Invalid path to Setup.iss.

-9 Not a valid list type (string or number).

-10 Data type is invalid.

-11 Unknown error occurred during setup.

-12 Dialog boxes are out of order.

-51 Cannot create the specified folder.

-52 Cannot access the specified file or folder.

-53 Invalid option selected.


94 November 2000

2.1.3.2.3 Configuration of the Drag&Relate ServletPrerequisitesYou have installed the Drag&Relate Servlet.

Process Flow1. Defining the Drag&Relate Parameter [Page 95]

2. Activating the Drag&Relate Servlet [Page 96]

3. After the installation you have to perform several configuration steps - depending on how youwant to use Drag&Relate:

− Drag&Relate in a single logical system

− Drag&Relate between logical systems

− Drag&Relate from a logical system to the World Wide Web

− Drag&Relate from a MiniApp to a transaction in a logical system

− Drag&Relate from a MiniApp to the World Wide Web

To configure the Drag&Relate Servlet for the mySAP.com Workplace refer to the CD SAPOnline Documentation mySAP.com Workplace 2.11 (Path: SAP Library → mySAP.comWorkplace → Drag&Relate) supplied with the mySAP.com Workplace 2.11.


November 2000 95

2.1.3.2.4 Defining the Drag&Relate ParameterUseTo enable HyperRelational navigation, you must specify the Drag&Relate Server parameter foreach logical system.

PrerequisitesThe Workplace Server is installed.

Procedure1. Logon to the Workplace Server.

2. You have to alternatives to perform the task:

Alternative 1 Alternative 2

a. Go to transaction SM30.

b. On the Maintain Table Views screen,enter the following value in theTable/View field: TWPURLSVR.

c. Choose Maintain

Go to transaction View Maintenancecontained in the Workplace Administratorrole.

3. On the Change View screen, in the Drag&Relate Server column of the SAP System, enterthe Drag&Relate Server address using the following syntax:Drag&RelateServerHostName:<PortNumber>

For example:thomas.sap.com:9999

In this example, thomas.sap.com is the host name of the machine on which theDrag&Relate Servlet is installed, and 9999 is the port number assigned to theserver during the setup.

In the Drag&Relate server protocol field, enter the appropriate protocol, either HTTP orHTTPS if you use SSL.

The field Drag&Relate path ID is currently not used.


96 November 2000

2.1.3.2.5 Activating HTML link generationUseIn order to generate Drag&Relate links, new or different settings are needed in the system as ofWorkplace plug-in 2.11.

ProcedureRefer to SAP Note 212773 for detailed information.


November 2000 97

2.1.3.3 MiniApp Servlet InstallationPrerequisites• You met the minimum requirements. [Page 10]

• The SAP DCOM Connector has been installed and customized [Page 74] for the componentsystems.

• The corresponding web server instance has been installed (see Installation of the WebServer Instances [Page 19]).

Process Flow1. You install the MiniApp Servlet [Page 98] on the WEB host for the Workplace Server.

You can also predetermine installation settings by configuring a silent installer.This enables another user to simply double-click an executable file to install theservlet. For details, see Configuring a Silent Installation [Page 107].

2. You configure the MiniApp Servlet [Page 111].


98 November 2000

2.1.3.3.1 Installing the MiniApp ServletUseOne MiniApp Servlet for iViews is required in which you want to enable iView and/or WebsiteComponent functionality.

Procedure1. Insert the Server Components 4.6D CD-Rom in the CD-ROM drive.


3. Select the directory <CD-ROM>:\wp_servl\Wp211\nt\i386.

4. Double-click runsetup.exe and choose OK.

5. In the Choose Servlet dialog box, choose the MiniApp Servlet for iViews option and clickNext.

6. Read the Welcome screen, and choose Next.

If you have already installed Microsoft Data Access Component (MDAC; as part of theInternet Explorer 5.0) you are not prompted to install it.

Otherwise, the MDAC is automatically installed. If you are prompted to reboot, choose OK.Following the reboot, Setup resumes automatically. When the Welcome screen appears,choose Next.

7. In the Choose Destination Location dialog box, specify the destination folder for the MiniAppServlet for iViews installation and choose Next.


November 2000 99

8. In the System Databases dialog box, if Microsoft SQL Server 7.0 is installed on the network,choose SQL 7.0 and click Next. This option is recommended for optimum performance.

Otherwise, choose MSDE and click Next.Then, in the Choose MDSE Location dialog box, choose a location and sort order type for theMSDE installation and click Next. MSDE will be installed in the location you specify. Whenthe Setup has finished installing MSDE on your computer , a message appears. Choose OK.

9. In the Select Program Folder dialog box, specify a program folder and choose Next.


100 November 2000

10. In the SAP R/3 Parameters dialog box, enter the DCOM Component Connector destinationof the Workplace server and choose Next.

The Destination value is used to identify the MiniApp Servlet for iViews in theWindows NT Services Manager. For example, if the Destination value is P30, theservlet appears in the Windows NT Services Manager under the name MiniAppServlet for iViews SAP_P30.The value you enter in the Destination field must be exactly the same as theDCOM CC destination parameter defined for the Workplace Server.If you do not know the DCOM Component Connector destination value, open theDCOM CC homepage (Start -> Programs -> SAP DCOM Connector -> SAPDCOM Connector) and choose Destination, then choose Edit. The destinationparameter is displayed in this form.


November 2000 101

11. If the SQL 7.0 Server dialog box appears, do the following (Otherwise skip to the next step):

a. Enter the Host Name of the machine on which the SQL 7.0 Server is installed

b. Enter the name and password that enables access to the SQL 7.0 installation on thenetwork and choose Next.

Try to access with user sa and no password entry.If it doesn't work, contact your system administrator.


102 November 2000

12. In the Choose Path dialog box, enter the destination directory for the system database files.

If setup detects previously installed system tables, the System Databases dialog box appearsinstead of the Choose Path dialog box. Do one of the following and choose Next:

a. Enter a unique name for a new installation of the system databases and choose Next.Specify a destination folder.

b. Use the existing system databases.

c. Overwrite the existing system databases.


November 2000 103

13. In the HRNP Servlet dialog box, enter the host name of the Windows NT machine on whichyou are installing the MiniApp Servlet for iViews and choose Next.

If the default port used by the MiniApp Servlet for iViews (9999) is already being used byanother device on the machine, change the port number now.


104 November 2000

14. In the Web Server Configuration dialog box, enter the host name of the machine on whichthe Microsoft IIS is installed and specify the Web server root folder.

If you want the MiniApp Servlet for iViews to support Secured Socket Layer (SSL)connections, select the SSL checkbox.

Choose Next.


November 2000 105

15. In the Login to SAP R/3 System dialog box, enter the user name and password that enableaccess to the Workplace Server and choose next.

Now the predefined iViews that are included with the servlet are transferred to the MiniAppcatalog on the Workplace Server.


106 November 2000

16. In the Start Copying Files dialog box, verify the installation settings. If you want to change theparameters, choose Back to return to the previous dialog boxes.

17. Choose Next to begin copying the program files.

18. When prompted, click Finish to complete the setup.


November 2000 107

2.1.3.3.2 Configuring a Silent InstallationUseYou can incorporate a silent installation as part of a batch process. To do so, you set theinstallation parameters in a batch file that also points to the RunSetup.exe file. A user can installthe MiniApp Servlet for iViews by launching the batch file. The installer runs “silently,” reading thesettings from the batch file rather than prompting the user to select setup options.

ProcedureIn order to configure a silent installation, you create a batch file that includes the following itemsin the order in which they are listed:

• The path to the RunSetup.exe file

• /s /a /s /pInstalliView

• A series of switches (described below)

Each switch must begin with a space and a slash ( /). Each switch must include the switch nameand value, separated by a space. If the value itself contains a space, then enclose the valuewithin quotation marks.

Example:C:\MyDirectory\SubDirectory\runsetup.exe /s /a /s/pInstalliView /pPath "C:\MiniApp Servlet for iViews"/pUseSQL 1 /pUseMSDE 0 /pFolder "MiniApp Servlet for iViews2.11" /pDCOM Q99 /pSQLserver server1 /pSQLuser sa /pSQLpasssa /pServer server1.sap.com /pPort 9989 /pWebServerserver1.sap.com /pWebRoot c:\inetpub\wwwroot /pSSL 1

In the table below, the switches are listed along with a brief description and the default value.Note that if a switch is not included in the batch file, the default value is automatically used.

pPath Specify the path to the destination folder for the MiniApp Servlet for iViewsinstallation.

Default value: "C:\MiniApp Servlet for iViews"

pUseSQL Enter the value 1 to install system databases to a SQL 7.0 Server. Otherwiseenter 0.

Note: The values for the pUseSQL and the pUseMSDE switches cannot bethe same; System databases must be installed either on SQL 7.0 Server orMSDE.

Default value: 0

pUseMSDE Enter the value 1 to install MSDE and then install the system databases to theMSDE installation. Otherwise enter 0.

Note: The values for the pUseSQL and the pUseMSDE switches cannot bethe same; System databases must be installed either on SQL 7.0 Server orMSDE.

Default value: 1


108 November 2000

pFolder Specify a program folder.

Default value: "MiniApp Servlet for iViews"

pDCOM Enter the DCOM Component Connector (DCOM CC) destination of the SAPWorkplace servers.

Default value: Q99

pSQLserver Enter the Host Name of the machine on which the SQL 7.0 Server is installed.

Default value: devtm

pSQLuser Enter the User Name that enables access to the SQL 7.0 installation.

Default value: sa

pSQLpass Enter the Password that enables access to the SQL 7.0 installation.

(This switch has no default value.)

pDBnew In case the installer detects previously installed system tables, enter the value1 if you want to install additional instances of the tables. Otherwise enter 0.

Note: The value 1 can be assigned to only one of the following switches:pDBnew, pDBreplace, and pDBuseExist.Default value: 0

pDBnewName If you entered the value 1 for the pDBnew switch, then this switch valuedetermines the name of the new instances of the system tables. This switch isirrelevant if the pDBnew value is 0.

Default value: TTDB

pDBreplace In case the installer detects previously installed system tables, enter the value1 to replace the existing system tables. Otherwise enter 0.


pDBuseExist In case the installer detects previously installed system tables, enter the value1 to use the existing system tables. Otherwise enter 0.


pServer Specify the host name of the Windows NT machine on which you are installingthe MiniApp Servlet for iViews.


pPort Specify the port for the MiniApp Servlet for iViews.

Default value: 9999

pWebServer Specify the host name of the machine on which the Microsoft IIS is installed.



November 2000 109

pWebRoot Specify the Web server root.

Default value: C:\Inetpub\wwwroot

pSSL Enter the value 1 if you want the MiniApp Servlet for iViews to supportSecured Socket layer (SSL) connections. Otherwise, enter 0.

Default value: 0

pMSDEPath Specify the path to the MSDE installation.

Default value: c:\MSDE

pMSDEuser Enter the User Name that enables access to the MSDE installation.

Default value: sa

pMSDEpass Enter the Password that enables access to the MSDE installation.

(The switch has no default value.)

Log FileAfter activating the batch file, you can consult the Silent Installer’s log file, TTSetupiView.log, todetermine if installation was successful. You will find this log file in the root of the C: drive of themachine on which you ran the Silent Installer.

When the batch file is activated, the installation parameters it contains are writtento an initialization file called Setup.iss. The installer reads the parameters fromthis file.

Below is a sample log file:[InstallShield Silent]Version=v5.00.000File=Log File[Application]Name=MiniApp Servlet for iViews 2.11Version=2.11Company=TopTierLang=0009[ResponseResult]ResultCode=0


110 November 2000

In the sample, the ResultCode value is “0”. The table below details this and the other possiblevalues of the ResultCode.

Result Code Description 0 Success.

-1 General error.

-2 Invalid mode.

-3 Required data not found in Setup.iss.

-4 Not enough memory available.

-5 File does not exist.

-6 Cannot write to Setup.iss.

-7 Unable to write to the log file.

-8 Invalid path to Setup.iss.

-9 Not a valid list type (string or number).

-10 Data type is invalid.

-11 Unknown error occurred during setup.

-12 Dialog boxes are out of order.

-51 Cannot create the specified folder.

-52 Cannot access the specified file or folder.

-53 Invalid option selected.


November 2000 111

2.1.3.3.3 Configuration of the MiniApp ServletPrerequisitesYou have installed the MiniApp Servlet.

Process Flow1. Defining the MiniApp Servlet for iViews Parameter [Page 112]

2. To administer the MiniApp Servlet for the mySAP.com Workplace refer to the CD SAP OnlineDocumentation mySAP.com Workplace 2.11 (Path: SAP Library → mySAP.com Workplace→ Drag&Relate → MiniApp Servlet for iViews ) supplied with the mySAP.com Workplace2.11.


112 November 2000

2.1.3.3.4 Defining the MiniApp Servlet for iViews ParameterUseTo enable the MiniApp Servlet, you must define the MiniApp Servlet for iViews parameter on theWorkplace server.

PrerequisitesThe Workplace Server is installed.

Procedure1. Logon to the Workplace Server.

2. You have to alternatives to perform the task:

Alternative 1 Alternative 2

a. Go to transaction SM30.

b. On the Maintain Table Views screen,enter the following value in theTable/View field: TWPURLSVR.

c. Choose Maintain

Go to transaction View Maintenancecontained in the Workplace Administratorrole.

3. Check whether an entry for the logical system that corresponds to your workplace server isalready maintained.

If this is not the case, you must create one.

Then you just need to fill the MiniApp Server address including port number in theDrag&Relate Server name field using the following syntax.MiniAppServerHostName:<PortNumber>

For example:miniapp.sap.com:9998

In this example, miniapp.sap.com is the host name of the machine on which theMiniApp Servlet is installed, and 9998 is the port number assigned to the serverduring the setup.

In the Drag&Relate server protocol field, enter the appropriate protocol, either HTTP orHTTPS if you use SSL.

The field Drag&Relate path ID is currently not used.


November 2000 113

2.1.4 Terminal Server Installation (optional)PurposeThe Terminal Server is a multi-user version of Windows NT or Windows 2000 from MicrosoftCorporation.

Together with the Metaframe software from Citrix Systems Inc. it enables users to run Windowsapplications, more precisely the user interface of such an application, in a Web browser.

By using a Terminal Server it is possible to integrate applications into the Workplace that are notimplemented in HTML or Java. This includes almost any legacy application and terminalemulation.

This documentation describes how to integrate SAP GUI for Windows into the Workplace usingTerminal Server. This is just one scenario: any other application that runs on Terminal Server canalso be integrated into the Workplace. Depending on the requirements of these applications (e.g.parameter transfer and authentication) they have to be implemented on a case-by-case basis.

PrerequisitesThe Workplace Server and the Internet Transaction Server are installed.

Process Flow1. You check the hardware and software requirements. [Page 10]

2. You set up the Terminal Server. [Page 114]

3. You enable the ITS to use the Terminal Server. [Page 117]

4. You configure the Workplace server for the use of the Terminal Server [Page 118].


114 November 2000

2.1.4.1 Setting up the Terminal ServerUseThe Terminal Server is launched from the LaunchPad in the mySAP.com Workplace. A CitrixWeb Client will be invoked in the Workplace and will connect to the application from there.Windows NT, Terminal Server Edition or Windows 2000 Server can be licensed from MicrosoftCorp.

Citrix Metaframe can be licensed from Citrix Systems Inc.

Technical OverviewThe Workplace calls the TSGUI service via the SAPXGINET gateway. This will generate anHTML page that itself invokes the Citrix Web Client (i.e. Citrix ActiveX Primary ALE Client forWin32 platforms). The Citrix control connects to the Citrix Metaframe Server and starts thepublished application sapshcut. SAPSHCUT.EXE is generally used to start SAP GUI sessionsfrom a shortcut file. All parameters are passed as command line parameters.

Current versions of Metaframe contain extensions that support the controlled start of any SAPtransaction as well as navigation in Terminal Server-based sessions from the LaunchPad.

Prerequisites• Windows NT 4.0, Terminal Server Edition with Support Package 4 or higher in combination

with Citrix Metaframe 1.8 and Support Package 1 or higher is installed.

• Either Windows 2000 Server or Windows 2000 Advanced Server with Windows TerminalServices in combination with Citrix Metaframe 1.8a or higher is supported.

• SAP GUI for Windows 4.6D.

• The Terminal Server has to be installed on a different host than the ITS server.

• The file system on the server is not protected by default. Make sure that a security system isset up.

Procedure (Example for SAP GUI for Windows)1. Install Windows NT 4.0 Terminal Server Edition or Windows 2000. Install the latest Service

Pack.

2. Install Citrix Metaframe 1.8 or higher on the Terminal Server. Install the latest Service Packfor Metaframe.

3. Install the SAP GUI for Windows from the mySAP.com Presentation CD (see Overview ofRelated Installation Guides [Page 121]) on the Terminal Server. For technical reasons theinstallation path for SAP GUI needs to be the root directory of any disk. Note that on aTerminal Server applications need to be installed using Control Panel → Add/RemovePrograms.


November 2000 115

4. Define a Citrix Published Application that points to <drive>:\SAPpc\SAPGUI\sapshcut.exe %*

The recommended name for the Published Application is sapshcut. Please select

Anonymous mode for authentication.

You define a Published Application using the Published Application Manager fromCitrix that is part of the Metaframe software; please refer to the Citrixdocumentation for details.

5. You configure anonymous users on the Terminal Server.

The Workplace Server does not use NT authentication, because authenticationtakes place on the Workplace Server. Instead it uses the Citrix PublishedApplication with anonymous users (Anon000 - Anon014, created during theinstallation of Metaframe). If necessary, Metaframe will dynamically add Anonxxxusers for up to 99 concurrent sessions..

a. Set up a profile in \<systemroot>\Profiles\Default User containing at leastSAPLOGON.INI and SAPMSG.INI. If these files are to be valid for all users on theTerminal Server, they must also be stored centrally in \<systemroot>

Anonymous users get their profile (SAPLOGON.INI, Start Menu, favorites etc.)during logon from \<systemroot>\Profiles\Default User. Create files and settingshere, if they are to be available for anonymous users. If a file with the same name(same name as what?)already exists in the \Winnt (or similar) directory, this filerather than the \Default User version will be used.When the last relevant process for the anonymous user has ended (SAP GUIlogoff or the user navigates out of the Workplace), the ICA session will be reset


116 November 2000

that is equivalent to a user logoff. At this point of time all profile settings(SAPLOGON.INI etc.) will be cleared.

b. Further settings for each Anonxxx user:

i. Password never expires: Yes

ii. User can change password: No

iii. User must be member of Anonymous and Users groups

iv. On a broken or time-out session: Reset (This is the default for anonymous users)

v. Connect client drives: No

vi. User Guest must be disabled

c. Additional adjustments can be made to optimize the logon process and the appearanceof the Terminal Server session. You can find some recommended changes in the SAPNote 215529.


November 2000 117

2.1.4.2 Enabling the ITS to Use the Terminal ServerUseThe SAP Internet Transaction Server must be made aware of the Terminal Server. To do so, youwill have to maintain the file tsgui.srvc (has been installed by the ITS).

PrerequisitesYou have installed the Terminal Server. [Page 114]

Procedure1. Log on to the Internet Transaction Server.2. Save the latest Citrix Web Client. contained in wfica.cab in a directory on the ITS that is

accessible from a URL. Example: http://hostname/xxx_ITS/Citrix/wfica.cab.

Either take the file wfica.cab from your Metaframe installation or use a Webbrowser to access the Citrix Web site(http://download.citrix.com/index.htm), and download the CitrixActiveX web client. Use the ActiveX Primary ALE Client for Win32 platforms (i.e.,NT 4.0, Win98, etc.).

3. Logon to ITS Administration and adjust the following parameters for the service TSGUI:

− citrixcabfile: This parameter must contain the URL for the Citrix ActiveX PrimaryALE Client for WIN32 Platforms (wfica.cab#Version=4,2,779,0). When a Workplace userconnects to a Terminal Server for the first time , the Citrix ActiveX control is installed fromthis file on the client computer. During subsequent sessions the installed control is used.

− terminalserver: Hostname or IP address of the Terminal Server or ICA MasterBrowser (see Citrix MetaFrame documentation for a discussion on ICA Browsers), onwhich SAP GUI was installed.

− Terminalserver2: Additional ICA Browser (optional)

Do not change any further parameters . Note that the template for the .ica filewhich is used to connect to the Terminal Server can be found as tsica.html in the\templates\tsica\99 directory. For more details on the parameters, refer to theCitrix Metaframe documentation.


118 November 2000

2.1.4.3 Configuring the Workplace ServerUseYou have to enable the mySAP.com Workplace Server to communicate with the Terminal Server.

By default the Workplace Server is not enabled for the Terminal Server.

Procedure1. Log on to the Workplace Server.

2. Edit the table VWPCUSTOMC with transaction SM30 and set the entry WPGUIS TRML_SRVR

to ‘X’.


November 2000 119

3. Now you can set the user interface (UI) preferences to SAP GUI for Windows using thetransaction SURL_PERS_ADMIN.

SAP GUI for Windows from your PC SAP GUI for Windows throughTerminalSrvr

• You need a SAP GUI for Windowsinstalled on your frontend

• The transactions are started in aseparate SAP GUI Window

• Window sizing is possible

• Downloads and uploads refer to theuser's local hard disk

• You do not need SAP GUI forWindows installed locally on yourfrontend

• The transactions are started in thebrowser.

• Increasing the window is limited by thesize of the browsers frame

• Downloads and uploads refer to the filesystem of the terminal server (unlessclient drive mapping is selected)


120 November 2000

2.1.5 Business Connector Installation (optional)UseSAP Business Connector (SAP BC) is a middleware component.

It enables integration with a SAP System via open and non proprietary technology.

SAP BC uses the Internet as communication platform and XML/HTML as data format.

Thus it seamlessly integrates different IT architectures with a SAP System.

For some special features of a SAP B2B Procurement - System you need the SAP BusinessConnector; follow the instructions in the SAP BBP Procurement installation guide.

ProcedureIf required, install the SAP Business Connector according to SAP Business Connector 3.0Installation Guide (see Overview of Related Installation Guides [Page 121]).

For more information about Business Connector, refer to SAP ServiceMarketplace: http://service.sap.com/connectors.


November 2000 121

3 Overview of RelatedDocumentation

The whole mySAP.com Workplace LandscapeGuide Purpose Location of Guide

Sizing-Information and Hardware Requirements

Information /Papers

Purpose Where to find

Workplacerequirements

Scalability News and Overview In SAP Service Marketplace :http://service.sap.com/workplace ; choose folderrequirements.

Sizing my SAP.com Sizing papers (Workplace Server,Workplace Middleware, SAP Systems,Sizing methodology)

In SAP Service Marketplace :http://service.sap.com/sizing

SAP-Information about mySAP.com internet integration and security

mySAP.comWorkplace - NetworkIntegration Guide

mySAP.com Workplace specificnetwork guidance

In SAP Service Marketplace :http://service.sap.com/network

SAP Security Guide(Vol. I / II / III)

Network security guidance In SAP Service Marketplace :http://service.sap.com/securityguide

Workplace Middleware ServerApplication Software Installation and Configuration Guides

Guide Purpose Location of Guide

SAP@WebInstallation Guide4.6D

Installing and configuring the SAPInternet Transaction Server (ITS)

CD-ROM:

Server Components Package4.6D

SAP BusinessConnectorInstallation Guide

Installing and configuring the SAPBusiness Connector.

CD-ROM:

Server Components Package4.6D

SAP Employee SelfService Release 4.6

Installing and configuring the ESS Automatically installed with theR/3 IAC Package


122 November 2000

Workplace Server and component systemsGuide Purpose Location of Guide

mySAP.comWorkplace –Overview

High-level description of mySAP.comWorkplace

Configuration Guidefor the mySAP.comWorkplace

Cookbook:Configuration activities for theWorkplace Server and Workplacecomponent systems

Drag&Relate Configuration of Drag&Relate

CD-ROM:

SAP Online DocumentationmySAP.com Workplace 2.11

Path: SAP Library →mySAP.com Workplace

SAP Add-OnInstallation Tool(Transaction SAINT)

Installing required functions on themySAP.com component systems andthe Workplace Server

CD-ROM:

Workplace Plug-In 2.11 forComponent Systems with SAPBasis 3.1H - 4.6D

Workplace Server onlyApplication Software Installation Guides

Guide Purpose Location of Guide

Several guides forthe SAP 4.6D BasisSystem installationon differentoperating systemsand databases

Installing required SAP BASIS 4.6DSystem as Workplace Server basis. CD-ROM:


Path: install/WPServer

MiniApps Cookbook:Creating and adding MiniApps

Roles in theWorkplace

Cookbook:Creating and adding roles

Single Sign-On inthe mySAP.comWorkplace

Establishing the SSO feature

CD-ROM:


Path: SAP Library →mySAP.com Workplace

FrontendGuide Purpose Location of Guide

SAP FrontendInstallation Guide

Installing the SAP GUI for Windows onthe user's frontend.

Presentation CD:mySAP.com WorkplacePath: /docu/Pc46d_e.pdf


November 2000 123

4 Overview of Related SAP NotesThe whole mySAP.com Workplace 2.11 LandscapeNote Number Short Text

355911 mySAP.com Workplace 2.11 Installation

319895 Release restrictions Workplace 2.10/2.11

Workplace MiddlewareNote Number Short Text

201190 Upgrade des ITS / Templates

105055 ITS, R/3 and Web Server Supported Releases

150533 Printing under Windows Terminal Server (WTS)

138869 SAPGUI on Windows Terminal Server (WTS)

183845 Preclarification ITS

212773 Drag&Relate: Link generation in Workplace 2.11

322597 Additions Workplace Upgrade to Release 2.11

317922 Workplace Performance : ITS and Browser Cache

318515 Collective Note: SSO in the mySAP.com Workplace

211005 WP-PI 2.11 Support Packages Drag & Relate

PerformanceNote Number Short Text

317992 Workplace Performance: ITS and Browser Cache

309779 Workplace Performance: Optimizing browser settings

212396 Performance mySAP.com Workplace: Tips for IAC, Mini-Apps

203845 Performance mySAP.com Workplace

mysap.com workplace 2.10 - installation guide... and os/400® are registered trademarks of ibm...

Documents