Certification Suite BC-ILM 3.0

Transcription

1 Master Guide Certification Suite ABAP Document Version: ABAP

2 Typographic Conventions Type Style Example Example EXAMPLE Example Example <Example> EXAMPLE Description Words or characters quoted from the screen. These include field names, screen titles, pushbuttons labels, menu names, menu paths, and menu options. Textual cross-references to other documents. Emphasized words or expressions. Technical names of system objects. These include report names, program names, transaction codes, table names, and key concepts of a programming language when they are surrounded by body text, for example, SELECT and INCLUDE. Output on the screen. This includes file and directory names and their paths, messages, names of variables and parameters, source text, and names of installation, upgrade and database tools. Exact user entry. These are words or characters that you enter in the system exactly as they appear in the documentation. Variable user entry. Angle brackets indicate that you replace these words and characters with appropriate entries to make entries in the system. Keys on the keyboard, for example, F2 or ENTER SAP SE or an SAP affiliate company. All rights reserved. Typographic Conventions

3 Document History Caution Before you start the implementation, make sure that you have the latest version of this document that is available on SAP Service Marketplace at Version Date Change Initial Delivery Additional Plug-ins added Document History 2015 SAP SE or an SAP affiliate company. All rights reserved. 3

4 Table of Contents 1 Getting Started About this Document Certification Suite ABAP BC-ILM 3.0 Overview Software Units of Certification Suite ABAP BC-ILM Prerequisites Required Authorizations Certification Suite Cockpit Toolbar Left Panel (List of Plug-Ins for Execution) Right Panel (List of Available Plug-Ins) Execution Procedure Implementation Sequence Variant Creation Certification Execution Display and Analysis of Results Maintenance of Run ID BC-ILM 3.0 Certification Plug-Ins Acceptance Test Description Input Parameters and Setup Behavior Expected Results SAP ILM Storage - Simple Performance Test Description Input Parameters and Setup Behavior Expected Results SAP ILM Storage - Performance Test Loop - Small BLOBs Description Input Parameters and Setup Behavior Expected Results SAP ILM Storage - Performance Test Loop - Big BLOBs Description Input Parameters and Setup Behavior Expected results SAP SE or an SAP affiliate company. All rights reserved. Table of Contents

5 7.4 Plug-in for Testing Framework Functionality Description Input Parameters and Setup Behavior Expected Results Plug-in for Testing of Framework Functionality Description Input Parameters and Setup Behavior Expected Results Plug-in for Load Test Description Input Parameters and Setup Behavior Expected Results Plug-in for Concurrent Load Measurement Description Input Parameters and Setup Behavior Expected Results Plug-in for Store Phase Simulation Description Input Parameters and Setup Behavior Expected Results Plug-in for Store Phase Simulation (Direct) Description Input Parameters and Setup Behavior Expected Results Plug-in for Attachment Simulation Description Input Parameters and Setup Behavior Expected Results Plug-in for Attachment Simulation (Direct) Description Input Parameters and Setup Behavior Expected Results Plug-in for SAP ArchiveLink Retention Propagation Description Input Parameters and Setup Behavior Expected Results References Table of Contents 2015 SAP SE or an SAP affiliate company. All rights reserved. 5

6 SAP SE or an SAP affiliate company. All rights reserved. Getting Started

7 1 Getting Started 1.1 About this Document Purpose This guide is the central starting point for the technical implementation of Certification Suite ABAP (BC-ILM 3.0). Use this guide to get an overview of the ABAP implementation of the BC-ILM 3.0 Certification Suite. Getting Started 2015 SAP SE or an SAP affiliate company. All rights reserved. 7

8 2 Certification Suite ABAP BC-ILM 3.0 Overview Certification Suite ABAP BC-ILM 3.0 is an ABAP tool that should be able to replace all functions of the Certification Suite JAVA implemented solution in analyzing the BC_ILM 3.0 compatibility of storage solutions that claim to be ILM-aware. The designed ABAP tool consists of a framework and plug-ins (various sets of test cases) as separate units. The framework builds, executes, and evaluates the test cases. Test cases are a key part of the tool and qualified to certify the storage service. As of the creation of this document, ILM-aware storage implementation exists exclusively via WebDAV. 2.1 Software Units of Certification Suite ABAP BC-ILM 3.0 Two main reports have been delivered for interaction with the Certification Suite. ILM Store: Certification Suite Cockpit (ILM_STOR_CS_COCKPIT) Executes Certification Suite framework (available for end users to perform general storage tests scenarios) ILM Store: Test for Framework Functionality (ILM_STOR_CS_TEST) Edit and maintain test RUNIDs and results (at certification time this report is restricted and should be maintained in agreement with the SAP Integration and Certification Center (ICC) personnel) 2.2 Prerequisites Certification Suite is available for the ILM Store as of: SAP NetWeaver 7.40 SP13 SAP NetWeaver 7.50 SP01 This documentation does not cover the enablement/installation support of the SAP ILM or the Storage and Retention Service. They are expected to be available and operational. For more information, see SAP SE or an SAP affiliate company. All rights reserved. Certification Suite ABAP BC-ILM 3.0 Overview

