Sap 3
Sap 3
Sap 3
Contents
Applicability, Goals, and Requirements ....................................................................................................2 Preliminary Information.............................................................................................................................3 SCM System Landscape....................................................................................................................4 SCM APO Monitoring and Administration.................................................................................................5 General mySAP APO Monitoring Information ....................................................................................6 Monitoring and Administration of liveCache .......................................................................................6 liveCache Monitoring and Administration Tools ...........................................................................7 liveCache Log Files ......................................................................................................................8 LiveCache Parameters...............................................................................................................10 Parameter OMS_HEAP_LIMIT ..................................................................................................11 Monitoring Heap Memory Usage ...............................................................................................11 Garbage Collectors and Data Cache Filling Levels .........................................................................12 Monitoring liveCache Memory Areas and Devspaces......................................................................12 Network Monitoring Between liveCache and Application Server .....................................................14 Monitoring and Testing COM and liveCache Transactions ..............................................................15 Monitoring APO Optimizers ..............................................................................................................18 Monitoring Guidelines for SAP APO and R/3 ...................................................................................19 Enhanced Workload Analysis Tool - ST03N.....................................................................................21 Job Scheduling - Standard SCM System Jobs ..........................................................................22 mySAP APO Software Maintenance Guidelines ..............................................................................25 Architecture and Support Packages...........................................................................................25 Plug-Ins and Connected R/3 Systems .......................................................................................27 Transfer Mechanisms - qRFC Versions .....................................................................................27 Important Gateway and qRFC Parameters................................................................................28 Downloading Support Packages from SAP ...............................................................................28 Further Information .................................................................................................................................29
These procedures ensure the smooth and reliable flow of the core business process in order to meet your business requirements.
Alternative Practices
You can get SAP experts to deliver this Best Practice onsite if you order the Solution Management Optimization (SMO) service known as the SAP Business Process Management service.
Business department Solution support organization (for example, the IT department and the Help Desk) Implementation project team
Execution Teams The execution teams are the following groups, which taken together form the customers Solution Support Organization:
q q q q q q
The business process champion for each business process Application support Development support Program scheduling management Software monitoring team System monitoring team
More information about roles and responsibilities of these teams can be found in the superordinate Best Practice General Business Process Management, which you can obtain through the SAP Solution Manager. Necessary or Useful Training Courses: See the SAP Service Marketplace (http://service.sap.com/education) for the most up-to-date information on SCM-specific training courses. 2002 SAP AG
Prerequisites
Experience with SAP Basis 4.x monitoring tools and functionality, including the relevant SAP and database training courses.
Preliminary Information
The SAP Advanced Planner and Optimizer (APO) is the planning component of mySAP SCM, the Supply Chain Management solution provided by SAP. SAP APO is used to make strategic, tactical, and operational decisions and supports you in performing the following planning activities: Demand Planning (DP) Supply Network Planning (SNP) Production Planning (PP) Detailed Scheduling (DS) Deployment Transport Planning and Vehicle Scheduling (TP/VS) / Transport Load Builder (TLB) Global Available-to-Promise (gATP)
SAP APO is a planning tool. Execution functions, such as confirmations, goods receipt, purchasing, and so on are performed in the SAP R/3 OLTP system, which contains all functionality for Material Management MM, Sales and Distribution SD, Production Order Processing PP-SFC, Logistics Execution LES, and Controlling CO. The SAP R/3 online transaction processing (OLTP) system also provides relevant planning data (master data and transaction data) for the APO system. Products are planned in the APO system, and the planning results are transferred back to the OLTP system. If not all components of a BOM structure are planned in the APO system, the planning can be completed in the OLTP system. In general, we recommend that you plan critical products and critical components in APO and noncritical products and components in the OLTP system. However, if you plan a component in APO, you must also plan all components in the BOM structure up to the BOM header product in APO. Conversely, if you plan a component in the OLTP system, you also must plan all subcomponents in the OLTP system. The various strategies for using R/3 and APO in combination are called integration scenarios. They utilize the Core Interface (CIF), which is part of the mySAP Plug-In.
2002 SAP AG
OLAP System
OLTP System
OLAP System
live Cache
RDBMS RDBMS
OLTP System
2002 SAP AG
The following diagram shows the relationship between APO application software components and the databases:
APO Application Server Dialog WP Dialog WP Dialog WP
Background WP Background WP
Optimizer Application Server RFC: SNP PP/DS SAP Gateway CTM SEQ ND VSR
SAP Gateway
DATA request: ABAP Open SQL DATA request: Calling COM Routine
connect_to_livecache. exec sql. execute procedure "SAPAPO_COM_XX"( in :in_com_params, out :out_com_params) endexec.
DATA request: Direct to liveCache via Database Interface (certain optimizers only)
APO DB
COM Routines
liveCache
2002 SAP AG
2002 SAP AG
Technical Prerequisites
Remote Function Call OS collector is required for monitoring the operating system of physically separate liveCache servers using transaction OS07 (similar to the functionality offered by transaction ST06) For information about how to install RFCOSCOL, see SAP Notes 0450741, 20624, 202934,
The DBMGUI and DBMCLI each consist of a server and a client part. The server part (DBM server) is responsible for functionality. The client part is called the Database Manager. For DBMGUI it consists of a graphical user interface, for DBMCLI a command line interface. After installing DBMGUI software on the frontend, you can start DBMGUI. You can administer several liveCaches with one DBMGUI session. Make sure that you select the correct liveCache server when you issue a command. Before you can adminster a liveCache, you need to register it. To do so, proceed as follows: 1. Start DBMGUI and choose File >> Register database. 2. Enter the name of the liveCache server you wish to register and press return. A list appears of all the liveCaches available on that server. 3. Select the liveCache instance you wish to register and choose Register. 4. If you wish, you can enter another name for this liveCache, or use the default <LCSID>. 5. Enter the name of the DBM user and its password (control, control). 6. Press Return or OK to finish the registration process. To download the latest DBMGUI (only available for Windows operating systems), go to www.sapdb.org, and choose Tools. The following page has links to information and a download for Database Manager. Alternatively, to download from SAPNet, see SAP Note 386714. CCMS monitoring (transaction RZ20) is enhanced in APO 3.1 and for APO 3.0A with Basis SP30 to provide enhanced monitoring functionality for liveCache and can be called directly from transaction LC10 (see screenshot cutout). For more information on transaction RZ20 and CCMS monitoring toolsets, visit SAP Service Marketplace, alias /monitoring (http://service.sap.com/monitoring)
2002 SAP AG
2002 SAP AG
Look at recent liveCache System messages to ensure that monitorin no errors were g encountered Can also be used to check status of liveCache, warnings,
Especially useful when liveCache errors are encountered (also includes information on starting and stopping of liveCache) Check and investigate any alerts shown. Also possible to use these monitors to analyze the up to 24 hours history of datacache, heap and Devspace usage As directed by SAP Support
System Monitorin g
Check liveCache Alerts (CCMS alerts) New LC10 Only Activate Kernel trace
System Monitorin g
2002 SAP AG
10
LiveCache Parameters
General information
For up-to-date information on important liveCache parameters, see SAP Notes 433115 and 424886 for liveCache 7.2 or SAP Notes 490958 and 496318 for liveCache 7.4. These notes are updated frequently. Different releases of liveCache and COM routines may require different parameter settings. Changes in the hardware configuration of your liveCache machine such as additional RAM or CPUs, or changes in application data volumes or configuration, may also require different parameter settings. Check the above notes regularly for updated parameter settings. If you experience performance issues, check your liveCache settings against the latest recommendations of these SAP Notes. Several important parameters for liveCache are: MAXCPU number of CPUs that can be used by liveCache. For information about potential performance issues with MAXCPU > 1, see SAP Note 425051. DATA_CACHE (7.2) or CACHE_SIZE (7.4) size of the data cache memory area used by liveCache. The initial value for this parameter is usually defined during the sizing of your system, but it may require some tuning for normal operation, or in other situations such as increasing the amount of RAM or data volume on your liveCache server. OMS_HEAP_LIMIT maximum useable heap memory of liveCache and COM routines (private memory) Note: Changes to liveCache parameters do not take effect until the liveCache has been stopped and restarted, so schedule downtime for liveCache if you wish to adjust any parameters. liveCache Memory Areas This section describes the main liveCache memory areas. These areas are: LC Management, Heap Memory, and Net Memory Usage.
liveCache
LC Management
LC Management is needed for administrative purposes, such as starting, stopping, and backup of liveCache Heap Memory refers to the memory allocation of the COM objects in liveCache (private liveCache memory regions) Kernel parameter OMS_HEAP_LIMIT
Total Memory
Parameter
OMS_HEAP_LIMIT
Heap Memory
Parameter
DATA_CACHE (7.2) CACHE_SIZE (7.4)
Net Memory Usage of objects is where the actual data is stored in liveCache Kernel parameter DATA_CACHE (liveCache 7.2) CACHE_SIZE (liveCache 7.4)
2002 SAP AG
11
Parameter OMS_HEAP_LIMIT
SAP Note 337445 describes how to perform the calculation and to adjust the parameter for the OMS_HEAPLIMIT, for liveCache 7.2 it is as follows:
Max_Virtual_Memory - (DATA_CACHE+CONVERTER_CACHE+SHOW_STORAGE+TASK_STACK+100 MB) For liveCache 7.4 replace DATA_CACHE with CACHE_SIZE NOTE: with Windows NT/2000 the maximum virtual memory available for liveCache is 3GB
Heap Memory
Cache_Size or Data_Cache
Conv Cache
Show Storage
OMS_HEAPLIMIT
RESERVED (R)
Memory that is Reserved specifically to stop requested memory through functions COM normally routines
Previously allocated by COM routines/OMS layer. Is available to COM routines only, but not to operating system
Parameter OMS_HEAP_LIMIT
2002 SAP AG
12
Transactions: LiveCache 7.2 = LC10 Performance Data Cache LiveCache 7.4 = LC10 liveCache: monitoring memory areas Data Cache
2002 SAP AG
13
Respon- Escalation sibility Procedure System Monitorin g
Data cache LC10 > liveCache hit rate Performance > Devspace Statistic <OR> LC10 > liveCache monitoring > Current Status > Memory Areas > Data Cache Active liveCache parameters <OMS_HE AP_LIMIT>
At least daily
This value should be >=98.8% If it is not, your liveCache may be too small or incorrectly configured After restarting liveCache you need at least 50 000 liveCache data requests before a meaningful value is shown
System Monitorin g
LC10 > liveCache As Performance > required Active parameters <OR> LC10 > liveCache monitoring > Current Status > Parameters > Currently
Adjust as necessary
Show currently active parameters Parameter OMS_HEAP_LIMIT For parameter settings and calculation, see SAP Notes 0337445 and either 0424886 (7.2) or 0496318 (7.4)
Basis support
SE38 > Often /SAPAPO/OM_LC (especial _MEM_MONITOR ly when data <OR> volumes LC10 > liveCache: or system Monitoring > changes Current Status > occur) Memory Areas > Heap Usage
Sufficient memory must be available for heap areas, data cache, and the operating system of the liveCache server and correctly distributed between them
The list header shows the value System for the reserved memory Monitorin marked with 'R' or Reserved g This value shows the (private) memory dynamically requested by liveCache, usually for use by COM routines. It is not returned to the OS until liveCache is stopped. So this value specifies the amount of RAM that is locked into the liveCache/COM process it is reuseable only by liveCache, but it is not necessarily currently in use by liveCache; it is the high water mark of heap usage
2002 SAP AG
14
Respon- Escalation sibility Procedure System Monitorin g Team
Add devspace
Basis Support
SAP recommends using transaction LC10 for liveCache monitoring. Some of the information listed above can also be seen using the tools DBMGUI or DBMCLI, but these tools are not described here. Note that you may occasionally see different values using DBMGUI or DBMCLI than from within LC10. In such cases, always take the values from LC10, as these may have been converted or adjusted to show true values or statistics.
2002 SAP AG
15
Other standard basis tools can also be used for monitoring liveCache and COM routines SE30 ABAP runtime analysis (Note: this may not distinguish between APO database and liveCache accesses) ST05 SQL trace (may become extremely large do not leave traces running unattended), see SAP Note 483854
2002 SAP AG
16
Respon- Escalation sibility Procedure
As Check that Check which COM versions are System required correct versions installed on your liveCache Monitorin or after are installed server g Team SPs and upgrades Correctly configured liveCache and COM should have output like No errors occurred or COM routines and liveCache are working well Performs a simple check for COM and liveCache: useful to check correct installation of liveCache and/or COM System Monitorin g Team and/or Basis Support
/SAPAPO/OM13
Daily / regularly
Shows COM versions, checks important liveCache and COM information, checks network speed/status, shows liveCache log files Ensure COM traces are not active when they are not required Ensure COM traces are not active when they are not required Use to help analyze COM messages or errors COM traces should only be used in cooperation with SAP Support
/SAPAPO/OM01
As required
/SAPAPO/OM02
As required
Display /SAPAPO/OM10 meaning of COM return code Upgrade/ /SAPAPO/OM09 recovery application log (liveCache 7.2) Delete logging log /SAPAPO/OM12
As required
Basis support
Daily or after recovery/ migration /upgrade Monthly or as required Daily / weekly/ after upgrade or SP Weekly / after upgrade or SP Check to see if performance of liveCache and COM differs greatly from previous runs Ensure it does not grow too large
Shows details of objects that have not been upgraded, recovered or migrated (blank = no errors) Use to delete the action log (see /SAPAPO/OM11 above) up to a specific date
The test cockpit contains many Basis reports that are available to test Support liveCache and COM routines. It can be used for performance comparisons/tests. Tests liveCache and COM routines based on benchmark data. Results can be used to roughly compare performance and ensure liveCache / COM are working well Performa nce Monitorin g Team
2002 SAP AG
17
Respon- Escalation sibility Procedure Basis and Applicati on Support System Monitorin g Team (Basis & Applicati on) Applicati on & Basis Support
/SAPAPO/OM18
As required
Check no long running jobs are active in the system when manually requesting checkpoints, or that another checkpoint is not already requested / active
Use to manually request a liveCache checkpoint (liveCache 7.2 only) Should only be used in special circumstances, for example to ensure no data loss occurs from liveCache crash after finalization of DP planning cycle, or after upgrades, SPs, and so on Use transactions to help analyze liveCache and COM activity; show details of current activity; COM runtime analysis statistics; Class container information; OMS data, size, age and versions; active transactions
As required
Basis support
2002 SAP AG
18
/SAPAPO/OPT11
User list for /SAPAPO/OPT03 Optimizers Versions of /SAPAPO/OPT09 Optimizers Running Optimizer Processes Optimizer server settings /SAPAPO/OPT12
As required As required As required During installatio n, or for configura tion changes to Optimize r servers As above
Displays a user list for Optimizers Displays Optimizer versions Display Optimizer Processes Maintain master data for optimization servers (PP/DS ONLY) Maintain parameter for parallel optimization
/SAPAPO/COPT02
Optimizer parallel server settings Optimizer server settings check availability of servers
/SAPAPO/COPT01
Basis Support
/SAPAPO/COPT00
As above
Checks server availability prior to the start of the optimization run and switches to another server if the check was unsuccessful
SM59
Defining and Checking Optimizer RFC destinations can also be used to check if Optimzer server is online
2002 SAP AG
19
Monitoring Activities
For the administration of an SAP R/3 OLTP system and the SAP R/3 Basis of an SAP APO system, we strongly recommend scheduling and supervising a number of jobs and monitoring activities on a regular basis. The following list is not complete. For example, it omits jobs and tasks for database administration, such as backups, archiving transaction logs, and update statistics for cost based optimizer. The list simply gives an impression of what you need to do to keep a system running. As part of SAP Basis, these monitors do not display any APO-specific monitoring data, and should be analyzed using the same procedures as those used in a non-APO system environment. To answer further questions on these subjects, schedule the SAP Solution Management Optimization Service System Administration, which also includes special recommendations for administering an SAP APO system.
Monitoring Object System workload analysis Monitor Monitor Monitor Indicator TA/Tool Freq. Time or Error ST03 or ST03N Daily To be determi ned (TBD) TBD Average dialog response time > 1000 ms Expensive SQL statements Paging rate, CPU utilization Swaps Monitoring Activity or Error Handling Procedure Responsibility System monitoring team Escalation Procedure
Database performance analysis Operating system monitor System buffer monitor Local work process overview System-wide work process overview Database performance monitor
ST04
Hourly
ST06
Hourly
TBD
System
monitoring team
ST02
Weekly
TBD
System
monitoring team
SM50
TBD
WP status, WP utilization WP status, long running jobs Table space sizes, table indexes for tRFC and aRFC Dumps
System
monitoring team
SM66
TBD
System
monitoring team
DB02
TBD
System
monitoring team
ST22
Daily
TBD
System
monitoring team
SM21
Daily
TBD
Entries
System
monitoring team
Update errors
SM13
Daily
TBD
Status ERR
2002 SAP AG
20
Process Step Restartability If a background job is canceled, consider possible succeeding jobs or dependencies on other jobs when deciding whether to restart the aborted job. The aborted job may also delay the start of succeeding jobs. Escalation Procedures In general, we recommend that you search for related SAP Notes in the SAP Service Marketplace R/3 frontend system for any unknown problems or errors. If you have questions or problems that cannot be solved, forward the issue to the next support level. If the corresponding escalation path is not well defined, contact Application Support. If none of the defined support levels can provide a solution for a particular problem, we recommend that you create a customer problem message in the SAP Service Marketplace R/3 frontend system.
2002 SAP AG
21
2002 SAP AG
22
RSTS0020 * RSBPCOLL *
RSCOLL00 *
Hourly
SAP_COLLECTOR_FOR_PERFMO Basis Job NITOR collects the general Scheduling statistical data for R/3 performance analysis SAP_REORG_ABAPDUMPS deletes short dumps that are older than six days SAP_REORG_BATCHINPUT deletes logs of background input processes. SAP_REORG_JOBS deletes old jobs SAP_REORG_JOBSTATISTIC cleans up the run-time statistics of background jobs SAP_REORG_PRIPARAMS reorganizes print parameters on a cross-client basis See SAP Note 307970 Basis Job Scheduling Basis Job Scheduling Basis Job Scheduling Basis Job Scheduling Basis Job Scheduling
RSSNAPDL *
Daily
RSBDCREO *
Daily
RSBTCDEL * RSBPSTDE *
Daily Monthly
RSBTCPRIDEL *
Monthly
RSPO0041 * RSXMILOGREORG *
Daily Weekly
Basis Job Scheduling Basis Job Scheduling Basis Job Scheduling Basis Job Scheduling
RSTRFCER
Weekly
Weekly (minimum)
2002 SAP AG
23
Escalation Procedure
SAP_OM_REORG_DAILY deletes Basis Job old COM and transactional Scheduling simulation data, and old Optimizer logs Re-organizes COM data from old sim sessions in liveCache, helps free up memory The report can be configured to send e-mails in case of CIF errors. Verify e-mail and apply errorhandling procedure described in mail text Basis Job Scheduling Basis Job Scheduling
R/3
Daily
These reports generate and activate Application integration models, respectively Job Scheduling Contact Application Support team to schedule these reports accordingly Detects and corrects inconsistencies between material master and integration models Check for material/plant combinations where correction of APOKZ could not be carried out (this is due to lock problems) If errors are reported, determine why material is locked (for example update on material master or stock) and rerun job when lock has been released Application Job Scheduling
R/3
Daily
SBAL_DELETE or /SAPAPO/RDELLOG
APO
SBAL_DELETE or RDELALOG
R/3
At least once per Week (dependant on how quickly the logs fill up)
The records in the application log are not automatically deleted by the system. To prevent the database from overflowing, we recommend that you delete the records at regular intervals. If you do not make any entries in the date and time fields, all records that are older than one week are automatically deleted. Deletes obsolete / processed change pointers (for ALE) See SAP Note 329110
RBDCPCLR
Daily/ Weekly
APO
Daily
RFC Test: Status of Outbound /Inbound Queues ensure that no errors occur Check liveCache and COM functionality reports errors
APO
/SAPAPO/OM_LIVEC ACHE_STATUS
APO
Performs a simple check to see if liveCache is active. Also performs basic checks of the network between APO and liveCache servers investigate any errors or slow network response times
System monitoring
2002 SAP AG
24
Escalation Procedure
Checks and extends time-streams in Basis and Application liveCache Support See SAP Note 449452 Basis and Checks and repairs internal consistency between APO database Application Support and liveCache See SAP Note 425825 for details and other consistency reports
/SAPAPO/OM17
APO
Daily / Weekly
Daily
Checks the external consistency between R/3 and APO and allows corrections to be made Check for objects reported to be missing either in APO or in R/3 Use transaction /SAPAPO/CCR to manually check and correct inconsistencies See SAP Note 425825 for details and other consistency reports
APO
Every 4 -6 hours
Scheduled checkpoints in line with Basis Job Scheduling your backup and recovery strategy This job should not be used with liveCache 7.4 If you often have failures or long wait times with checkpoints, do not shut down liveCache but see SAP Note 325384
/SAPAPO/OM_ARCHI VE_LOGAREA_DEL Only liveCache 7.2 with archive logging active RSLVCBACKUP Only liveCache 7.4
APO
Daily - Only Delete archive log area after successful Only after successful backup of liveCache (once a day) backup of liveCache Daily Starts a backup of liveCache See SAP Note 455154
APO
Integration, CIF, qRFC administration and monitoring To ensure optimal performance of your integration scenario and for a complete description of administration and monitoring SCM integration scenarios, see Best Practice for Core Interface. For more information about CIF and how to activate inbound queues: PI 2000.2 SAP Notes 388001, 388528 PI 2001.1 and APO3.0A SP14 SAP Notes 416475, 430725 Storage (disk space) requirements for CIF communication SAP Note 505304 http://service.sap.com/SCM mySAP SCM Technology System Management http://service.sap.com/R3-PLUG-IN Plug-In homepage
2002 SAP AG
25
In addition to the SAP component patches, you may also have to install operating system or database patches. For information about such requirements, see the SAP Note for the relevant APO support package. For information about essential operating system / kernel parameters in UNIX operating systems, see SAP Note 0487972. For the latest information on platform availability and operating system patch levels for all operating systems, check http://service.sap.com/scm mySAP SCM Technology DB & OS Platforms and System Requirements.
2002 SAP AG
26
2002 SAP AG
27
For more information on SCM support packages, component release, and support levels, see http://service.sap.com/scm mySAP Technology Availability of SAP APO Support Packages, SAP liveCache and COM Builds .
Why update just the qRFC version and not implement a Basis SP?
2002 SAP AG
28
Meaning
Maximum number of allowed connections to a gateway of an instance Maximum Swap Space of CPIC requests on gateway for R/3 >=4.6D Maximum number of allowed CPIC connections to gateway for R/3 < 4.6D Maximum number of connections to an application server Maximum number of RFC connections in relation to rdisp/max_comm_entries in percent Maximum number of dialog work processes, which are allowed to use for RFC in relation to sum of work processes Number of work processes that are unavailable for sending RFC requests Maximum number of allowed connections to an instance
APO Support Packages BW Support Packages BASIS and ABA Support Packages Plug-In Support Packages Kernel patches
2002 SAP AG
29
Further Information
Background Information
For more information about availability of support packages, release levels, liveCache COM and related components, see the mySAP SCM technology pages: http://service.sap.com/scm mySAP SCM Technology Availability of SAP APO Support Packages, SAP liveCache and COM Builds
SAP Documentation
SAP APO 3.1 documentation is available on CD or in the SAP Help Portal in German or English. SAP APO 3.0 documentation is available on CD or in the SAP Help Portal in German or English. Print files (PDF format) of several chapters in both languages are available in the Media Center of the SAP Marketplace for SCM.
2002 SAP AG