Non‑Windows TestConnection failures with SAP NetWeaver (NW) RFC SDK 7.50 PL18 libraries in the ITCAM SAP Agent

To resolve this issue, you must follow the instructions below to replace the existing ksa_config.jar with the updated version.

1. Take a backup of the existing ksa_config.jar file located in the SAP Agent installation classes directory, for example, "<AgentHome>/classes".
2. Download and replace it with the new ksa_config.jar file from the Download_ksa_config.jar from Fix Central link.
3. Assign 0777 permissions to the new ksa_config.jar.
4. Run the TestConnection functionality again using any GUI environment (e.g., Xming or VNC).

Note: After replacing the file, the updated TestConnection functionality is not backward compatible. SAP NetWeaver (NW) RFC SDK 7.50 PL17 libraries will no longer work with this updated version.

If any user encounters the error "Unknown error occurred" while running the TestConnection functionality after replacing the new ksa_config.jar, please follow the resolution steps below:

1. Execute the TestConnection functionality directly from the non‑Windows machine by using a PuTTY/SSH terminal.

2. Run the following command from the Agent installation directory, for example, "/opt/IBM/ITM".

   AgentHome>/<Architecture>/bin/TestConnection appsrvmode <System_ID> <System_IP> <System_Number> <Client_Number> <User> <Password> E false 0 false false false

   Example

   /opt/IBM/ITM/lx8266/bin/TestConnection appsrvmode PS5 10.53.114.22 01 001 IBMMON_AGENT PASSWORD E false 0 false false false

Possible outputs

1. The required library is missing.
   Solution

   1. Run the ldd command to identify which libraries are not found. 

      ldd /opt/IBM/ITM/lx8266/bin/TestConnection

      This command will list all required libraries.

   2. Download the libraries that show “not found”, and for the already downloaded ones, for example, "SAP NetWeaver (NW) RFC SDK 7.50 PL18 libraries", make sure the correct path is set in the environment variables.
      On Linux systems, set the path using the LD_LIBRARY_PATH variable, and on UNIX systems, use the LIBPATH variable.
2. Connection failed.
    Solution
   1. Verify that the SAP system connection parameters are correct.
   2. Also, ensure that bidirectional network access is enabled between the SAP system and the Agent machine.
3. Connection is successful.
   1. Proceed to validate via GUI by running TestConnection functionality again (Xming or VNC) and confirm that no errors appear.