9 2.3 Required Authorizations Authorization Object Activity Description ILM Store: Authorization for Certification Suite (SILMSTORCS) ILM Store: Authorization for Certification Suite Testers (SILMSTORCT) ILM Store: Authorization for Access (SILMSTOR) ILM Storage and Retention Service (S_ILM_SRS) Execute Maintain Read Execute Execute Execute Plug-in execution Variant maintenance Display of data Tester plug-ins are displayed in the plug-in list and during execution Execution of processing in the SAP ILM Store Execution of processing in the Storage and Retention Service Certification Suite ABAP BC-ILM 3.0 Overview 2015 SAP SE or an SAP affiliate company. All rights reserved. 9

10 3 Certification Suite Cockpit You use the transaction ILM_STOR_CS_COCKPIT. You can prepare for the certification run and actual start of certification takes place. This screen consists of three main parts: Toolbar Left Panel (List of Plug-Ins for Execution) Right Panel (List of Available Plug-Ins) 3.1 Toolbar The toolbar consists of buttons that help in certification run actions and variant preparation actions. The buttons are as follows: Execute Listed Plug-ins: Creates a background job that executes all of the plug-ins within the created variant. Once the run starts, the user is redirected to a screen that displays the certification run results. Each execution is logged and identified by a Run ID. The run ID is a unique identifier for the execution run. You cannot delete or change the results after execution through the cockpit (RILM_STOR_CS_COCKPIT). You can maintain the results only by using the report ILM Store: Test for Framework Functionality (RILM_STOR_CS_TEST). Display Run Statistics: Displays certification run results and provides search and filter functionalities for analyzing the results. Create New Variant: Creates a new variant. This button is displayed only when the existing variant is already loaded. It provides an option for creating a new variant. Choose Variant: Loads one of the existing variants stored in framework. Save Variant: Saves the variant. Variant Information: Displays information such as the variant name, description, created by, timestamp of creation, last changed by, and timestamp when changed. This button is displayed only when the existing variant is loaded. 3.2 Left Panel (List of Plug-Ins for Execution) The execution of the listed plug-ins is performed in a top-down approach. This panel displays the plug-ins that are available for execution. You can perform the following operations on the plug-ins: Move Down: Move selected plug-in down Move Up: Move selected plug-in up Move Bottom: Move selected plug-in to the end of plug-in list Move Top: Move selected plug-in to the beginning of plug-in list SAP SE or an SAP affiliate company. All rights reserved. Certification Suite Cockpit

11 Remove: Remove selected plug-in from plug-in list Remove All: Remove all plug-ins 3.3 Right Panel (List of Available Plug-Ins) This panel displays the list of available plug-ins. The list of available plug-ins contains two types of plug-ins: The Certification plug-in and the Test plug-in. For the test plug-ins, authorization SILMSTORCT is needed and is intended for the system administrator. You can perform the following operations on the plug-ins: Add Selected Plug-in: Adds selected plug-in into the Left Panel (List of Plug-Ins for Execution). You can also drag and drop the plug-ins from the right panel to the left panel. Information about Selected Plug-in: Displays information about the selected plug-in. Certification Suite Cockpit 2015 SAP SE or an SAP affiliate company. All rights reserved. 11

