You are on page 1of 39

6$3,76

6HWXS$GPLQLVWUDWLRQ
7XQLQJ 7URXEOHVKRRWLQJ

Frank Krause,
SAP AG

$JHQGD

,QWURGXFWLRQ
1HWZRUN %DVLFV
:HE 6HUYHUV
6$3 ,76 ,QVWDOODWLRQ
6$3 ,76 $GPLQLVWUDWLRQ
&RQILJXUDWLRQ
0RUH ,QIRUPDWLRQ

 SAP AG 2002, SAP Skills 2002 B1_Krause 2

1
6$3 6\VWHPV DQG WKH :HE 7KH 7DVN

Web Browser
Intranet
Web Browser
Web Browser

Firewall

Web SAP System


Internet Server

Web Browser

PC

PC GUI
Web Browser

 SAP AG 2002, SAP Skills 2002 B1_Krause 3

6$3 6\VWHPV DQG WKH :HE 7KH 6ROXWLRQ

Web Browser
Intranet
Web Browser
Web Browser

Firewall

Web SAP System


SAP
Internet Server ITS
Web Browser

PC

PC GUI
Web Browser

 SAP AG 2002, SAP Skills 2002 B1_Krause 4

2
6$3 ,QWHUQHW 7UDQVDFWLRQ 6HUYHU
Extends the reach of SAP Systems into the Web by mapping SAP
screens to HTML, WML, or similar Web formats.

Drives transactions within the SAP System or calls function modules


„ Application server sees a SAP GUI for Windows

Separation of business logic and visual appearance.

Downward compatible to both SAP System and SAP ITS releases.

 SAP AG 2002, SAP Skills 2002 B1_Krause 5

+RZ WR 2IIHU D 6HUYLFH RQ WKH :HE"


SAP ITS

SAP System

Web Browser

Web Server

WGate AGate

MIME Files Service Files Application


•Images •Service description •ABAP
•Videos Outside SAP
•HTMLSystem
Templates Inside SAP
•Dynpro System
Screens
•Language Resource
•Sound HTML Visualization •Customization
Business Logic
Files
SAP@Web
•Flow Files
Studio or
ABAP ABAP
Workbench Workbench
 SAP AG 2002, SAP Skills 2002 B1_Krause 6

3
6$3 ,76 $UFKLWHFWXUH

Load
Load
Service
Service File
File

Send
Send Prepared
Prepared
User
User Request
Request Call
Call WGate
WGate Request
Request

R/3
R/3 Input
Input SAP System

SAP Internet
WGateWGate AGate Application Component

Web Browser Web Server R/3


R/3 Output
Output
BAPI
HTML Stylesheets
Templates
HTML
HTML Page
Page HTML
HTML Page
Page
SAP Data

Load
Load
HTML
HTML Template
Template (and
(and Stylesheet)
Stylesheet)
 SAP AG 2002, SAP Skills 2002 B1_Krause 7

$JHQGD

,QWURGXFWLRQ
1HWZRUN %DVLFV
:HE 6HUYHUV
6$3 ,76 ,QVWDOODWLRQ
6$3 ,76 $GPLQLVWUDWLRQ
&RQILJXUDWLRQ
0RUH ,QIRUPDWLRQ

 SAP AG 2002, SAP Skills 2002 B1_Krause 8

4
1HWZRUNV
$ JRRG XQGHUVWDQGLQJ RI QHWZRUNV DQG QHWZRUN
FRPPXQLFDWLRQ LV HVVHQWLDO IRU LQVWDOOLQJ 6$3 ,76

„ SAP ITS is a piece of software that serves as a connector


between Web server and SAP System and thus needs to
communicate with both Web Server and SAP Application Server
using the appropriate network protocols.
„ To understand and design SAP ITS landscapes for increased
scalability and fault tolerance you need to have a feeling of how
networks operate.
„ Basic Network information (like the name or address of the
server) is used during the execution of ITSSetup and the
administration of SAP ITS.

 SAP AG 2002, SAP Skills 2002 B1_Krause 9

&RPPXQLFDWLRQV 3URWRFRO 7&3,3


TCP/IP = Transmission Control Protocol / Internet Protocol

Internet

'HYHORSHG DQG VWDQGDUGL]HG LQ 

$YDLODEOH RQ DOPRVW DQ\ RSHUDWLQJ V\VWHP SODWIRUP

(QDEOHV D V\VWHP WR H[FKDQJH GDWD ZLWK RWKHU V\VWHPV

 SAP AG 2002, SAP Skills 2002 B1_Krause 10

5
,3 $GGUHVVHV
A four-byte address that uniquely identifies each computer in the
Internet worldwide

An IP address consists of:


„ Network ID (bytes 1-3)
„ Host ID (byte 4)

IP address
IP address 142.16.172.83
161.78.135.91

 SAP AG 2002, SAP Skills 2002 B1_Krause 11

7&3 3RUWV
IP address z Mail Server
142.16.1.9

z News Server

z Web Server
Internet 6RIWZDUH

Logical
+DUGZDUH TCP port

 SAP AG 2002, SAP Skills 2002 B1_Krause 12

6
+773 ² +\SHUWH[W 7UDQVIHU 3URWRFRO
+773 LV WKH PDLQ DSSOLFDWLRQ SURWRFRO RI WKH ,QWHUQHW
„ Handles transmissions between HTTP Clients (usually Web
Browsers) and HTTP Servers (Web Servers)
„ Based on TCP/IP
„ Stateless

HTTP request

HTTP response
Web Browser Web Server

 SAP AG 2002, SAP Skills 2002 B1_Krause 13

$JHQGD

,QWURGXFWLRQ
1HWZRUN %DVLFV
:HE 6HUYHUV
6$3 ,76 ,QVWDOODWLRQ
6$3 ,76 $GPLQLVWUDWLRQ
&RQILJXUDWLRQ
0RUH ,QIRUPDWLRQ

 SAP AG 2002, SAP Skills 2002 B1_Krause 14

7
:HE 6HUYHUV
A Web Server software responds
to requests from Web Browsers

„ Each request is sent to a specific Web


Server (or an HTTP Router).
„ Each request is directed to a specific port
on this server (if no port is specified the
request is directed to a default port –
usually 80).

Responses are either generated dynami-


cally or are taken from a predefined direc-
tory structure belonging to the Web Server
„ This structure usually is created before the
Web Server itself is set up.
„ The default IIS 5.0 file directory is
C:\INETPUB\WWWROOT.
„ If you don’t specify a file to be accessed the
Web Server may return a default document.

 SAP AG 2002, SAP Skills 2002 B1_Krause 15

:HE 6HUYHU
Web Server software
„ Listens on a specific TCP port for requests
„ Replies to HTTP requests from HTTP clients
„ Can only send data after receiving a request

Sends request

Replies with data


Web Browser Web Server

 SAP AG 2002, SAP Skills 2002 B1_Krause 16

8
:HE %URZVHUV
Software used to access the Internet
„ Requests data from a Web Server (client/server structure)
„ Presents the information received (such as text and pictures)
„ Sends data to the Web Server

Sends data

Receives data
Web Browser Web Server

 SAP AG 2002, SAP Skills 2002 B1_Krause 17

:HE 6HUYHUV
0DMRU :HE 6HUYHUV
„ Microsoft Internet Information Server (IIS)
„ iPlanet Web Server (formerly known as Netscape Enterprise
Server)
„ Apache Web Server (for LINUX, UNIX and Windows NT)

&XUUHQWO\ 6$3 ,76 VXSSRUWV


„ Microsoft IIS
„ iPlanet Web Server
„ Apache Web Server on Windows NT and Linux
„ Other Web Servers on Windows NT platforms through a generic
CGI interface

 SAP AG 2002, SAP Skills 2002 B1_Krause 18

9
9LUWXDO :HE 6HUYHUV
On a single computer, multiple Web Servers can be installed without
having to repeat a physical installation. This kind of Web Server is
called a ‘virtual’ Web Server.

A request to a host with multiple virtual Web Servers installed is


directed to the correct virtual Web Server by differentiating by
„ IP address (each virtual Web Server may have its own IP address)
„ Port number (each virtual Web Server may listen on a different port)

Each virtual Web Server should have its own directory structure
„ This is necessary to install multiple SAP ITS instances with different
application contents on the same computer

To use virtual Web Servers Microsoft IIS 4.0 (or higher), Netscape
3.51 (or higher) or Apache Web Server are required

 SAP AG 2002, SAP Skills 2002 B1_Krause 19

0LFURVRIW ,,6 :HE 6HUYHU 'LUHFWRU\ 6WUXFWXUH


C:
„ \INETPUB (default web area)
‹\WWWROOT (default web root directory)

Root directories for multiple virtual Web Servers

C:
„ \INETPUB
‹\WWWWEBGUI (Web area for SAP ITS ‘WEBGUI’)
‹\WWWADM (Web area for SAP ITS ‘ADM’)

 SAP AG 2002, SAP Skills 2002 B1_Krause 20

10
:HE 6LWH FUHDWLRQ
Start the Internet Services Manager (Control
Panel Administrative Tools). Right-click on
the name of your computer in the left frame of
the window and select ‘New Web Site’.
Type ‘WEBGUI’, click ‘Next’.
Select TCP Port 1080 and click ‘Next’.

Provide the path to the


virtual Web Server root
directory and click ‘Next’.

Deselect all options


except ‘Read’ and
click ‘Next’. On the
next screen click
‘Finish’.
 SAP AG 2002, SAP Skills 2002 B1_Krause 21

([HUFLVH 
&UHDWH WKH GLUHFWRULHV DQG WKH FRUUHVSRQGLQJ
YLUWXDO :HE 6HUYHUV IRU \RXU 6$3 ,76 LQVWDOODWLRQV

Create 2 directories under C:\INETPUB for your virtual Web


Servers named
„ WWWWEBGUI
„ WWWADM

Each of these will serve as a root directory for a virtual Web


Server instance
Create two virtual Web Servers using the Microsoft
Management Console (Start Programs Administrative
Tools Internet Services Manager)
Create the first virtual Web Server and call it ‘WEBGUI’
„ Use the directory C:\INETPUB\WWWWEBGUI\
„ Set it up on port 1080

Create the second virtual Web Server and call it ‘ADM’


„ Use the directory C:\ITSPUB\WWWADM
„ Set it up on port 2080

 SAP AG 2002, SAP Skills 2002 B1_Krause 22

11
$JHQGD

,QWURGXFWLRQ
1HWZRUN %DVLFV
:HE 6HUYHUV
6$3 ,76 ,QVWDOODWLRQ
6$3 ,76 $GPLQLVWUDWLRQ
&RQILJXUDWLRQ
0RUH ,QIRUPDWLRQ

 SAP AG 2002, SAP Skills 2002 B1_Krause 23

6$3 ,76 ,QVWDOODWLRQ


<RX FDQ JHW WKH LQVWDOODWLRQ ILOHV IURP
„ A Server Components CD (directory ITS\NT\i386).
„ http://service.sap.com/swcenter-main Web site for the latest patches.

7KH VHWXS H[HFXWDEOH LV DQ ,QVWDOO 6KLHOG SURJUDP


„ Easy user friendly dialog
„ Simple uninstall through ‘Control Panel Add/Remove Programs’

6$3#:HE ,QVWDOODWLRQ *XLGH


„ Detailed step by step instructions
„ Print and read these instructions before starting an
installation

6$3 ,76 LV IXOO\ GRZQZDUG FRPSDWLEOH


„ SAP System release must be 3.0D or higher
„ The SAP ITS release must at least equal the
SAP System release

 SAP AG 2002, SAP Skills 2002 B1_Krause 24

12
6$3 ,76 ,QVWDOODWLRQ 5HTXLUHPHQWV
:LQGRZV 17  6HUYHU QRW :RUNVWDWLRQ
„ Running on an Intel or compatible processor
„ Minimum Service Pack 4 (Service Pack 6a is recommended)
„ Windows NT 4.0 Option Pack is required for virtual Web Servers

:LQGRZV  6HUYHU QRW :RUNVWDWLRQ


„ Running on an Intel or compatible processor
„ Service Pack 1

A minimum of 128 MB physical memory is


recommended (productive installations may
require a lot more than this).

1GB Hard Drive space will suffice for several


SAP ITS installations.

 SAP AG 2002, SAP Skills 2002 B1_Krause 25

6$3 ,76 ,QVWDOODWLRQ 3DUDPHWHUV


/DQGVFDSH  7\SH RI LQVWDOODWLRQ

„ Single Host
„ Dual Host (Recommended for Security and Scalability)
‹ AGate installed on one host
‹ WGate installed on another host together with the Web Server
6$3 ,76 LQVWDQFH W\SH ² 7\SLFDO RU $GPLQLVWUDWLRQ LQVWDQFH

„ Typical instances can run SAP GUI for HTML and other applications
„ Administration instances exclusively run ITS Administration

(virtual) Web Server to connect the SAP ITS to

Application packages (IAC packages) to be installed

SAP System Connection information and Logon Data (optionally)

 SAP AG 2002, SAP Skills 2002 B1_Krause 26

13
6LQJOH +RVW ,QVWDOODWLRQ

ISAPI
HTTP
DIAG

WGate

AGate
NSAPI
HTTPS TCP/IP
APACHE RFC
SAP
Web
Server
CGI
,76 Application
Server

Windows NT Server 4.0 or Windows 2000 Server

 SAP AG 2002, SAP Skills 2002 B1_Krause 27

'XDO +RVW ,QVWDOODWLRQ

ISAPI
HTTP
DIAG
WGate

AGate

NSAPI
HTTPS TCP/IP
APACHE RFC
SAP
Web
Server
CGI
,76 Application
Server

Windows NT Server 4.0, Windows NT Server 4.0 or


Windows 2000 Server or Windows 2000 Server
Linux (Redhat 6.1 & 6.2,
SuSE 7.0)

 SAP AG 2002, SAP Skills 2002 B1_Krause 28

14
6HFXULW\ ² $GGLWLRQDO 3URWHFWLRQ
Firewalls

ISAPI
DIAG

WGate

AGate
NSAPI
HTTPS TCP/IP
APACHE RFC
SAP
Web CGI Application
Server Server

SNC, (SAPRouter possible) SAPRouter


These security measures are strongly recommended for productive
installations. The firewall between AGate and WGate is only possible in Dual
Host mode !
 SAP AG 2002, SAP Skills 2002 B1_Krause 29

9LUWXDO LQVWDQFHV
ISAPI
WGate

AGate

NSAPI
With a certain number of
,76
TCP/IP
APACHE virtual Web Servers installed,
Virt. Web
Server CGI
 you can create the same
number of SAP ITS
environments on a single host.

Several ITS instances (also


ISAPI called ‘virtual instances’) can
operate independently on the
WGate

AGate

NSAPI
same server.
,76
TCP/IP
APACHE
Virt. Web
Server CGI


 SAP AG 2002, SAP Skills 2002 B1_Krause 30

15
6$3 ,76 ,QVWDOODWLRQ
2Q WKH IROORZLQJ SDJHV \RX FDQ ILQG VFUHHQVKRWV IURP DQ
LQVWDOODWLRQ RI D 6$3 ,76 '&
„ Different SAP ITS versions may have slightly different screens
„ A Dual Host Installation requires more information (e.g. the name of the
server the AGate is installed on as well as information on which TCP
ports the AGate is listening on)
„ For simplicity we will not install the SAP ITS using Windows NT File
System protection. Using this feature allows to protect all ITS data
stored in files on the SAP ITS hosts from unauthorized access.

The concepts and information are the same


for all versions up to release 4.6D
(as of release 6.10, a new installation tool is
used, but the concepts basically stay the same).

 SAP AG 2002, SAP Skills 2002 B1_Krause 31

6$3 ,76 ,QVWDOODWLRQ 


Click ‘Next’.

Select ‘Single-Host’
and click ‘Next’.

Click ‘Next’.

 SAP AG 2002, SAP Skills 2002 B1_Krause 32

16
6$3 ,76 ,QVWDOODWLRQ 
Select ‘Typical’
and click ‘Next’.

Type ‘WEBGUI’
and click ‘Next’.

Select ‘Microsoft IIS 5.0 (WEBGUI)’


and click ‘Next’.

 SAP AG 2002, SAP Skills 2002 B1_Krause 33

6$3 ,76 ,QVWDOODWLRQ 


Enter the name of the server (without
domain extension) and the port your
Web Server is listening on. Click
‘Next’.

Select ‘webgui’, click ‘Install’ and


then ‘Next’. Ignore the popup.

Confirm the selection by


clicking ‘Next’.
 SAP AG 2002, SAP Skills 2002 B1_Krause 34

17
6$3 ,76 ,QVWDOODWLRQ 
Select ‘Minimize Memory Usage’
and click ‘Next’.

Type the name of the


SAP System the SAP
ITS will be connected to
and click ‘Next’.
Enter the SAP System connection data
and click ‘Next’.

 SAP AG 2002, SAP Skills 2002 B1_Krause 35

6$3 ,76 ,QVWDOODWLRQ 


Select ‘Everyone’ and click ‘Next’.

Type the full URL to your


Web Server home page and
click ‘Next’.
Confirm all popups and Skip reading the Release Notes Ready to go!
wait for the files to be and let the computer reboot
copied. when asked to.
 SAP AG 2002, SAP Skills 2002 B1_Krause 36

18
([HUFLVH 
,QVWDOO D ¶W\SLFDO· 6$3 ,76 LQVWDQFH WR \RXU
¶:(%*8,· :HE 6HUYHU LQVWDQFH
„ Use SAP System data provided during class.
„ Install the IAC package ‘WEBGUI’.
„ Use the ‘Minimized Memory Configuration’.
„ Do not allow a reboot after installing this ITS instance.
Install an administrative instance to your ‘ADM’ Web Server
instance
„ Notice the differences in the installation dialog.
„ This time allow the computer to be rebooted.
Start the SAP ITS application ‘webgui’ (SAP GUI for HTML)
by opening a Web Browser and requesting the URL
‘http://<yourServer>:1080/scripts/wgate/webgui/!’
where <yourServer> is replaced by the IP address or DNS
name of your computer. Use the logon data supplied in
class.
 SAP AG 2002, SAP Skills 2002 B1_Krause 37

6$3 ,76 ,QVWDOODWLRQ  7URXEOHVKRRWLQJ


3RVVLEOH SUREOHPV HQFRXQWHUHG GXULQJ 6$3 ,76 LQVWDOODWLRQ

3UREOHP 6ROXWLRQ
ITSSetup continues to prompt for Remove the write protection flag
rebooting the system even if you from some system files located in
have already rebooted once or C:\WinNT\system32 (see OSS note
several times 322113 for details)
System ‘hangs’ when installing or This problem sometimes occurs
uninstalling the SAP ITS when using MS IIS. A solution can be
to quit the installation, reboot and
stop the IIS Admin NT service before
repeating the installation.
The installation stops with the error Close all applications before starting
message ‘Failed to copy the file ITSSetup (especially MMC). Some
<filename> because it is being used SAP applications, e.g. SAP GUI for
by another process.’. Windows, and SAP ITS share files
that can’t be exchanged by ITSSetup
while these applications are still
running.

 SAP AG 2002, SAP Skills 2002 B1_Krause 38

19
6$3 ,76 6FDODELOLW\
6$3 ,76 RIIHUV VHYHUDO 6FDODELOLW\ DQG /RDG %DODQFLQJ
RSWLRQV
„ Scale up the Web Server infrastructure
„ Scale up the number of AGate servers / AGate processes
„ Use Load Balancing via SAP Messageserver
„ Use SAP ITS Load Balancing
„ Make use of an HTTP Router

 SAP AG 2002, SAP Skills 2002 B1_Krause 39

:HE 6HUYHU  6$3 ,76 6FDODELOLW\


SAP System

WGate

Web Browser Web Server


AGate

WGate

Web Server
Web Browser

One WGate passes requests on to one Agate

One AGate can be connected to several Web Servers/WGates

 SAP AG 2002, SAP Skills 2002 B1_Krause 40

20
6$3 ,76 6FDODELOLW\
SAP System

WGate AGate

Web Server
Web Browser

WGate AGate

Web Server
Web Browser

Several SAP ITS instances can be connected to the same SAP


System

 SAP AG 2002, SAP Skills 2002 B1_Krause 41

6$3 ,76  6$3 6\VWHP 6FDODELOLW\


SAP System

Appl.
Server

WGate AGate

Web Server
Web Browser

Message
Server

„ One SAP ITS can use several Application Servers of one SAP
System via:
‹ Load Balancing
‹ Separate selection of a specific Application Server

 SAP AG 2002, SAP Skills 2002 B1_Krause 42

21
6$3 ,76 /RDG %DODQFLQJ
SAP System
AGate

AGate
WGate

Web Browser Web Server

AGate

„ WGate just passes prepared requests on to AGate


„ AGate does the actual work
‹ Session management
‹ HTML page generation
„ CPU utilization of AGate is much higher than WGate´s
„ This scenario offers additional fault tolerance for AGate

 SAP AG 2002, SAP Skills 2002 B1_Krause 43

+773 5RXWLQJ 6$3 ,76 '  +LJK $YDLODELOLW\

AGate

WGate

Web Server
AGate

Web Browser HTTP Router WGate

Web Server
AGate

 SAP AG 2002, SAP Skills 2002 B1_Krause 44

22
:*DWHFRQI  85/ VHFWLRQ
The URL section describes which URLs will be passed to which SAP ITS
instance by the Web Server:
<url _default_:1080/scripts/wgate>
instance WEBGUI
</url>
This rule means that all requests with the Web Server name followed by
‘:1080/scripts/wgate’ will be directed to the instance named ‘WEBGUI’.
You can adapt the URL to start an SAP ITS application by changing the
‘/scripts/wgate’ part according to your conception (only lower case !).
After the WGate.conf has been
modified you have to restart the Web
Server to apply the changes.
To do this open the NT Services
administration (‘Control Panel
Administrative Tools Services’),
mark the line ‘IIS Admin Service’ and
push the ‘Restart Service’ icon.

 SAP AG 2002, SAP Skills 2002 B1_Krause 45

:*DWHFRQI  ,QVWDQFH VHFWLRQ


By reading the instance sections the WGate figures out which AGates to
connect to. This section is also used to specify configuration parameters:
<instance WEBGUI> This is the TCP port the first AGate
<agate> process of the ‘WEBGUI’ instance is
Host <yourServer> listening on (the values are stored in
PortAGate sapavw00_WEBGUI C:\WinNT\System32\drivers\etc\services).
PortMManager sapavwmm_WEBGUI This is the port the Mapping Manager of
the ‘WEBGUI’ instance is listening on.
Secure 1
Type 2
This parameter indicates whether the AGate
MultiProcess no of the according instance is configured to
</agate> run multiple AGate processes.
TraceFile "C:\Program Files\SAP\ITS\2.0 \WEBGUI\traces\WGate.trc"
TraceLevel 1
</instance> These two parameters let you configure
the location of the WGate tracefile and the
level of detail used to generate the file.

If you want to use SAP ITS Load Balancing, you just need to add another
<agate> section pointing to the second AGate and make sure the settings for
the TCP ports and ‘Multiprocess’ are correct.

 SAP AG 2002, SAP Skills 2002 B1_Krause 46

23
([HUFLVH 

In the file C:\Program Files\SAP\ITS\2.0\WGateIIS\WGate.conf


create a second AGate section for instance WEBGUI (use the
connection information provided during class). Edit the file
with Notepad.

Create a second AGate section for instance ADM (use the


connection information provided during class).

Restart the Web Server.

Start the SAP GUI for HTML and try to find out which SAP ITS
AGate server you are connected to.

 SAP AG 2002, SAP Skills 2002 B1_Krause 47

:*DWHFRQI  7URXEOHVKRRWLQJ
3UREOHP 6ROXWLRQ
SAP ITS can’t be accessed (‘The page Check the wgate.conf file for syntax
cannot be displayed’). errors (especially duplicate <instance>
sections). Did someone set ‘available’ to
‘no’?
SAP ITS can’t be accessed (‘500 ITS Make sure that the values for
Error’ or ‘HTTP 500 Error’ in Web ‘PortAGate’ and ‘PortMManager’ in
Browser). wgate.conf are correct. Compare the
values you entered with the values for
SAPavw00_<instance name> and
SAPavwmm_<instance name> in the
C:\WinNT\system32\drivers\etc\services
file on the AGate host. Is the AGate
started? Do you use Firewalls?
SAP ITS can’t be accessed (‘HTTP Check the URL sections in wgate.conf.
Error 403 – Forbidden: Read Access Does the URL you used in your request
Forbidden’). The Web Browser might match one of the patterns in the URL
also ask you whether some file from sections? Avoid using upper case
the SAP ITS host is to be downloaded letters in the URL sections of gate.conf.
or not.
 SAP AG 2002, SAP Skills 2002 B1_Krause 48

24
,$&25 ,QVWDOODWLRQ &RQILJXUDWLRQ
,$&25 ,$& 2EMHFW 5HFHLYHU
„ Windows NT based tool that was designed to allow publishing IAC
contents from an SAP System to a virtual SAP ITS instance
„ Registers SAP ITS instances at a gateway of the SAP System (release
4.6C or higher) and waits for files to receive
„ The publication process can be started from transactions SE80 (Web
Application Builder) and SE38 in the SAP System
„ From SAP System release 6.10 on, IACOR can also be used to publish
IAC files to SAP ITS landscapes in addition to single SAP ITS instances

 SAP AG 2002, SAP Skills 2002 B1_Krause 49

,$&25 ,QVWDOODWLRQ 
Start ‘C:\Program Files\SAP\ITS\2.0\
Admin\IACORAdmin.exe’ on your
host. In addition to the window on
the right the below popup appears.

Press ‘Register’ to register the


Click ‘OK’
IACOR service and ‘OK’ on
and in the
the next popup.
main
window use
‘Options’ to
display the
IACOR
options.

 SAP AG 2002, SAP Skills 2002 B1_Krause 50

25
,$&25 ,QVWDOODWLRQ 
The ‘o’ in the upper right corner of
the main window turned green
(IACOR is installed). Press ‘New’ to
create an RFC destinations.

In the field ‘ITS Instance’ enter


‘WEBGUI’, press ‘TAB’ and
change the entry for ‘Web
Server’ to the Web Server
directory belonging to the
instance ‘WEBGUI’. Click ‘OK’.

Enter the data provided during


class. In the bottommost
section you need to enter the
login data of a user privileged
to create RFC destinations in
the SAP System.

 SAP AG 2002, SAP Skills 2002 B1_Krause 51

8VLQJ ,$&25 
To publish IAC files to your SAP
ITS instance start the SAP GUI
for HTML, launch transaction
SE38 and execute the program
‘W3_Publish_Services’.

Skip the screen asking


for a transport request
by clicking on
‘Execute’. After
selecting the IACs to
be published click on
‘Workbench settings’
to choose the instance
to receive the files.

 SAP AG 2002, SAP Skills 2002 B1_Krause 52

26
8VLQJ ,$&25 
Select the SAP ITS instance
named <ITS host name>/<SAP
ITS instance name> and click
the button with the green tick to
return to W3_Publish_Services.
Start the process by clicking
the ‘Publish’ button.

In the IACOR
window you can
track the progress
of publishing. Errors
(if any) are reported
both in IACOR and
SE38.

 SAP AG 2002, SAP Skills 2002 B1_Krause 53

([HUFLVH  RSWLRQDO

Install IACOR as a Windows NT Service


(start C:\Program Files\SAP\ITS\2.0\Admin\IACORAdmin.exe).

Create an RFC destination in the SAP System by using the ‘New’


button. Use the data provided in class.

Logon to the SAP System using SAP GUI for HTML and start
transaction SE38. Execute the report ‘W3_Publish_Services’, skip
the first screen, select the correct SAP ITS instance via ‘Workbench
settings’, choose to publish the IAC ‘sysmsg’ and press ‘Publish’.

Logoff from the SAP System.

Start ‘sysmsg’ via the URL


‘http://<yourServer>:1080/scripts/wgate/sysmsg/!’

 SAP AG 2002, SAP Skills 2002 B1_Krause 54

27
$JHQGD

,QWURGXFWLRQ
1HWZRUN %DVLFV
:HE 6HUYHUV
6$3 ,76 ,QVWDOODWLRQ
6$3 ,76 $GPLQLVWUDWLRQ
&RQILJXUDWLRQ
0RUH ,QIRUPDWLRQ

 SAP AG 2002, SAP Skills 2002 B1_Krause 55

6$3 ,76 $GPLQLVWUDWLRQ DQG &RQILJXUDWLRQ


ITSSetup offers two standard configurations in respect to the
amount of memory used by the SAP ITS instance. These two
configurations differ in the number of Workthreads and Sessions
launched upon start:
„ Default
‹ 400 Sessions
‹ 40 Workthreads
„ Minimized Memory Mode
‹ 64 Sessions
‹ 4 Workthreads

 SAP AG 2002, SAP Skills 2002 B1_Krause 56

28
:RUNWKUHDG6HVVLRQ 0RGHO

SAP System

Dispatcher

In Port

Pool of
Workthreads Session Pool

AGate

 SAP AG 2002, SAP Skills 2002 B1_Krause 57

,QWHUQDO 6FDODELOLW\ $*DWH


Increasing the number of Workthreads will result in
z Higher throughput of your SAP ITS instance
z A rise in memory consumption as well as processor utilization
Increasing the number of Sessions will result in
z The SAP ITS being capable of serving more users at the same
time (as long as the number of Workthreads is sufficient)
z A rise in memory consumption
If you increase the number of Workthreads and/or Sessions you
should always make sure that your server can take the new load. An
alternative is to increase the number of Workthreads/Sessions by
setting up more than one SAP ITS Server and using ITS Load
Balancing.

For hosts equipped with more than 2GB of physical memory and a
fast CPU, installing more than one AGate process is an option.

 SAP AG 2002, SAP Skills 2002 B1_Krause 58

29
6$3 ,76 $GPLQLVWUDWLRQ DQG 0RQLWRULQJ
SAP ITS Administration is an HTML based Administration and Monitoring
tool that can be remotely accessed via Web.

Flexible configuration and administration tool capable of


„ Changing SAP ITS settings
„ Monitoring SAP ITS performance data
„ Editing service files
„ Viewing template files
„ Viewing SAP ITS log files and trace files

Dedicated to and optimized for SAP ITS


„ Control SAP ITS instances (Start, Stop and Restart)
„ Control Web Server instances (Start, Stop and Restart)

Installed on a separate virtual SAP ITS instance.

 SAP AG 2002, SAP Skills 2002 B1_Krause 59

6$3 ,76 $GPLQLVWUDWLRQ /RJLQ


URL request for login:
http://<server>:<port>/
scripts/wgate/adminremote/!
Default Login: itsadmin
Password: init

You can access all features of


ITS Administration by using the
menu on the left hand side. Note
that there is one entry for each
AGate section in wgate.conf.

 SAP AG 2002, SAP Skills 2002 B1_Krause 60

30
6$3 ,76 $GPLQLVWUDWLRQ /RFDO 2YHUYLHZ
On the ‘Local Overview’ screen
the current performance of all
local instances and data on
resources of the host computer
can be observed.

A more detailed view of an


instances current performance
is available after clicking on
the name of that instance in the
right frame.

 SAP AG 2002, SAP Skills 2002 B1_Krause 61

6$3 ,76 $GPLQLVWUDWLRQ 8VHU $GPLQLVWUDWLRQ


To change the password for the
current user select ‘Administration’
followed by ‘Change Password’.

If you want to create SAP ITS


Administration users with
limited privileges you can do so
via ‘Administration User
Management. An ‘Administrator’
can, e.g. change service file
parameters, restart and stop
instances, while ‘View Only’
users cannot change settings or
restart the SAP ITS. Modifying
registry settings except for
performance settings is
restricted to the user ‘itsadmin’.

 SAP AG 2002, SAP Skills 2002 B1_Krause 62

31
6$3 ,76 $GPLQLVWUDWLRQ 0DQDJLQJ 5HPRWH ,QVWDQFHV
The full set of SAP ITS Administration features is available for local SAP ITS
instances only while for remote instances you can access the performance
analysis commands. SAP ITS development has integrated a command (‘Go to
Native ADM’) that lets you switch to a remote Administration instance, so you
can conveniently administer all SAP ITS servers.

 SAP AG 2002, SAP Skills 2002 B1_Krause 63

6$3 ,76 $GPLQLVWUDWLRQ 6HUYLFH )LOHV


‘Configuration Global Services
All Settings’ will give you a list
of global configuration parameters
for the instance you selected.

You can change the setting of


any parameter by modifying
its value in the corresponding
edit field and clicking ‘SAVE’.
This kind of changes is
applied instantly .

The configuration of other


IACs (Internet Application
Components) can be
changed with
‘Configuration Services
<name of the service>’.

 SAP AG 2002, SAP Skills 2002 B1_Krause 64

32
6$3 ,76 7XQLQJ 3DUDPHWHUV 
These tuning parameters can be set in service files:
~http_use_compression – Enables / Disables HTTP compression
between SAP ITS and Web Browser. The level of compression is
determined by the value of the parameter ~http_compress_level.
Activating this feature reduces the amount of data sent to the Web
Browser thus reducing overall network traffic.
~timeout – This parameter specifies the time in minutes after which
an idle user session is terminated. Tuning this parameter will help in
situations where large numbers of sessions are blocked because of
users not logging off but rather closing the Web Browser.
Changes to these parameters take effect immediately (without
requiring to restart the SAP ITS), but already established sessions
are not affected.

 SAP AG 2002, SAP Skills 2002 B1_Krause 65

6$3 ,76 $GPLQLVWUDWLRQ 3HUIRUPDQFH 6HWWLQJV


The most important settings regarding SAP ITS performance can be accessed
by selecting ‘Configuration Performance’.

In most cases it is
sufficient to modify
one or more of these
settings if you want to
adjust your SAP ITS
according to your
needs. Remember that
after saving your
changes you still have
to restart the SAP ITS
instance in order to
apply them.

 SAP AG 2002, SAP Skills 2002 B1_Krause 66

33
6$3 ,76 7XQLQJ 3DUDPHWHUV 
MaxSessions – Maximum number of sessions the SAP ITS instance
can support in parallel
MinWorkThreads – The number of Workthreads created by the SAP
ITS instance at startup
MaxWorkThreads – Maximum number of Workthreads supported by
the instance (the SAP ITS will start with MinWorkThreads and increase
this number up to a maximum of MaxWorkThreads in case of high
load)
StaticTemplates – When this parameter is set to ‘1’ the SAP ITS will
cache all HTML templates used by SAP ITS applications thus
improving performance. In development environments this parameter
should always be set to ‘0’.
StaticBor – Enables caching of data in applications based on SAP ITS
Flow Logic. This performance setting improves the speed of module
calls considerably, but should not be turned on during development
of applications based on Flow Logic.

 SAP AG 2002, SAP Skills 2002 B1_Krause 67

6$3 ,76 /RJV DQG 7UDFH )LOHV


The most important logs and trace files:
„ access.log: In this file the SAP ITS records whenever an SAP ITS
session is started or ended (by timeout or the user logging off).
„ performance.log: This file (and loadstat.log) is used to store
basic information on SAP ITS performance as well as the host’s
performance. The SAP ITS can be tuned according to the
numbers detailing the unused sessions and workthreads.
„ AGate.trc: All information messages, warnings and errors
generated by the component AGate are written to this file.
„ WGate.trc: This file resides on the Web Server host and is
especially useful when communication problems prevent the
WGate from connecting to the AGate for some unknown reason.

 SAP AG 2002, SAP Skills 2002 B1_Krause 68

34
6$3 ,76 $GPLQLVWUDWLRQ 9LHZLQJ /RJ 7UDFH )LOHV
Click ‘WEBGUI View Logs Logs’
to take a look at the log files for the
‘WEBGUI’ instance. The traces can be
accessed via ‘Traces’.
Analyzing the log files will help you
tuning SAP ITS. If e.g. the number of
workthreads or sessions runs low for a
longer period of time you should
consider increasing the values of these
parameters.
This is an excerpt taken from a
sample performance.log:
2001/08/29 09:38:33.686: --- log opened ------------------------------------------
2001/08/29 09:39:33.692: H:
2001/08/29 09:39:33.692: H:=======================================================================
2001/08/29 09:39:33.692: H:ID Avai Max Avai Max Hits/ TAT Number Uptime
2001/08/29 09:39:33.692: H: Sess Sess Thrds Thrds Sec Hits (hh:mm:ss)
2001/08/29 09:39:33.692: H:========================================================================
...
2001/08/29 10:19:33.944: D: 0 61 64 4 4 0.000 0.005 0 00000:41:00
2001/08/29 10:20:33.950: D: 0 60 64 3 4 0.000 0.294 0 00000:42:00
2001/08/29 10:21:33.956: D: 0 60 64 4 4 0.000 0.004 0 00000:43:00
2001/08/29 10:22:33.963: D: 0 60 64 3 4 0.000 0.028 0 00000:44:00
2001/08/29 10:23:33.969: D: 0 60 64 4 4 0.000 0.000 0 00000:45:00

 SAP AG 2002, SAP Skills 2002 B1_Krause 69

6$3 ,76 $GPLQLVWUDWLRQ 6HWWLQJ 7UDFH )LOH 3DUDPHWHUV


Use ‘Configuration Traces’ to
alter the settings for SAP ITS trace
files (likewise for log files).

‘Tracelevel’ is the level of


detail used to create the
trace file for this SAP ITS
instance. After modifying
this setting you have to
restart the instance.

 SAP AG 2002, SAP Skills 2002 B1_Krause 70

35
6$3 ,76 $GPLQLVWUDWLRQ 3HUIRUPDQFH 0RQLWRULQJ
Select ‘Configuration Registry’ to
change the SAP ITS registry
settings. In this example we choose
‘CCMS’ in the frame on the right to
have the SAP ITS performance
monitoring parameters displayed.

To activate the advanced


performance monitoring
click ‘PerfMonitoring’ and
enter the value ‘1’. Again
you will have to restart the
SAP ITS after saving, but
of course you don’t have
to restart once for every
single change, one restart
after all changes have
been made is enough.

 SAP AG 2002, SAP Skills 2002 B1_Krause 71

&RQWUROOLQJ 6$3 ,76 ,$&25 DQG :HE 6HUYHU LQVWDQFHV


To stop an SAP ITS instance expand
the node ‘Control’ for this instance
and click ‘Stop’ for ‘ITS Manager’.

You can check the state of


the NT service in ‘Control
Panel Administrative
Tools Services’. Search
for the entry ‘ITS Manager –
<instance name>’.

Click ‘Start’ or mark ‘ITS Manager – <instance


name>’ and push the ‘play’ button in the
Services Manager to restart this instance.
 SAP AG 2002, SAP Skills 2002 B1_Krause 72

36
6$3 ,76 7XQLQJ 3HUIRUPDQFH 0RQLWRULQJ
If you suspect a performance bottleneck in your system (consisting of Web
Browser, SAP ITS and SAP System), but are not quite sure which component is
responsible for the bottleneck, you can get an impression where the processing
time is spent by selecting ‘Performance Thread Performance’ for the SAP ITS
instance in question.
In this example most of the
processing time (>90%) was
spent in the SAP System
while the SAP ITS was nearly
idle. From these numbers you
can also conclude that the
number of Workthreads on
this instance is suitable since
the fourth Workthread was
never used. If the overall load
on the SAP ITS increases you
should consider to configure
more Workthreads. In a
scenario like this you should
make sure that the SAP
System is sized correctly.
 SAP AG 2002, SAP Skills 2002 B1_Krause 73

([HUFLVH 
Start SAP ITS Administration with the URL ‘http://<your
computer>:2080/scripts/wgate/adminremote/!’.

Change the value of the ~timeout parameter in the global


service file of your ‘WEBGUI’ SAP ITS instance.

Change the number of sessions on your ‘WEBGUI’


instance.

Change the number of workthreads on your ‘WEBGUI’


instance.

Stop and start your SAP ITS instance ‘WEBGUI’.

Explore!

 SAP AG 2002, SAP Skills 2002 B1_Krause 74

37
$JHQGD

,QWURGXFWLRQ
1HWZRUN %DVLFV
:HE 6HUYHUV
6$3 ,76 ,QVWDOODWLRQ
6$3 ,76 $GPLQLVWUDWLRQ
&RQILJXUDWLRQ
0RUH ,QIRUPDWLRQ

 SAP AG 2002, SAP Skills 2002 B1_Krause 75

$GGLWLRQDO ,QIRUPDWLRQ
Classes
„ BC440 SAP ITS Developing Internet Applications
‹ Prerequisites: BC400, BC410
„ ITS070 Installation and Administration
„ ITS100 Developing EasyWebTransactions
„ ITS110 Developing Web Scenarios and MiniApps using Flow Logic
Literature
„ SAP@Web Installation Guide
„ SAP ITS Tuning & Troubleshooting Guide
„ SAP ITS Administration Guide
SERVICE.SAP.COM/SAP-ITS
„ SAP ITS FAQ and White papers

SERVICE.SAP.COM/SWCENTER
„ SAP ITS patch downloads

WWW.SAPMARKETS.COM/ITS
„ Software and Resource downloads

 SAP AG 2002, SAP Skills 2002 B1_Krause 76

38
&RS\ULJKW  6$3 $* $OO 5LJKWV 5HVHUYHG
„ © Copyright 2002 SAP AG. All rights reserved.
„ No part of this publication may be reproduced or transmitted in any form or for any purpose without the express
permission of SAP AG. The information contained herein may be changed without prior notice.
„ Some software products marketed by SAP AG and its distributors contain proprietary software components of other
software vendors.
„ Microsoft®, WINDOWS®, NT®, EXCEL®, Word®, PowerPoint® and SQL Server® are registered trademarks of
Microsoft Corporation.
„ IBM®, DB2®, DB2 Universal Database, OS/2®, Parallel Sysplex®, MVS/ESA, AIX®, S/390®, AS/400®, OS/390®,
OS/400®, iSeries, pSeries, xSeries, zSeries, z/OS, AFP, Intelligent Miner, WebSphere®, Netfinity®, Tivoli®, Informix
and Informix® Dynamic ServerTM are trademarks of IBM Corporation in USA and/or other countries.
„ ORACLE® is a registered trademark of ORACLE Corporation.
„ UNIX®, X/Open®, OSF/1®, and Motif® are registered trademarks of the Open Group.
„ Citrix®, the Citrix logo, ICA®, Program Neighborhood®, MetaFrame®, WinFrame®, VideoFrame®, MultiWin® and
other Citrix product names referenced herein are trademarks of Citrix Systems, Inc.
„ HTML, DHTML, XML, XHTML are trademarks or registered trademarks of W3C®, World Wide Web Consortium,
Massachusetts Institute of Technology.
„ JAVA® is a registered trademark of Sun Microsystems, Inc.
„ JAVASCRIPT® is a registered trademark of Sun Microsystems, Inc., used under license for technology invented and
implemented by Netscape.
„ SAP, SAP Logo, R/2, RIVA, R/3, SAP ArchiveLink, SAP Business Workflow, WebFlow, SAP EarlyWatch, BAPI,
SAPPHIRE, Management Cockpit, mySAP, mySAP.com, and other SAP products and services mentioned herein as
well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and in several other
countries all over the world. MarketSet and Enterprise Buyer are jointly owned trademarks of SAP Markets and
Commerce One. All other product and service names mentioned are the trademarks of their respective owners.

 SAP AG 2002, SAP Skills 2002 B1_Krause 77

39

You might also like