CODE EXTRACTION TOOL

SETUP GUIDE
Version: 4.10 March 2012

TABLE OF CONTENTS
Introduction ................................................................................................... 2 Getting Support ............................................................................................... 2 Prerequisites .................................................................................................. 2 Setup Procedure .............................................................................................. 2 Step 1 Download and Install Panaya Code Extraction Tool.......................................... 3 Step 2 Defining RFC Connection to Production System .............................................. 6 Step 3 Extracting the Custom Code and Usage Data ................................................. 9 Step 4 Uploading Results to Panaya Web site ........................................................ 11 What Happens Now?......................................................................................... 13 Appendix A How to Install ABAP program ............................................................. 14 Frequently Asked Questions ............................................................................... 15

Important Notice This document is subject to the following conditions and restrictions: This functional description contains proprietary information belonging to Panaya Ltd. No part of its contents may be used for any other purpose, disclosed to any person or firm or reproduced by any means, electronic or mechanical, without the explicit prior written permission of Panaya Ltd. The text and graphics are for the purpose of illustration and reference only. The specifications on which they are based are subject to change without notice. Information in this functional description is subject to change without notice. Company names, brand products and service names are trademarks or registered trademarks of their respective holders. Copyright 2012 Panaya Ltd. All rights reserved.

-1-

INTRODUCTION
Panaya solution requires an installation of software component on your SAP systems. This software component performs the following tasks: Extraction of custom developed ABAP code. Identification and extraction of used transactions - finding out which transactions are used in your production system.

GETTING SUPPORT
The installation process was designed with simplicity and ease in mind. However, if you require assistance, please contact Panaya support at support@panayainc.com.

PREREQUISITES
Before starting the installation process, make sure you have the following privileges: 1. Access to your SAP Development QA and Production system 2. User with development permissions allowed to: a. Display SAP standard program source code b. Creating and executing programs using RFC to Production system (required RFC permissions described in Step 2) c. Running jobs 3. A Panaya user name and password. 4. Internet Explorer browser versions 6, 7 & 8.

SETUP PROCEDURE
The setup procedure consists of following steps: 1. Download and install Panaya code extraction tool from Panaya web site. 2. Execute the program on your SAP system. 3. Uploading the result (XML file) to Panaya web site.

-2-

STEP 1 DOWNLOAD AND INSTALL PANAYA CODE EXTRACTION TOOL

In this step you will download and install Panayas ABAP code extraction tool on your SAP system. The code extraction tool reads the repository objects locally and extracts customer developed objects from the system it runs on. The program also uses an RFC connection to extract current usage statistics from the production system.

Choosing the right system to extract your custom objects Panaya analysis is based on custom objects extracted from your system. Because we are extracting the custom developed objects only from one instance. In most cases, there are differences between objects in the development system and the production system. Please choose the system that is best representing your needs for analysis. Should you require assistance defining from which system in your landscape you should extract the custom code, our support team will be happy to any questions you may have. Please contact our support team at: support@panayainc.com Download Panaya Code extraction tool 1. Login to Panaya website at https://my.panayainc.com 2. Enter your login details. Make sure you use your registered e-mail address as a user ame & the password you received from Panaya. 3. Click the System Setup tab

-3-

4. From the Select System dropdown list, select the desired system.

5. Click on the Code Extraction Tool link.

-4-

6. Choose the appropriate source code by pressing on the radio button beside the SAP version currently implemented. Notice it takes time for the ABAP code to get populated before you copy it to your clipboard. Use the busy mouse cursor as an indication to when the code had finished its population.

SAP Version

ABAP Source Code

7. Select the source code presented in the screen to your SAP system and press the Copy to Clipboard button. 8. Save it under a new program name ZPANAYA_EXTRACT_PROG_LIB as executable program. 9. Save the program in a change request, should you need to execute it on other systems like QA or Production. Detailed instruction on how to create executable program in SAP system can be found in Appendix A.

-5-

STEP 2 DEFINING RFC CONNECTION TO PRODUCTION SYSTEM

In this step you will define RFC connection to your Production system. This connection is needed to extract usage statistics information. You should always use RFC connection when running Panays code extraction tool, even if you choose to execute the program directly on your Production system. Defining RFC Connection 1. Start transaction SM59 (configuration of RFC connection). 2. Press the create button in the upper tool bar. 3. In the new window fill the following values:

Field
RFC Destination Connection Type Description 1 PANAYA_PRD 3 (ABAP connection) PANAYA_PRD

Value

4. Under the Technical Setting tab, fill the following values:

Field
Target Host System Number

Value
Type your PRD system host name or number Your PRD system number

-6-

5. Under the Logon & Security setting tab, fill the following values:

Field
Language Client Type User & Password

Value
English (EN) PRD client number System user name and password