12 4 Execution Procedure 4.1 Implementation Sequence Step Action 1 Variant Creation 2 Certification Execution 3 Display and Analysis of Results Variant Creation Creating a test variant is a major part of initiating a certification procedure. During variant creation you need to consider an applicable scenario for the storage being used. Maintaining plug-in parameters is a core function that allows users to maintain and control the test parameters for each plug-in (each test operation). This enables date and time changes for retention control as well as allowing volume and size changes for basic and advanced load testing. All plug-ins are delivered with default values. You can enhance the parameters. This functionality is supported, and in some cases even required (retention date maintenance). The change in parameter values can result in extended processing times Certification Execution Certification execution is logged and identified by a run ID. A run ID is a unique identifier of the certification execution. When you execute the plug-ins by choosing the Execute Listed Plug-Ins button, a pop-up window shows where you can provide the run ID. Once executed, the results cannot be deleted or changed in the Certification Suite cockpit (RILM_STOR_CS_COCKPIT). You can use the report RILM_STOR_CS_TEST to maintain the results Display and Analysis of Results You can display the results by loading and executing run ID and entering Display mode. The analysis of the results is supported and made easy by green and red lights indicating the success or failure of the individual scenarios and test cases. For a user friendly analysis, the Display Run Evaluation Data window lets you filter messages by type. It also lets you expand and collapse folders by type. You can also navigate to the ILM Store's application log SAP SE or an SAP affiliate company. All rights reserved. Execution Procedure

13 5 Maintenance of Run ID Once the run ID is executed, you cannot execute it again. The results cannot be deleted or changed after execution with the Certification Cockpit (RILM_STOR_CS_COCKPIT). You can use the report RILM_STOR_CS_TEST to maintain the run ID. The use of this report is restricted to test executions of the certification report and storage performance tests. You can select a run ID and perform the following actions: Display Result Start Run Terminate Run Delete a Run ID. Maintenance of Run ID 2015 SAP SE or an SAP affiliate company. All rights reserved. 13

14 6 BC-ILM 3.0 Certification Plug-Ins 6.1 Acceptance Test Type: Certification plug-in for BC-ILM 3.0 Name: CL_ILM_STOR_CS_PLG_AT Coverage Area: This plug-in is executed using the SRS server. Required Authorizations: Authorization object Activity Description SILMSTORCS Execute Maintain Read Plug-in execution Variant maintenance Display of data SILMSTOR Execute Execution of processing in the SAP ILM Store S_ILM_SRS Execute Execution of processing in SRS server Description The plug-in tests whether the Store and Storage and Retention Service accept and support: Creation and access to collections, resources, and properties Required character set URI length Auto naming of resources Input Parameters and Setup Mandatory Parameters: Archive Store Name [ARCHIVE_STORE]: You enter the technical name of the targeted archive store. Archive store names are maintained in transaction ILMSTOREADM. Optional Parameters: Deletion Phase [DELETION_PHASE]: You use this as an indicator of the deletion phase when cleanup of residual structures (collections, resources, and properties) is executed. This parameter expects a Boolean value: X TRUE Empty field/ FALSE SAP SE or an SAP affiliate company. All rights reserved. BC-ILM 3.0 Certification Plug-Ins

15 6.1.3 Behavior One of the plug-in's tasks is to test the ability of a store to set an expiration date for collections and resources. The expiration date restricts the deletion of a bound object. The expiration date used within the plug-in has the relative value <tomorrow> so that a direct cleanup after execution of a plug-in is not possible. Therefore the plug-in has to be executed in two waves: Standard Run The parameter DELETION_PHASE is initial Deletion Run - Scheduled for the day after tomorrow (or later) the parameter DELETION_PHASE is set to X If an error occurs during a plug-in execution, cleanup is automatically triggered. The cleanup procedure is the same as that used by the deletion run. If an error occurs after an expiration date is set, the cleanup will be unsuccessful. Therefore the deletion runs always have to be scheduled Expected Results The acceptance test is passed if all function calls of the standard run phase are executed successfully. BC-ILM 3.0 Certification Plug-Ins 2015 SAP SE or an SAP affiliate company. All rights reserved. 15

16 7 7.1 SAP ILM Storage - Simple Performance Test Type: ILM Store single performance test Name: CL_ILM_STOR_CS_PLG_PF_SINGLE Coverage Area: Certification via SRS client Required Authorizations: Authorization object Activity Description SILMSTORCS Execute Maintain Read Plug-in execution Variant maintenance Display of data SILMSTORCT Execute Tester plug-ins are displayed in the plug-in list and during execution SILMSTOR Execute Execution of processing in the SAP ILM Store Description The test is focused on the basic functionality of WebDAV commands for the ILM Store. It will create the collection path, store only one resource, read the resource and finally delete it Input Parameters and Setup Mandatory Parameters: Destination [RFC_DESTINATION]: RFC destination pointing to WebDAV-service of the ILM Store Optional Parameters: BLOB size in MB [BLOB_SIZE]: Size of the BLOB that will be sent to the ILM Store. The only permitted values are 100, 200, 500, 700 and 1000 MB. The default value is 100 MB. Resource counter [ILM_STOR_CS_PARAM_NAME]: Determines the name of the stored resource with pattern res_<resource_counter>.bin. This can be any integer value, 999 being the highest number. The default value is SAP SE or an SAP affiliate company. All rights reserved.

