Using Debian Advanced Package Tool (APT) for Apama on thin-edge.io

Tech Community - Dec 22 '22 - - Dev Community

Apama 10.15.0.2 now supports the Debian advance package tool (APT) for installation of Apama software and projects on thin-edge devices running on Debian operating systems. This process can be manged entirely using the Device Management app in your Cumulocity IOT tenant. Once your thin-edge device is set up, there is no further need to use the command line on your device. Instead, the following steps should be used to install support for Apama on thin-edge and individual Apama projects. Please note that when installing Apama projects, the projects must be compressed in ZIP format.

Set up the repository from which the packages will be installed

  1. In the Cumulocity IoT tenant, open the Device Management app, go to the Management menu option and select the Software repository.
  2. Click Add software at the right of the top menu bar.
  3. In the ADD SOFTWARE dialog enter the following details:
  1. Click the Add Software button.
  2. Now select the Devices menu option and then select All devices.
  3. In the list of devices, select the thin-edge device installed previously.
  4. In the sub-menu for the device, select the Software option.
  5. Click the Install software button in the bottom left; the apama-repo should be listed.
  6. Click the drop-down arrow on the right and check the 2022::apt radio button. Then, click Install.
  7. Finally, click the Apply changes button in the lower right of the panel. Image description

Image description

Add the Apama thin-edge support package to the tenant software repository and deploy it to thin-edge

  1. Return to the Device Management app and go to the Management menu option and select the Software repository.
  2. Click Add software at the right of the top menu bar.
  3. In the ADD SOFTWARE dialog enter the following details:
  • Software : apama-thin-edge-support
  • Description : apama-thin-edge-support (or something else if you choose)
  • Device Filter Type : (leave empty)
  • Software Type : apt
  • Version : 10.15.0.2-1::apt
  • SOFTWARE FILE : select the Provide a file path option and give an empty space (’ ').
  1. Click the Add Software button.
  2. Now return to the Devices menu option and then select All devices.
  3. In the list of devices, select the thin-edge device installed previously.
  4. In the sub-menu for the device, select the Software option.
  5. Click the Install software button in the bottom left; the apama-thin-edge-support should be listed.
  6. Click the drop-down arrow on the right and check the 10.15.0.2-1::apt radio button. Then, click Install.
  7. Finally, click the Apply changes button in the lower right of the panel. Image description

Image description

Once Apama support has been installed, the correlator will attempt to start. However, it will initially fail because there is not yet an Apama project installed on the device. An Apama project can be deployed using the Cumulocity IoT tenant, as described below.

Installing an Apama project on the thin-edge device

Once you have created an Apama project you must zip up the project using the ZIP format and not some other compression utility. Then use your tenant to deploy the zipped project to your thin-edge device by following the steps outlined in the original article.

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .