Skip to content

Deploy to your platform

Prerequisite

  • You need to have your device created on Kamea

    Refer to the Kamea documentation to learn how to create a compatible device.

  • You need to have your release package built

Debian-based distributions

Upload the package to your target

The examples below are using SSH and SCP to connect and/or to send files to the target.

shell scp <release-package-path> <username>@<target-ip>:<destination-path>

Then, we can proceed to the installation.

Connect to the target.

shell ssh <username>@<ip-address>

A password may be required depending on your configuration. Then, go to the directory you deployed the package.

For Raspbian, we'll be using dpkg to install the agent.

shell cd <update-directory> dpkg -i <your-klas-release-package>.deb

Yocto and other linux distributions

Refer to the meta-klas documentation to learn how to build and integrate Klas on your Yocto platform.

Or you can cross-compile and deploy Klas, following the dedicated documentation.

Welma

For Welma devices, updatectl can also be used to install Klas on your target.

shell cd <update-directory> updatectl install <package>.swu

Then reboot your device and re-ssh on it to confirm the update:

shell updatectl confirm

Your Kamea Linux Agent Service should be successfully installed and ran once to create default configuration files. Now, you need to generate your SSL certificate and edit your provisioning config file to establish a working connection between the agent and the cloud.

Run the application

In the case of using Systemd: You can now start the service using systemctl restart klas (sudo may be required) systemctl status klas can be used to check the agent logs.

Firmware update

Klas is used to facilitate the firmware update process by downloading the new firmware, communicating with the system, and keeping track of the update status.

To start a firmware update, refer to the Kamea documentation to learn how to:

  • Upload a new firmware version.
  • Apply the new firmware version to your device

If you want more information about the firmware update process, check the Klas Firmware Update documentation.