17 7.1.3 Behavior If an error is raised in the plug-in run then deletion is executed in an emergency teardown Expected Results The test has to be finished without errors. This means all WebDAV requests have to be executed successfully. There is no time limit for test execution. 7.2 SAP ILM Storage - Performance Test Loop - Small BLOBs Type: ILM Store performance test Name: CL_ILM_STOR_CS_PLG_PF_R_SMALL Coverage Area: Certification via SRS client Required Authorizations: Authorization object Activity Description SILMSTORCS Execute Maintain Read Plug-in execution Variant maintenance Display of data SILMSTORCT Execute Tester plug-ins are displayed in the plug-in list and during execution SILMSTOR Execute Execution of processing in the SAP ILM Store Description The test is focused on the write/read performance of small resources via WebDAV to the ILM Store. It will create the collection path, write the desired count of resources, read resources, and finally delete them Input Parameters and Setup Mandatory Parameters: Destination [RFC_DESTINATION]: RFC destination pointing to the WebDAV-service of the ILM Store 2015 SAP SE or an SAP affiliate company. All rights reserved. 17

18 Optional Parameters: BLOB size in kb [BLOB_SIZE]: Size of the BLOB that will be stored in the ILM Store. The only permitted values are 100, 500 and 1024 kb. The default value is 100 kb. Number of Retries (Max. 999) [RETRIES]: Determines the number of stored resources with the pattern res_<iteration>.bin. This can be any integer value, 999 being the highest number. The default value is Behavior If an error is raised in the plug-in run then deletion is executed in an emergency teardown Expected Results The test has to be finished without errors. This means that all WebDAV requests have to be executed successfully. There is no time limit for test execution. 7.3 SAP ILM Storage - Performance Test Loop - Big BLOBs Type: ILM Store performance test Name: CL_ILM_STOR_CS_PLG_PF_R_BIG Coverage Area: Certification via SRS client Required Authorizations: Authorization object Activity Description SILMSTORCS Execute Maintain Read Plug-in execution Variant maintenance Display of data SILMSTORCT Execute Tester plug-ins are displayed in the plug-in list and during execution SILMSTOR Execute Execution of processing in the SAP ILM Store SAP SE or an SAP affiliate company. All rights reserved.

19 7.3.1 Description The test is focused on write/read performance of big resources via WebDAV to ILM Store. It will create the collection path, write the desired count of resources, read resources, and finally delete them. Running this test can consume huge amounts of memory on the application server and massively reduce the DB size for a short period of time Input Parameters and Setup Mandatory Parameters: Destination [RFC_DESTINATION]: RFC destination pointing to WebDAV-service of ILM Store Optional Parameters: BLOB size in MB [BLOB_SIZE]: The size of the BLOB that will be stored in the ILM Store. The only permitted values are 100, 250 and 500 MB. The default value is 100 MB. The setup of this value is limited by the setup of the application server memory and the maximum allowed HTTP request size on the client and ILM Store server. Number of Retries (Max. 999) [RETRIES]: Determines number of stored resources with pattern res_<iteration>.bin. This can be any integer value, 999 being the highest number. The default value is Behavior If an error is raised in the plug-in run then deletion is executed in an emergency teardown Expected results The test has to be finished without errors. This means that all WebDAV requests have to be executed successfully. There is no time limit for test execution SAP SE or an SAP affiliate company. All rights reserved. 19

20 7.4 Plug-in for Testing Framework Functionality Type: Certification Suite Framework test Name: CL_ILM_STOR_CS_PLUGIN_TEST Coverage Area: Certification Suite functionality for plug-ins Required Authorizations: Authorization object Activity Description SILMSTORCS Execute Maintain Read Plug-in execution Variant maintenance Display of data SILMSTORCT Execute Tester plug-ins are displayed in the plug-in list and during execution Description The test is focused on the validation of the functionality of the CS framework provided for plug-in runs. It tests the correct run of plug-in phases, evaluation of functionality, and message processing Input Parameters and Setup Mandatory Parameters: Simulate exception in SID [RAISE_EXCEPTION_IN]: Start ID where you simulate raising of exception. If SID doesn t exist during run then the exception will not be raised. Default value is 0. Optional Parameters: Duration of setup phase [s] [SETUP_DURATION]: This determines how long the setup phase of the plug-in should run. The default value is 1 second. Duration of execute phase [s] [EXECUTE_DURATION]: This determines how long the execute phase of the plug-in should run. The default value is 1 second. Duration of execute phase [s] [TEARDOWN_DURATION]: This determines how long the teardown phase of the plug-in should run. The default value is 1 second. Duration of emergency cleanup [s] [EMERGENCY_CLEANUP]: This determines how long the emergency cleanup of the plug-in should run. The default value is 1 second Behavior In each phase, a test of the plug-in is executed to test all possible evaluation functions of the framework SAP SE or an SAP affiliate company. All rights reserved.

