Considerations and restrictions when migrating to RHEL 8 or RHEL 9

Migrating SPL applications

Teracloud® Streams Version 7.2.0 does not support running applications on Version 8 or Version 9 systems that are compiled from a prior release. Additionally, Streams does not support running applications on a Version 9 system that are compiled on a Version 8 system.

To run applications on a Teracloud® Streams Version 8 or Version 9 system, you must recompile the applications for the target system.

Here are some changes that you may have to make to your application:

1. If you use any of the toolkits provided by Streams you will have to rename the package name. The toolkit package names have been renamed from com.ibm.streams and com.ibm.streamsx to com.teracloud.streams.
2. If you are using custom Java operators you may have to make changes due to the changes between Java 8 and Java 17. See the Oracle's JDK Migration Guide on migrating to Java 17.
3. If you are using custom C++ operators you may have to make changes due to C++ 17 support. See the Changes between C++11 and C++14 and Changes between C++14 and C++17 for removed C++ features.

To maintain an application on both a Version 8 or Version 9 system, use one of the following options:

Option 1: Copy the application source directories to a new location and recompile the application.

This option is preferred. This option is required if you need to make changes to your application enhancement in the product or the application has output files or data that cannot be shared between two running instances of the application.

Option 2: Specify a different output directory for the Version 8 or Version 9 version of the application.

Use the --output-directory option on the sc command to specify a different output directory for the application. For example, if a RHEL 7 application used the default output directory, you might specify --output-directory=output_rhel8 for the RHEL 8 version or --output-directory=output_rhel9 for the RHEL 9 version.