Beruflich Dokumente
Kultur Dokumente
5
version for SAP NetWeaver
Target Audience Technical Consultants System Administrators Solution Consultants Business Process Owner Support Specialist
SAP AG Dietmar-Hopp-Allee 16 69190 Walldorf Germany T +49/18 05/34 34 34 F +49/18 05/34 34 20 www.sap.com
Copyright 2010 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, Outlook, and PowerPoint 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, System i, System i5, System p, System p5, System x, System z, System z9, z/OS, AFP, Intelligent Miner, WebSphere, Netfinity, Tivoli, Informix, i5/OS, POWER, POWER5, POWER5+, OpenPower and PowerPC are trademarks or registered trademarks of IBM Corporation. Adobe, the Adobe logo, Acrobat, PostScript, and Reader are either trademarks or registered trademarks of Adobe Systems Incorporated in the United States 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, ICA, Program Neighborhood, MetaFrame, WinFrame, VideoFrame, and MultiWin are trademarks or registered trademarks of Citrix Systems, Inc. HTML, XML, XHTML and W3C 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. MaxDB is a trademark of MySQL AB, Sweden. SAP, R/3, mySAP, mySAP.com, xApps, xApp, SAP NetWeaver, 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. All other product and service names mentioned are the trademarks of their respective companies. Data contained in this document serves informational purposes only. National product specifications may vary. These materials are subject to change without notice. These materials are provided by SAP AG and its affiliated companies (SAP Group) for informational purposes only, without representation or warranty of any kind, and SAP Group shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP Group products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty.
Disclaimer
Some components of this product are based on Java. Any code change in these components may cause unpredictable and severe malfunctions and is therefore expressively prohibited, as is any decompilation of these components. Any Java Source Code delivered with this product is only to be used by SAPs Support Services and may not be modified or altered in any way.
2/68
PUBLIC
2009-12-15
Typographic Conventions
Example
<Example>
Description
Angle brackets indicate that you replace these words or characters with appropriate entries to make entries in the system, for example, Enter your <User Name>. Arrows separating the parts of a navigation path, for example, menu options Emphasized words or expressions Words or characters that you enter in the system exactly as they appear in the documentation Textual cross-references to an internet address Quicklinks added to the internet address of a homepage to enable quick access to specific content on the Web Hyperlink to an SAP Note, for example, SAP Note 123456 Words or characters quoted from the screen. These include field labels, screen titles, pushbutton labels, menu names, and menu options. Cross-references to other documentation or published works Output on the screen following a user action, for example, messages Source code or syntax quoted directly from a program File and directory names and their paths, names of variables and parameters, and names of installation, upgrade, and database tools Technical names of system objects. These include report names, program names, transaction codes, database table names, and key concepts of a programming language when they are surrounded by body text, for example, SELECT and INCLUDE Keys on the keyboard
http://www.sap.com /example
123456 Example
Example
EXAMPLE
EXAMPLE
2009-12-15
PUBLIC
3/68
Document History
CAUTION
Before you start the implementation, make sure you have the latest version of this operations guide. You can find the latest version at the following location: http://service.sap.com/ instguidesEPM-BPC 7.5, version for SAP NetWeaver . The following table provides an overview of the most important document changes.
Version Date Description
1.0
2009-12-15
First version
4/68
PUBLIC
2009-12-15
Table of Contents
Chapter 1 Chapter 2 Chapter 3 3.1 3.2 3.3 3.4 3.5 3.6 3.6.1 3.6.2 Chapter 4 4.1 4.1.1 4.1.2 4.1.3 4.1.4 4.1.5 4.1.6 4.1.7 4.2 4.3 4.4 4.5 4.6 4.7 4.8 4.8.1 4.8.2
Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Important SAP Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Monitoring of Planning and Consolidation . . . . . . . . . . . . . . . . . . . . . . . . Log and Trace Files List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Client and Server Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Logging of Exceptions in the SLG1 System . . . . . . . . . . . . . . . . . . . . . . . . . . . . Trace File for Debugging Logic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data Manager Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Central Computing Management System . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting up a Minimal-Access User to Configure SMD . . . . . . . . . . . . . . . . . . . Monitoring with Central Computing Management System . . . . . . . . . . . . . . Management of Planning and Consolidation . . . . . . . . . . . . . . . . . . . . . . . Managing Your Planning and Consolidation Servers . . . . . . . . . . . . . . . . . . . . Viewing Server Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Client Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Server Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configuring the SLD Data Supplier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Domain User Group Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting Up Debug Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Server Manager Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configure Central Management System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Migrating Users to Central Management System . . . . . . . . . . . . . . . . . . . . . . . Starting and Stopping .NET Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . Backup Best Practices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Microsoft Message Queue (MSMQ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configuring IIS Web Gardens to Run Multiple Processes . . . . . . . . . . . . . . . . . Best Practices for Performance Management . . . . . . . . . . . . . . . . . . . . . . . . . . Processing Tiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Cube Fact Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 13 13 18 18 18 19 19 20 23 23 23 25 25 26 27 28 29 29 32 33 34 34 35 35 35 36
2009-12-15
PUBLIC
5/68
4.8.3 4.8.4 4.8.5 4.8.6 4.9 Chapter 5 5.1 5.1.1 5.1.2 5.1.2.1 5.1.2.2 5.1.3 5.1.4 5.1.4.1 5.1.4.2 5.1.4.3 5.1.4.4 5.1.4.5 5.1.4.6 5.1.4.7 5.1.4.8 5.1.4.9 5.1.4.10 5.1.4.11 5.1.4.12 5.1.4.13 5.1.4.14 5.1.4.15 5.1.4.16 5.1.4.17 5.1.4.18 5.1.4.19 5.1.4.20 5.1.4.21 5.1.4.22 5.1.4.23 5.1.4.24
Cube Optimization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Cube Modification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Writeback Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SQE Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Set Up of BPF E-mail Notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Software Change Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Transport Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Transport Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Transport Execution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Transporting Application Sets into Production . . . . . . . . . . . . . . . . . . . . . . . . Transporting Process Chains into Production . . . . . . . . . . . . . . . . . . . . . . . . . Transport Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Transport Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AppSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Script Logic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Table Driven Logic (Business Rules) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Workbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Journals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Work Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Live Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Audit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data Manager Packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data Manager Transformation Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data Manager Conversion Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data Manager Macro Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . New Files and Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Team . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Other Files and Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Web Admin Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Dimension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Dimension Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Validation Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data for ApShell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
36 36 37 37 37 39 39 40 40 40 41 41 42 42 42 43 43 43 44 44 44 44 45 45 45 45 45 46 46 46 48 48 49 51 51 51 52
6/68
PUBLIC
2009-12-15
5.1.5 5.2 Chapter 6 6.1 6.2 6.3 6.4 6.5 6.6 6.7 Chapter 7 7.1 7.2 7.3
Deployment Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 Product Versioning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Troubleshooting in Planning and Consolidation . . . . . . . . . . . . . . . . . . . . . . . Troubleshooting on a .NET Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Analyzing Problems Using Solution Manager Diagnostics . . . . . . . . . . . . . . . . Installing Appsight Black Box Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Reporting and Analyzing System Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . Generating and Analyzing Trace Files Using E2E Trace . . . . . . . . . . . . . . . . . . Logging and Tracing Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Support Desk Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Remote Support Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CA Wily Introscope Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Problem Message Handover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 55 55 55 56 56 57 60 63 63 63 64
2009-12-15
PUBLIC
7/68
This page is left blank for documents that are printed on both sides.
Getting Started
1 Getting Started
CAUTION
This guide does not replace the daily operations handbook that we recommend customers create for their specific production operations. About this Guide Designing, implementing, and running Planning and Consolidation at peak performance 24 hours a day has never been more vital for your business success than now. This guide provides a starting point for managing Planning and Consolidation solutions and maintaining and running them optimally. It contains specific information for various tasks and lists the tools that you can use to implement them. This guide also provides references to the documentation required for these tasks, so you will sometimes also need other guides such as the Master Guide and SAP Library.
2009-12-15
PUBLIC
9/68
This page is left blank for documents that are printed on both sides.
CAUTION
Check regularly to see which SAP Notes are available for this Operations Guide. Important SAP Notes
SAP Note Number Title Comments
XXX
XXX
2009-12-15
PUBLIC
11/68
This page is left blank for documents that are printed on both sides.
3 3.1
Format
log<mm-dd-yyyy>.txt
EXAMPLE
log06-26-2009.txt \Documents and Settings\<username>\My log<mm-dd-yyyy>.txt Documents\Planning and Consolidation \Logging
EXAMPLE
log06-26-2009.txt
You can use various levels to restrict the information that is recorded in logs. To set a level, you set a parameter at the application set level by choosing Web Admin Tasks Application Set Parameters in the Administration interface.
2009-12-15
PUBLIC
13/68
3 3.2
The application set parameter is LOGLEVEL, and the options are: DONOTHING This level records no issues. INFO This level records fatal problems, errors, warnings, and other system info. WARNING This level records fatal problems, errors, and warnings. ERROR This level records fatal problems and errors. FATAL This level records fatal problems. The valid values for Trace Severity are: DEBUG This level records debug information, system information, warnings, and errors. INFO This level records errors, warnings, and other system info. WARNING This level records errors and warnings. ERROR This level records errors. (This is the default value.)
Log Files in SAP Logging Format 2.0
The following table describes the location and format of log files in SAP Logging Format 2.0:
Parser State Pos Field Name Example Value Optional Default Description
Version
2.0
No
2.0
DateTime
2008 01 08 14:30:36:084
No
Time Zone
+6:30
No
Severity
INFO
No
SourceName
com.sap.mycomponent or /System/Database
No
Logging API version. This value is used for defining parsing procedure version. YYYY MM DD HH:MM:SS:ms of Date & time Time Zone in format +/-N:NN (where N is Number) Severity of the record
MsgCode
web:0a0067
No
If Log Record was written using Category then value is equal to that Category name, and if Location was in use, value is equal to the Location name. Unique message id used in MessageID concept
14/68
PUBLIC
2009-12-15
Pos
Field Name
Example Value
Optional Default
Description
CSN Component
BC-JAS-ADM
No
8 9 10
8 9 10
11
11
Application
MyApplication
No
12
12
Location
com.sap.mycomponent
No
13
13
User
MyUser
No
14
14
Session
MySession
No
15
15
Transaction
MyTransaction
No
16
16
DSRRootContextID
No
17
17
DSRTransaction
No
18
18
DSRConnection
No
19
19
DSRCounter
No
20 21
20 21
ThreadName MsgType
No No
Empty string Component in the () CSN system to which this message refers Empty string Development () Component GUID value Unique LogRecord ID Correlation Implicit properties ID from the J2EE engine Empty string Implicit properties () from the J2EE engine Location Class or package name name where LogRecord was created Empty string Implicit properties () from the J2EE engine Empty string Implicit properties () from the J2EE engine Empty string Implicit properties () from the J2EE engine Empty string Implicit properties () from the J2EE engine Empty string Implicit properties () from the J2EE engine Empty string Implicit properties () from the J2EE engine Empty string Implicit properties () from the J2EE engine Main Thread name Plain LogRecord Message type: PLAIN message with-out arguments
2009-12-15
PUBLIC
15/68
Pos
Field Name
Example Value
Optional Default
Description
22 23 24
22 23 24
MyResourceBundle
No
25 26 27
MyServer 15 ...
JAVA message with arguments Empty string ResourceBundle () name Empty string Message () Number of arguments in message (for example, 2) First message argument Second message argument Next message argument
Example
Version DateTime TimeZone Severity SourceName MsgCode CSNComponent DCComponent GUID CorrelationID Application Location User Session Transaction DSRRootContextID DSRTransaction DSRConnection DSRCounter ThreadName MsgType
2.0 2008 01 08 14:30:36:084 +6:30 INFO com.sap.mycomponent web:0a0067 BC-JAS-ADM tc/lm/webadmin/performance/viewer/wd 000FFE93A54F002700000683000018B401228AEE 000FFE93 MyApplication com.sap.mycomponent MyUser MySession MyTransaction 38fe6ce0639411dc96dd000ffe93a2aa 38fe6ce0639411dc96dd000ffe93b1cc 38fe6ce0639411dc96dd000ffe93d345 20 System [28] JAVA
16/68
PUBLIC
2009-12-15
3 3.2
Monitoring of Planning and Consolidation Client and Server Log Files Value
Field Name
All expected fields are shown on a new line. Empty string values display as . Empty numeric values display as -1. Example
2.0 000FFE93A54F002700000683000018B401228AEE 2008 01 08 14:30:36:084 com.sap.mycomponent MyApplication com.sap.mycomponent MyUser MySession MyTransaction 38fe6ce0639411dc96dd000ffe93b1cc System [28] INFO JAVA web:0a0067 MyResourceBundle Server MyServer will be down in 15 minutes! +6:30
2009-12-15
PUBLIC
17/68
3 3.3
This generates an exception and produces the following message in the log: Member "A1000" not exist.
18/68
PUBLIC
2009-12-15
3 3.6
In the NetWeaver version of Planning and Consolidation, these logs are stored in <Drive>\WEBFOLDERS \%APPSET%\%APP%\PRIVATEPUBLICATIONS\<username>\tempfiles. In the Microsoft version of Planning and Consolidation, these logs are stored in <Drive>\webfolders \<Appset>\<application>\privatepublication\<username>\tempfiles. The name of the log file contains the following details: The name of the package A timestamp The extension .LOG
EXAMPLE Validatetransformation20090915211503.log NOTE
In the NetWeaver version of Planning and Consolidation, passwords are masked when contained in a log file. To be masked, however, the parameter name for passing the password must include the substring password.
1. 2. 3. 4.
Log on to the Apshell application set through the Admin Console. Choose Security Users and then select Add new user from the Session Information action pane In the Add New Users wizard, enter a suitable user name or use the Search function to find an available user name. Choose Next at all remaining steps of the wizard without entering any user details or assignments data.
2009-12-15
PUBLIC
19/68
3 3.6
5. 6.
Check that the user has no teams or profiles assigned and click Apply. Configure the SMD connection to Planning and Consolidation to use this user. For information about setting up SMD, see Connecting to Solution Manager Diagnostics in the Planning and Consolidation Installation Guide.
20/68
PUBLIC
2009-12-15
3 3.6
dllhost.exe (DLL application process) For the Microsoft version of Planning and Consolidation: w3wp.exe (Microsoft Internet Information Services application pool process) dllhost.exe (DLL application process) OSoftSendGovernor.exe (SAP Planning and Consolidation Send Governor process) OSoftInsightSchedulerWindowsService.exe (SAP Planning and Consolidation Insight process) You can customize the thresholds for alert triggering to suit your business needs. In the Microsoft version of the system, you can access technical configuration details using WebService at http://server_name:port/osoft/app/SMDWebService/BPCSMDService.asmx.
2009-12-15
PUBLIC
21/68
This page is left blank for documents that are printed on both sides.
4 4.1
Management of Planning and Consolidation Managing Your Planning and Consolidation Servers
The System Information window shows information about the server, including the Operating System version and available memory. You can access the System Information window by doing the following: Start Server Manager by selecting (All) Programs SAP Server Manager from the Windows Start menu on your .NET application server. You can click the Refresh button to refresh the information on the screen. The configuration XML files are available on a local file system. Configuration files include web.config.xml and machine.config.xml. Planning and Consolidation provides seven remote function calls for Solution Manager to monitor the configuration data of the system. The following table provides an overview of the mapping relationship of the DDIC tables (available by transaction SE16) and the remote function calls for the ABAP server.
2009-12-15
PUBLIC
23/68
4 4.1
Management of Planning and Consolidation Managing Your Planning and Consolidation Servers Configuration data included
Table Fields
UJA_SVR_DEFAULT UJ0_API_BPC_CONFIG_03 Planning and Consolidation system administrators UJA_DOMAIN UJ0_API_BPC_CONFIG_05 Supported domain
UJA3_SFT_VERSION UJ0_API_BPC_CONFIG_07 The prerequisite ABAP software components for the system
UJA3_CLT_OPT
UJ0_API_BPC_CONFIG_08 Settings for the Client options in Server Manager UJ0_API_BPC_CONFIG_11 Parameters that control the behavior of application queries
UJQ_PARAM
UJR_PARAM
UJU_AUDSTING
UJ0_API_BPC_CONFIG_12 Parameters that control locking behavior when writing data UJ0_API_BPC_CONFIG_13 Indicate audit settings for various system components
MANDT SAP GUI Logon Client Number IS_CMS_DONE Specifies whether the system is running in CMS mode VALUE The value of the field MANDT SAP GUI Logon Client Number GROUP_NAME The logic group of the system user DOMAIN_TYPE Specifies whether the system is running in domain or work group mode DOMAIN_NAME Name of the domain READ_ONLY Indicates whether the value can be changed COMPONENT The components required by the system SAPRELEASE Component release version VERSION Component version PATCH Component patch version DESC_TEXT Component description MANDT SAP GUI Logon Client Number FIELD Can be customized. Currently stores the client options of the system VALUE The value of the field MANDT SAP GUI Logon Client Number APPSET ID Application set ID APPLICATION ID Application ID PARAM The related parameter name of the application VALUE The value of the parameter APPSET ID Application set ID APPLICATION ID Application ID PARAM The related parameter name of the application VALUE The value of the parameter MANDT SAP GUI Logon Client Number APPSET_ID Application set ID ADMIN_ON Indicates whether auditing is turned on for the Administration module
24/68
PUBLIC
2009-12-15
4 4.1
Management of Planning and Consolidation Managing Your Planning and Consolidation Servers Configuration data included
Table Fields
USER_ON Indicate whether auditing is turned on for the User module BPF_ON Indicate whether auditing is turned on for the Business Process Flows module BIZRULE_ON Indicates whether auditing is turned on for business rules functionality More Information
You can access the Client Options screen from Server Manager by selecting Options Client Options. You can set the following options: Sox Compliance You can enable the server to be Sarbanes-Oxley compliant if you want all clients that access the server to challenge users for a user name and password. Check Prerequisite Software If you want to install a different version of a required software component than is installed during an auto update, you can provide a different version number and file name for the desired software program. When you change the version or file name, it impacts all subsequent client installations and client diagnostics.
NOTE
The Microsoft XML Version is here for historical reasons. We recommend that you do not change this value.
You can access the Server Options screen from Server Manager by selecting Options Server Options. The following table describes the available options:
2009-12-15
PUBLIC
25/68
4 4.1
Management of Planning and Consolidation Managing Your Planning and Consolidation Servers Value Description
Server Option
Application server name - External server name - Virtual server name - Web site - HTTP compression - Protocol - Port number - Authentication type Scheduler Server Name
Web Server name - External server name - Virtual server name - Website - HTTP compression - Protocol - Port number - Authentication type
The name of the application server. TCP/IP address for accessing the server from outside a firewall. The server name for load balancing if it is installed. The IIS web site name, if it differs from the default web site. The default value is No. (Yes provides better performance in some situations.) The available values are http or https. The default value is http. The port number to which the application server connects. 80 is the default for http, 443 is the default for https. Active Directory. The name of the server used for scheduling, usually the application server, for example, GMPV50072862B. If you have multiple application servers, select the appropriate one. The name of the web server, for example, GMPV50072862B TCP/IP address for accessing the server from outside a firewall. The server name for load balancing, if it is installed. The IIS web site name, if it differs from the default web site. The default value is No. (Yes provides better performance in some situations.) The available values are http or https. The default value is http. The port number to which the Reporting Services server connects. 80 is the default for http; 443 is the default for https. Active Directory.
26/68
PUBLIC
2009-12-15
4 4.1
Management of Planning and Consolidation Managing Your Planning and Consolidation Servers
Prerequisites
To have the SLD Data Supplier for Planning and Consolidation work with the SLD server, the SLD server needs to be on one of the following minimum releases of SAP Netweaver Application Server Java: 7.00 SP021 7.01 SP005 7.02 SP002 7.10 SP009 7.11 SP004
Features
You maintain the SLD Agent from Server Manager by selecting Server Configure SLD .: Hostname The host on which the SLD server is deployed and running Port The HTTP or HTTPS port at which the SLD server is listening User name The user name associated with the SLD credentials Password The user password associated with the SLD credentials Use HTTPS Indicates whether the data is transferred via secure connection or not SLD Upload Frequency The number of times per that the Planning and Consolidation system transfers currently active data to the SLD server Choose Save to save the SLD Agent connection setting. Choose Upload to upload an SLD Payload file to the SLD server.
You can define user groups from the Server Manager by selecting Options Define system user groups. You use the following features for defining a user group: Choosing user group names
2009-12-15
PUBLIC
27/68
4 4.1
Management of Planning and Consolidation Managing Your Planning and Consolidation Servers
The default group name is Domain users if a domain user installs the Planning and Consolidation server. The default group name is Local users if a local user installs the Planning and Consolidation server. The group name is displayed in the Add Users assistant in the Admin Console. You can modify the settings for an existing group by selecting the name of the group from the list. Defining Filters You use filters to define user groups. The following table includes examples of filters you can define:
Scenario Example Description
OU=Marketing OU=Sales;OU=Marketing
OU=Sales;OU=Marketing;CN=Users
CN=DM,OU=Sales
Multiple groups (or CN=DM,OU=Sales;CN=DM,OU=Sales2 users) in an OU (when multiple groups are in a single or different groups)
Mixed condition
CN=DM,OU=Sales;CN=FR,OU=Sales2; CN=HR,CN=Users
Finds users of the Marketing OU. Finds users of the Sales and Marketing organizational units. Finds users of the Sales and Marketing organizational units and the Users container. Finds users of the DM group in the Sales organizational unit. Finds the users of the DM group in the Sales2 organizational unit and the users in the DM group in the Sales organizational unit. Finds users of the DM group in the Sales organizational unit, users of FR group in Sales2 organizational unit, and users of HR group in the Users container.
28/68
PUBLIC
2009-12-15
4 4.2
of the service user. This allows the administrator to set an external breakpoint for the ABAP user ID in the back-end ABAP system, then perform the Planning and Consolidation client operation they wish to debug. The operation then stops when the external breakpoint is encountered, and the user is taken into the ABAP debugger. If no debug users are specified, all connections between the .NET application server and the ABAP application server are made with the three base connection users (SYSADMIN, ADMIN, or USER).
Procedure
1. 2. 3.
To set up debug users, from Server Manager, select Server Maintain Debug Users . Enter the Planning and Consolidation user ID, the ABAP user ID as the debug user ID (this must be a dialog user), and the corresponding password for the ABAP user ID, then click Update. Restart the IIS service for this change to become effective.
Launch the Server Manager View the server information Server Information Run server diagnostics Server Diagnostic Reset logon credentials Server Reset Login Credentials Set up and maintain debug users Server Maintain Debug Users Choose the server language Options Language Set client options Options Client Options (SOX Compliance) Define system user groups Options Define System User Groups
2009-12-15
PUBLIC
29/68
4 4.2
Prerequisites
The Central Management System (CMS) is installed and the Planning and Consolidation system has an administrator-level ID and password to the CMS. To log on to CMS as an administrator, you need the following information.
Field Description
CMS system name (server name:port number), for example, CMSServer:6400 CMS system name If a CMS cluster name exists, use the cluster name (multiple names should be separated by a comma ,). Select the appropriate value from the list The user identifier of the dedicated administrator account Password for the administrator account Group name of the SAP BusinessObjects Enterprise users, who have access to the system This group name is filtered as the default when adding a user in Planning and Consolidation Administration. (Multiple names should be separated by a comma ,.) The default is http://<CMS name>:8080/dewbobje/ If your system is configures with an SSL protocol and a specific port, amend this protocol accordingly.
Features
The following authentication modes are possible: Windows CMS The Server Manager Options menu has different entries according to the authentication mode selected.
Windows Authentication Mode
From the Server Manager Options menu, you have the following entries that are specific to the Windows authentication mode: Define System User Groups Here you can define groups of Windows users that have similar system responsibilities. Enable CMS Authentication mode Switch from Windows authentication to CMS authentication.
NOTE
If you have more than one server, you need to change the authentication mode on all servers.
CAUTION
We recommend CMS authentication mode. On installation of Planning and Consolidation, CMS authentication mode is selected by default.
30/68
PUBLIC
2009-12-15
4 4.2
From the Server Manager Options menu, you have the following entries that are specific to the CMS authentication mode: Configure CMS The following parameters can be defined in the SAP BusinessObjects User Management System view:
The name of the system CMS system name If a CMS cluster name exists, use the cluster name (multiple names should be separated by a comma ,). Authentication type Select the appropriate value from the list Administrator ID The user identifier of the dedicated administrator account Administrator password Password for the administrator account Group name Group name of the SAP BusinessObjects Enterprise users, who have access to the system This group name is filtered as the default when adding a user in Planning and Consolidation Administration. (Multiple names should be separated by a comma ,.) Cache expiration duration The time (in minutes) after which the cache is cleared Heartbeat interval After a period of inactivity, the CMS session may expire at the server, after which the Planning and consolidation system cannot communicate with the server The Heartbeat function periodically simulates activity to keep the session active. Set the Heartbeat interval (in minutes) to a suitable level for the CMS session. System name Trusted CMS name
Click Update to update the user management system with these new values. CMS Migration Select this option to migrate all current Windows user authentication information to CMS user authentication information. To use this menu option, you should be logged on to CMS as an administrator. If you are not already logged on, enter the correct logon information when prompted. You are guided through the following actions: Select one or more Windows application sets to migrate to CMS from the list that is displayed. The system displays a list of Windows user IDs for the selected application sets. Click 1. Validate user to enable the system to align Windows and BusinessObjects user IDs. A green tick indicates that a corresponding BusinessObjects user exists while a red cross means that there is no BusinessObjects user corresponding to the Windows user ID. Click 2. Migrate and then click OK to migrate the validated Windows user information to CMS. When the migration is complete, click 3. View result to view a detailed result log of the migration process. If required, you can save a copy of the result log. Set complete Click 4 Set complete.
2009-12-15
PUBLIC
31/68
4 4.3
The migrated application sets are set as CMS mode application sets. These application sets are no longer visible in the migration wizard.
More Information
Make sure you have the latest version of Planning and Consolidation by uninstalling the 7.0 .NET server and installing the 7.5 .NET server. Select the CMS authentication method during the installation. Also, ensure that the ABAP server is upgraded to Planning and Consolidation 7.5. Download and install SAP BusinessObjects Enterprise Server XI 3.1 or Mini-BOE from the SAP Marketplace. For more information, see the Installation Guide. Enable CMS Authentication mode from Server Manager Options Enable CMS Authentication Mode or through the installation program (select CMS as the authentication method).
Procedure
To migrate users from AD to CMS
1.
2.
3. 4. 5.
6.
Set up the secWinAD mode so that BusinessObjects Enterprise Server can map the CMS user to the corresponding Windows AD user. This step is optional. If you do this step, the migration tool can automatically map the Windows AD users to CMS users. If you do not do this step, you must manually map all Planning and Consolidation users from Windows AD to CMS. Log on to Windows as the system administrator defined in table uja_svr_default. Only this system administrator can run the migration tool. You can change the system administrator by running program UJA3_WRITE_SYS_USERS. Run the migration tool (<bpc_install_folder>\Websrvr\Web\bin\MigrationTool.exe). Log on to CMS as an administrator. If you set up the user mapping in step 1, the migration tool maps the Windows AD users to CMS. You can also map all the users manually. Check the automatic mapping and add additional user mappings manually. Select Attributes which may contain USER_ID. Attributes in Planning and Consolidation dimensions may contain the USER_ID. These attributes should be changed as the USER_ID is changed to the new CMS ID. Select the attributes that contain USER_ID.
32/68
PUBLIC
2009-12-15
4 4.4
7.
Review and click Do Migration. The migration is executed as an ABAP job. An ABAP user can monitor the job status for detailed information (SAPGUI transaction: SM37). If the migration is successful, the USER_ID in all ABAP tables changes from Windows user to a CMS user. The migration tool cannot be run again. If the migration fails, everything that has been done is rolled back and the USER_ID in all Planning and Consolidation tables are still the Windows users. In this case, the migration tool can be run again.
Result
When users have been migrated from Windows to CMS, the user's cache still contains the Windows authentication information. Each user should clear this cache to enable all features of Planning and Consolidation. To clear the cache, at the first login to Planning and Consolidation after the migration to CMS: 1. Open an Interface for an Office application 2. In the eTools menu, choose Clear Current View and then Clear Local Application Information 3. Close and then reopen the Interface for an Office application
You may also need to stop and restart Planning and Consolidation components if the system is not performing in the expected manner. Starting Planning and Consolidation Components In the Microsoft Control Panel, choose Administrative Tools Internet Information Services and ensure that the OSoft site is running. If it is not running, use the context menu to start it. Stopping Planning and Consolidation Components In the Microsoft Control Panel, choose Administrative Tools Internet Information Services , select the OSoft site and use the context menu to stop it. In the Microsoft Control Panel, choose Administrative Tools Component Services Com+ Application , select all Planning and Consolidation SAP NetWeaver components and use the context menu to stop them.
2009-12-15
PUBLIC
33/68
4 4.5
Refer to the following items for information about backing up your Planning and Consolidation system: 1. On the SAP Help Portal, refer to the backup procedures at http://help.sap.com/saphelp_nw70/ helpdata/EN/7c/efa841c1dade34e10000000a1550b0/content.htm. 2. On SAP Service Marketplace at http://service.sap.com/solutionmanagerbp, refer to documents 084 Business Continuity Management for SAP System Landscapes and 085 Emergency Handling for Recovery of SAP System Landscapes. 3. On the SAP Developer Network at https://www.sdn.sap.com/irj/sdn/go/portal/prtroot/ docs/library/uuid/30c221aa-b4e5-2910-b899-d268d84c19c5, refer to the article entitled Architecting a high availability SAP NetWeaver infrastructure.
34/68
PUBLIC
2009-12-15
4 4.7
Management of Planning and Consolidation Configuring IIS Web Gardens to Run Multiple Processes
http://msdn.microsoft.com/en-us/library/ms706083(VS.85).aspx http://msdn.microsoft.com/en-us/library/ms700996(VS.85).aspx
Microsoft Message Queue has been installed. See the Installation Guide on SAP Service Marketplace.
Procedure
To configure the number of worker processes on the Application or Web server, use the following procedure: 1. Choose Control Panel Administrative Tools Internet Information Services (IIS) Manager. . 2. In the Internet Information Services (IIS) Manager dialog box, choose <local_computer> Application Pools . 3. In the DefaultAppPool context menu, choose Properties. 4. Enter a value in the Maximum number of worker processes field.
CAUTION
There may be performance issues if the number is greater than 1, depending on number of processors and available RAM.
Database
The following processes occur at the database level: Data reads Data write-backs
2009-12-15
PUBLIC
35/68
4 4.8 Tier
Management of Planning and Consolidation Best Practices for Performance Management Description NOTE
Write-back performance is primarily affected by work status locks, the validation framework, concurrency lock parameters, and the security model. Metadata reads and writes Application file storage (book repositories, report and input templates, unstructured data, conversion files, and transformation files) NetWeaver ABAP The following processes occur at the application server level: Application Server Script logic, calculations, and MDX parsing Parameter-driven logic Data Manager loads and ETL (extraction, transform, load) OLAP engine and calculations Microsoft IIS Web and The following processes occur at the web server level: Application Server User authentication Web Service request parsing and processing Interface for Web BI Accelerator (optional The BI Accelerator can be used to eliminate database read times through the use of component) in-memory storage.
36/68
PUBLIC
2009-12-15
4 4.9
moved with the data. These modifications include such things as tablespaces, BI Accelerator indexes, DTPs (distributed transaction processing), aggregates, and database performance parameters.
PACKAGE_SIZE SPARSITY_COEF
40000 5
RECLEVEL_NR MULTIPLY_COEF
10 50
INTERVAL_NR
10
This specifies the size into which packages will be divided during the writeback process. If (the number of dimensions multiplied by the number of unique members in each dimension) is greater than (number of records multiplied by the this value), then the record set is considered sparse. If the number of records being saved is less records than or equal to this value, record-based locking will be implemented. In the situation where record-level locking is not being implemented and a sparse data set is being saved, this value specifie the maximum number of members for which you can implement record level locking (that is, when to swap to using a BETWEEN range in the lock table). In the situation where record level locking is not being implemented and the data set being saved is NOT sparse, any dimensions with less than this number of distinct member values in the dataset will be locked using their single values. If the dimension has more than this number of records, the range between the low to high values will be locked.
SPARSITY_COEF
If (the number of dimensions multiplied by the number of unique members in each dimension) is greater than (number of records multiplied by this value), then the record set is considered sparse.
2009-12-15
PUBLIC
37/68
4 4.9
Prerequisites
Owners are notified by e-mail when a BPF instance is created and actions are taken. In addition, they are notified when an instance has been completed and ready to be finalized. Reviewers are notified by e-mail when a step region is ready for review.
EXAMPLE
Subject: BPF instance <name> now ready for action Text: BPF Instance for dimensions time 2009.total and category budget. Step region(s): first active step number and step region dimension:member. As a participant in this business process please select the following link: HTTP://sample_link/. Creating a BPF instance generates a notification to all users with access to the BPF monitor. Types of BPF e-mails Planning and Consolidation contains a number of e-mail templates by default. These are S-type (system) templates, which you cannot modify. You can create a copy of each system template and customize the copy for your business needs. These are C-type (customized) templates. You can customize the title and body of C-type (customized) e-mail templates. You can input multilanguage text in the e-mail body, and you can add the following variables to display information in the e-mail to help its recipient: %INST_NAME% %STEP_NAME% %URL% %STEP_REGION_NAME% You can add URLs to the body of an e-mail to give users direct access to BPF web. To be able to include a URL in an e-mail, however, you must access Server Manager and provide the Web server name and port number used in Planning and Consolidation. In Server Manager, choose Server Maintain Web Server Name , enter the name of the Web sever, then choose Update. You can activate or inactivate an e-mail by entering a Y or N in Is Active. Managing BPF e-mails Set up and customization of BPF e-mail notification templates is done on the back-end. Perform the following steps: 1. In SAP GUI, choose transaction code SE80 for the Object Navigator. 2. Choose Package in the left navigation pane, then enter the package name UJB. 3. Choose Programs, then run UJB_MAINTAIN_EMAIL_TMPL. You create a copy of a system template by selecting a system template then clicking the Create customized email template icon in the toolbar. Then, modify it as needed,
38/68
PUBLIC
2009-12-15
5 5.1
Software Change Management standardizes and automates software distribution, maintenance, and testing procedures for complex software landscapes and multiple software development platforms. These functions support your project teams, development teams, and application support teams. The goal of Software Change Management is to establish consistent, solution-wide change management that allows for specific maintenance procedures, global rollouts (including localizations), and open integration with third-party products. This section provides additional information about the most important software components.
2009-12-15
PUBLIC
39/68
5 5.1
1.
2.
3.
Configure the SAP NetWeaver transport framework by creating transport domains, routes, and other aspects of a transport. For information, see Change and Transport System in the SAP NetWeaver Application Help on the SAP Library at http://help.sap.com. Configure the system to import Client-Dependent Objects because all Planning and Consolidation data is client-dependent. Do the following: Create User ALEREMOTE (BW Background User) Create an RFC destination to allow the import method to be executed in the correct client. Otherwise it is executed in client 000. Use transaction RSTPRFC to create the destination for this client For information, see Importing Client-Dependent Objects in the SAP NetWeaver Application Help on the SAP Library at http://help.sap.com. Configure which objects get transported. This involves starting the transaction SM30, going to the table UJT_TRANS_CHG, and setting the objects to create in development and the objects to create in production. Anything marked as Development in the table is transported when a transport is collected from this system. Anything marked as Production is not transported when a transport is collected from this system. For information about transport objects, see Transport Objects [page 42].
40/68
PUBLIC
2009-12-15
5 5.1
Enter the application set that you are promoting or deleting in the Appset Id field. If you want to release the request immediately upon creating, select Release Request Directly.
NOTE
4. 5.
This setting does not take effect until the transport operation has been completed. Choose Execute. Contact IT to import the request into the target systems throughout the landscape. Once this request is created, the transport can be viewed, maintained, and released using transaction SE10.
The corresponding default instruction in table UJD_INSTRUCTIONS needs to be transported via transaction SE16.
Prerequisites
Transport maintenance involves the following: After deleting an AppSet, you can make sure that all data has been removed. Use program UJT_CHECK_TABLE_ENTRIES to check how many records exist in the UJ* database tables for a particular appset. You can test the ApShell installation process or test the migration tools. Use program UJT_DLT_TRANS_DATA to delete data from the transport shadow tables (UJT_TRANS_OBJ and UJT_TRANS_HDR) for a particular AppSet.
NOTE
Be careful when using the UJT_DLT_TRANS_DATA program because this is a System Admin utility.
2009-12-15
PUBLIC
41/68
5 5.1
5.1.4.1 AppSet
The object type ASET refers to an AppSet. It can be configured from transport within table UJT_TRANS_CHG via transaction SM30. It is recommended to always have this object set to Development. If this object is set to Production, then the AppSet changes are not transported. There are valid scenarios where only specific changes may need to be imported, for example script logic changes. At those times, this may be flagged as production to only send the sub-objects of the AppSet that need to be sent. However, as a best-practice, it is recommended to transport the entire AppSet to ensure all changes are fully transported and dependencies are not missed between objects.
5.1.4.2 Application
The object type APPM refers to an Application. It can be configured from transport within table UJT_TRANS_CHG via transaction SM30. This setting controls whether applications are imported into your target system when importing a Planning and Consolidation transport. If this is flagged to Development, all application cha_chg_mgmt_transportnges within the AppSet are imported. This includes which dimensions are assigned to the application. If the dimensions assigned to the application are the same in the target AppSet, then the underlying technical cube in SAP NetWeaver BW does not change. However, if the dimensionality changes in development, and then this application is transported, the transport creates a shadow cube with the new structure and moves the application data from the old application to the new application and then deletes the old application. Assuming a new dimension is added in development and this new dimension is assigned to a new application, this dimension is not pre-populated in the application with the first dimension member from the member sheet. In most cases, customers assign a NULL value as the first member in the member sheet as a best practice. When transporting this application with a new dimension, there are no dimension members in the target system. In this case, the first member is transported from development to the target system and then this member is inserted into the application as part of the application change.
42/68
PUBLIC
2009-12-15
5 5.1
5.1.4.5 Workbooks
The object type WORK refers to Dynamic Report Templates and Dynamic Input Schedules. It can be configured from transport within table UJT_TRANS_CHG via transaction SM30. This setting allows you to control whether these reports are imported into your target system when importing a Planning and Consolidation transport. If this is flagged to Development in the target system, all workbook changes within the AppSet are imported. There is currently no method for transporting only some workbooks and not others. If workbooks need to be created in production for the whole application, it is a best practice to create a sub-folder within production within the eexcel folder that does not exist in development. All production reports can be stored in this sub-folder. This way, they would not get overwritten when transporting an AppSet from development to production. The file service never transports a deletion. Existing files created in production are not deleted when transporting files. Any workbooks stored in TEAM or USER folders are not transported with this setting. The workbooks stored within TEAM folders are transported with the TEAM transport setting (in UJT_TRANS_CHG). The path that gets transported is this path within file service:
2009-12-15
PUBLIC
43/68
5 5.1
<Drive>\WEBFOLDERS\%APPSET%\%APP%\EEXCEL\*
Any workbook saved to a team folder are transported as part of the TEAM transport.
5.1.4.6 Reporting
The object type REPT is currently not used within Planning and Consolidation.
5.1.4.7 Journals
The object type JOUR refers to Journals configuration. It can be configured from transport within table UJT_TRANS_CHG via transaction SM30. This setting controls whether journals are imported in your target system when importing a Planning and Consolidation transport. If this is flagged to Development in the target system, all journals configuration changes within the AppSet are imported. Journal entries are not transported. If an application has a changed dimensionality and the application is transported from development to production, all journal entries in the production system for this application are deleted. It is a best practice to back up these journal entries using the Data Manager packages to backup and restore journals prior to transporting application changes that have journal configuration.
5.1.4.8 Security
The object type SECU refers to member access profiles and task access profiles. It can be configured from transport within table UJT_TRANS_CHG via transaction SM30. This setting controls whether member access profiles and task access profiles are imported in your target system when importing a Planning and Consolidation transport. If this is flagged to Development, all member access profiles and task access profiles within the AppSet are imported. For member access profiles, if the members are not the same between development and production, they must be altered in production or this security object must be set to Production to avoid transporting member access profiles. However, this one setting controls both member access profiles and task access profiles, so you must be careful when changing it.
44/68
PUBLIC
2009-12-15
5 5.1
Transports support the work states and the work status settings that are defined. Transports does not include any work status locks that have been set.
5.1.4.11 Comments
The object type COMM refers to Comments. Currently, this entry is not used by Planning and Consolidation. Transporting of comments is not supported, and there is no configuration related to comments that needs to be transported.
5.1.4.12 Audit
The object type AUDI refers to Audit. Currently, this entry is not used by Planning and Consolidation. Transporting of audit logs or audit configuration is not supported, and there is no configuration related to audit that needs to be transported. Audit configuration needs to be turned on directly in production for the applications and task changes that need to be audited.
2009-12-15
PUBLIC
45/68
5 5.1
Transformation Files are imported in your target system when importing a Planning and Consolidation transport. If this is flagged to Development in the target system, all Data Manager transformation files within the application set are imported. Deletion of transformation files is not supported with transports, and must be done manually in each system. This does not transport any transformation files assigned to specific Team folders. These transformation files are only transported if the TEAM object is marked as Development.
This information is relevant for Planning and Consolidation 7.5 implementations. If you are running 7.0 SP02, see Other Files and Folders [page 48].
46/68
PUBLIC
2009-12-15
5 5.1
AppSet Anytime a new application within the development system is created and transported to a target system where this new application does not already exist, this AppSet folder is transported again:
<Drive>\WEBFOLDERS\%APPSET%\
Application Anytime a new application within the development system is created and transported to a target system where this new application does not already exist, all Application folders are transported again.
<Drive>\WEBFOLDERS\%APPSET%\%APP%\
AppPublications Anytime a new application within the development system is created and transported to a target system where this new application does not already exist, all AppPublications folders are transported again:
<Drive>\WEBFOLDERS\%APPSET%\%APP%\APPPULBICATIONS
Data Manager Anytime a new application within the development system is created and transported to a target system where this new application does not already exist, all DataManager files and folders listed below are transported again.
<Drive>\WEBFOLDERS\%APPSET%\%APP%\DATAMANAGER\ <Drive>\WEBFOLDERS\%APPSET%\%APP%\DATAMANAGER\DATAFILES\ <Drive>\WEBFOLDERS\%APPSET%\%APP%\DATAMANAGER\MACROFILES\* <Drive>\WEBFOLDERS\%APPSET%\%APP%\DATAMANAGER\PACKAGEFILES\ <Drive>\WEBFOLDERS\%APPSET%\%APP%\DATAMANAGER\PACKAGEFILES\EXAMPLES\* <Drive>\WEBFOLDERS\%APPSET%\%APP%\DATAMANAGER\PACKAGEFILES\MYFILES\* <Drive>\WEBFOLDERS\%APPSET%\%APP%\DATAMANAGER\PACKAGEFILES\SYSTEMFILES\* <Drive>\WEBFOLDERS\%APPSET%\%APP%\DATAMANAGER\SELECTIONFILES\ <Drive>\WEBFOLDERS\%APPSET%\%APP%\DATAMANAGER\TRANSFORMATIONFILES\EXAMPLES\* <Drive>\WEBFOLDERS\%APPSET%\%APP%\DATAMANAGER\TRANSFORMATIONFILES\SYSTEMFILES\*
PrivatePublications Anytime a new application within the development system is created and transported to a target system where this new application does not already exist, all Application folders are transported again.
<Drive>\WEBFOLDERS\%APPSET%\%APP%\PRIVATEPUBLICATIONS\
Anytime a new application within the development system is created and transported to a target system where this new application does not already exist, all the following folders are transported again:
<Drive>\WEBFOLDERS\%APPSET%\ADMINAPP\ <Drive>\WEBFOLDERS\%APPSET%\ADMINAPP\DIMCACHE
2009-12-15
PUBLIC
47/68
5 5.1
Software Change Management Transport Management <Drive>\WEBFOLDERS\%APPSET%\APPSETPUBLICATIONS\ <Drive>\WEBFOLDERS\%APPSET%\APPSETPUBLICATIONS\LIBRARY\ <Drive>\WEBFOLDERS\%APPSET%\APPSETPUBLICATIONS\PUBLICATIONS\ <Drive>\WEBFOLDERS\%APPSET%\DOCUMENTS\ <Drive>\WEBFOLDERS\%APPSET%\SYSTEMFILES\ <Drive>\WEBFOLDERS\ADMINTEMPLATES\*
5.1.4.18 Team
The object type TEAM refers to Teams. It can be configured from transport within table UJT_TRANS_CHG via transaction SM30. This setting controls whether Team files are imported in your target system when importing a Planning and Consolidation transport. If this is flagged to Development in the target system, all Team files within the application set are imported. This refers to files stored under this path:
<Drive>\WEBFOLDERS\%APPSET%\%APP%\TEAM FILES\*
Teams that are created in development are never transported. User assignments for teams are not transported because users are configured in each environment and typically, the users accessing the development system would not be the same users to access the production system. Therefore, this TLOGO object is only useful if the team names are the same in development and production (created manually in each environment). Then the files for the team can be transported to the team in the target system. The team transport transports any conversion file or transformation files that are assigned to this team. Data Files for Data Manager in the Team folder are not transported. Additionally, the team transport transports any workbooks (dynamic report templates or dynamic input schedules) that are assigned to the Team folder. Any Data Manager packages assigned to teams are handled by the PACK object, not the TEAM object. This means that Data Manager packages that are assigned to the team are only transported if the PACK object is set to Development in table UJT_TRANS_CHG.
48/68
PUBLIC
2009-12-15
5 5.1
This information is relevant for SAP Planning and Consolidation 7.5 and higher implementations. If you are running 7.0 SP03, see New Files and Folders [page 46].
<Drive>\WEBFOLDERS\ADMINTEMPLATES\* <Drive>\WEBFOLDERS\%APPSET%\ <Drive>\WEBFOLDERS\%APPSET%\ADMINAPP\ <Drive>\WEBFOLDERS\%APPSET%\ADMINAPP\DIMCASHE\ <Drive>\WEBFOLDERS\%APPSET%\APPSETPUBLICATIONS\ <Drive>\WEBFOLDERS\%APPSET%\APPSETPUBLICATIONS\LIBRARY\ <Drive>\WEBFOLDERS\%APPSET%\APPSETPUBLICATIONS\PUBLICATIONS\ <Drive>\WEBFOLDERS\%APPSET%\DOCUMENTS\ <Drive>\WEBFOLDERS\%APPSET%\SYSTEMFILES\ <Drive>\WEBFOLDERS\%APPSET%\%APP%\ <Drive>\WEBFOLDERS\%APPSET%\%APP%\DATAMANAGER\ <Drive>\WEBFOLDERS\%APPSET%\%APP%\DATAMANAGER\DATAFILES\ <Drive>\WEBFOLDERS\%APPSET%\%APP%\EEXCEL\* <Drive>\WEBFOLDERS\%APPSET%\%APP%\EEXCEL\INPUT SCHEDULES\ <Drive>\WEBFOLDERS\%APPSET%\%APP%\EEXCEL\INPUT SCHEDULES\WIZARD\ <Drive>\WEBFOLDERS\%APPSET%\%APP%\EEXCEL\PDBOOKS\ <Drive>\WEBFOLDERS\%APPSET%\%APP%\EEXCEL\REPORTS\ <Drive>\WEBFOLDERS\%APPSET%\%APP%\EEXCEL\REPORTS\WIZARD\ <Drive>\WEBFOLDERS\%APPSET%\%APP%\EEXCEL\REPORTS\WIZARD\HOTANALYSIS\ <Drive>\WEBFOLDERS\%APPSET%\%APP%\JOURNALS\* <Drive>\WEBFOLDERS\%APPSET%\ADMINAPP\%APP%\*.LGF <Drive>\WEBFOLDERS\%APPSET%\SYSTEMLIBRARY\LOGIC LIBRARY\*.LGF <Drive>\WEBFOLDERS\%APPSET%\ADMINAPP\LOGIC EXAMPLES\CONSOLIDATION\*.LGF
2009-12-15
PUBLIC
49/68
5 5.1
X X
X X
X X X X X
The ADMIN_DIM_CACHE also has special handling. It is always incremented in the target system to invalidate the dimension member cache when a transport is done. This is done for all dimensions.
50/68
PUBLIC
2009-12-15
5 5.1
5.1.4.21 Dimension
The object type DIME refers to a Dimension. It can be configured from transport within table UJT_TRANS_CHG via transaction SM30. This setting controls whether dimensions are imported in the target system when importing a Planning and Consolidation transport. If this is flagged to Development, all dimension changes within the application set are imported. This includes the properties assigned to dimensions. If the properties assigned to a dimension change, this triggers the removing/adding of these dimensions as navigational attributes from all associated applications within the application set. Therefore, when transporting dimensions, it is also important to transport the applications within this application set as well to ensure the attribute changes to the applications are also transported. When transporting this application with a new dimension, there are no dimension members in the target system. If an application needs to be filled by this dimension in a transport, the first member is transported from development to the target system and then the member is inserted into the application as part of the application change.
2009-12-15
PUBLIC
51/68
5 5.2
This special case allows the ApShell installation to have some sample data to load for ApShell.
In the Development to Production deployment scenario, you create and maintain an AppSet in development. All dimensions, dimension properties, and applications are created in development. A decision needs to be made for all other objects in UJT_TRANS_CHG. Typically, all objects are created in development and transported to production. The exceptions include security and teams, which typically are handled landscape by landscape. Additionally, the decision would need to be made for Workbooks (report templates and input schedules). If this is done in development, then workbooks in production would be overwritten. If this is done in production, then workbooks from development are not transported. For more information, see Workbooks [page 43].
Production Only (with Development for patch testing)
In this scenario, you work in production only. When you need to apply a patch, you transport the AppSet from Production to Development. You test the patch in Development. After the patch is validated, you apply the patch to Production.
Best Practices for Ongoing Development
Some customers have release cycles in which they are unable to transport an entire AppSet. For example, they may have a configuration that has Production support changes and another configuration on the same application or Appset that is transported at a later stage in the project cycle. In this case, you should have two AppSets in development, one for new development, and one for production support changes. When a production support change occurs, this should be done in both AppSets in development. When the cutover of new development needs to be transported, then the configuration can be moved to the production support AppSet and transported.
52/68
PUBLIC
2009-12-15
5 5.2
You can view the major and minor release number, enhancement package number, and support package number of the system by opening the About dialog box. The product version is in the following format:
R.ME.SS
Where: R is the major release number M is the minor release number E is the enhancement package number SS is the support package number
EXAMPLE
If a product version in the About dialog box reads 7.50.01, 7 is the major release number, 5 is the minor release number, 0 is the enhancement package number, and 03 is the support package number.
Patch Level
Patch levels are four digits in length. For the product and .NET assemblies, the versioning (including patch level) information is displayed in the form:
R.ME.SS.PPPP
Where R, M, E, and, SS are as above and PPPP is the patch number. You can view the patch level of a client in the registry key HKEY_LOCAL_MACHINE\SOFTWARE\OUTLOOKSOFT \50\CLIENT\PATCHVER. To check the production version, the registry key for the Admin client is HKEY_LOCAL_MACHINE \SOFTWARE\OUTLOOKSOFT\50\ADMIN\VERSION, and for the Excel client, the path is HKEY_LOCAL_MACHINE \SOFTWARE\OUTLOOKSOFT\50\CLIENT\VERSION. When you install a patch, the version of changed dlls reflects the appropriate version and patch level. For example, if you install 7.50 SP0<x>, the version of all dlls is 7.50.0<x.>.0000. If you install patch 1, the version of any changed dlls is 7.50.0<x.>.0001. The version of dlls that are not changed by a patch does not change. However, for Visual Basic 6.0 (VB6) and Planning and Consolidation 7.5, the versioning for the VB6 dlls has the format:
R.ME.NN.SSPP
Where: R is the major release number M is the minor release number E is the enhancement package number NN cannot be used SS is the support package number
2009-12-15
PUBLIC
53/68
5 5.2
PP is the patch number If no patches have been installed, the patch levels on dlls are zero.
54/68
PUBLIC
2009-12-15
6 6.1
6 Troubleshooting
You can view information on key statistics related to server performance. When you start Server Manager by selecting Start All Programs SAP Server Manager , the System Information window is displayed. You can run a server diagnostics tool that checks for the server and client prerequisites. The results are displayed on the screen when you select Server Diagnostic . In addition, the system saves a full diagnostic report to the \Server Management\osoftdiagnostic.txt file.
2009-12-15
PUBLIC
55/68
6 6.4
1. 2. 3.
Download and extract the *.rar files attached to SAP Note 1356729 from SAP Service Marketplace. Create a directory on your C:\ drive called Identify. Copy either Triserv2.rpr or Triserv_XpressServer.rpr file into the Identify folder depending on what application is needed to be monitored. Triserv2.rpr BlackBox profile that is used by the application. This profile outlines the type of process for BlackBox to monitor. This filename must match the one that is in the startservice.bat file. Triserv_XpressServer.rpr The Xpress Server profile. This filename must match the one that is in the startservice.bat file. 4. Install AppSight Black Box Service in standalone mode. 1. Run AppSight Black Box Service.exe. 2. Select Install. 3. Accept the agreement and choose Next. 4. Enter any information for username and company name and choose Next. 5. Leave the server prompt blank for standalone mode and choose Next. 6. Leave Black Box with no license option and choose Finish. 5. Copy the startservice.bat and stopservice.bat files into the Identify folder. Startservice.bat starts the application using the profile path and the naming convention for the log. Stopservice.bat stops the Blackbox application. You must stop the application before you can copy the log. 6. Run startservice.bat to begin logging. Once you start the application, the Identity folder contains an .ASLfile, which is the log that will write all the information from the application. The computer name and date are used as a variable for the naming convention. The log stays at 0 bytes until the service is stopped and only then is its actual size shown.
RECOMMENDATION
Stop and start the service at the end of each day, copy the file to another folder, and have the application create a new one. This allows you to monitor the file size.
56/68
PUBLIC
2009-12-15
6 6.6
parameters and configuration parameter changes. It is based on the data of the Configuration and Change Database (CCDB). Documentation is available to you on SAP Service Marketplace at http://service.sap.com/almtools. Navigate to SAP Solution Manager and Tools SAP Solution Manager End-to-End Root Cause Analysis , then review the E2E Change Analysis - User Guide as well as the documentation listed under Installation and Configuration.
Ensure that the latest Planning and Consolidation Clients with the E2E Trace plug-in are installed on your client machine. Introscope Workstation has been downloaded to your PC. The DotNet Agent of the Planning and Consolidation server is online. Refer to the section Verifying the DotNet Agent of the Planning and Consolidation Server is Online below for instructions. The minimum release on the SAP Solution Manager Diagnostics side for E2E Trace Analysis is Solution Manager 7.0 EhP 1 SP23.
Procedure
Generating and analyzing trace files using E2E Trace involves the following tasks, which are described below: Enable tracing in the ABAP back-end system Perform a trace in the Administration module Perform a trace in the Microsoft Excel module Manually upload the trace file to SMD if not done automatically Evaluate the trace file in SAP Solution Manager
Enable Tracing in the ABAP Back-end System (NetWeaver platform only)
1.
Enter the Root Cause Analysis work center of SAP Solution Manager.
2009-12-15
PUBLIC
57/68
6 6.6
2. 3. 4. 5. 6. 7.
Choose End-To-End Analysis. Select the query that contains all systems involved within the E2E trace and select the system ID of the Planning and Consolidation ABAP stack. Choose Trace Analysis, which opens a new window with the E2E Trace Analysis application. Select the Trace Enabling tab. Select the system ID of the Planning and Consolidation ABAP stack. Select Enable. A green icon displays besides the system ID.
1. 2. 3. 4.
5. 6. 7.
Launch the E2E Plug-In by running plugin-starter-gui.exe. Select Assign, choose OSoftAdminMain.exe, then choose Save. Select Launch, then ensure that Instrument HTTP protocol is selected and that wininet is set as the protocol. When the Admin module opens, enter the following values in the E2E Trace Plug-in user interface: 1. Enter a name for your trace in Business Transaction Name. After uploading the trace to SMD, you locate the trace by this name. 2. Set the Session Trace Level to High. 3. Enter the SMD server host. 4. Enter the SMD HTTP port. Choose Start Transaction in the E2E Trace Plug-in user interface, then choose OK to log on to the Admin module. Choose Stop Transaction in the E2E Trace Plug-In user interface to upload the transaction XML to the SMD server. In the E2E Trace application within SMD, collect the corresponding trace of the .NET server and ABAP server.
1. 2. 3. 4.
5. 6.
Launch the E2E Plug-In by running plugin-starter-gui.exe. Select Assign, choose Excel.exe, then choose Save. Select Launch, then ensure that Instrument HTTP protocol is selected and that wininet is set as the protocol. When the Admin module opens, enter the following values in the E2E Trace Plug-in user interface: 1. Enter a name for your trace in Business Transaction Name. After uploading the trace to SMD, you locate the trace by this name. 2. Set the Session Trace Level to High. 3. Enter the SMD server host. 4. Enter the SMD HTTP port. Click Log On in the Excel tool bar. Choose Start Transaction in the E2E Trace Plug-in user interface, then choose OK to log on to the Excel module.
58/68
PUBLIC
2009-12-15
6 6.6
7. 8.
Choose Stop Transaction in the E2E Trace Plug-In user interface to upload the transaction XML to the SMD server. In the E2E Trace application within SMD, collect the corresponding trace of the .NET server and ABAP server.
If you need to manually upload a trace file to SMD, perform these steps: 1. On the client machine on which you recorded the trace, expand the Manually upload section. 2. Choose Browse under Upload BusinessTransaction.xml. The file to upload appears in <trace plug-in folder>\Logs. 3. Select the BusinessTransaction.xml file and choose Upload.
Evaluation of Traces in SAP Solution Manager
1. 2. 3. 4. 5. 6.
In SAP Solution Manager, access the Root Cause Analysis work center. Choose End-To-End Analysis. Select the query that contains all systems involved within the E2E Trace and select all systems. Choose Trace Analysis to open a new window with the E2E Trace Analysis application Select the trace from the list. If you want the SMD to collect corresponding server side trace data, choose Select systems for trace collection dynamically.
NOTE
This starts trace data collection and results in a list of success or error messages. If you forgot to enable tracing or wait too long between trace recording and trace data collection (for example, more than one day), trace data may not be found. 7. Select the first step of the recorded E2E Transaction Trace and choose Display. 8. Select the Summary tab if it is not selected. 9. Select the Message table tab. 10. Expand the tray Server Analysis and choose the Request tree tab. 11. Choose Expand all to see incoming http calls, outgoing DOTNET Connector calls, and incoming RFC calls, then do one or more of the following: To view Introscope Transaction Trace data, select a line with incoming http calls, then choose Display Introscope Transaction Trace. To view ABAP Trace data, select a line with incoming RFC calls, then choose Display aggregated ABAP Trace. To view ABAP SQL Trace data, select a line with incoming RFC calls, then choose Display ABAP SQL Trace Summary.
2009-12-15
PUBLIC
59/68
6 6.7
Verifying the DotNet Agent of the Planning and Consolidation Server is Online
As a prerequisite for the automatic trace collection, make sure that the DotNet Agent of the Planning and Consolidation server is online. 1. Choose Workstation New Investigator . 2. Drill down to Super Domain and locate the hostname of the .NET server. 3. When the DotNet Agent of the Planning and Consolidation server is online, the node DotNet Process appears. 4. If the node DotNet Process does not appear, the W3WP process of the Planning and Consolidation server may have shut down. Trigger an action on the Planning and Consolidation server such as connecting the Admin Client to the server. After this, the node DotNet Process should appear.
More Information
Logging and Tracing Configuration [page 60] Log and Trace File Management (in the application help in the SAP Library at http://help.sap.com)
Configuring logging and tracing involves setting a trace level, trace user, and log level for all application sets. After you have completed your troubleshooting, you can deactivate logging and tracing. You activate this functionality by populating the application set parameters TRACELEVEL, TRACEUSER, LOGLEVEL, which are described in Application Set Parameters within the application help in the SAP Library at http://help.sap.com. You can also configure logging and tracing within the Server Manager interface by choosing Server Maintain Log/Trace Configuration . You enter the following settings: Application set the name of the application set for which you are activating tracing or logging Trace destination the path to the location where the trace file is created Trace file count the number of trace files, as in BPCtrace1.log, BPCtrace2.log,...BPCtracen.log, that the system creates before overwriting the contents of the oldest file. Default is 10. Max trace size maximum file size for each trace file. Default is 10 MB. Log destination the path to the location where the log file is created Log file count the number of log files, as in BPClog1.log, BPClog2.log,...BPClogn.log, that the system creates before overwriting the contents of the oldest log file. Default is 10. Max log size maximum file size for each log file. Default is 10 MB. Application set parameters
60/68
PUBLIC
2009-12-15
6 6.7
The settings for the logging and tracing-related application set parameters are stored in a file named log-configuration.xml within the directory <Drive>\Websrvr\Web. You can customize the path of the log-configuration.xml file. The configuration file ServerConfiguration.config, contains a node named LogTraceConfig in which you specify the path to the log-configuration.xml file. The default is <LogTraceConfig path="<Drive>\Websrvr\Web\log-configuration.xml" />. In Load Balance mode, the file log-configuration.xml can be used as a shared file to archive more than one server to a single log/trace file. By default, the log and trace file that the system creates are stored in <Drive>\Logging\Log and <Drive>\Logging\Trace, respectively. To view and analyze the log and trace files in the Log Viewer application of SAP Solution Manager Diagnostics, access SAP Solution Manager then choose Workcenter Root Cause Analysis (Transaction SOLMAN_WORKCENTER) System Analysis <SAP BPC system> Log Viewer <host> Start Log Viewer . In the Log Viewer application, select the appropriate log or trace file in the drop-down box.
NOTE
The system selection to find your <SAP BPC system> allows for searching and filtering for attributes like Installation Number, System ID (SID), or System Type. You can also define your own queries. The host selection displays all hosts when a multi-server system landscape exists.
2009-12-15
PUBLIC
61/68
This page is left blank for documents that are printed on both sides.
7 7.1
2009-12-15
PUBLIC
63/68
7 7.3
the CA Wily IS server and part of SAP Solution Manager. User-specific interaction can be traced in CA Wily IS using the Transaction Trace. Metrics, which are collected and reported through tracers defined in Probe Builder Directives .pbd files, define the information that is collected at runtime. The CA Wily IS .NET agent collects this information and reports it to the Enterprise Manager. The Enterprise Manager stores these metrics in its own database. You can view performance metrics using the IS Workstation or the IS WebView application.
Prerequisites
To enable IS for Planning and Consolidation, install and configure the CA Wily IS .NET agent on the SAP Planning and Consolidation application server hosts. For more about information about setting up and configuring CA Wily Introscope for SAP Planning and Consolidation, refer to SAP Note 1126554 as well as SAP Note 797147 and its attached FAQ document. For more information about the installation, configuration, and use of SAP Solution Manager Diagnostics, visit the SAP Service Marketplace at http://service.sap.com/diagnostics.
Procedure
1. 2. 3. 4. 5. 6.
Log on to Root Cause Analysis workcenter of SAP Solution Manager (transaction code solman_workcenter). Select System Analysis from the detail navigation menu. Choose the query that contains the SAP Planning and Consolidation system or find it in All Technical Systems. Select the SAP Planning and Consolidation system from the systems selection table. Choose CA Wily Introscope and log on to the CA Wily IS WebView. Choose Start Introscope, then log on to the Introscope WebView. Do any of the following: Select the Console tab to view Wily Dashboards. Select the Investigator tab to view the Wily Investigator tree. Select the Transaction Viewer tab to view Wily Transaction Trace.
It is not necessary to use component strings to use the support portal. However, they can reduce processing time, since their use removes the need for SAP Support to dispatch your message to the appropriate support personnel.
64/68
PUBLIC
2009-12-15
7 7.3
Area Planning and Consolidation as a whole Documentation Interface for Powerpoint Server Manager Transport
Administration: EPM-BPC-NW-ADM
Component String
EPM-BPC-NW-ADM-APP EPM-BPC-NW-ADM-DIM EPM-BPC-NW-ADM-K2 EPM-BPC-NW-ADM-SEC EPM-BPC-NW-ADM-TDL EPM-BPC-NW-ADM-WS
Area Application Management Dimension Management K2 Script Logic Security Table Driven Logic Work Status
Installation: EPM-BPC-NW-INS
Component String
EPM-BPC-NW-INS-NET EPM-BPC-NW-INS-NW
2009-12-15
PUBLIC
65/68
7 7.3
66/68
PUBLIC
2009-12-15
SAP AG Dietmar-Hopp-Allee 16 69190 Walldorf Germany T +49/18 05/34 34 34 F +49/18 05/34 34 20 www.sap.com
Copyright 2010 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.