21 7.4.4 Expected Results When finished, the test displays the results for each of these phases: Startup, Execution, and Teardown. There is no time limit for test execution SAP SE or an SAP affiliate company. All rights reserved. 21

22 SAP SE or an SAP affiliate company. All rights reserved.

23 7.5 Plug-in for Testing of Framework Functionality 2 Type: Certification Suite Framework test Name: CL_ILM_STOR_CS_PLUGIN_TEST2 Coverage Area: Certification Suite result view functionality Required Authorizations: Authorization object Activity Description SILMSTORCS Execute Maintain Read Plug-in execution Variant maintenance Display of data SILMSTORCT Execute Tester plug-ins are displayed in plug-in list and during execution Description The test is focused on the validation of the Certification Suite's result view. It tests the correct representation of messages in the result tree Input Parameters and Setup Optional Parameters: Simulate exception in SID [RAISE_EXCEPTION_IN]: Start ID where you simulate raising of exception. If the SID doesn t exist during the run then the exception will not be raised. The default value is 0. Number of result repetitions [TEST_CASE_COUNT]: Number indicates how many times the test with all possible results should be repeated. The default value is Behavior In each phase, a test of the plug-in is executed to test all possible output results of the CS framework Expected Results The test has to be finished without errors. There is no time limit for test execution SAP SE or an SAP affiliate company. All rights reserved. 23

24 7.6 Plug-in for Load Test Type: Certification Suite Framework test Name: CL CL_ILM_STOR_CS_PLG_LT Coverage Area: Certification Suite result view functionality Required Authorizations: Authorization object Activity Description SILMSTORCS Execute Maintain Read Plug-in execution Variant maintenance Display of data SILMSTOR Execute Execution of processing in the SAP ILM Store S_ILM_SRS Execute Execution of processing in SRS server SAP SE or an SAP affiliate company. All rights reserved.

25 7.6.1 Description The plug-in tests if the Store and SRS can handle big load of data in appropriate time. You can test the following waves of data load: One time 500 MB resource times 100KB resource times 100KB resource Note: Each resource is deleted right after it has been written to ILM Store by PUT method. Only duration of the write operation is measured. Every test deletes its collection after the PUT method has been executed (delayed by 30sec) Input Parameters and Setup Mandatory Parameter: Archive Store Name [ARCHIVE_STORE]: Indicates technical name of targeted archive store. Archive store names are maintained in the transaction ILMSTOREADM Behavior Each time the plugin is executed a cleanup function is triggered. The plugin expects that there are no residual structures from a previous plugin execution otherwise it ends with an error. If an error occurs during a plugin execution cleanup is automatically triggered Expected Results The acceptance test is passed if all function calls of the plugin run are executed successfully and also the test cases are finished within the following time ranges: One time 500 MB resource is executed in one minute times 100KB resource is executed in 10 minutes times 100KB resource is executed in 100 minutes 7.7 Plug-in for Concurrent Load Measurement Type: Certification Suite Framework test 2015 SAP SE or an SAP affiliate company. All rights reserved. 25

26 Name: CL CL_ILM_STOR_CS_PLG_CLM Coverage Area: Certification Suite result view functionality Required Authorizations: Authorization object Activity Description SILMSTORCS Execute Maintain Read Plug-in execution Variant maintenance Display of data SILMSTOR Execute Execution of processing in the SAP ILM Store Description This plug-in is executed using the SRS client. The plugin tests if the archive store can assure an appropriate data throughput. It executes the tasks and iterations in parallel Input Parameters and Setup Mandatory Parameter: RFC Destination [RFC_DESTINATION]: RFC destination pointing to the WebDAV-service of the ILM Store. Concurrent Tasks [CONCURRENT_TASKS]: Number of concurrent tasks Iterations [ITERATIONS]: Number of iterations per operation PUT, GET and DELETE Content Size [kb] [CONTENT_SIZE]: The size of the content in kilobytes that is written into a Store by each PUT operation Behavior After each plugin run a cleanup function is triggered. The plugin expects that there are no residual structures from a previous plugin run otherwise it ends with an error. If an error occurs during a plugin execution cleanup is automatically triggered. Recommendation: You need to consider the available system resources prior to execution and schedule your execution for a time when the base load is low or maintain your configuration accordingly to enable higher workload as needed. For example, check the available number of maximum background jobs SAP SE or an SAP affiliate company. All rights reserved.

