SAP CC Agent Preparations

The relevant jar files required for the preparations must be obtained from the SAP CC server provider. The Core SDK jar files can be found in the SAP Convergent Charging Installation Materials.

1 SAP CC Core SDK Jar files for 2023 FPS1, FPS2, FPS3 or 2025 FPS0
2 Secure Communications via TLS

Note!

MediationZone 9.x runs on Java 17 or Java 21 and therefore cannot use SAP CC Core SDK client JAR files compiled for Java 25, such as those delivered with SAP CC 2023 SPS4 and SAP CC 2025 FPS1.

SAP CC provides ascending compatibility, meaning a newer SAP CC server version accepts requests from clients built with an older SAP CC SDK version. You can therefore connect MediationZone 9.x to the SAP CC servers that runs on Java 25 by using an earlier SAP CC SDK that is compiled for Java 17, as shown below.

+-----------------------+-----------------------------------+
| SAP CC server version | SAP CC SDK client version to use  |
+-----------------------+-----------------------------------+
| SAP CC 2023 SPS4      | SAP CC 2023 FPS1, FPS2, FPS3      |
| SAP CC 2025 FPS1      | SAP CC 2025 FPS0                  |
+-----------------------+-----------------------------------+

For official SAP compatibility statements, refer to:

SAP CC Core SDK Jar files for 2023 FPS1, FPS2, FPS3 or 2025 FPS0

The following jar files are required by SAP CC agents when using with SAP CC 2023 or 2025:

common_message.jar
common_util.jar
core_chargingplan.jar
core_chargingprocess.jar
core_client.jar
jaxb-api-2.3.1.jar
jaxb-core-2.3.0.1.jar
jaxb-impl-2.3.8.jar
logging.jar
sap.com~tc~logging~java.jar

Note!

The version of SAP CC Core SDK client JAR files must match the version of your SAP CC core system (i.e., the back-end servers).

From the unpacked SAP Convergent Charging installer, the jar files can typically be found by navigating to the directory and unzipping the core_sdk.zip file located in DATA_UNITS/<CC_VERSION>_TOOLS_CONTENT_UC_OSIND.

Example - Unzip core_sdk.zip

$ unzip DATA_UNITS/CC2023_TOOLS_CONTENT_UC_OSIND/core_sdk.zip -d core_sdk

For the SAP Convergent Charging server patches, the JAR files can typically be found by unpacking the patch file for the SAP CC Core SDK software unit.

Example - Unzip SAP CC Core SDK patch file

$ unzip CORESDK02_0-80008788.ZIP -d core_sdk

Example - Listing SAP CC Core SDK jar files

$ ls -gG core_sdk/jars/
total 17152
-rw-r--r-- 1 174853 Feb 12 2024 common_message.jar
-rw-r--r-- 1 660812 Feb 12 2024 common_util.jar
-rw-r--r-- 1 691798 Feb 12 2024 core_chargingplan.jar
-rw-r--r-- 1 426602 Feb 12 2024 core_chargingprocess.jar
-rw-r--r-- 1 4917429 Feb 12 2024 core_client.jar
-rw-r--r-- 1 128076 Feb 12 2024 jaxb-api-2.3.1.jar
-rw-r--r-- 1 254858 Feb 12 2024 jaxb-core-2.3.0.1.jar
-rw-r--r-- 1 1117712 Feb 12 2024 jaxb-impl-2.3.8.jar
-rw-r--r-- 1 89161 Feb 12 2024 logging.jar
-rw-r--r-- 1 302450 Feb 12 2024 sap.com~tc~logging~java.jar

The classpaths for the jar files are specified for each EC. In the example below, the SAP jar files are located in MZ_HOME/3pp.

Note!

Ensure that you include existing paths, so that they are not overwritten. Example command to get existing classpaths:

$ mzsh topo get topo://container:<container>/pico:<ec>/obj:config.classpath

Example - Setting classpath

$ mzsh topo set topo://container:<container>/pico:<ec name>/obj:config.classpath.jars ' 
["lib/picostart.jar",
"3pp/common_message.jar",
"3pp/common_util.jar",
"3pp/core_chargingplan.jar",
"3pp/core_chargingprocess.jar",
"3pp/core_client.jar",
"3pp/jaxb-api-2.3.1.jar",
"3pp/jaxb-core-2.3.0.1.jar",
"3pp/jaxb-impl-2.3.8.jar",
"3pp/logging.jar",
"3pp/sap.com~tc~logging~java.jar"]'

After the classpath has been set, you need to manually distribute the jar files so that they are in place when the EC is started.

You can then restart the EC to register the configuration changes above for the SAP CC agents.

Secure Communications via TLS

The agent can be configured for secure communication via TLS. This requires a keystore to be created for each EC host. For more information about setting up secure communication, refer to SAP CC Secured Connection.

Note!

For SAP CC Online Agent, it is required to add the hostname information of the SAP Convergent Charging Core server Dispatcher Instance(s). The execution content server needs this information. The IP address needs to be explicitly mentioned. Refer to the SAP CC Online Agent Configuration page.