Technical Blog Post
Abstract
Troubleshooting issues with the SAP Suite Adapter for JCo 3.x in a Unix/Linux environment
Body
I recently worked with a customer who had successfully installed a fix pack to Sterling B2B Integrator only to find that the SAP Suite Adapter for JCo 3.x would longer start.
I checked all the usual suspects:
- <SI Root
>/in stal l/pr oper ties /dyn amic clas spat h.cf g contained a reference to the sapjco3.jar. - The <SI Root
>/in stal l/ja r/sa pjco 3/<s ap version> directory contained the sapjco3.jar - <SI Root
>/in stal l/sa pjco 3/<s ap version>/linux directory contained the library file.
Everything looked fine, so we used a time-honored technique to determine whether SI could find the sapjco3.jar and its library:
In the SI User Interface, we went to Deployment > Utilities > SAP Suite Builder 3 > IDOC Meta Data Builder and clicked Go.
If you try this and you are prompted for credentials, that tells you that SI can find the sapjco3.jar and its library. In this case, we saw an error message, which told us what we already suspected - the sapjco3.jar and libsapjco3.so were in place, but for whatever reason, SI could not find them.
As a rule, installing a patch will not clobber SI's ability to find the SAP components, but in this case, something clearly had. The quickest course of action seemed to be uninstalling and reinstalling the sapjco3.jar and library. We set to work.
The first order of business was to stop Sterling B2B Integrator by executing .hardstop.sh in the <SI Root>/install/bin directory.
The second step was to copy the sapjco3.jar and the libsapjco3.so out of the SI directory structure and into another directory for safe keeping (you can skip this step if you already have back up copies of these files.)
The third item on the agenda was to execute ./in
./i
** Looking /opt
**** Found a match &INS
** Looking /opt
**** No match found
** Looking /opt
**** No match found
** Looking /opt
**** No match found
** Looking /opt
**** No match found
** Looking /opt
**** No match found
[TIMING] - InteropBuildHelper completed: 0 seconds.
It was now time to uninstall the sapjco3.jar:
./in
I wasn't sure if I needed to do the same for the library file, so what the heck, I executed the command again on the library:
./in
So far so good. Running these commands does not delete the files themselves, so for good measure, we executed two more commands:
rm -rf /opt
rm -rf /opt
Time now for a public service announcement: Always have a backup of SI and the database before you execute commands that delete files - that way, you can restore if anything goes wrong! Too,
exercise extreme caution with commands such as rm -rf. Be careful and you won't inadvertently delete a file that you hadn't intended to delete!
With the uninstallation accomplished, it was time to reinstall:
In <SI Root>/install/bin, we executed:
./in
then:
./in
We decided to throw caution to the wind - we didn't check the dyna
After the restart, the SAP Suite Adapter for JCo 3.x started up without difficulty.
These steps aren't usually necessary, but if you find that SI cannot find the sapjco3.jar and/or its library, these steps can restore the SAP Suite Adapter for JCo 3.x back to functioning properly.
UID
ibm11120503