27 7.7.4 Expected Results The KPI is the time it takes for each operation (for example, PUT or GET / GET RANGE) averaged across all tasks. The mandatory KPI in this case for each operation is 10 MB/second. 7.8 Plug-in for Store Phase Simulation Type: Certification Suite Framework test Name: CL CL_ILM_STOR_CS_PLG_SPS Coverage Area: Certification Suite result view functionality Required Authorizations: Authorization object Activity Description SILMSTORCS Execute Maintain Read Plug-in execution Variant maintenance Display of data SILMSTOR Execute Execution of processing in the SAP ILM Store S_ILM_SRS Execute Execution of processing in SRS server Description This plug-in is executed using the SRS server. This is a simulation of the ILM store phase to evaluate how long a predefined store process for archiving files would take. The test runs follow this sequence: To create collections and resources To set the ILM properties (for example, expiration dates) on the created collections Input Parameters and Setup Mandatory Parameter: Archive Store Name [ARCHIVE_STORE]: You enter the technical name of the targeted archive 2015 SAP SE or an SAP affiliate company. All rights reserved. 27

28 store. Archive store names are maintained in transaction ILMSTOREADM. Optional Parameters: Deletion Phase [DELETION_PHASE]: You use this as an indicator of the deletion phase when cleanup of residual structures (collections, resources, and properties) is executed. This parameter expects a Boolean value: X TRUE SPACE - FALSE Empty field/ FALSE Behavior One of the plug-in's tasks is to test the ability of a store to set an expiration date for collections and resources. The expiration date restricts the deletion of a bound object. The expiration date used within the plug-in has the relative value <tomorrow> so that a direct cleanup after execution of a plug-in is not possible. Therefore the plug-in has to be executed in two waves: Standard Run The parameter DELETION_PHASE is initial Deletion Run - Scheduled for the day after tomorrow (or later) the parameter DELETION_PHASE is set to X If an error occurs during a plug-in execution, cleanup is automatically triggered. The cleanup procedure is the same as that used by the deletion run. If an error occurs after an expiration date is set, the cleanup will be unsuccessful. Therefore the deletion runs always have to be scheduled Expected Results The mandatory KPI for the entire process is 5 seconds. 7.9 Plug-in for Store Phase Simulation (Direct) Type: Certification Suite Framework test Name: CL CL_ILM_STOR_CS_PLG_SPS_DIRECT Coverage Area: Certification Suite result view functionality SAP SE or an SAP affiliate company. All rights reserved.

29 Required Authorizations: Authorization object Activity Description SILMSTORCS Execute Maintain Read Plug-in execution Variant maintenance Display of data SILMSTOR Execute Execution of processing in the SAP ILM Store S_ILM_SRS Execute Execution of processing in SRS server Description This plug-in is executed using the SRS server. This is a simulation of the ILM store phase to evaluate how long a predefined store process for archiving files would take. The test runs follow this sequence: To create collections and resources To set the ILM properties (for example, expiration dates) on the created collections Note: The test is directly executed on the store bypassing SRS Input Parameters and Setup Mandatory Parameters: RFC Destination [RFC_DESTINATION]: RFC destination pointing to WebDAV-service of the Store. Optional Parameters: Deletion Phase [DELETION_PHASE]: You use this as an indicator of the deletion phase when cleanup of residual structures (collections, resources, and properties) is executed. This parameter expects a Boolean value: X TRUE SPACE - FALSE Empty field/ FALSE 2015 SAP SE or an SAP affiliate company. All rights reserved. 29

