Migrating the Cumulocity IoT transports to 10.5
In order to migrate an existing Apama project to 10.5 which is using the removed 9.0+ and/or 9.8+ Cumulocity IoT connectivity bundles, you must proceed as described below. If you are using Cumulocity IoT with the built-in Apama EPL editor, then no migration steps should be needed.
To migrate the Cumulocity IoT transports to 10.5:
1. Back up the CumulocityIoT.properties files for 9.0+ and/or 9.8+. These are located in the config/connectivity folder of your project.
2. Remove the Cumulocity Client 9.0+ and/or Cumulocity Client 9.8+ connectivity bundles from your project.
3. If present, remove the Cumulocity IoT > Event Definitions for Cumulocity 9.0+ and/or Cumulocity IoT > Event Definitions for Cumulocity 9.8+ EPL bundles from your project.
4. If present, remove the Cumulocity IoT > Utilities for Cumulocity 9.0+ and/or Cumulocity IoT > Utilities for Cumulocity 9.8+ EPL bundles from your project.
5. Add the Cumulocity IoT > Cumulocity Client 10.5+ connectivity bundle.
6. Add the Cumulocity IoT > Event Definitions for Cumulocity 10.5+ EPL bundle.
7. Add the Cumulocity IoT > Utilities for Cumulocity 10.5+ EPL bundle.
8. Populate the CumulocityIoT.properties file for 10.5 with the data from your backup.
9. Use the com.apama.cumulocity.Util.generateReqId() action to generate all request identifiers (reqId).
Important:
There should be no use of integer.getUnique() or integer.incrementCounter() to generate request identifiers.
For detailed information on this connectivity plug-in, see
The Cumulocity IoT Transport Connectivity Plug-in.