Prerequisites

  • Have a Heex CLI
  • Have a packaged SDK
  • Have a USER_SECRET_KEY. Should be accessible in your personnal space on the heex cloud platform. If you already logged-in you don’t need to add the Api-Key in your command line.

Usage

SubcommandDescription
packageCreate an installer with Heex Kernel and your implementations.
uploadCreate an installer with Heex Kernel and your implementations, and release it onto your system(s). Several system ids can be provided if built agent needs to be uploaded on several systems at once. Note: Api-Key is mandatory.
installPackage and install Heex Kernel and your implementation onto your computer. Note: Api-Key is mandatory.
uninstallUninstall Heex Kernel from your computer. Both background-process and service are removed.
Usage:
./heex agent SUBCOMMAND [--help]

How to package your own Heex Agent

To create your Agent installer locally, you may use the package functionality Available options:
  • --api-key: Provide your USER_SECRET_KEY. It is mandatory if you provide your system-id instead of the path to your system-conf.
  • --config-path: If you have the systemConf.json path, provide it here. It shall be packaged inside your installer.
  • --system-id: If you don’t have the systemConf.json yet, you may provide the system-id here. It shall use your api key to download the systemConf.json
  • --path-to-sdk: use this option if you run the Heex CLI from a location that is not inside a SDK folder, so that you can point to the root of the SDK folder. (usage: --path-to-sdk path/to/sdk/folder).
Usage:
./heex agent package --api-key <USER_SECRET_KEY> --path-to-sdk /path/to/sdk/folder --system-id <SYSTEM_ID>

How to release your own Heex Agent

To take advantage of the ease of deployment and over-the-air update capabilities, you need to release your Heex Agent to our Cloud. Available options:
  • --system-id: with this option you can specify one or several system-id’s to which you would like to upload your packaged Agent. Please use the option for each id you want. (usage: --system-id ID1 --system-id ID2 …).
  • --config-path: alternatively to the option mentionned above, you can also provide the path to a specific systemConf.json. This will then include the systemConf inside the package and upload the Agent to given system. Note that this implies that you can only upload to one system at the time, and it cannot be combined with the --system-id option. (usage: --config-path path/to/systremConf.json).
  • --path-to-sdk: use this option if you run the Heex CLI from a location that is not inside a SDK folder, so that you can point to the root of the SDK folder. (usage: --path-to-sdk path/to/sdk/folder).
Usage:
./heex agent upload --api-key <USER_SECRET_KEY> --path-to-sdk /path/to/sdk/folder --config-path path/to/systremConf.json

How to install your own Heex Agent onto your computer

Heex Agent can be directly installed onto your local computer. Available options:
  • --config-path: the path to a specific systemConf.json. This will then include the systemConf inside the installed Agent.
  • --path-to-sdk: use this option if you run the Heex CLI from a location that is not inside a SDK folder, so that you can point to the root of the SDK folder. (usage: --path-to-sdk path/to/sdk/folder).
  • --execution-mode: ‘background’ or ‘service’ (optinal, defaults to service).
Usage:
./heex agent install --api-key <USER_SECRET_KEY> --path-to-sdk /path/to/sdk/folder --config-path path/to/systremConf.json

How to uninstall your own Heex Agent onto your computer

Heex Agent can be uninstalled from your local computer with a simple command. Usage:
./heex agent uninstall

Getting Help

./heex agent --help
./heex agent package --help
./heex agent upload --help
./heex agent install --help
./heex agent uninstall --help