Process Archiving using NetWeaver Business Process Management
Applies to: NetWeaver Composition Environment 7.2, 7.3. For more information, visit the Business Process Modeling homepage.
Summary This document describes how process instances can be archiving using the archiving services provided by SAP NetWeaver Java Platform. Author:
Chembrakalathil Venugopal
Company: SAP AG Created on: 10 January 2010
Author Bio Chembrakalathil Venugopal has experience in various SAP NetWeaver CE technologies and working closely with SAP NetWeaver CE customers.
SAP COMMUNITY NETWORK © 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com 1
Process Archiving using NetWeaver Business Process Management
Table of Contents Process Archiving ............................................................................................................................................... 3 Configuration of Archive Store ............................................................................................................................ 3 Defining Roles ................................................................................................................................................. 3 Configure Destination...................................................................................................................................... 3 Configure Archive Destination using XML DAS Administration ...................................................................... 6 Archiving Process Instances to a remote J2EE system. .................................................................................... 7 Archiving Process Instances using NWA Java archiving cockpit ....................................................................... 7 Accessing the archived process instances from NWA ..................................................................................... 10 Scheduling Archiving ........................................................................................................................................ 11 Related Content ................................................................................................................................................ 15 Copyright........................................................................................................................................................... 16
SAP COMMUNITY NETWORK © 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com 2
Process Archiving using NetWeaver Business Process Management
Process Archiving This document describes how process instances can be archived using Net weaver Composition Environment 7.2 and 7.3. It provides a description about how to schedule process archiving in order to automate the archiving. Archiving process instances help to remove the process instances which are completed and no more required by the business. All process instances which are marked for archiving will be taken out from the database and archived to a location as configured by the administrator. This include the process, task and business log related content from the Database. Process archiving frequency depends on many factors. 1. Number of process instances and task instances started in a day. 2. Duration of a process instance 3. Number of users assigned to a task role. If there is a UME role/ group assignment, number of uses assigned to this role/group. In BPM process archiving has two phases. 1. Retrieval of the process instances from the Database and persist the instances in the destination. 2. Deletion of the archived process instances from the Database. Process archiving improves the overall performance of the system. It keeps the database with active process instances and reduces the data base size. Net weaver BPM process archiving uses NetWeaver XML DAS framework for archiving. Archiving requires specific roles for the user. An administrator with required roles needs to configure the destinations using the XML DAS Administration. http://help.sap.com/saphelp_nwce72/helpdata/en/cf/b2fc3f48ecc742e10000000a1550b0/content.htm Archiving requires a onetime configuration step and regular archiving of the process instances.
Configuration of Archive Store Defining Roles Assign the following roles using NWA->Identity Management
SAP_ARCH_XMLDAS_VIEW;
SAP_ARCH_SUPERADMIN;
XMLDASSecurityRole;
NWA_SuperAdmin
Configure Destination Goto Configurations->Security->Destinations Configure the destination by providing connection information. The destination URL points to the J2EE instance where the archived process instances will be persisted. Once configured, changes in the destination URL require an engine restart to archive the process instances to the new destination. It is possible to archive the process instance to another J2EE system as destination system and retrieve the archived instances thru NWA from both the systems. The customer has to deploy the process model in the target system to view the archived instances using NWA session from the destination system.
SAP COMMUNITY NETWORK © 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com 3
Process Archiving using NetWeaver Business Process Management
SAP COMMUNITY NETWORK © 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com 4
Process Archiving using NetWeaver Business Process Management
Ping the destination to make sure that the destination connection is correct.
SAP COMMUNITY NETWORK © 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com 5
Process Archiving using NetWeaver Business Process Management
Configure Archive Destination using XML DAS Administration Go To Operation Management Data and Databases XML DAS Administration (ignore warning about SLD if you do not SLD) Define a new archive store Select the storage type as File system Provide the windows root which is the directory where process instances will be archived. Save and test the archive store using the Test Selected button
Assign the newly created archive store to the standard NetWeaver BPM archive path bpm_proc. In the archiving path properties will have archive path as /sys_id/bpm_proc/. The sys_id is a configurable property (AHome) and by default it will be system name. This property need to modify only if the archiving location is a remote J2EE system.
If archive paths are missing in this step do an additional step. Go to Java Archiving Cockpit and go to the Hierarchy tab. Select the Archiving set bpm_proc .
SAP COMMUNITY NETWORK © 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com 6
Process Archiving using NetWeaver Business Process Management
Archiving Process Instances to a remote J2EE system. Process instances can be archived to a remote system and viewed the archived instances from the remote system using NWA. In this scenario the client system contains both process definition and the process instances. The Server system which is the archiving destination contains the process model. Deploy the process model both in the client and server system. Perform steps described in section 2.1 and 2.2 in both client and server systems. Make sure the client system destination URL points to the server system. Perform section 2.3 in the server system where the process instances need to be archived and persisted.
Define the sys_id using the configuration property AHome.
Archiving Process Instances using NWA Java archiving cockpit Go to Manage Processes->Process Instances view Select the process instances which should be archived and click on archive
By default the Path extension will be the current date. But this can be changed. The Process ID list contains the process id of the selected process instances. The check box Start Delete phase automatically determines the deletion of the process instances from the memory. If this is unchecked the process instances will be only retrieved and persisted in the destination, but not deleted from the Database.
SAP COMMUNITY NETWORK © 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com 7
Process Archiving using NetWeaver Business Process Management
Click on Start Write Session button.
The archiving monitor will provide the status and the logs of the current archiving session.
The process instances are archived at the destination.
SAP COMMUNITY NETWORK © 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com 8
Process Archiving using NetWeaver Business Process Management
SAP COMMUNITY NETWORK © 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com 9
Process Archiving using NetWeaver Business Process Management
Accessing the archived process instances from NWA Go to the Manage Processes:Process Instances Click on the advanced link and navigate to the advanced search view. Select the value Archived from the dropdown
In the above search result the status Archived shows that the process instance is in archived state.
SAP COMMUNITY NETWORK © 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com 10
Process Archiving using NetWeaver Business Process Management
Scheduling Archiving A job can be scheduled to have a regular archiving session. This can be configured the following steps. Goto NWA Operation management->Java Scheduler->Tasks
Create a new task and select the job name as bpm_proc_write
SAP COMMUNITY NETWORK © 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com 11
Process Archiving using NetWeaver Business Process Management
Set the task parameters. Refer http://help.sap.com/saphelp_nwce72/helpdata/en/45/37367971534c2ee10000000a1553f6/frameset.htm
SAP COMMUNITY NETWORK © 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com 12
Process Archiving using NetWeaver Business Process Management
Note that if you don’t check the auto_deletephase , then the process instance will not be deleted from the Database.
Add the start and end time and the frequency at which archiving should be scheduled.
SAP COMMUNITY NETWORK © 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com 13
Process Archiving using NetWeaver Business Process Management
SAP COMMUNITY NETWORK © 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com 14
Process Archiving using NetWeaver Business Process Management
Related Content For more information, visit the Business Process Modeling homepage.
SAP COMMUNITY NETWORK © 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com 15
Process Archiving using NetWeaver Business Process Management
Copyright © 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, Excel, Outlook, and PowerPoint are registered trademarks of Microsoft Corporation. IBM, DB2, DB2 Universal Database, System i, System i5, System p, System p5, System x, System z, System z10, System z9, z10, z9, iSeries, pSeries, xSeries, zSeries, eServer, z/VM, z/OS, i5/OS, S/390, OS/390, OS/400, AS/400, S/390 Parallel Enterprise Server, PowerVM, Power Architecture, POWER6+, POWER6, POWER5+, POWER5, POWER, OpenPower, PowerPC, BatchPipes, BladeCenter, System Storage, GPFS, HACMP, RETAIN, DB2 Connect, RACF, Redbooks, OS/2, Parallel Sysplex, MVS/ESA, AIX, Intelligent Miner, WebSphere, Netfinity, Tivoli and Informix are trademarks or registered trademarks of IBM Corporation. Linux is the registered trademark of Linus Torvalds in the U.S. and other countries. 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. SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP Business ByDesign, 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 other countries. Business Objects and the Business Objects logo, BusinessObjects, Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius, and other Business Objects products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of Business Objects S.A. in the United States and in other countries. Business Objects is an SAP company. 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.
SAP COMMUNITY NETWORK © 2010 SAP AG
SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com 16