6. Test youre connection by pressing the Connection Test button. 7. Test the validity of the user you defined by pressing the Remote Logon button. Important Note: When running Panayas code extraction tool, there may be cases in which the user you choose for the RFC connection will not have all the required permissions to extract the necessary data.

-7-

The authorizations required for the RFC user Object S_RFC (Authorization Check for RFC Access): RFC_TYPE (type of RFC object to be protected) FUGR RFC_NAME (name of RFC to be protected) SDTX, STUW, 'BDCH', SRTT, SRFC, THFB,SIFP ACTVT (Activity) 16 Object S_TABU_DIS (Table Maintenance via standard tools such as SM30): DICBERCLS (Authorization Group) = PC, SS, SC, SA,&NC& ACTVT (Activity) = 3 Object S_DEVELOP (ABAP Workbench): ACTVT (Activity) = 3 DEVCLASS (Development class for Transport) =* OBJNAME (Object name) = * OBJTYPE (Object type) =* P_GROUP (Authorization group ABAP/4 program) = *

-8-

STEP 3 EXTRACTING THE CUSTOM CODE AND USAGE DATA

In this step you will use the program ZPANAYA_EXTRACT_PROG_LIB to extract the custom developed objects from your SAP system and usage statistics information. Extracting Custom Objects 1. 2. 3. 4. Login to the system you choose to run Panayas code extraction tool. Start transaction SE38. Type the program name ZPANAYA_EXTRACT_PROG_LIB and press the execute button (F8). In the selection screen, choose the Foreground option (automatically marked).

5. Open the file path screen and select the destination on the client machine in which the custom code file will be saved. 6. The suffix of the file needs to be .xml. 7. Choose the RFC PANAYA_PRD that was defined in step 2. 8. The period for extracting the usage transaction data is automatically defined inside the program and will extract one year back (if the data exist in the production system). 9. Leave the Usage Only check box unchecked. 10. Run the program by pressing the execute button (F8).

Please note: 1. The program normally runs between 45 minutes to two hours, depending on the extent of custom objects developed in your system. 2. If running in foreground mode is not possible (e.g. receive a timeout message), you can choose the background mode. This will save the file on the SAP application server in the designated path.

-9-

To Run the Process in Background Mode Choose 1. 2. 3. 4. Define the directory, in which the file will be saved. Prepare 3GB of free space. Press the Background option in the selection screen. Enter the directory path. Choose from the menu: Program > execute in backgroundand create immediate job (you can review the job processed in SM37)

Extracting Only Usage Statistics Data By using the Usage only mode, the program enables to extract ONLY usage statistics data without extracting other custom developed objects. For extracting only usage date, the program can be executed on any of the existing SAP systems in the landscape but always require an RFC connection to the system were the require data exists (Normally the Production system). This process should be performed by special request and not as regular code extraction process. For any questions you may have, please contact Panaya support at: support@panayainc.com 1. 2. 3. 4. Set the program to be executed in foreground or background mode. Define RFC connection to the production system (or other system). Mark the Usage Only check box. Execute the program.

- 10 -

STEP 4 UPLOADING RESULTS TO PANAYA WEB SITE

In this step you will upload the output file created in step 3 to Panaya web site. Important note: all information you upload to Panaya via its web site is encrypted using SSL technology. More information about Panaya security can found at http://www.panayainc.com/Products-Technology/SecurityPrivacy.html 1. Compress the file that you saved from step 3 into a Zip archive file (please use standard ZIP format and not any other formats). 2. Enter your account at Panaya web site at https://my.panayainc.com 3. Click on the System Setup tab.

4. From the Select System dropdown list, select the desired system.

- 11 -

5. Press the Upload custom code link.

6. The Upload Custom Code File screen displays table with lists of projects.

- 12 -

The left column displays the currently active projects that will be affected by the custom code to be uploaded. The right column displays the projects that will not be affected. Make sure to consult the project managers that their projects are potentially affected before you upload the code extraction results. 7. In the upload page, press the Browse button and select the Zipped file that you created for the custom code. 8. Click the Continue button. The upload process takes time to complete and is transferred to Panaya through FTP.

9. After the file is uploaded successfully to Panaya, you should receive a confirmation message with a ticket number.

WHAT HAPPENS NOW?

After performing steps 1-4, Panaya start analyzing your company custom code and inform you when the results are ready to be used. The results should be available to you in 48 hours or less. For any questions or problems please contact our support team at: support@panayainc.com

Panaya Support Team

- 13 -

APPENDIX A HOW TO INSTALL ABAP PROGRAM

To install the above program, login to your SAP development system and perform the following steps: Creating new development class Create 1. 2. 3. 4. 5. a new Development class for Panaya ABAP program: Start Transaction SE80 Choose in the drop-down menu window the object type Development class/ Package. Type the Development class/package name ZPANAYA and press Enter. Press Yes to create a new development class/package. Choose a transport layer and press Save.

