SAPEX Installation from Transport Request

How to know the SAP NetWeaver version

1. Log on to the system using SAPGUI
2. On the main menu, choose System > Status…
3. In the System: Status window you’ll see a section in the middle-right called SAP System data
4. Click the icon next to Product version to show the details of all the components installed on your system
   
5. Look for SAP_BASIS
   1. Release = major release version of NetWeaver
   2. SP-Level = installed support pack

What permissions are needed to run SAPEX in SAP

Depending on your use of SAPEX (Remote or Local) the permissions are different.

Remote usage of SAPEX means that the SAPEX functionality is executed within an external system. This means that you will use KLA to remotely connect to the SAP Server to extract the code and analyse it. In this remote scenario, the SAP Server acts as a pure server host. It provides the needed APB source files for KLA to analyze. Therefore, KLA will use an SAP user to connect to the SAP server to extract the code (i.e. to invoke the SAPEX RFCs).

In a Local usage of SAPEX, you will need to configure a SAP user with permissions to run the code extraction and execute the SAPEX programs.

Common permissions for both (Local and Remote) usage

Regardless of local vs remote usage, there are some common permissions the SAPEX user needs to be granted: 

• Object : S_DATASET
  • ACTVT = 06, 33, 34
  • FILENAME = DIR_HOME/sape4k/*

  • Note: if you configure the SAP instance to be balanced to a group of SAP servers, you will need to configure this permission in every SAP server (because DIR_HOME will be different for every SAP instance)

• Object : S_LOG_COM
  • COMMAND = 'ZKW_MKDIR', 'ZKW_RMDIR'
  • OPSYSTEM = Operating System type ( SY-OPSYS system variable) established for SM69 commands (for example, Linux, UNIX, ANYOS, Windows NT, etc… )
  • HOST = SAP server where above commands will be executed ( "*" or SY-HOST system variable, recommended * )

• Object : S_RZL_ADM
  • ACTVT = 03
  • Needed to remove export temporary directories of SAP server

Permissions for Remote usage

For SAPEX remote usage, SAP user must be type B (system) .

A type B user with above privileges should also be granted the following authorizations:

• Object : S_RFC
  • ACTVT = 16
  • RFC_TYPE = ‘FUGR’
  • RFC_NAME = ‘ZKW_SAPEX_FG’, ‘SYST’,’ RFC1’,’ SDIFRUNTIME’ 

The above permissions as displayed in SAP:

Permissions for Local usage

In a Local scenario, SAP user must be type A (dialog).

Besides the common authorizations (above explained), this SAP user must also have next ones:

Distribution of SAPEX as a Transport Request

Note: SAP Extractor for Kiuwan (SAPEX) is distributed as a Transport Request. This way, you can easily install all the required SAPEX source programs importing the transport request into your target SAP system.
SAPEX binary files (data-file and co-file) are contained into sapex_transport.zip (located at $(AGENT_HOME)/resources/abap directory of your Kiuwan Local Analyzer installation).

Note: If you cannot use this installation mechanism you can also install SAPEX by manually installing source code ( please visit Manual Installation of SAP Extractor)

How to import the SAPEX Transport Request

In this section, we will import the Transport Request for SAPEX that is included in your Kiuwan Local Analyzer distribution.

1. Get the Transport Request files

Find the Transport Request as a zip file (sapex_transport.zip) in the $(AGENT_HOME)/resources/abap directory of your Kiuwan Local Analyzer installation.

Unzip the file into your local system. This will extract two files :

• a data-file: R900039.NPL
• a co-file:    K900039.NPL

Please note that the last 3 digits of the transport numbers might be different in the most recent versions.

2. Copy the Transport Request files to your SAP System

If you have direct access to your SAP system, you can copy them directly.

Otherwise, execute SE37 and execute the ARCHIVFILE_CLIENT_TO_SERVER function. Click on Test/Execute

Then select the files you want to import (in your local machine) and the target path (in the SAP server), check Uppercase/Lowercase and Execute it.

In order to confirm the copy, you can use AL11 to check the transfer was done to the correct places.

Execute it and double-click on the DIR_TRANS row.

For cofiles, you should see something like the image below. Similar to data directory.

3. Import the Transport Request files

Next, the SAPEX Transport Request must be imported into your SAP system

Execute STMS and click on Import Overview

Then you will see your Import Queue(s).

Double-click on the queue, and you will see the requests for that queue.

Now, you should add the SAPEX Transport Request (Extras > Other Requests > Add) 

Click Transp. Request to see available Transport Requests:

Select it

Click Yes.

Then you will see the SAPEX Transport Request, select it, and click Import Request.

Select the Options tab below.

Once the import process is finished, you can check it using SE09. 

4. Create OS Commands (ZKW_MKDIR and ZKW_RMDIR)

After importing SAPEX Transport Request, you must create OS commands (ZKW_MKDIR and ZKW_RMDIR)

To do this, follow the instructions on Create OS commands (ZKW_MKDIR and ZKW_RMDIR)

Additional steps for local execution 

5. Create OS command to launch the analysis (ZKW_KLA_AGENT)

If you decide on a local scenario, you must create an OS command (ZKW_KLA_AGENT)

To do this, follow the instructions on Create OS command to launch the analysis (ZKW_KLA_AGENT)