Installing a License

To use the SAP Toolkit, a valid Rhapsody license with the SAP Toolkit feature enabled is required. Refer to Managing Licensing for details on how to install a license.

Deploying the SAP Toolkit

Download the Libraries

To use the SAP Toolkit, the appropriate SAP libraries for your system are required. These can be downloaded from the SAP Service Marketplace. The SAP JCo (version 3) libraries are required for the Rhapsody engine, and the SAP Nco (version 3) libraries are required for any machine that will be using the Rhapsody IDE to configure SAP components.

Without the SAP libraries installed, SAP filters and communication points can be used in the Rhapsody IDE, but it would not possible to configure them. They may need to be re-configured after the libraries have been installed before they can be used.

Installing the SAP JCo libraries

In the tools/DeploySAPModule folder of the engine is a tool that will package the SAP JCo libraries into a format that Rhapsody can use. The following steps should be followed:

  1. Copy the appropriate JCo libaries into this folder. This should be two files, the sapjco3.jar and the native library, which will either be libsapjco3.so or sapjco3.dll, depending on which operating system Rhapsody is running on.

    Care should be taken to make sure that the correct native library for the operating system and architecture (for example, 32- or 64-bit) is chosen.

  2. Run either deploySAPModule.bat or deploySAPModule.sh, depending on which operating system Rhapsody is running on.

  3. The console output should indicate whether or not the operation was successful. If it did succeed, a file, com.orchestral.rhapsody.module.helper.sap.jar will have been deployed to the modules folder of the data directory. If the was an issue deploying the file to that location, the file should appear in the current directory, and it should be manually copied to the modules folder of the data directory.
  4. Typically the engine picks up this new file within a minute or two. The Rhapsody IDE will need to be restarted to pick up these changes.

If the output indicates failure due to a permissions issue, make sure that the user running the script has permissions to write to the modules folder and/or run the script with a user that does have permissions.

Installing the SAP NCo libraries

For any machine that is running the Rhapsody IDE and is required to configure SAP communication points or filters, the SAP NCo (version 3) libraries should be installed. The 32-bit (x86) version should be installed.

When installing the SAP NCo library, it is imperative to select the Install assembles to GAC option on the Optional setup steps dialog. Failure to do this results in the Rhapsody IDE being unable to find the SAP NCo library.