To create Executable ABAP program, follow the procedure below: 1. 2. 3. 4. Start transaction SE38. Type the program name in the "Program" field and press "Create". Enter the program name as "Title", set the "Type" as "Executable program" and press Enter or "Save". When prompted for Development class/package, choose the Development class/package ZPANAYA and press Save. 5. If prompted for change request enter a workbench change request or create one. 6. Press the button above the editor or choose from the menu: Utilities > More Utilities > Upload/Download > Upload 7. Choose the appropriate text file that you saved and press "Open". 8. Activate the program by pressing the button or choose from the menu Program > Activate.

- 14 -

FREQUENTLY ASKED QUESTIONS

1. Question: I have security concerns about what the Panaya program might extract from my system. Answer: The Panaya extraction tool extracts only technical objects; it does not extract any customer or transactional data (orders, accounts, financial, records. etc.). The objects that the program extracts are: development class, function groups, transactions, custom developed programs, data elements, table types, user exits and modifications. In addition, Panaya uses an RFC connection to your production system to extract usage statistics information (transactions, RFC) that is only available in the production system. This information is extracted from the performance workload monitor reports (Transaction ST03N). This process is NOT a system copy; it is only an extraction of technical objects that allows Panaya to simulate your system structure, without the need to have a direct connection to any of your SAP systems, in order to perform our analysis and present our findings. The output of the extraction process is a large XML file that you can review before you upload it to Panaya. 2. Question: I am unable to log in to Panaya. I always bounce back to the login screen. No error message appears. Answer: When logging in to Panaya, make sure that your user name is the valid e-mail address that you used when you registered at Panaya. Some users enter their SAP user name by mistake, and that causes the login to fail. 3. Question: I am unable to log in to Panaya. I receive the error message Failed to Login user. Answer: When logging in to Panaya, make sure that you manually enter your password instead of copying it to the clipboard and pasting it into the password field. If you do not remember your password, and to avoid having your account locked, you can reset it by clicking on the link on the login page: Account Locked/Reset Password. Alternatively, you can ask your account manager to reset it for you. 4. Question: Due to security restrictions, I cannot point the RFC to my real production system, only to a copy of it. I get the following error message: RFC destination PANAYA_PRD doesnt point to Production System. Please choose another RFC destination that points to Production. (message no. CONV000) Answer: When directing the RFC destination to a copy of your production system, put this line in comment: DONT_SHOW_ERROR_ON_RFC TYPE C VALUE SPACE. It appears in the code extraction program as presented below: * Show error for not Production RFC. To turn off the error * please set the SPACE to 'X' as follows: * DONT_SHOW_ERROR_ON_RFC TYPE C VALUE 'X'. Enable this line remove the comment DONT_SHOW_ERROR_ON_RFC TYPE C VALUE SPACE. Disable the line add a comment * 5. Question: When logging in to Panaya, I receive the error message Your account is locked. How do I unlock it? Answer: You can unlock your account and reset the password by clicking on the link on the login page: Account Locked/Reset Password.

- 15 -

This should open a new screen. Insert your valid e-mail address (that you used when registering at Panaya) and confirm. Within a few minutes you should receive an e-mail with instructions. Follow them carefully. 6. Question: I am unable to connect the RFC to production. As a result, the code extraction program does not include the necessary usage. What should I do? Answer: To connect to production through RFC, you need to have authorizations that are detailed in the setup guide (see page 9). If you do not have the sufficient authorizations, you could ask your SAP Basis (or admin) to run the Panaya program in Usage Only mode (see explanation on page 11) and upload both output files to Panaya. 7. Question: When should I extract the code in Usage Only mode? Answer: The Usage Only mode is used for extracting the usage statistics from the production server it connected to through RFC. It could be used in several situations, for example: When the development system is connected to more than one production system. In that case, extract the usage in Usage Only mode from each production system and upload all to Panaya. When the development system and production system are not connected through RFC, and the code extraction has to run once on each system as Usage Only mode on the production system. If Panaya requested that you upload an additional Usage Only file to aggregate it into the existing analysis to improve its results. 8. Question: What should I check before uploading the code extraction results to Panaya? Answer: Open the generated XML file and verify that: The file has a header, starting with: <?xml version="1.0" encoding="UTF-8"?> <ROOT_ELEMENT> That the file has a suffix: </ETL_MESSAGES> </ROOT_ELEMENT> Zip the file using a standard zip program (make sure this is not RAR or 7-zip). Do not protect the zipped file with a password and do not zip it more than once. Be sure to wait for the upload to finish and indicate an upload ID.

- 16 -