30 7.9.3 Behavior User can test the ability of a store to set an expiration date for collections and resources. The expiration date restricts the deletion of a bound object. The expiration date used within the plugin has the relative value <tomorrow> so that a direct cleanup after execution of a plug-in is not possible. Therefore the plug-in has to be executed in two waves: Standard Run The parameter DELETION_PHASE is initial Deletion Run - Scheduled for the day after tomorrow (or later) the parameter DELETION_PHASE is set to X If an error occurs during a plug-in execution, cleanup is automatically triggered. The cleanup procedure is the same as that used by the deletion run. If an error occurs after an expiration date is set, the cleanup will be unsuccessful. Therefore the deletion runs always have to be scheduled Expected Results The mandatory KPI for the entire process is 5 seconds Plug-in for Attachment Simulation Type: Certification Suite Framework test Name: CL CL_ILM_STOR_CS_PLG_AS Coverage Area: Certification Suite result view functionality Required Authorizations: Authorization object Activity Description SILMSTORCS Execute Maintain Read Plug-in execution Variant maintenance Display of data SILMSTOR Execute Execution of processing in the SAP ILM Store S_ILM_SRS Execute Execution of processing in SRS server SAP SE or an SAP affiliate company. All rights reserved.

31 Description This plug-in is executed using the SRS server. It simulates the retention propagation process for attachments. The test runs follow this sequence: To create collections and resources To set the ILM properties (for example, al* properties) on the created resources Note: The actual propagation of the retention to archive link documents is not considered because based on the certification specification, retention constraint cannot be applied to a physical archive Link document when the reference is not valid. The test provides the value for the property al_doc_id, which does not point to any actual document Input Parameters and Setup Mandatory Parameters: Archive Store Name [ARCHIVE_STORE]: Indicates the technical name of targeted archive store. Archive store names are maintained in transaction ILMSTOREADM. Optional Parameters: Deletion Phase [DELETION_PHASE]: You use this as an indicator of the deletion phase when cleanup of residual structures (collections, resources, and properties) is executed. This parameter expects a Boolean value: X TRUE SPACE - FALSE Empty field/ FALSE Behavior One of the plug-in's tasks is to test the ability of a store to set an expiration date for collections and resources. The expiration date restricts the deletion of a bound object. The expiration date used within the plug-in has the relative value <tomorrow> so that a direct cleanup after execution of a plug-in is not possible. Therefore the plug-in has to be executed in two waves: Standard Run The parameter DELETION_PHASE is initial Deletion Run - Scheduled for the day after tomorrow (or later) the parameter DELETION_PHASE is set to X If an error occurs during a plug-in execution, cleanup is automatically triggered. The cleanup procedure is the same as that used by the deletion run. If an error occurs after an expiration date is set, the cleanup will be unsuccessful. Therefore the deletion runs always have to be scheduled 2015 SAP SE or an SAP affiliate company. All rights reserved. 31

32 Expected Results The mandatory KPI for the entire process is 10 seconds Plug-in for Attachment Simulation (Direct) Type: Certification Suite Framework test Name: CL CL_ILM_STOR_CS_PLG_AS_DIRECT Coverage Area: Certification Suite result view functionality Required Authorizations: Authorization object Activity Description SILMSTORCS Execute Maintain Read Plug-in execution Variant maintenance Display of data SILMSTOR Execute Execution of processing in the SAP ILM Store S_ILM_SRS Execute Execution of processing in SRS server Description This plug-in is executed using the SRS server. This is a simulation of the ILM store phase to evaluate how long a predefined store process for archiving files would take. The test runs follow this sequence: To create collections and resources To set the ILM properties (for example, expiration dates) on the created collections Note: The test is directly executed on the store bypassing SRS. The actual propagation of the retention to ArchiveLink documents is not considered, because, based on the certification specification, retention constraint cannot be applied to a physical archive link document when the reference is not valid. The test provides the value for the property al_doc_id, which does not point to any actual document SAP SE or an SAP affiliate company. All rights reserved.

33 Input Parameters and Setup Mandatory Parameters: RFC Destination [RFC_DESTINATION]: RFC destination pointing to WebDAV-service of the Store. Optional Parameters: Deletion Phase [DELETION_PHASE]: You use this as an indicator of the deletion phase when cleanup of residual structures (collections, resources, and properties) is executed. This parameter expects a Boolean value: X TRUE SPACE - FALSE Empty field/ FALSE Behavior One of the plug-in's tasks is to test the ability of a store to set an expiration date for collections and resources. The expiration date restricts the deletion of a bound object. The expiration date used within the plug-in has the relative value <today> so that a direct cleanup after execution of a plug-in is not possible. Therefore the plug-in has to be executed in two waves: Standard Run The parameter DELETION_PHASE is initial Deletion Run - Scheduled for the next day (or later) the parameter DELETION_PHASE is set to X If an error occurs during a plug-in execution, cleanup is automatically triggered. The cleanup procedure is the same as that used by the deletion run. If an error occurs after an expiration date is set, the cleanup will be unsuccessful. Therefore the deletion runs always have to be scheduled Expected Results The mandatory KPI for the entire process is 10 seconds Plug-in for SAP ArchiveLink Retention Propagation Type: Certification Suite Framework test Name: CL CL_ILM_STOR_CS_PLG_RP Coverage Area: Certification Suite result view functionality 2015 SAP SE or an SAP affiliate company. All rights reserved. 33

