IBM Support

Handling NWRFCSDK dependencies for BAPI connector

Preventive Service Planning


Abstract

This section details the process to upload NWRFCSDK dependent libraries in Cloud Pak for Data environment for BAPI connector runtime.

Content

The runtime execution of the SAP BAPI connector and SAP BW load processes requires the NWRFCSDK libraries libsapnwrfc.so and libsapucum.so as mandatory dependencies. These libraries must be available in the Cloud Pak for Data environment to ensure proper RFC communication and Unicode handling. Refer to the section below for the detailed procedure to upload and configure these dependencies
 
Prerequisite  
NWRFCSDK dependent libraries libsapnwrfc.so and libsapucum.so should be downloaded from SAP Marketplace.

Following are the steps to upload the required NWRFCSDK libraries to Cloud Pak for Data.
 
  • Use sshpass command to copy the NWRFCSDK files from the downloaded location on local environment to CPD cluster. The command format to be be used: sshpass -p <SSH password for cluster> scp <file_to_be_copied_from_local> root@<cluster URL>:<path _where_file_is_to_be_copied>
         for e.g., sshpass -p 'mypwd@123' scp Users/testuser/Downloads/sapbapi.tar.gz 
          root@api.tahoetestxyz.cp.fyre.ibm.com:/root/testuser
 
  • Login to the CPD cluster with SSH using root user. Refer command:  ssh root@<Cluster URL> and change directory to the location where dependency files have been copied in above step.
  • Identify the runtime pod using command oc get pod| grep runtime. The runtime pod instance name begins with keyword ds-px-default-ibm-datastage-px-runtime-<identifier>. For instance, the runtime pod name may appear like  ds-px-default-ibm-datastage-px-runtime-769d588968-4wm46.
  • Use oc cp command to copy dependent files from source location to the directory /ds-storage/user-lib/
      oc cp libsapucum.so ds-px-default-ibm-datastage-px-runtime-769d588968-4wm46:/ds-storage/user-lib/
      oc cp libsapnwrfc.so ds-px-default-ibm-datastage-px-runtime-769d588968-4wm46:/ds-storage/user-lib/
 

Known Issues:

          Issue: With the latest release of SAP NWRFCSDK Patch Level 18 (PL18) on 5th December 2025, SAP BAPI flows fail on

          Cloud Pak for Data (CPD) environment due to ICU library dependencies.

 Resolution: Copy the required ICU library files to the ds-px-default-ibm-datastage-px-runtime-<identifier>  Pod  along with the above two libraries. This ensures that all runtime dependencies are satisfied and allows successful execution of the flows. 


Parent topic : SAP BAPI connection 

[{"Type":"MASTER","Line of Business":{"code":"LOB76","label":"Data Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSZJPZ","label":"IBM InfoSphere Information Server"},"ARM Category":[{"code":"a8m0z0000001ir7AAA","label":"Cloud Pak for Data"}],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Document Information

Modified date:
04 June 2026

UID

ibm17156762