Professional Documents
Culture Documents
Learning Objectives
Agenda
1 1
Introduction Web Servers & Platform Matrix SAP ITS Installation SAP ITS Administration & Configuration Additional Information
2 2 3 3 4 4
5 5
Browser
PC
Browser
PC
GUI
Drives transactions within the SAP System or calls function modules, BAPIs, etc. in the backend system
Application Server sees a SAP GUI for Windows
Separation of Business Logic and Visual Appearance Downward compatible (towards ITS and Web Application Server releases)
ITS 6.20 can be used to access SAP products based on SAP Web Application Server releases 6.20 and below. ITS 6.10 and 4.6D C4 can be used to connect to SAP products based on SAP Basis 4.6D and below.
Web Browser
Service Files MIME Files SAP@Web Service description Images Studio or ABAP HTML Templates Stylesheets Language Resource Javascripts Workbench Files Multimedia Outside SAP System Flow Files HTML Visualization
SAP AG 2003, PA351, Arno Esser, Page 6
Service Files
SAP System
SAP Internet Application Component
BAPI
Load Load HTML Templates // Flow Files HTML Templates Flow Files
SAP AG 2003, PA351, Arno Esser, Page 7
Agenda
1 1
Introduction Web Servers & Platform Matrix SAP ITS Installation SAP ITS Administration & Configuration Additional Information
2 2 3 3 4 4
5 5
Sends request
Web Server
Sends data
Receives data
Web Browser
SAP AG 2003, PA351, Arno Esser, Page 10
Web Server
AGate
Microsoft Windows 2000 Server Microsoft Windows 2003 Server SUSE Linux Enterprise Server 8 RedHat Enterprise Linux 2.1 ES/AS
Solaris
SUN One Web Server
SAP@Web Studio
Microsoft Windows 2000 Workstation
Linux / Intel
SUSE Linux Enterprise Server 8
Apache HTTP Server (Apache Module)
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 Apache file directory is /srv/www/htdocs. If you dont specify a file 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 instances with different application contents on the same computer
Agenda
1 1
Introduction Web Servers & Platform Matrix SAP ITS Installation SAP ITS Administration & Configuration Additional Information
2 2 3 3 4 4
5 5
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 suffice for several SAP ITS installations.
(virtual) Web Server to connect the SAP ITS to Application packages (IAC packages) to be installed SAP System Connection information and Logon Data (optionally)
ISAPI
WGate
HTTPS
NSAPI APACHE
TCP/IP
AGate
HTTP
DIAG RFC
Web Server
ITS
Windows 2000 Server Windows 2003 Server 32-bit SUSE Linux Enterprise Server 8 RedHat Enterprise Linux 2.1
SAP AG 2003, PA351, Arno Esser, Page 18
ISAPI
WGate
TCP/IP
AGate
HTTP
DIAG RFC
Web Server
ITS
Wgate & Agate OS platforms: Windows 2000 Server Windows 2003 Server 32-bit SUSE Linux Enterprise Server 8 RedHat Enterprise Linux 2.1
ISAPI
WGate
HTTPS
NSAPI APACHE
TCP/IP
AGate
DIAG RFC
Web 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 2003, PA351, Arno Esser, Page 20
Virtual instances
ISAPI
WGate
NSAPI APACHE
AGate
TCP/IP
ITS 1
With a certain number of 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.
ISAPI
WGate
NSAPI APACHE
TCP/IP
ITS 2
AGate
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 engine and a JAVA based GUI. It allows remote installation of servers without a graphical window system where the engine runs on the server and the GUI on a desktop workstation. SAPInst supports unattended installations. Engine and GUI can run on different operating systems.
To setup SAPInst installation tool please confirm all dialogs. The ITS installation will start automatically after SAPInst has been successfully installed
The installation of ITS on LINUX needs to know the installation directory. Accept the default here and click Next. Please accept following license agreement.
Tooltips
Context sensitive help for input fields
Port definition
Avoid confusion with network based mgmt, e.g. YP, NIS Doesnt override definitions No influence on sapms*, sapiacor* Define ports
sapdp[00-99] to 3200 - 3299 sapgw[00-99] to 3300 - 3399
Streamline
Set default in global.srvc Not supported on linux clients yet Templates and mimes are always installed
Additional dialogs
Ease up installation for seldom used options
Portbased:
Listen 1080 Listen 8080 <VirtualHost _default_:1080> DocumentRoot /srv/www/its/1080 </VirtualHost> <VirtualHost _default_:8080> DocumentRoot /srv/www/its/8080 </VirtualHost>
SAP AG 2003, PA351, Arno Esser, Page 30
Hostbased:
Listen 80 NameVirtualHost www.xxx.yyy.zzz <VirtualHost hostname1:80> DocumentRoot /srv/www/hostname1 </VirtualHost> <VirtualHost hostname2:80> DocumentRoot /srv/www/hostname2 </VirtualHost>
Select 'YES' to start ITS instance after installation and click 'Next'.
SAPInst now starts the installation process and finishes if nothing went wrong with the upper success dialog. Click Ok.
SAP AG 2003, PA351, Arno Esser, Page 34
Wgate:
export LD_LIBRARY_PATH=<ITS installation directory>/programs Start apache
Test
Set registry key StatusMonitorEnabled in ItsRegistryWGATE.xml and request wgate status with http://<host>:<port>/scripts/wgate/wgate-status? Test wgate-agate communication with http://<host>:<port>/scripts/wgate/itsping/!
Unattended installation
Features
Script-based Fully automatic installation without user interaction, e.g. ports are determined automatically Provides the same functionality as manual gui-based installation, i.e. single/dual host, admin/non-admin, additional packages etc. No GUI capabilities are required, no JAVA Any number of instances with individual installation types can be performed through one call
Repeating an installation
Repeating a previously successfully executed installation unattended Part of a backup scenario Not customizable See note 526835
ITS 620:
Procedure
Steps:
Create example .ini file with:
sapinst SAPINST_SMART_COMPONENT=ITS_BATCH_PROCESSING SAPINST_SMART_CONFIGFILE=ITS_PARAMETER.ini
The normal installation starts. Abort it on first welcome screen. An exemplary file with comments has been created. Edit ITS_PARAMETER.ini to meet your requirements Restart unattended installation with:
sapinst SAPINST_SMART_COMPONENT=ITS_BATCH_PROCESSING SAPINST_SMART_CONFIGFILE=ITS_PARAMETER.ini SAPINST_SKIP_DIALOGS=true
Example
[ITS_MAIN] ACTIONS= INSTALL INSTANCE_IT1 [INSTALL] PROGRAM_DIRECTORY=/usr/sap/its/6.20 [INSTANCE_IT1] ADMIN_INSTANCE=false TYPE=* NAME=IT1 DEVELOPER_MODE=true SYSTEM_NUMBER=41 WEBGUI=true FLOW_DEBUG=false APPLY_ADDITIONAL_PACKAGES=false WATCHDOG=false SAP_SYSTEM_NAME=BCE USE_ANOYMOUSLOGIN=false MESSAGE_SERVER=bcemain.wdf.sap.corp START_AFTER_INSTALLATION=true RUN_MULTIPLE_AGATE_PROCESSES=false WEBSERVER_INSTANCE=Apache (virtual host: _default_:1080) APACHE_CONFIG_DIRECTORY=/etc/httpd APACHE_EXECUTABLE=/usr/sbin/httpd
Exercise 1
Install a typical SingleHost SAP ITS instance to port 1080:
Use SAP System data provided during class. Use the Development Configuration. Check with url 'http://basel03:1080/scripts/wgate/webgui_start/!
Note: Before you can check the ITS connection, apache has to be restartet and LD_LIBRARY_PATH has to be set once:
export LD_LIBRARY_PATH=/usr/sap/its/6.20/programs Restart apache with the command: "rcapache restart"
Web Browser
Appl. Server
AGate
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
AGate
AGate
Web Browser
AGate
WGate passes prepared requests on to AGate AGate does the actual work Session management HTML page generation CPU utilization of AGate is much higher than WGates This scenario offers additional fault tolerance for AGate
SAP AG 2003, PA351, Arno Esser, Page 45
Web Browser
HTTP Router
This scenario offers additional fault tolerance for both AGate and WGate When HTTPS is used the load on the WGate server can be fairly high
Mapping Manager
AGate processes
The load is distributed between the AGate 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 2003, PA351, Arno Esser, Page 47
Logical Instances
Activation/ Reload
Exercise 2
Enable the Wgate Config tool. Open the ItsRegistryWgate.xml with the editor of your choice. Search for the Global Section and change the value for ConfigMonitorStatus from no to yes. Restart the Web server instance. Start the Wgate Configuration Tool using URL: http://localhost:1080/scripts/wgate/wgate-config? Create a second AGate section for instance WEBGUI that points to the DEMO instance (result of the unattended installation). Start the SAP GUI for HTML and try to find out which SAP ITS AGate server you are connected to.
IACOR Setup
IACOR demon:
Is installed as a services automatically during initial setup Can be started via
W32: ServiceManager LINUX: "Installation directory"/bin/itsIACOR.sh start|stop
Using IACOR
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.
Using IACOR
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.
Agenda
1 1
Introduction Web Servers & Platform Matrix SAP ITS Installation SAP ITS Administration & Configuration Additional Information
2 2 3 3 4 4
5 5
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 ITS instance.
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.
On the Load Balancing screen the current load balancing situation of all instances can be observed.
SAP AG 2003, PA351, Arno Esser, Page 62
You can change the setting of any parameter by modifying its value in the corresponding edit field and clicking 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 2003, PA351, Arno Esser, Page 64
Workthread/Session Model
SAP System
Dispatcher In Port
Pool of Workthreads
Session Pool
AGate
SAP AG 2003, PA351, Arno Esser, Page 69
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 hosts 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 host and are especially useful when communication problems prevent the WGate from connecting to the AGate for some unknown reason.
With ITS 6.20 it is no longer necessary to restart the instance after changing trace level.
Exercise 3
Start SAP ITS Administration with the URL http://<your computer>:8080/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. Explore!
Agenda
1 1
Introduction Web Servers & Platform Matrix SAP ITS Installation SAP ITS Administration & Configuration Additional Information
2 2 3 3 4 4
5 5
Further Information
Public Web:
http://service.sap.com/sap-its
SAPNet:
Use ALIAS: sap-its
Literature
SAP@Web Installation Guide SAP ITS Tuning & Troubleshooting Guide SAP ITS Administration Guide SAP ITS Service Parameters
NET100
3 days
Necessary
HTML, CSS Knowledge, Internet Terminology
NET050
3 days
ITS150
2days
ITS070
3 days
Questions?
Q&A
Feedback
Please complete your session evaluation and drop it in the box on your way out. Be courteous deposit your trash, and do not take the handouts for the following session.