ITS 6.20 Installation - Part 2
Content
SAP ITS 6.20: Installation, Administration, Security, and Tuning Edgar Ch Edgar Chuan uang g & Klau Klaus s Lay Layer er SAP AG
Learning Objectives
As a result of this workshop you will be able to:
Understand the concepts of SAP ITS
Install an ITS 6.20 with w ith multiple virtual instances
Configure Confi gure and load loadbalan balance ce you yourr ITS landscap landscape e
Administer your ITS server
Tune your ITS instances
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 2
Agenda
11
Introduction
22
Web Servers & Platform Matrix
33
SAP ITS Installation
44
SAP ITS Administration & Configuration
55
Additional Information
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 3
SAP Sys System tem & T The he We Web b
Browser Intranet
Browser
Browser
Firewall
Browser
Internet
Web Server
ITS
PC Browser
PC
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 4
GUI
SAP System
SAP Internet Transaction Server Extends ds the reach reach of SAP System Systems s into the the Web Exten Maps SAP screens to HTML, WML or or similar web formats Usin Using g web transfer transfer protocol HTTP(S) HTTP(S)
Drives transactions within the SAP System or calls function modules, BAPIs, etc. in the backend system Applicati Application on Server sees a SAP SAP GUI for Windows Windows
Separation of Business Logic and Visual Appearance Downward compatibl Downward compatible e (tow (towards ards ITS and Web Application Application Server releases) ITS 6.20 can be used used to acce access ss SAP produ products cts based based on SAP SAP Web Web
Application Server Server releases 6.20 and below. ITS ITS 6.10 and 4.6D 4.6D C4 can be used to connect to SAP SAP products based on SAP Basis 4.6D and below.
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 5
How Ho w to of offe ferr a S Ser ervi vice ce on th the e We Web? b? SAP ITS SAP System
Web Brows Browser er
Web Server Server WGate
AGate
Service Files MIME Files SAP@Web •Service description •Images Studio or •HTML Templates ABAP •Stylesheets •Language Resource •Javascripts Workbench Files •Multimedia Outside SAP System •Flow Files HTML Visualization
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 6
Application •ABAP •Dy Dynpr npro oABAP Screen Scr eens s Workbench •Customization
Inside SAP System Business Logic
ITS Arch Architec itecture ture Deta Details ils Load Load Service Service File File
User User Request Request
Send Send Prepared Prepared Request Request
Call Call WGate WGate
Service Files
Input Input WGate Browser
SAP Internet Application Component
AGate Output Output
Web Server HTML Templates
HTML HTML Page Page
SAP System
Flow Files
BAPI
HTML HTML Page Page SAP SA P Da Data ta
Load Load HTML Templates HTML Templates // Flow Flow Files Files SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 7
Agenda
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 8
11
Introduction
22
Web Servers & Platform Matrix
33
SAP ITS Installation
44
SAP ITS Administration & Configuration
55
Additional Information
Web Server Web Server software Listens on a specific TCP port for requests Replies to HTTP requests from HTTP clients c lients Can only send data after receiving rec eiving a request
Sends request
Replies with data Web Server
Web Browser SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 9
Web Browsers Software used to access the Internet Requests data from a specific port of a specific 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 SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 10
Web Server
ITS 6.20 Server Platforms WGate
AGate
Microsoft Windows 2000 and 2003
Microsoft Windows 2000 Server
Server Microsoft Web Server (ISAPI) Apache HTTP Server (Apache Module) SUN One Web Server (NSAPI)
SUSE Linux Linux Enter Enterprise prise Se Server rver 8 RedHat Enterprise Linux 2.1 ES/AS
Solaris SUN One Web Server
Linux / Intel SUSE Linux Linux Enter Enterprise prise Se Server rver 8
Microsoft Windows 2003 Server
SAP@Web Studio Microsoft Windows 2000 Workstation
Apache HTTP Server (Apache Module)
RedHatt Ente Enterprise rprise Linu Linux x 2.1 ES/AS RedHa Apache
HTTP Server ( Apache Module)
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 11
Virtual Web Servers On a single computer, multiple Web Servers (so-called virtual Web Servers) can be installed without having to repeat the entire installation process. 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)
Responses are either generated dynamically or are taken from a predefined directory 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 fi le directory is C:\INETPUB\WWWROOT. If you don’t specify a file fi le to be accessed the Web Server may return a
default document.
Each virtual Web Server should have its own directory structure This is necessary to install multiple SAP ITS I TS instances with different
application contents on the same computer
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 12
Microsoft IIS Web Server Directory Structure C: \INETPUB
(default web area)
\WWWROOT
(default web root di directory) rectory)
Example: Root directories for virtual Web Servers C: \INETPUB \WWWWEBGUI
(Web area for SAP ITS
‘WEBGUI’) \WWWADM
(Web area for SAP ITS ‘ADM’ ‘ADM’))
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 13
Web Site creation Start the Internet Services Manager (Control Panel Administrative Adminis trative Tools). Right-click on the name of your computer in the left frame of the window and select ‘New Type ‘WEBGUI’, click ‘Next’.
Web Site’.
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 AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 14
Exercise 1 Create the directories and the corresponding virtual Web Servers for your SAP ITS installation Create 2 directories under C:\INETPUB for your virtual Web Servers named WWW-WEBGUI WWW-ADM
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 Administra Administrative tive Tools Internet Services Manager) Create the first virtual Web Server and call it ‘WEBGUI’ Use the directory C:\INETPUB\WWW-WEBGUI Set it up on port 1080
Create the second virtual Web Server and call it ‘ADM’ Use the directory C:\INETPUB\WWW-ADM Set it up on port 2080 SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 15
Agenda
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 16
11
Introduction
22
Web Servers & Platform Matrix
33
SAP ITS Installation
44
SAP ITS Administration & Configuration
55
Additional Information
SAP ITS Installation You can get the installation installation files from The Server Components CD (directory \\its\nt\i386). http://service.sap http://service.sap.com/patches .com/patches web site for the latest patches.
The setup program is based on SAPInst Installation tool which provides Easy user friendly dialogs A scripting interface for installations without user interaction The chance to continue continue a failed insta installation llation after resolv resolving ing the cause
of the problem Simplifie Simplified d update process for IITS TS servers (only on one e installation for all instances) Installation tool known from SAP S AP WebAS
SAP@Web Installation Guide Detailed step by step instructions and matrix of necessary
parameters Print and read these instructions before starting an installation
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 17
SAP ITS Installation Requirements Windows 2000 Server (not Professional) Running on an Intel or compatible processor Recommended minimum Service Pack 3
Windows 2003 Server Running on an Intel or compatible processor (32-bit)
Linux Server Running on an Intel or compatible processor (32-bit) SUSE Linux Enterprise Server 8 (SLES8) Red Hat Enterprise Linux 2.1 (AS/ES)
A minimum of 256 MB physical memory is recommended (productive installations may require a lot more than this). 1GB Hard Drive space will w ill suffice for several SAP ITS installations.
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 18
SAP ITS Installation Parameters Landscape - Type of insta Landscape installati llation on Single Host Dual Host (Recommended for Security and Scalability)
AGate AGa te insta installed lled on o one ne hos hostt
WGate installed on another host to together gether with the Web Server
SAP ITS installation type – Typical or Administration Administration
Typical installations can run SAP GUI for HTML and other applications Administrati Administration on installations exclusively run ITS Admi Administration nistration
(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 AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 19
Single Host Installation
ISAPI HTTP NSAPI
HTTPS
APACHE
Web Server
e t a G W
TCP/IP
e t a G A
ITS
Windows Windows 2000 2003 Server Server 32-bit SUSE Linux Enterprise Server 8 RedHat Enterp Enterprise rise Linux 2.1 SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 20
DIAG
RFC
SAP Application Server
Dual Host Installation
ISAPI HTTP
e t a G W
NSAPI HTTPS
APACHE
Web Server
TCP/IP
e t a G A
DIAG
RFC
SAP Application Server
ITS Wgate & Agate OS platforms: Windows 2000 Server Windows 2003 Server 32-bit SUSE Linux Enterprise Server 8 RedHat Enterprise Linux 2.1
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 21
Securit Sec urity y – Add Addition itional al Pro Protect tection ion Firewalls
ISAPI NSAPI
HTTPS
APACHE
Web Server
e t a G W
TCP/IP
e t a G A
DIAG
RFC
SAP Application Server
SNC, (SAPRout (SAPRouter er poss possible) ible) 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 AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 22
Virtual instances
ISAPI NSAPI APACHE
Virt. Web Server
e t a G W
TCP/IP
ITS 1
e t a G A
ISAPI NSAPI APACHE
Virt. Web Server
e t a G W
TCP/IP
ITS 2
e t a G A
With a certain number o off virtual Web Servers installed, you can create the same number of SAP ITS environments on a single host. Several ITS installations (also called ‘virtual instances’) can operate independently on the same server.
One physical server SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 23
SAP ITS Installation On the following pages you can find screenshots from an installation of a SAP ITS 6.20 (patch level 4) Different SAP ITS versions have different screens A Dual Host Installation requires more information (e.g. the name of
the server the AGate is installed on)
The required information is almost identical for all ITS versions. Therefore the installation concepts basically are the same for all releases. ITS 6.20 uses SAPInst, the new SAP Web Application Server installation tool. SAPInst consists of an installation en engine gine and a JAVA based GUI. It allows remote installation of servers without w ithout a graphical window system where the engine runs on the server and the GUI on a desktop deskto p workst workstation ation.. SAPIn SAPInst st suppo supports rts unat unattende tended d instal installatio lations. ns. Engine and GUI can run on different operating systems.
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 24
Preparing the SAP ITS Installation To begin the installation start the program \its\nt\SETUP.CMD. \its\nt\SETUP .CMD. You You will see a command shell and a graphical user interfaces. If your JAVA_HOME environment variable is not set, the command shell window will warn you. Just press any key. Normally installation will find the Java directory. Java is required by SAPIn SA PInst st GUI GUI.. To setup SAPInst SAPInst insta installati llation on tool please confirm all dialogs. The ITS installation will start automatically after SAPI SA PInst nst has be been en successfully installed SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 25
SAP ITS 6.20 Installation (1) Accept the legal conditions by choosing ‘Yes’ and click ‘Next’.
When installing ITS for the first time on a server you have to enter (or browse for) an installation directory. Accept the default and click ‘Next’.
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 26
SAP ITS 6.20 Installation (2)
If you already have installed one or more ITS instances on your server you will get this screen instead of the one on the previous slide. Here you can decide whether to install an additional ITS instance or to refresh the installation (e.g. to repair a corrupted installation or to apply a patch). SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 27
SAP ITS 6.20 Installation (3)
On the IACOR Ports definition page normally nothing has to be done. Please just confirm this page by clicking Next
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 28
SAP ITS 6.20 Installation (4)
Confirm the default setting and click ‘Next’.
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 29
SAP ITS 6.20 Installation (5)
Enter WEBGUI as the name of your ITS and the SAP system name provided during class. Click ‘Next’.
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 30
SAP ITS 6.20 Installation (6)
Select web server ‘Microsoft IIS 5.0 (WEBGUI)’ and click ‘Next’.
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 31
SAP ITS 6.20 Installation (7)
Select connection mode Applica Application tion Server, enter the connection data provided during class and click ‘Next’.
AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 32 SAP AG
SAP ITS 6.20 Installation (8)
Confirm Application Server Port definition dialog.
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 33
SAP ITS 6.20 Installation (9)
Select yes to start ITS instance and click ‘Next’. SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 34
SAP ITS 6.20 Installation (10)
Check installation overview page and click ‘Start’. SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 35
SAP ITS 6.20 Installation (11)
SAPInst now starts the installation process and finishes if nothing went wrong with the upper success dialog. Click ‘Ok’. SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 36
Remark: Upgrade of an older ITS installation
If SAP ITS 6.20 Installation detects a previous version of ITS, it will w ill offer a take over of the detected instance definitions. Please note that it will only deactivate the services of the old ITS. You have to remove them manually. SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 37
Remark: Instance/System Number During the Installation your are asked for an IACOR System Number and a instance number for each ITS instance. Hey, what’s that? The system/instance number is something like a namespace to avoid shared memory clashed between different applications (i.e. R/3, ITS, Gateway, IACOR). Changing this number is *ONLY* needed when ITS and SAP system or gateway run on the same server. In that case you have to check the system numbers of previous installed R/3 or gateway and adjust the proposed numbers during ITS installation. If you use the same system/instance number for ITS and R/3 system, the first one you start will w ill catch the number while the other will fail to start. ITS Installation will always always start with 40 for IACOR and then will count up for each instance.
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 38
Adding an addition ITS 6.20 instance To create an additional instance after a successful installation select:
1. Sta Start rt
Pro Progra grams ms
SA SAP P Inst Inst ITS 6.2 6.20 0 Prepare new Installation
Will clean up installation and write logs for later usage to backup directory
2. Sta Start rt
Pro Progra grams ms
SA SAP P Inst Inst ITS 6.2 6.20 0 SAP SAPInst Inst Serv Server er with GUI
Will start installation engine and GUI to add another ITS instance
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 39
Exercise 2 Install a ‘typical’ ‘SingleHost’ SAP ITS instance to your ‘WEBGUI’ Web Server instance Use SAP System data provided during class. Use the ‘Development Configuration’. Configuration’.
Install an administrative instance to your ‘ADM’ Web Server instance Notice the differences in the installation dialog.
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_start/!’ where <yourServer> is replaced by the IP address or DNS name of your computer. Use the logon data supplied in class. If webgui does not respond please check if your webserver instance is running.
AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 40 SAP AG
SAP ITS Scalability SAP ITS offers several Scalability and Load Balancing options: 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
Use more more than o one ne AGa AGate te proce process ss
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 41
Web Serv Server er / SA SAP P ITS S Scala calabilit bility y
SAP System
WGate
Web Browse Browser r
Web Server Server AGate
WGate
Web Brows Browser er
Web S Server erver
One AGate can be connected to several Web Servers/WGates
AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 42 SAP AG
SAP SA P IT ITS S - SA SAP P Sy Syst stem em S Sca cala labi bili lity ty
SAP System
Appl. Server
WGate
Web Browse Browser r
AGate
Web Serve Server r
Message Server
One SAP ITS can use several se veral Application Servers of one SAP Syst Sy stem em vi via: a: Loa Load d Ba Balan lancin cing g Separate selection of a specific Applicati Application on Server
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 43
SAP ITS Load Balancing
SAP System
AGate
WGate
Web Browse Browser r
AGate
Web Serve Server r
AGate
WGate passes prepared requests on to AGate AGate AGa te does tthe he act actual ual 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 AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 44
HTTP Routing / High Availability
AGate WGate Web Serve Server r AGate
Browser Web Browse r
HTTP Router
WGate Web S Serve erver r
AGate
This scenario offers offers additional fault tolerance for both A AGate Gate and WGate When HTTPS is used the load on the WGate server can be fairly high
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 45
Multiple Mult iple AGat AGate e proc processe esses s
SAP ITS AGate
WGate
… Web B Browse rowser r
Web Serve Server r
Mapping Manager
AGate processes
The load is di distributed stributed betwee between n the A AGate Gate processes It is always useful to have several Agate processes per instance due to
failover, locking and the 2GB memory limit per process SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 46
Wgate Configuration Tool (1) Configuration tool to completely administrate Wgate Add new URL section Setup connection to multiple agates No need to restart your web server (in most cases) Connectivity test to Agate and Mapping manager available SNC version displayed SNC environment displayed After activating no need to edit ItsRegistryWGate/Wgate.conf by
hand Changing of Wgate trace level without web server restart
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 47
Wgate configuration tool: Activation (2) Edit ItsRegistryWgate.xml with you favorite editor and change ConfigMonitorEnabled in global section to yes
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 48
Wgate Wgat e conf configur iguration ation tool tool:: (3)
Global Parameters URL UR L Se Sect ctio ion n
Logical Instances
Activation/Reload
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 49
Wgate Wgat e Confi Configura guration tion Too Tooll – Do’s an and d Dont’ Dont’s s Make sure you stay in the same webserver process (loadbalancing) Switch off (or overtake) reverse-proxies, loadbalancers Start web servers as single process e.g. Apache –X Switch off the tool after a fter configuring Wgate, otherwise your Wgate
will be open to anyone for configuring
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 50
Exercise 3 Enable the Wga Enable Wgate te Confi Config g tool tool.. Open th the e ItsReg ItsRegistry istryWgate. Wgate.xml xml with notepad. Search for the Global Section and change the value for ConfigMonitorStatus from ‘no’ to ‘y ‘yes’. es’. Restart th the e Web server instance. Start the the Wgate Confi Configurati guration on Tool usi using ng URL ‘http://<yourServer>:1080/scripts/wgate/wgate-config?’ and to create a second se cond AGate section for instance WEBGUI (use the connection information provided during class). Create a second AGate section sec tion for instance ADM (use the connection information provided during class). Start the SAP GUI for HTML and a nd try to find out which SAP ITS AGate server you are connected to.
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 51
IACOR Installation & Configuration IACOR (IAC Object Recei Receiver) ver) Windows/Linux based tool that was designed to allow publishing
IAC contents from a SAP System to a virtual SAP ITS instance Registers SAP ITS instances at a gateway of the S SAP AP System
(release 4.6C or higher) and waits for files to receive The publication process can be started from transactions SE80 (Web
Application Builder) 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 AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 52
IACOR Setup (1) Start ‘C:\Program Files\SAP\ITS\ Files\SAP\ITS\6.20\ 6.20\ Programs\IACORAdmin.exe’ on your host. In addition to the window on the right the below popup appears.
IACOR services is not automatically started by installation. Please click ‘Start’ to start the IACOR service.
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 53
IACOR Setup (2) Now you can press ‘New’ to create RFC destinations for your ITS instances.
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 AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 54
IACOR Setup (3) Mark the new destination and click ‘Start’ to activate it.
The red ‘o’ in the upper right corner turns green and the connection status is now ‘activated’. IACOR is ready to receive files. SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 55
Using IACOR (1) 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 ITS instance to receive the files.
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 56
Using IACOR (2) 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. W3_Publish_Serv ices. 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 the SAP System.
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 57
Exercise 4 Install IACOR as a Windows Service (start C:\Program Files\SAP Files\SAP\ITS\2.0\Ad \ITS\2.0\Admin\IACORA min\IACORAdmin.exe). dmin.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 SAP ITS instance via via ‘Workbench settings’, settings’, choose to publish the IAC ‘sysmsg’ and press ‘Publish’. Logoff from the SAP System. Start the IAC ‘sysmsg’ via the URL ‘http://<yourServer>:1080/scripts/wgate/sysmsg/!’
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 58
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 58
Agenda
11
Introduction
22
Web Servers & Platform Matrix
33
SAP ITS Installation
44
SAP ITS Administration & Configuration
55
Additional Information
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 59
SAP ITS Administration and Monitoring SAP ITS Administration is an HTML based Administration and Monitoring tool that can be remotely accessed via Web. Flexible configuration and administration tool designed for Changing SAP ITS settings Monitoring SAP ITS performance data Editing service files Viewing template files Viewing SAP ITS log files and trace files Tuning your ITS server
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 AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 60
SAP ITS Administration: Login URL request for login: http://<server>:<port>/scripts/wgate/ admin/! 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 AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 61
SAP ITS Administration: User Administration To change the password for the current user select ‘Administrati ‘ Administration’ on’ followed by ‘Change Password’.
If you want to create SAP ITS Administration Administrati on users w with ith limited privileges you can do so via ‘Administration User Management. An ‘Administrator ‘Administrator’’ can, e.g. change service file parameters, restart and stop instances, while ‘View Only’ users cannot change settings or restart SAP ITS. Modifying registrythe settings except for performance settings is restricted to the user ‘itsadmin’.
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 62
SAP ITS Administration: System View & Overview Under ‘System View’ you can find data on the resources of the host computer (active processes, allocated memory, free disk space).
On the ‘Overview’ screen the current load on all instances and the load balancing situation can be observed. SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 63
SAP ITS Administration: Managing Remote Instances The full set of SAP ITS Administration Administration features is available available for local SAP ITS instances only while for remote instances you can access the performance analysis commands. commands. However there is is a command (‘Go to Native AD ADM’) M’) that lets you switch to a remote Administration instance, so you can conveniently administer all SAP ITS servers.
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 64
SAP ITS Administration: Service Files ‘Configuration Global Services All Settings’ will give you a list of global configuration parameters for the instance you selected.
You can change the setting setting of any parameter by modifying its theclicking corresponding editvalue field in and ‘SAVE’. This kind of change is applied instantly . The configuration of other IACs (Internet Application Components) can be changed with ‘Configuration Services <name of the service>’. SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 65
SAP ITS Tuning Parameters (1) These tuning parameters can be set in service files: ~http_use_compression – Enables / Disables HTT HTTP P compression between SAP ITS and Web Browser. Activating this feature reduces the amount of data sent to the Web Browser thus reducing overall network traffic. ~timeout – This parameter speci specifies fies 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 either closing the Web Browser or being idle. Changes to these parameters take effect immediately, but already established sessions are not affected.
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 66
SAP ITS Administration: Performance Settings The most important settings regarding SAP ITS performance can be accessed by selecting ‘Configuration Performance’. It is often 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 have to restart the SAP ITS instance in order to apply them.
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 67
SAP ITS Tuning Parameters (2) MaxSessions – Maximu MaxSessions Maximum m numb number er of sessio sessions ns th the e SAP IITS TS in instance stance can support in parallel MinWorkTh MinWor kThrea reads ds – The n numb umber er of Wo Workt rkthre hreads ads cre created ated b by y the SA SAP P ITS instance at startup MaxWorkTh MaxWor kThrea reads ds – Max Maximu imum m numb number er of Wor Workth kthread reads s sup suppor ported ted by the instance (the ITS will start with MinWorkThreads and increase this number up to a maximum of MaxWorkThreads in case of high load – we strongly strongly recommen recommend d to se sett MinW MinWorkTh orkThreads reads = MaxWor MaxWorkThread kThreads). s). StaticTemplates StaticTempl ates – When th this is param parameter eter is set to ‘1’ (d (defaul efault) t) the SA SAP P 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’. Production Produ ctionMode Mode – Enabl Enables es cachin caching g of data iin n appl applicatio ications ns base based d 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 AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 68
SAP ITS Memory Configuration ITSSetup offers two standard configu configurations rations in respect to the maximum 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 Development Mode
64 Sessions
4 Workthreads
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 69
Workthread/Session Model
SAP System
Dispatcher In Port
Pool of Workthreads
AGate
Session Pool
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 70
Internal Scalability (AGate) Increasing Increa sing the numbe numberr of Workthrea Workthreads ds will resul resultt in Higher throughput of your SAP ITS instance A rise in memory consumption as well as processor utilization
Increasing the number of Sessions will result in The SAP ITS being capable of serving more users at the same
time (as long as the number number of Workth Workthreads reads is suffic sufficient) ient) A rise in memory consumption
If you increase the n number umber of Workthreads and/or Sessions y you ou 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. It is always useful to hav have e several Agate p processes rocesses per in instance stance due to failo failover, ver, lock locking ing and the 2GB memo memory ry limit per proc process ess
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 71
SAP ITS Logs and Trace Files 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. AGateX_*.trc: All information messages, warnings and errors
generated by the component AGate are written to these files. Wgate*.trc: These files resides on the Web Server Ser ver host and are
especially useful when communication problems prevent the WGate from connecting to the AGate for some unknown reason.
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 72
SAP ITS Administration: Viewing Log & Trace Files 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 f or 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 29 09 09:38: 33 33.686:
--- lo g opened --------- ---------- ---------- --------- ---------
2001/08/29 09:39:33.692:
H:
2001 20 01/0 /08/ 8/29 29 09 09:3 :39: 9:33 33.6 .692 92: :
H:== H: ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== === =
2001/08/29 09:39:33.692:
H:ID
Avai
Max
Avai
Max
Hits/
2001/08/29 09:39:33.692:
H:
Sess
Sess
Thrds
Thrds
Sec
2001 20 01/0 /08/ 8/29 29 09 09:3 :39: 9:33 33.6 .692 92: :
H:== H: ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ==
TAT
Number
Uptime
Hits
(hh:mm:ss)
... 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 AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 73
SAP ITS Administration: Setting Trace File Parameters 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. With ITS 6.20 it is no longer necessary to restart the instance after changing trace level.
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 74
SAP ITS Administration: Performance Monitoring 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 S AP ITS performance monitoring parameters displayed. To activate the advanced performance monitoring click ‘PerfMonitoring’ and enter the value ‘1’. Also active the MemoryTuning by setting ‘PerfMemTune’ to ‘1’. Again you will w ill 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 AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 75
Controlling SAP ITS 6.20, IACOR and Web Server instances To stop an SAP ITS 6.20 instance expand the node ‘Control’ for this instance and click ‘Stop’ for ‘ITS Manager’. You can check the state state of the service via ‘Control Panel Administrative Tools Services’. Search for entry ‘SAP ITS Manager – <instance name>’.
Click ‘Start’ or mark ‘SAP ITS Manager – <instance name>’ and push the ‘play’ button in the Services Manager to restart this instance.
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 76
SAP ITS 6.20 Tuning: Performance Monitoring 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 the processing time was equally shared between SAP System and SAP ITS. From these numbers you can also conclude that the number of Workthread Workt hreads s on this iinstan nstance ce is suitable since the fourth Workthread Workt hread was neve neverr used. IIff the overall load on the SAP ITS increases you should consider to configure more Workthreads. In a scenario like this it might also be a good idea to check the sizing of the SAP System. SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 77
SAP ITS 6.20 Tuning: Memory Tuning Tool If you want to optimize the memory requirements of your ITS installation you can use ‘Performance Memory Tuning’ for any given ITS instance. The memory tuning tool can can be used to find out how much memory your curren currentt configuration would consume under worst conditions (this value should always be below 2GB). You can experiment experiment with the para parameters meters without changing the ITS settings and in conjunction with the performance analysis you can possibly reduce the memory requirements.
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 78
Exercise 5 Start SAP ITS Administration with the URL ‘http://<your computer>:2080/scripts/wgate/admin/!’. 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 AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 79
Agenda
11
Introduction
22
Web Servers & Platform Matrix
33
SAP ITS Installation
44
SAP ITS Administration & Configuration
55
Additional Information
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 80
Further Information
Public Web: http://service.sap.com/sap-its
SAPNet: Use ALIAS: ‚sap-its‘
Literature SAP@Web SAP@ Web Inst Installat allation ion Guide SAP ITS Tuning & Troubleshooting Guide SAP ITS Administration Guide SAP ITS Service Parameters
Related Relat ed Lectur Lectures es at TechEd 2003 Future of ITS, PA104, WEN 8:00 am+THU 2:45pm, GB117 UI Clients Clients for SAP NetWeaver, UI101, WE WEN N 1:30pm+THU 8:00am, P1
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 81
SAP Technology: Web Applicati Application on Deve Developm lopment ent Curri Curriculu culum m SAPTEC
2 days
mySAP Techn Technology ology Solution Overview
BC400
5 days
NET200
3days
SAP Web Application ABAP Workbench: Foundation Found ation and Concepts
Server: Developing Develo ping Web Applications
NET100
Necessary
NET050
3 days
HTML, CSS Knowledge, Internet Terminology
Web Application Development: Foundations
3 days
SAP ITS: Developing Devel oping Screen based Intern Internet et Application Comp.
ITS150
2days
SAP ITS: Corporate Identity Design
ITS070
3 days
SAP ITS: Administration
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 82
Questions?
Q
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 83
Feedback
Please complete your session evaluation and drop it in the box on your way out. Be courteou courteous s — depo deposit sit your your trash, trash, and do not take the handouts for the following session.
The SAP TechEd ’03 Las Vegas Team
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 84
Copyright 2003 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 d distributors istributors 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 Server TM are trademarks of IBM Corporation in USA and/or other c countries. ountries.
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 Massachus etts Institute of Technology.
JAVA® is a registered trademark of Sun Microsystems, Inc.
JAVASCRIPT ® is a registered trademark of Sun Microsystems, Microsystems, Inc., used under license for technology invented invented and implemented by Netscape.
MarketSet and Enterprise B Buyer uyer are jointly owned tradem trademarks arks of SAP AG and Commerce One.
SAP, R/3, mySAP, mySAP.com, mySAP.com, xApps, xApp and other SAP products and servic services es 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. All other product and service names mentioned are the trademarks of their respective companies.
SAP AG AG 2003, PA351, Edgar Chuang & Dr. Klaus Layer, Page 85
Copyright 2003 SAP AG. Alle Rechte vorbehalten
Weitergabe und Vervielfältigung dieser Publikation oder von Teilen daraus sind, zu welchem Zweck und in welcher Form auch immer, ohne die aus-drückliche aus-drückliche schriftliche Genehmigu Genehmigung ng durch SAP AG nicht gestattet. In dieser Publikation enthaltene Informationen Informationen können ohne vorherige Ankün-digung Ankün-digung geändert werden.
Die von SAP AG oder deren Vertriebsfirmen angebotenen Softwareprodukte können Softwarekomponenten auch anderer Softwarehersteller enthalten.
Microsoft®, WINDOWS®, NT®, EXCEL®, Word®, PowerPoint® und SQL Server ® sind eingetragene Marken der 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 und Informix® Dynamic Server TM sind Marken der IBM Corporation in den USA und/oder anderen Ländern.
ORACLE® ist eine eingetragene Marke der ORACLE Corporation.
UNIX®, X/Open®, OSF/1® und Motif ® sind eingetragene Marken der Open Group.
Citrix®, das Citrix-Logo, ICA®, Program Neighborhood®, MetaFrame®, WinFrame®, VideoFrame®, MultiWin® und andere hier erwähnte Namen von Citrix-Produkte Citrix-Produkten n sind Marken von Citrix Systems, Inc.
HTML, DHTML, XML, XHTML XHTML sind Marken oder eingetragene Marken Marken des W3C®, World Wide Web Consortium, Massachusetts Massachus etts Institute of Technology.
JAVA® ist eine eingetragene Marke der Sun Microsystems Microsystems,, Inc.
JAVASCRIPT® ist eine eingetragene Marke der Sun Microsystems, Inc., verwendet unter der Lizenz der von Netscape entwickelten und implementier implementierten ten Technologie.
MarketSet und Enterprise Buy Buyer er sind gemeinsam gemeinsame e Marken von S SAP AP AG und Comm Commerce erce One.
SAP, R/3, mySAP, mySAP.com, xApps, xApp und weitere im Text erwähnte SAP-Produkte und –Dienstleistungen sowie die entsprechenden Logos sind Marken oder eingetragene Marken der SAP AG in Deutschland und anderen Ländern weltweit. Alle anderen Namen von Produkten und Dienstleistungen sind Marken der jeweiligen Firmen.