34 Required Authorizations: Authorization object Activity Description SILMSTORCS Execute Maintain Read Plug-in execution Variant maintenance Display of data SILMSTOR Execute Execution of processing in the SAP ILM Store S_ILM_SRS Execute Execution of processing in SRS server Description This plug-in is executed using the SRS server. You can use this to test the enforcement of archive link retention requirements. The test consists of two test cases: ILM Retention Management scenario System decommissioning scenario Input Parameters and Setup Mandatory Parameters: Archive Store Name [ARCHIVE_STORE]: Indicates the technical name of targeted archive store. Archive store names are maintained in transaction ILMSTOREADM. Content repository [AL_CREP_ID]: Content Repository ID. The IDs are maintained using the transaction OAC0. SAP ArchiveLink: System ID [AL_SID]: ID of a system where the specified content repository ID is registered. SAP ArchiveLink: Document ID for _1.bin [AL_DOC_ID_1] SAP ArchiveLink: Object ID for _1.bin [AL_OBJ_ID_1] SAP ArchiveLink: Document ID for _2.bin [AL_DOC_ID_2] SAP ArchiveLink: Object ID for _2.bin [AL_OBJ_ID_2] Optional Parameters: Decommissioning Scenario Indicator (yes = X ) [DECOMISSIONING] Phase [PHASE]: This indicates the type of an execution phase type. This parameter expects one of the following values: o S Standard phase: Standard execution of selected scenario SAP SE or an SAP affiliate company. All rights reserved.

35 o L Legal hold lifting phase: Legal hold that is set during the standard phase ( S ) is lifted. It is important to specify an URI of the target resource _1.bin. The target URI can be found within evaluation results of the standard phase. o D Deletion phase: Cleanup of residual structures (collections, resources and properties) URI [URI]: Allows you to specify an URI of a collection or a resource which is required for the legal hold lifting phase. Environmental prerequisites SAP system with SAP NetWeaver 7.40 SPS 13/ 7.50 SPS 01 or higher Application Server ABAP Storage system with SAP Archive Link-Interface BC-HCS 6.20 and WebDAV-Interface BC-ILM 3.0. Content Repository of type HTTP Content Server that is customized in the SAP system so that it can be used to store Archive Link documents in your storage system (from here on known as ZK) Behavior The ILM Retention Management scenario and System Decommissioning scenarios require manual preparation steps. The outcome of the preparation phase is a structure of collections and resources with setup properties for retention enforcement. One of the plug-in's tasks is to test the ability of a store to set an expiration date for collections and resources. The expiration date restricts the deletion of a bound object. The expiration date used within the plug-in has the relative value <tomorrow> so that a direct cleanup after execution of a plug-in is not possible. Therefore the plug-in has to be executed in two waves: Standard Run The parameter PHASE is set to 'S'. Legal Hold Lifting Run - The parameter PHASE is set to 'L'. Deletion Run - Scheduled for the day after tomorrow The parameter PHASE is set to D If an error occurs during a plug-in execution, cleanup is automatically triggered. The cleanup procedure is the same as that used by the deletion run. If an error occurs after an expiration date is set, the cleanup will be unsuccessful. Therefore the deletion runs always have to be scheduled Expected Results No collection / resource can be deleted while it has assigned a valid retention policy (expiration date or legal hold) SAP SE or an SAP affiliate company. All rights reserved. 35

36 8 References References The following table lists all of the documents mentioned in this Master Guide. Title WebDAV Storage Interface for SAP NetWeaver Information Lifecycle Management - (BC-ILM) ILM Store Help portal documentation ILM Store Business Function Documentation SAP SE or an SAP affiliate company. All rights reserved. References

37

38 SAP SE or an SAP affiliate company. 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 SE or an SAP affiliate company SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP SE (or an SAP affiliate company) in Germany and other countries. All other product and service names mentioned are the trademarks of their respective companies. Please see for additional trademark information and notices. Material Number: