Professional Documents
Culture Documents
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
1
6$3 6\VWHPV DQG WKH :HE 7KH 7DVN
Web Browser
Intranet
Web Browser
Web Browser
Firewall
Web Browser
PC
PC GUI
Web Browser
Web Browser
Intranet
Web Browser
Web Browser
Firewall
PC
PC GUI
Web Browser
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.
SAP System
Web Browser
Web Server
WGate AGate
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
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
4
1HWZRUNV
$ JRRG XQGHUVWDQGLQJ RI QHWZRUNV DQG QHWZRUN
FRPPXQLFDWLRQ LV HVVHQWLDO IRU LQVWDOOLQJ 6$3 ,76
Internet
5
,3 $GGUHVVHV
A four-byte address that uniquely identifies each computer in the
Internet worldwide
IP address
IP address 142.16.172.83
161.78.135.91
7&3 3RUWV
IP address z Mail Server
142.16.1.9
z News Server
z Web Server
Internet 6RIWZDUH
Logical
+DUGZDUH TCP port
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
$JHQGD
,QWURGXFWLRQ
1HWZRUN %DVLFV
:HE 6HUYHUV
6$3 ,76 ,QVWDOODWLRQ
6$3 ,76 $GPLQLVWUDWLRQ
&RQILJXUDWLRQ
0RUH ,QIRUPDWLRQ
7
:HE 6HUYHUV
A Web Server software responds
to requests from Web Browsers
: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
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
: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)
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.
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
C:
\INETPUB
\WWWWEBGUI (Web area for SAP ITS ‘WEBGUI’)
\WWWADM (Web area for SAP ITS ‘ADM’)
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’.
([HUFLVH
&UHDWH WKH GLUHFWRULHV DQG WKH FRUUHVSRQGLQJ
YLUWXDO :HE 6HUYHUV IRU \RXU 6$3 ,76 LQVWDOODWLRQV
11
$JHQGD
,QWURGXFWLRQ
1HWZRUN %DVLFV
:HE 6HUYHUV
6$3 ,76 ,QVWDOODWLRQ
6$3 ,76 $GPLQLVWUDWLRQ
&RQILJXUDWLRQ
0RUH ,QIRUPDWLRQ
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
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
13
6LQJOH +RVW ,QVWDOODWLRQ
ISAPI
HTTP
DIAG
WGate
AGate
NSAPI
HTTPS TCP/IP
APACHE RFC
SAP
Web
Server
CGI
,76 Application
Server
ISAPI
HTTP
DIAG
WGate
AGate
NSAPI
HTTPS TCP/IP
APACHE RFC
SAP
Web
Server
CGI
,76 Application
Server
14
6HFXULW\ ² $GGLWLRQDO 3URWHFWLRQ
Firewalls
ISAPI
DIAG
WGate
AGate
NSAPI
HTTPS TCP/IP
APACHE RFC
SAP
Web CGI Application
Server Server
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.
AGate
NSAPI
same server.
,76
TCP/IP
APACHE
Virt. Web
Server CGI
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.
Select ‘Single-Host’
and click ‘Next’.
Click ‘Next’.
16
6$3 ,76 ,QVWDOODWLRQ
Select ‘Typical’
and click ‘Next’.
Type ‘WEBGUI’
and click ‘Next’.
17
6$3 ,76 ,QVWDOODWLRQ
Select ‘Minimize Memory Usage’
and click ‘Next’.
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
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.
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
WGate
WGate
Web Server
Web Browser
20
6$3 ,76 6FDODELOLW\
SAP System
WGate AGate
Web Server
Web Browser
WGate AGate
Web Server
Web Browser
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
21
6$3 ,76 /RDG %DODQFLQJ
SAP System
AGate
AGate
WGate
AGate
AGate
WGate
Web Server
AGate
Web Server
AGate
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.
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.
23
([HUFLVH
Start the SAP GUI for HTML and try to find out which SAP ITS
AGate server you are connected to.
:*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
,$&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.
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.
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’.
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.
([HUFLVH RSWLRQDO
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’.
27
$JHQGD
,QWURGXFWLRQ
1HWZRUN %DVLFV
:HE 6HUYHUV
6$3 ,76 ,QVWDOODWLRQ
6$3 ,76 $GPLQLVWUDWLRQ
&RQILJXUDWLRQ
0RUH ,QIRUPDWLRQ
28
:RUNWKUHDG6HVVLRQ 0RGHO
SAP System
Dispatcher
In Port
Pool of
Workthreads Session Pool
AGate
For hosts equipped with more than 2GB of physical memory and a
fast CPU, installing more than one AGate process is an option.
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.
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.
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.
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.
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.
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.
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
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.
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/!’.
Explore!
37
$JHQGD
,QWURGXFWLRQ
1HWZRUN %DVLFV
:HE 6HUYHUV
6$3 ,76 ,QVWDOODWLRQ
6$3 ,76 $GPLQLVWUDWLRQ
&RQILJXUDWLRQ
0RUH ,QIRUPDWLRQ
$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
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.
39